HTTP-Anfrage
Die HTTP-Aufgabe zeigt, ob eine Website oder ein Web-Service so geöffnet wird, wie Sie es in der normalen Arbeit erwarten.
Wann verwenden
- Wenn Sie eine Website-Seite, ein persönliches Konto oder einen Health-Endpoint überwachen müssen.
- Wenn es wichtig ist, nicht nur die Serververfügbarkeit, sondern auch die korrekte HTTP-Antwort zu prüfen.
- Wenn Sie den Ausfall aus der Sicht des Benutzers sehen möchten, nicht nur anhand eines offenen Ports.
Wann einen anderen Typ wählen
- Wenn Sie nur die grundlegende Netzwerkverfügbarkeit des Servers prüfen müssen, reicht meist Ping.
- Wenn nur die Gültigkeitsdauer des Zertifikats wichtig ist, eignet sich SSL besser.
- Wenn das Monitoring auf ein Signal von einem externen Prozess warten soll, verwenden Sie „Externes Ereignis".
Achtung:
Wählen Sie für die Hauptprüfung besser eine URL, die den tatsächlichen Betriebszustand des Services widerspiegelt,
und keine zufällige Seite, die sich aufgrund von Authentifizierung, Werbung oder Personalisierung ändern kann.
Allgemeine Formularfelder
| Feld | Bedeutung | Was angeben | Beispiel |
|---|---|---|---|
| Aufgabe aktiviert | Bestimmt, ob die Prüfung sofort nach dem Speichern gestartet wird. | Lassen Sie die Aufgabe aktiviert, wenn Sie den Monitoring sofort starten möchten. | Aktiviert |
| Name | Name der Prüfung in der Liste und Benachrichtigungen. | Geben Sie an, was genau geprüft wird. | Startseite example.com |
| Gruppe | Ermöglicht die Zuordnung der Aufgabe zu einem Projekt oder Abschnitt. | Wählen Sie eine Gruppe, wenn Sie Aufgaben pro Projekt zusammenhalten möchten. | Website example.com |
| Intervall | Wie oft die HTTP-Prüfung ausgeführt wird. | Wählen Sie das Intervall nach der Wichtigkeit der Seite oder des Services. | 5 Minuten |
| Benachrichtigungskanäle | Wohin Nachrichten über Probleme und Wiederherstellung senden. | Markieren Sie die Kanäle, in denen Sie Benachrichtigungen tatsächlich lesen. | Telegram und E-Mail |
| Berichte | Periodische Zusammenfassungen zur Aufgabe. | Aktivieren Sie, wenn Sie einen Überblick ohne manuelles Einloggen erhalten möchten. | Wöchentlicher Bericht |
Felder der HTTP-Prüfung
| Feld | Bedeutung | Was angeben | Beispiel |
|---|---|---|---|
| Methode | Welche HTTP-Anfrage gesendet wird. | Meist reicht GET. Andere Methoden sind nötig, wenn Ihr Endpoint diese erfordert. | GET |
| URL | Vollständige Adresse der Seite oder des Endpoints, der geprüft werden soll. | Geben Sie die vollständige URL mit Schema und Domain an. | https://example.com/health |
| Timeout | Wie lange auf eine Antwort warten, bis Fehler wegen Unerreichbarkeit. | Wählen Sie einen Wert etwas höher als die übliche Antwortzeit Ihres Services. | 30 Sekunden |
| Schlüsselwort | Zusätzliche Prüfung des Antwortinhalts. | Geben Sie den Text an, der in der Antwort vorhanden sein muss. | OK |
| Erweiterte Einstellungen | Öffnet zusätzliche HTTP-Felder. | Aktivieren Sie nur, wenn Sie Header, Anfragekörper oder eigene Erfolgs-Codes benötigen. | Aktiviert |
| Header | Zusätzliche HTTP-Header der Anfrage. | Fügen Sie nur die Header hinzu, die Ihr API wirklich benötigt. | Authorization: Bearer <token> Accept: application/json |
| Inhalt | Körper der HTTP-Anfrage für POST, PUT oder PATCH. | Füllen Sie aus, wenn der Endpoint JSON oder einen anderen Anfragekörper erwartet. | {"event":"healthcheck"} |
| Erfolgs-Codes | Welche HTTP-Codes als normales Ergebnis gelten. | Lassen Sie den Standardbereich oder legen Sie eigene Codes und Bereiche fest. | 200-299, 301 |
| Selbstsigniertes Zertifikat erlauben | Kein Fehler für ein Zertifikat, dem Browser nicht vertrauen. | Aktivieren Sie für interne Services über HTTPS mit eigenem Zertifikat. | Deaktiviert |
| Zulässige Prüfpunkte | Von welchen Punkten die Prüfung erfolgt. | Lassen Sie alle Punkte, wenn kein spezielles Szenario für Regionen oder Netzwerke benötigt. | Alle Prüfpunkte |
Wann kommt der Alarm
- Website oder Endpoint antwortet nicht rechtzeitig.
- Server gibt einen Code zurück, der nicht in der Erfolgsliste ist.
- In der Antwort fehlt der obligatorische Text, wenn Sie ein Schlüsselwort angegeben haben.
- Für eine HTTPS-Adresse kann keine sichere Verbindung hergestellt werden: Das Zertifikat ist abgelaufen, dem wird nicht vertraut oder es ist auf einen anderen Namen ausgestellt. Der Grund der Prüfung zeigt genau, was nicht stimmt.
Prüfen Sie einen internen Service? Wenn er über HTTPS mit selbstsigniertem Zertifikat läuft,
aktivieren Sie «Erweiterte Einstellungen» und markieren Sie «Selbstsigniertes Zertifikat erlauben» —
sonst schlägt die Prüfung aufgrund von Zertifikatsmisstrauen fehl, obwohl der Service selbst normal antwortet.
Benachrichtigungseinstellungen
Für jeden Benachrichtigungskanal in der Aufgabe können zusätzliche Parameter festgelegt werden. Sie gelten nur für DOWN-Ereignisse.
| Parameter | Was es tut |
|---|---|
| Aktiviert | Erlaubt oder verbietet das Senden von Benachrichtigungen über diesen Kanal für diese Aufgabe. |
| Verzögern um PRO | Verzögert die erste DOWN-Benachrichtigung um die gewählte Zeit (bis zu 12 Stunden). Praktisch, um keine Benachrichtigungen über kurzfristige Ausfälle zu erhalten. |
| Wiederholen alle PRO | Wiederholt die Benachrichtigung periodisch, solange die Aufgabe im Status DOWN bleibt (bis zu 1 Stunde zwischen den Wiederholungen). Geeignet, wenn es wichtig ist, einen langanhaltenden Ausfall nicht zu verpassen. |
Die Parameter „Verzögern" und „Wiederholen" haben keinen Einfluss auf UP-Ereignisse und Wiederherstellungsbenachrichtigungen.