# Formularfelder

> Jedes Feld der Formulare in up4: was es bewirkt, welcher Wert vorgegeben ist und welche Handbuchseite es erklärt.

Source: https://upfour.io/de/docs/reference/form-fields

Jedes Feld mit der Beschriftung aus der App, was es bewirkt und was das Formular vorgibt. Die Namen der API-Felder stehen im Kasten „Per API“ der jeweiligen Handbuchseite.

## Monitore

| Feld | Was es bewirkt | Vorgabe | Mehr dazu |
| --- | --- | --- | --- |
| Name | Der Name in Listen und Benachrichtigungen. | – | [Website überwachen](https://upfour.io/de/docs/watch-a-website.md) |
| Prüfart | Die Art der Prüfung: Website, Port, DNS-Eintrag oder Ping. | – | [Prüfungen und Regionen](https://upfour.io/de/docs/how/checks-and-regions#check-types) |
| Zu überwachende URL | Die Adresse, die up4 abruft. Ein fehlendes https:// ergänzt up4. | – | [Website überwachen](https://upfour.io/de/docs/watch-a-website.md) |
| Prüfintervall | Wie oft up4 prüft. Kürzere Abstände bemerken einen Ausfall früher und kosten mehr. | 3 Minuten in der App; 1 Minute über die API | [Prüfungen und Regionen](https://upfour.io/de/docs/how/checks-and-regions#intervals) |
| Regionen | Die Regionen, aus denen geprüft wird. Bei mehreren Regionen gleicht up4 sie ab, bevor es benachrichtigt. | – | [Prüfungen und Regionen](https://upfour.io/de/docs/how/checks-and-regions#regions) |
| Gilt als ausgefallen, wenn | Was als erreichbar gilt: eine erfolgreiche Antwort, ein genauer Statuscode oder ein Wort, das vorkommen oder fehlen muss. | Jede 2xx-Antwort | [Seiteninhalt prüfen](https://upfour.io/de/docs/check-page-content.md) |
| Gesuchter Text | Das Wort oder die Wendung, die in der Seite stehen soll. Groß- und Kleinschreibung spielt keine Rolle, solange „Groß-/Kleinschreibung ignorieren“ an ist. | – | [Seiteninhalt prüfen](https://upfour.io/de/docs/check-page-content.md) |
| Erwarteter Statuscode | Der Statuscode, mit dem die Seite antworten muss, zum Beispiel bei einer Weiterleitung, die bleiben soll. | – | [Seiteninhalt prüfen](https://upfour.io/de/docs/check-page-content.md) |
| HTTP-Methode | Die Methode, die up4 bei jeder Prüfung sendet. Eine Suchbegriff-Prüfung kann nicht HEAD nutzen, weil HEAD keine Seite liefert. | GET in der App; HEAD über die API, wenn keine Methode gesendet wird | [Prüfungen und Regionen](https://upfour.io/de/docs/how/checks-and-regions#http-checks) |
| Zeitlimit der Anfrage | Wie lange up4 auf eine Antwort wartet, bevor die Prüfung als fehlgeschlagen zählt. | 30 Sekunden, höchstens 1 Minute | [Prüfungen und Regionen](https://upfour.io/de/docs/how/checks-and-regions#timeouts) |
| Anfrageinhalt | Daten, die bei POST-, PUT- und PATCH-Prüfungen mitgehen, bis 8 KB. | – | [Prüfungen und Regionen](https://upfour.io/de/docs/how/checks-and-regions#http-checks) |
| Weiterleitungen folgen | Ob up4 Weiterleitungen bis zur Zielseite folgt. Ist es aus, gilt die Weiterleitung selbst als Antwort. | An | [Prüfungen und Regionen](https://upfour.io/de/docs/how/checks-and-regions#http-checks) |
| Cookies bei Weiterleitungen behalten | Behält Cookies, die während einer Weiterleitungskette gesetzt werden, für Seiten, die erst ein Cookie setzen. | Aus | [Prüfungen und Regionen](https://upfour.io/de/docs/how/checks-and-regions#http-checks) |
| TLS-Zertifikat prüfen | Ob up4 ein abgelaufenes, nicht vertrauenswürdiges oder falsch ausgestelltes Zertifikat ablehnt. Schalte es nur für einen Testserver aus. | An | [Prüfungen und Regionen](https://upfour.io/de/docs/how/checks-and-regions#tls-certificates) |
| Warnung vor Zertifikatsablauf | Warnt dich so viele Tage, bevor das Zertifikat abläuft. Standardmäßig aus. | Aus | [Prüfungen und Regionen](https://upfour.io/de/docs/how/checks-and-regions#tls-certificates) |
| Warnung vor Domainablauf | Warnt dich so viele Tage, bevor die Domain ausläuft. Standardmäßig aus. | Aus | [Prüfungen und Regionen](https://upfour.io/de/docs/how/checks-and-regions#tls-certificates) |
| Wann sollen wir dich benachrichtigen? | Sofort meldet, sobald Prüfungen einen Ausfall bestätigen. Die ruhige Option lässt kurze Aussetzer aus. | Sofort | [Wann du benachrichtigt wirst](https://upfour.io/de/docs/how/when-you-get-alerted.md) |
| Alarmplan | Ein Alarmplan holt Personen stufenweise dazu, bis jemand reagiert, zusätzlich zu den Kanälen. | – | [Alarmplan erstellen](https://upfour.io/de/docs/build-an-alert-plan.md) |
| Erholungszeit | Wie lange der Monitor stabil sein muss, bevor der Ausfall als beendet gilt. | 60 Sekunden im Formular | [Wann du benachrichtigt wirst](https://upfour.io/de/docs/how/when-you-get-alerted.md) |
| Incident-Screenshots | Nimmt einen Screenshot der Seite auf, wenn ein Vorfall beginnt. Zählt zu einem Monatskontingent. | – | [Vorfall bearbeiten](https://upfour.io/de/docs/handle-an-incident.md) |
| Host | Der Server, zu dem up4 eine Verbindung aufbaut. | – | [Server, Port oder DNS-Eintrag prüfen](https://upfour.io/de/docs/check-server-port-dns.md) |
| Port | Der Port, zu dem up4 sich verbindet, von 1 bis 65535. | – | [Server, Port oder DNS-Eintrag prüfen](https://upfour.io/de/docs/check-server-port-dns.md) |
| DNS-Server | Der DNS-Server, den up4 fragt. Leer nutzt einen öffentlichen. | – | [Server, Port oder DNS-Eintrag prüfen](https://upfour.io/de/docs/check-server-port-dns.md) |
| Eintragstyp | Der Eintragstyp, der abgefragt wird: A, AAAA, CNAME, MX, NS oder TXT. | A | [Server, Port oder DNS-Eintrag prüfen](https://upfour.io/de/docs/check-server-port-dns.md) |
| Erwartete Antwort | Ein Wert, den die Antwort enthalten muss. Leer prüft nur, ob der Name aufgelöst wird. | – | [Server, Port oder DNS-Eintrag prüfen](https://upfour.io/de/docs/check-server-port-dns.md) |
| Zusätzliche Bestätigungszeit | Sekunden; 0 heißt keine zusätzliche Wartezeit | 0, keine zusätzliche Wartezeit | – |
| Groß-/Kleinschreibung ignorieren | Standardmäßig an: Groß- und Kleinschreibung wird ignoriert. | – | [Seiteninhalt prüfen](https://upfour.io/de/docs/check-page-content.md) |
| Header | Wird bei jeder Prüfung mitgesendet. Bis zu 20 Header; die Werte werden verschlüsselt gespeichert. | – | [Seiteninhalt prüfen](https://upfour.io/de/docs/check-page-content.md) |
| Benutzername | Benutzername für Basic Auth. | – | [Seiteninhalt prüfen](https://upfour.io/de/docs/check-page-content.md) |
| Passwort | Passwort für Basic Auth. Wird verschlüsselt gespeichert und nie zurückgegeben. | – | [Seiteninhalt prüfen](https://upfour.io/de/docs/check-page-content.md) |
| Proxy | Prüfung über deinen Proxy senden. Der Port steht im Feld für den Proxy-Port. | – | [Seiteninhalt prüfen](https://upfour.io/de/docs/check-page-content.md) |
| IP-Version | Gilt nur für Ping-Prüfungen. | – | [Server, Port oder DNS-Eintrag prüfen](https://upfour.io/de/docs/check-server-port-dns.md) |
| Abzufragende Domain | Der Domainname, den up4 abfragt. | – | [Server, Port oder DNS-Eintrag prüfen](https://upfour.io/de/docs/check-server-port-dns.md) |
| Hostname oder IP-Adresse | Bei einer Ping-Prüfung steht der Host oder die IP-Adresse im Adressfeld. | – | [Server, Port oder DNS-Eintrag prüfen](https://upfour.io/de/docs/check-server-port-dns.md) |

## Alarmierung

| Feld | Was es bewirkt | Vorgabe | Mehr dazu |
| --- | --- | --- | --- |
| Name | – | – | – |
| Typ | email, sms, voice, webhook, slack, telegram, msteams, discord, pagerduty, zapier, datadog, newrelic, jira, grafana, ntfy oder pushover | – | – |
| E-Mail-Adresse | – | – | – |
| Webhook-URL | – | – | – |
| Signaturschlüssel | – | – | – |
| Slack-Webhook-URL | Slack, Microsoft Teams, Discord, Zapier und Grafana nutzen diesen Schlüssel für ihre URL | – | – |
| Bot-Token | – | – | – |
| Chat-ID | – | – | – |
| Routing-Schlüssel | – | – | – |
| Jede Meldung einzeln senden | – | – | – |
| Name des Alarmplans | – | – | – |
| Warte | Sekunden; ab Schritt 2 mindestens 60 | – | – |
| Wen sollen wir benachrichtigen? | eine Liste von Kanal-IDs | – | – |
| Wie dringend ist diese Meldung? | high, voice, sms oder low | – | – |
| Erinnerungen nach der letzten Stufe | 0 bis 8 | – | – |
| Name | – | – | – |
| Teammitglieder | Nutzer-IDs in Wechselreihenfolge | – | – |
| Wechselrhythmus | daily, weekly oder custom | – | – |
| Übergabezeit | – | – | – |
| Übergabetag | – | – | – |
| Zeitzone | – | – | – |
| Wer vertritt | – | – | – |
| Von | – | – | – |
| Bis | – | – | – |
| Grund (optional) | – | – | – |

## Kunden

| Feld | Was es bewirkt | Vorgabe | Mehr dazu |
| --- | --- | --- | --- |
| Kundenname | – | – | – |
| Hauptdomain | – | – | – |
| Startvorlage | – | – | – |
| Kommunikationssprache | – | – | – |
| Anmeldung für diesen Kunden erlauben | – | – | – |
| Monitore und geplante Aufgaben pausieren | Abfrageparameter, true zum Pausieren | – | – |
| Portalansicht | – | – | – |
| Vorfälle | – | – | – |
| Berichte | – | – | – |
| Service-Level | – | – | – |
| Antwortzeit | – | – | – |
| Vorfallauswertung | – | – | – |
| Ausfallnachweise | – | – | – |
| Berichtsdownloads | – | – | – |

## Geplante Aufgaben

| Feld | Was es bewirkt | Vorgabe | Mehr dazu |
| --- | --- | --- | --- |
| Name | – | – | – |
| Rückmeldung erwartet alle | Ganze Sekunden; das Formular rechnet Sekunden, Minuten, Stunden oder Tage um. | – | – |
| mit einer Toleranzzeit von | Ganze Sekunden, null oder mehr. | – | – |
| Gruppe | – | – | – |
| Kunde | – | – | – |
| Metadaten | – | – | – |

## Vorfälle

| Feld | Was es bewirkt | Vorgabe | Mehr dazu |
| --- | --- | --- | --- |
| Kurzbeschreibung | – | – | – |
| Ausführliche Beschreibung | – | – | – |
| Betroffener Monitor (optional) | – | – | – |
| Schweregrad | critical, warning oder info | – | – |
| Aktuellen Stand mitteilen | – | – | – |
| An eine bestimmte Person eskalieren | die Anfrage braucht außerdem den Header Idempotency-Key | – | – |
| Incident-Screenshots | eine Einstellung des Monitors, nicht des Vorfalls | – | – |

## Wartungsfenster

| Feld | Was es bewirkt | Vorgabe | Mehr dazu |
| --- | --- | --- | --- |
| Von | HH:MM in der Zeitzone des Fensters. | – | – |
| Bis | – | – | – |
| Zeitzone | Eine IANA-Zone wie Europe/Berlin. | – | – |
| An diesen Tagen | Drei Buchstaben pro Tag; eine leere Liste bedeutet jeden Tag. | – | – |
| Titel | Als Wartungseintrag mit dem Status scheduled senden. | – | – |
| Startdatum | Ein Zeitstempel; die App verbindet Startdatum und Startzeit. | – | – |
| Enddatum | Ein Zeitstempel; die App verbindet Enddatum und Endzeit. | – | – |
| Wiederholen | none, weekly oder monthly. | – | – |
| Während der Wartung | none prüft weiter, pause_checks pausiert die betroffenen Monitore. | – | – |
| Betroffene Komponenten | – | – | – |
| Abonnenten benachrichtigen | – | – | – |

## Playbooks

| Feld | Was es bewirkt | Vorgabe | Mehr dazu |
| --- | --- | --- | --- |
| Titel | – | – | – |
| Beschreibung | – | – | – |
| Zuständig | – | – | – |
| Schritte | eine Liste von Schritten mit Titel und Beschreibung | – | – |
| Verknüpfte Monitore | – | – | – |

## Berichte

| Feld | Was es bewirkt | Vorgabe | Mehr dazu |
| --- | --- | --- | --- |
| Name | – | – | – |
| Bericht | – | – | – |
| Auf Kunden begrenzen (optional) | – | – | – |
| Format | – | – | – |
| Empfänger | – | – | – |
| Rhythmus | – | – | – |
| Tag im Monat | – | – | – |
| Versandzeit (Stunde) | – | – | – |
| Zeitzone | – | – | – |
| Berichtssprache | – | – | – |

## Statusseiten

| Feld | Was es bewirkt | Vorgabe | Mehr dazu |
| --- | --- | --- | --- |
| Unternehmensname | – | – | – |
| Öffentliches Seitenkürzel | – | – | – |
| Aufbau | Bereiche mit ihren Komponenten in Anzeigereihenfolge | – | – |
| Layout | ein Objekt mit Layout, Hintergrund und Kopfzeilenfarben | – | – |
| Ankündigung | – | – | – |
| Wie viele Tage anzeigen? | – | – | – |
| Standardsprache | – | – | – |
| Antwortadresse für Statusmails | – | – | – |
| Passwort | – | – | – |
| Eigenes CSS | – | – | – |
| Statusseite veröffentlichen | eine über die API angelegte Seite startet unveröffentlicht, außer du sendest true | – | – |

## Teams und Mitglieder

| Feld | Was es bewirkt | Vorgabe | Mehr dazu |
| --- | --- | --- | --- |
| E-Mail-Adresse | – | – | – |
| Rolle | – | – | – |
| Team | – | – | – |
| Teamname | – | – | – |

Ein Strich heißt: Das Formular gibt nichts vor, oder die Handbuchseite beschreibt den Wert. Die Vorgaben gelten für das Formular in der App; die API kann abweichen, wo es dasteht.
