# UptimeScout incidents lesen: Ein Ausfallsignal ist noch kein bestätigter Vorfall

https://jsonscraper.com/de/blog/uptimescout-vorfallsignale-pruefen-und-einordnen

Author: Michael Johnson

Published: 2026-11-22T11:34:21+00:00

Updated: 2026-11-22T11:34:21+00:00

Der Endpunkt hilft dabei, aktuelle regionale Signale herauszufiltern; Ursache und Bestätigung müssen gesondert geprüft werden

**Lässt sich anhand einer Antwort von UptimeScout incidents sofort feststellen, dass ein Dienst ausgefallen ist?** Nein: Dieser Endpunkt listet Dienste mit kürzlich erhöhten Störungssignalen auf. Die Spezifikation weist ausdrücklich darauf hin, dass es sich nicht um bestätigte Vorfälle des Anbieters handelt. Das praktische Ergebnis ist eine kurze Liste von Signalen, die geprüft werden sollten – keine fertige Schlussfolgerung zur Ausfallursache.



![Artikel: UptimeScout incidents lesen: Ein Ausfallsignal ist noch kein bestätigter Vorfall
Zusammenfassung: Die UptimeScout-API kann eine Liste von Diensten mit erhöhten Störungssignalen zurückgeben. Hier erfahren Sie, wie Sie die Liste abrufen und die Aktualität der Daten prüfen, ohne ein Beobachtungssignal als offizielle Ausfallmeldung darzustellen.
Bildrolle: Titelbild – die zentrale Idee
Abschnitt: 
Visuelles Motiv: Redaktionelle Fotoillustration: eine gedruckte Karte der Vereinigten Staaten mit einer kleinen Gruppe roter und bernsteinfarbener Beobachtungsmarkierungen über einer Region](https://jsonscraper.com/assets/uploads/journal/2026/11/399257d5705aef451896bd5da1238f90.png.hero.webp)

Regionale Signale müssen abgeglichen werden© jsonscraper · KI-generiert

 

Diese Unterscheidung ist für Bereitschaftsingenieure und Analysten wichtig: Eine automatische Benachrichtigung kann melden: „Dienst X in Region Y prüfen“, während die Bestätigung des Sachverhalts und die Erklärung der Ursache dem offiziellen Status des Anbieters oder der eigenen Diagnose vorbehalten bleiben. Die [UptimeScout-Spezifikation](https://uptimescout.com/openapi.json) dokumentiert separate Routen für Signale, den aktuellen Status und den Beobachtungsverlauf.

 

## Was die Signalliste genau zurückgibt

 

`/v1/incidents` ist ein GET-Endpunkt für den Katalog von Diensten mit erhöhten Störungssignalen. Zu den Parametern gehören Filter nach Dienst, Region, Kategorie, Suchbegriff und Zeitfenster. Für die Antwort ist eine Lizenz erforderlich; die API beschreibt die Authentifizierung per Bearer-Token. Das Feld für die Region akzeptiert einen zweibuchstabigen Code, und `hours` legt ein Zeitfenster von 1 bis 2160 Stunden fest.

 

Das Wort „incident“ im Pfad lässt sich leicht als „bestätigter Ausfall“ verstehen, doch die Dokumentation definiert es enger: als aktuelles Beobachtungssignal. Formulieren Sie eine Benachrichtigung deshalb entsprechend den Antwortdaten, etwa „Es wurde ein Signal für eine Verfügbarkeitsstörung empfangen“, und unterstellen Sie dem Dienstanbieter nicht, einen Vorfall bestätigt zu haben.

 

## Mindestprüfungen vor einer Benachrichtigung

 

Speichern Sie zunächst die unveränderte Antwort samt Empfangszeitpunkt und Anfrageparametern. Prüfen Sie anschließend, welcher Dienst und welche Region zurückgegeben wurden, und bewerten Sie die Aktualität anhand der Dienstfelder `observed_at` und `stale`. Ist eine Beobachtung als veraltet markiert, sollten Sie sie von einem aktuellen Signal unterscheiden und nicht als Zustand „genau jetzt“ anzeigen.

 

```
curl -sS 'https://api.uptimescout.com/v1/incidents?region=US&hours=24' \
  -H "Authorization: Bearer $UPTIMESCOUT_LICENSE_KEY"
```

 

Dies ist eine Beispielanfrage für die USA mit einem Zeitfenster von 24 Stunden; der Schlüssel wird aus einer Umgebungsvariablen gelesen und nicht in der Befehlszeile ausgegeben. Prüfen Sie nach der Antwort auf HTTP-Fehler und die JSON-Struktur und verarbeiten Sie anschließend jeden zurückgegebenen Dienst einzeln. Die Schemas enthalten die Statuswerte `operational`, `degraded`, `outage` und `unknown`; fehlt ein Feld oder Wert, sollten Sie keine eigene Interpretation einsetzen.

 

Rufen Sie bei einem Signal, das Maßnahmen erfordert, über `/v1/status` den aktuellen Status des betreffenden Dienstes und über `/v1/history` dessen Verlauf ab. Im Verlauf sollten Sie neben den Datenreihen auch `resolution_seconds`, `samples`, `counts` und `effective_start` speichern: So ist ersichtlich, mit welcher zeitlichen Auflösung die Daten erfasst wurden und für welchen tatsächlichen Zeitraum sie verfügbar sind. Die Spezifikation weist darauf hin, dass fehlende Intervalle unbekannt sind; eine Datenlücke darf nicht automatisch als Verfügbarkeit oder Ausfall gewertet werden.

 

## Aus der Antwort einen überprüfbaren Bericht machen

 

Führen Sie für jeden Eintrag folgende Felder: Dienst-ID und -name, angefragte Region, Status, Beobachtungszeitpunkt, Kennzeichnung als veraltet, Zeitpunkt des Antwortempfangs sowie – sofern das Team den offiziellen Status geprüft hat – einen Link zur entsprechenden Quelle. Dieses letzte Feld wird von Ihrer Integration oder einer zuständigen Person ergänzt: Die UptimeScout-Spezifikation verspricht weder eine bestätigte Ursache noch eine Erklärung des Anbieters im Signal.



![Artikel: UptimeScout incidents lesen: Ein Ausfallsignal ist noch kein bestätigter Vorfall
Zusammenfassung: Die UptimeScout-API kann eine Liste von Diensten mit erhöhten Störungssignalen zurückgeben. Hier erfahren Sie, wie Sie die Liste abrufen und die Aktualität der Daten prüfen, ohne ein Beobachtungssignal als offizielle Ausfallmeldung darzustellen.
Bildrolle: ergänzende Illustration 2 – ein anderer konkreter Aspekt
Abschnitt: Aus der Antwort einen überprüfbaren Bericht machen
Visuelles Motiv: Redaktionelle Infografik auf Russisch mit einer einfachen dreistufigen Abfolge](https://jsonscraper.com/assets/uploads/journal/2026/11/985141e25ed6bf354030f6e87e5e10fc.png.hero.webp)

Vom Signal zur überprüften Schlussfolgerung© jsonscraper · KI-generierte Illustration

 

Gliedern Sie den Arbeitsablauf in drei Zustände. „Signal empfangen“ bedeutet, dass ein Eintrag im Ergebnis von `/v1/incidents` enthalten ist. „Status wird abgeglichen“ bedeutet, dass Sie den aktuellen Zustand und den Verlauf abgerufen haben. „Bestätigt“ sollte einer Schlussfolgerung vorbehalten bleiben, die durch eine externe offizielle Mitteilung oder eine interne Prüfung belegt ist. Diese einfache Trennung verhindert, dass ein Dashboard ein aggregiertes Signal als feststehende Tatsache ausgibt.

 

Wenn Ihr Team Berichte für mehrere Regionen erstellt, senden Sie für die gewünschten Regionscodes separate Anfragen und speichern Sie den Parameter zusammen mit dem Ergebnis. Das Feld `lang` bezieht sich auf die Sprache der Dienstbeschreibungen; es ändert nicht die Beobachtungsregion. Diese Unterscheidung ist wichtig, wenn beispielsweise ein lokalisierter Katalog mit dem regionalen Status verglichen wird.

 

## Wo die Aussagekraft endet

 

Das überprüfbare Ergebnis dieses Ablaufs ist ein Protokoll der Signale mit eindeutigen Angaben zu Zeit, Region und Aktualität, ergänzt durch einen separaten Abgleich von Status und Verlauf. Damit lässt sich erkennen, was Aufmerksamkeit erfordert und was sich anhand der ausgewählten Quellen bestätigen ließ. Die Antwort von `/v1/incidents` meldet ein erhöhtes Beobachtungssignal; für die Meldung eines bestätigten Ausfalls sind Belege erforderlich.
