HTTP-Inhalts-Check-Referenz

Alle Parameter, Schwellenwerte und Konfigurationsoptionen für den HTTP-Inhalts-Check in octoja.

Der HTTP-Inhalts-Check überwacht Web-Endpunkte auf erwartete Statuscodes, Antwortinhalt und Antwortzeit.

Konfigurationsfelder

Feld	Typ	Erforderlich	Standard	Beschreibung
Zu überwachende Endpunkte	Liste	Ja	—	Ein oder mehrere zu überwachende Endpunkte
— URL	String	Ja	—	HTTP(S)-Endpunkt-URL
— HTTP-Methode	String	Nein	GET	HTTP-Methode. Eine von: GET, POST, HEAD. Bei HEAD wird der Antwortkörper nicht gelesen: Erwarteter Inhalts-Teilstring und Verbotener Inhalts-Teilstring werden nicht ausgewertet, Inhalt und Verboten stehen im Ergebnis auf N/V, und Größe meldet 0 B
— Benutzerdefinierte Header	Schlüssel-Wert	Nein	—	Benutzerdefinierte HTTP-Header
— Anfrage-Body	String	Nein	—	Anfragekörper. Wird nur gesendet, wenn die Methode POST ist
— Erwarteter Statuscode	Ganzzahl	Nein	200	HTTP-Statuscode, der Erfolg anzeigt
— Erwarteter Inhalts-Teilstring	String	Nein	—	Text, der im Antwortkörper vorkommen muss
— Verbotener Inhalts-Teilstring	String	Nein	—	Text, der NICHT im Antwortkörper vorkommen darf
— Warnung Antwortzeit (ms)	ms	Nein	5000	Antwortzeit, die eine Warnung auslöst
— Kritische Antwortzeit (ms)	ms	Nein	15000	Antwortzeit, die ein kritisches Ergebnis auslöst
Timeout (ms)	ms	Nein	30000	Anfrage-Timeout in Millisekunden (gültiger Bereich: 1000–120000)

Der HTTP-Inhalts-Check läuft alle 10 Minuten. Das Intervall gehört zum Check selbst und nicht zu einer einzelnen Zuweisung; die Check-Bibliothek zeigt es in der Spalte Intervall.

Der Check läuft auf dem Gerät, dem er zugewiesen ist — die Check-Bibliothek zeigt dafür Läuft auf dem Gerät. Die Anfragen gehen von diesem Gerät aus, jede URL in der Liste muss also von dort erreichbar sein. Genau das erlaubt dir, einen internen Endpunkt zu überwachen, der nicht im Internet veröffentlicht ist. Weise den Check einem Gerät mit octoja-Agent zu.

Erfasste Metriken

Jede Metrik wird pro Endpunkt erfasst; ein Check über mehrere URLs zeigt also einen Block je URL.

HTTP-Statuscode
Antwortzeit (ms)
Antwortgröße (Bytes)
Inhaltsübereinstimmung (gefunden / nicht gefunden)
Verbotener Inhalt (nicht erkannt / erkannt)

Die Inhaltsübereinstimmung wird nur erfasst, wenn Erwarteter Inhalts-Teilstring ausgefüllt ist, und Verbotener Inhalt nur, wenn Verbotener Inhalts-Teilstring ausgefüllt ist. Solange das jeweilige Feld leer ist, steht der Wert auf N/V.

Plattformunterstützung

Plattform	Unterstützt
Windows	Ja
Linux	Ja
macOS	Ja

Hinweise

Ein abweichender Statuscode, fehlender erwarteter Inhalt, vorhandener verbotener Inhalt oder ein Anfragefehler führen jeweils zu einem kritischen Ergebnis. Nur eine Antwortzeit zwischen Warn- und kritischem Schwellenwert führt zu einer Warnung.
Die Endpunkte werden parallel abgefragt, und das Timeout gilt für jede Anfrage einzeln. Der Check meldet das schlechteste Ergebnis seiner Endpunkte — eine einzige fehlschlagende URL macht damit den gesamten Check kritisch.
Weiterleitungen werden automatisch verfolgt (bis zu 5); der erwartete Statuscode wird mit der finalen Antwort nach den Weiterleitungen verglichen.
Die Inhaltsübereinstimmung ist Groß-/Kleinschreibung-sensitiv. Verwende exakte Zeichenketten, die im Antwortkörper vorkommen.
Wenn sowohl erwarteter als auch verbotener Inhalt konfiguriert sind, ist der Check nur dann erfolgreich, wenn der erwartete Text vorhanden UND der verbotene Text nicht vorhanden ist.
Für Endpunkte, die Authentifizierung erfordern, füge die Anmeldedaten in die benutzerdefinierten Header ein (z. B. Authorization: Bearer <token>).
Ein Check mit leerer Endpunkt-Liste liefert eine Warnung, und die Detailansicht zeigt „Keine Endpunkte überwacht.“
Dieser Check verifiziert keine SSL-Zertifikate. Für die Überwachung des SSL-Zertifikatsablaufs verwende den SSL/HTTP-Check.

Siehe auch: Einen HTTP-Inhalts-Check konfigurieren