HTTP 200 ist ein Anfang
Eine API kann HTTP 200 liefern und im Inhalt trotzdem einen eingeschränkten Zustand melden. Auch ein vorgeschalteter Proxy kann erfolgreich antworten, während eine nachgelagerte Operation scheitert. API-Monitoring wird hilfreicher, wenn die Prüfung eine konkrete Erwartung an einen Endpunkt beschreibt. Ein erfolgreicher Status allein bestätigt nicht die gesamte Anwendung.
Die HTTP-Monitore von MetriBeacon unterstützen erwartete Statuscodes und bei GET-Anfragen Antworttext oder ein JSON-Feld auf oberster Ebene. Beginnen Sie mit einem kleinen Health-Endpunkt, der Ihnen gehört und dessen Aussage Sie kennen. Kundendaten und Geheimnisse gehören nicht in seine Antwort.
Die Aussage des Endpunkts festlegen
Ein einfacher Endpunkt bestätigt möglicherweise nur, dass der Anwendungsprozess antworten kann. Ein tieferer Check kann zusätzlich eine erforderliche Abhängigkeit prüfen. Beide Varianten sind sinnvoll, beantworten aber unterschiedliche Fragen. Vermeiden Sie eine aufwendige Prüfung, die für eine Zustandsmeldung jede Minute eine vollständige Transaktion wiederholt.
Eine kompakte Antwort könnte so aussehen:
{"status":"ok"}
Erwartetes HTTP 200 und der Wert ok im obersten Feld status ergeben eine eindeutige Prüfung. Verwenden Sie ein Feld, das Ihr Endpunkt tatsächlich liefert. Verschachtelte Objekte oder beliebige Anwendungsantworten passen nicht automatisch zum unterstützten Prüfverfahren.
Die passende HTTP-Methode wählen
| Prüfung | Methode | Aussage |
|---|---|---|
| Erwarteter Status | GET oder HEAD | Der Endpunkt liefert den erwarteten Code |
| Antworttext | GET | Die Antwort enthält den eingestellten Text |
| Oberstes JSON-Feld | GET | Ein eingestelltes Feld passt zum erwarteten Wert |
HEAD liefert keinen Antwortinhalt für eine Inhaltsprüfung. Für JSON und Text verwenden Sie GET und kontrollieren die Antwort des Endpunkts. Die HTTP-Monitor-Dokumentation beschreibt Konfiguration und unterstützte Ziele.
Einen Monitor Schritt für Schritt einrichten
- Öffnen Sie die Vorlage Website/API und wählen Sie einen Arbeitsbereich.
- Tragen Sie Ihren eigenen öffentlichen HTTP- oder HTTPS-Endpunkt ein und benennen Sie den Monitor verständlich.
- Stellen Sie den erwarteten Status und ein passendes Prüfintervall ein.
- Ergänzen Sie eine GET-Inhaltsprüfung, wenn Ihre API-Erwartung sie benötigt.
- Prüfen Sie die Vorschau, legen Sie den Monitor ausdrücklich an und warten Sie auf die erste Beobachtung.
- Untersuchen Sie eine normale Antwort und einen kontrollierten Fehler, bevor Sie sich auf Alarme verlassen.
Der Checker unterstützt öffentliche Ziele auf Port 80 und 443. Localhost und Ihr privates Netzwerk kann er nicht erreichen. Für private APIs erfassen Sie Beobachtungen innerhalb des Netzes und übermitteln passende Messwerte oder Ereignisse über die HTTPS-API.
Zugangsdaten schützen
Benötigt eine unterstützte Prüfung Zugangsdaten, verwenden Sie den vorgesehenen Mechanismus für geheime Header. Schreiben Sie keine Tokens in URL-Parameter, öffentliche Beispiele oder die Health-Antwort. Beschränken Sie die Berechtigung auf den Zweck und Zugriff, den die Prüfung wirklich braucht.
Prüfen Sie auch Weiterleitungen. Ein Check, der auf einer Anmeldeseite landet, beobachtet möglicherweise die falsche Ressource. Geheime Header werden nicht an eine andere Origin weitergereicht. Bevorzugen Sie eine stabile Health-URL, deren Antwort Sie direkt untersuchen können.
Fehler und unbekannte Ergebnisse getrennt lesen
Ein unerwarteter Status oder eine nicht passende Inhaltsprüfung ist eine negative Beobachtung Ihrer eingestellten Erwartung. Ein unbekanntes Ergebnis oder eine Kontingentpause bedeutet etwas anderes: Für diesen Zeitpunkt liegt keine gleichwertige Aussage über den Endpunkt vor.
Betrachten Sie Verfügbarkeit zusammen mit Abdeckung und Zeitraum. Regelmäßige Prüfungen erfassen einzelne Zeitpunkte; eine Unterbrechung dazwischen kann unbemerkt bleiben. Die Antwortzeit misst die überwachte HTTP-Anfrage und nicht die vollständige Lade- und Darstellungszeit der Anwendung im Browser.
Die Anleitung zum Website-Monitoring erklärt diese Unterschiede. Ergänzen Sie ein bestätigtes E-Mail- oder Telegram-Ziel, testen Sie die Zustellung und wählen Sie einen Alarm, der zur Bedeutung des Endpunkts passt.
Häufige Fragen
Prüft ein JSON-Check sämtliche API-Funktionen?
Nein. Er bewertet die konfigurierte Antwort und das ausgewählte Feld. Für andere Fehlerfälle benötigen Sie eigene aussagekräftige Endpunkte oder Beobachtungen.
Kann ich einen privaten Endpunkt direkt überwachen?
Der öffentliche Checker erreicht keine private Adresse. Verwenden Sie einen lokalen Datensammler und die Datenannahme-API mit geeigneten Zugangsdaten.
Ist das kürzeste Intervall immer am besten?
Wählen Sie nach erforderlicher Erkennungszeit und Aufwand des Endpunkts. Häufigere Anfragen erzeugen zusätzliche Last und verbrauchen Monitoring-Budget. Prüfen Sie die aktuellen Grenzen Ihres Kontos.
Mit einer klaren Erwartung beginnen
Verwenden Sie die Vorlage Website/API darunter für einen Endpunkt, halten Sie seine Aussage fest und testen Sie einen bekannten Fehler. Ergänzen Sie weitere Prüfungen, wenn sie eigene Erkenntnisse liefern statt denselben Status nur zu wiederholen.
