Um zu prüfen, ob ein vermuteter Ausfall mit Beobachtungen in einer bestimmten Region übereinstimmt, rufen Sie den Servicestatus und den Verlauf für ein ausgewähltes Zeitfenster ab. Gleichen Sie Region und Zeitstempel mit den Anwendungsprotokollen ab. Das Ergebnis beantwortet eine konkrete Frage: Ist in den gespeicherten Daten ein regionales Signal verzeichnet, und wie aktuell ist der betreffende Eintrag?
Die UptimeScout-Spezifikation beschreibt separate Methoden für Status und Verlauf. In der Statusantwort gibt das oberste Feld `status` das Ergebnis der API-Anfrage an; das Signal des Dienstes steht in `service.status`. Der Verlauf enthält aggregierte Zeitintervalle, die Auflösung und die Anzahl der Messungen. Diese Daten eignen sich für eine erste Diagnose und als Anlage zu einem Störungsbericht.
1. Dienst, Region und Lizenz vorbereiten
Das folgende Beispiel verwendet die Dienst-ID `github` und die Region `US`. Verwenden Sie für Ihre Prüfung eine gültige ID aus dem UptimeScout-Katalog und den Code der Region, in der das Problem beobachtet wurde. Die verfügbaren Regionen können je nach Dienst variieren; prüfen Sie vor der Interpretation `available_regions` in der Antwort.

Installieren Sie Python 3.10+ und das SDK gemäß der Projektanleitung. Hinterlegen Sie den Schlüssel in der Umgebungsvariable `UPTIMESCOUT_LICENSE_KEY` und nehmen Sie ihn weder in den Code noch in Protokolle auf. Das Beispiel stellt zwei Anfragen über den dokumentierten Client, hält die ursprünglichen JSON-Antworten im Speicher und gibt sie zur Prüfung aus. Es ist ein Integrationsbeispiel und kein Bericht über einen hier durchgeführten Test.
import json
import os
from uptimescout import Client, UptimeScoutError
client = Client(os.environ["UPTIMESCOUT_LICENSE_KEY"], timeout=30)
try:
status_data = client.status("github", region="US", lang="ru")
history_data = client.history("github", region="US", hours=24, lang="ru")
except UptimeScoutError as error:
raise SystemExit(f"API request failed: HTTP {error.status}")
print(json.dumps(
{"status": status_data, "history": history_data},
ensure_ascii=False,
indent=2,
))
Das offizielle UptimeScout-Python-SDK dokumentiert den Client, die Methoden `status` und `history` sowie die darunterliegende Bearer-Authentifizierung. Folgen Sie für Installation und Versionen den aktuellen Anweisungen im Repository; das gezeigte Beispiel setzt voraus, dass das SDK installiert ist.
2. Das Signal von einem Anfragestatus unterscheiden
Prüfen Sie in der Antwort die Felder `service.status`, `service.observed_at`, `service.stale` und die Antwortregion. Das oberste Feld `status` bezieht sich darauf, ob die API-Anfrage erfolgreich war, nicht auf die Verfügbarkeit des Dienstes selbst. Speichern Sie auch den Zeitpunkt der Anfrage, die Dienst-ID und die Regionsparameter, damit klar ist, auf welchen Eintrag sich das Ergebnis bezieht.
Ist die Beobachtung als aktuell gekennzeichnet und weist `service.status` auf eine Beeinträchtigung oder einen Ausfall hin, halten Sie dies als regionales Signal fest und vergleichen Sie es mit Ihren eigenen Protokollen, Verbindungsfehlern und Anwendungsprüfungen. Das Feld `stale` zeigt an, ob die gespeicherte Beobachtung das festgelegte Aktualitätsfenster überschritten hat. Ist sein Wert `true` oder fehlt das erforderliche Feld, kennzeichnen Sie die aktuelle Verfügbarkeit anhand dieser Antwort als unbekannt. Leiten Sie aus einem veralteten oder unvollständigen Eintrag keine Aussage über den gegenwärtigen Zustand ab.
UptimeScout beschreibt die Daten als gespeicherte regionale Signale: Sie dienen als Orientierung für die Diagnose, sind aber weder eine direkte Messung der Verfügbarkeit noch eine Bestätigung eines globalen Ausfalls. Formulieren Sie das Ergebnis daher präzise: „Für die Region wurde ein Signal dieses Typs mit dem angegebenen Zeitstempel gefunden.“ Der Abgleich mit Ihren eigenen Prüfungen zeigt, ob dieses externe Signal mit den Erfahrungen der Nutzer Ihrer Anwendung übereinstimmt.
3. Verlauf und Intervallauflösung abgleichen
Die Verlaufsmethode liefert zeitliche Aggregationen. Prüfen Sie in der Antwort `resolution_seconds`, `samples`, `counts` und `effective_start`; speichern Sie außerdem die tatsächlichen Zeitgrenzen der Intervalle. Die Dokumentation beschreibt eine Ausrichtung an UTC: Drei-Minuten-Intervalle für Zeitfenster bis zu einer Stunde, Fünf-Minuten-Intervalle bis zu drei Stunden, Stundenintervalle bis zu einem Tag und Tagesintervalle für längere Zeitfenster. Bei älteren gespeicherten Aggregaten kann eine gröbere angegebene Auflösung bestehen bleiben.

Wählen Sie das Zeitfenster daher passend zur Fragestellung. Verwenden Sie für einen kurzen Vorfall einen entsprechend kurzen Zeitraum und geben Sie die Auflösung neben dem Ergebnis an. Bei einem längeren Zeitraum sollten Sie darauf hinweisen, dass der Verlauf möglicherweise nach Tagen aggregiert ist: Aus einem Tageswert lässt sich keine minutengenaue Entwicklung rekonstruieren.
Fehlende Intervalle bedeuten unbekannte Daten, nicht den Nachweis eines normalen Betriebs. Halten Sie die Anzahl der Messungen und die Intervallgrenzen zusammen mit den aggregierten Werten fest. So lässt sich erkennen, wie vollständig der Verlauf den untersuchten Zeitraum abdeckt und auf welchen Daten die Schlussfolgerung beruht.
4. Einen überprüfbaren Störungseintrag erstellen
Für den Bericht genügt es, die ursprünglichen Antworten und normalisierten Felder zu speichern: Dienst, Region, Anfragezeit, `service.status`, `observed_at`, `stale`, ausgewähltes Verlaufsfenster, `resolution_seconds`, Anzahl der Messungen und `effective_start`. Lassen Sie fehlende Werte als fehlend stehen: Null und keine Daten haben unterschiedliche Bedeutungen.
Gleichen Sie diese Angaben anschließend mit internen Prüfungen für denselben Zeitraum ab: Antwortcodes, Verbindungsfehler, Hosting-Region und Zeitstempel. Wenn die Daten voneinander abweichen, halten Sie beide Seiten fest. Eine regionale UptimeScout-Beobachtung und eine Prüfung eines bestimmten Endpoints beziehen sich auf unterschiedliche Messpunkte. Eine Abweichung erfordert daher eine Untersuchung, statt dass man einfach das passendere Ergebnis auswählt.
Orientieren Sie sich bei API-Fehlern am HTTP-Code: Die Spezifikation führt ungültige Parameter, eine fehlende Lizenz, eine ungültige Lizenz, eine überschrittene Quote und eine vorübergehende Nichtverfügbarkeit auf. Beheben Sie die jeweilige Ursache. Ein Anfragefehler ist kein Status des geprüften Dienstes.
Was an den Bereitschaftsdienst weiterzugeben ist
Geben Sie in der kurzen Zusammenfassung Dienst, Region, Beobachtungszeitpunkt, Aktualität des Eintrags und Auflösung des Verlaufs an. Kennzeichnen Sie Intervalle ohne Daten gesondert als unbekannt und fügen Sie interne Protokolle für denselben Zeitraum bei. So erhält das Team ein überprüfbares regionales Signal, ohne den Status der API-Anfrage, UptimeScout-Beobachtungen und eigene Anwendungsmessungen miteinander zu vermischen.