API

Öffentliche Monitoring-API

Die aggregierten Netzbeobachtungen aus dem Live-Dashboard stehen auch als JSON bereit.

GET /api/monitoring

GET-Anfrage ohne Zugangsdaten oder Abfrageparameter. Höchstens alle 30 Sekunden abrufen. Der Endpunkt erlaubt keine Konfigurationsänderungen oder frei formulierten Monitoring-Abfragen.

Verfügbarkeit ist kein Gesundheitsnachweis

HTTP 200 mit status "ok" bedeutet, dass die Monitoring-Abfragen abgeschlossen wurden. Es bedeutet nicht, dass alle Dienste funktionieren oder der Funkstandort verbunden ist. HTTP 503 mit status "unavailable" bedeutet, dass die Monitoring-Quelle nicht abgefragt werden konnte oder nicht konfiguriert ist. Null steht für fehlende Daten und darf nicht als null Geräte oder als false interpretiert werden.

Zeit und Aktualität

checkedAt und sampleTime sind Unix-Zeitstempel in Millisekunden. current.time und history[].time sind Unix-Zeitstempel in Sekunden. checkedAt beschreibt den Abrufzeitpunkt und belegt nicht die Aktualität jeder Metrik. Die Historie enthält 288 Punkte im Abstand von fünf Minuten. current ist der letzte Historienpunkt; backhaulMode und backhaulState auf oberster Ebene verwenden ein separates 30-Sekunden-Fenster. Erfolgreiche Snapshots werden serverseitig 30 Sekunden zwischengespeichert, nicht verfügbare Snapshots 10 Sekunden.

Verkehr und Dienstzustände

uplinkBps und downlinkBps zeigen den aggregierten ogstun-Verkehr in Bit pro Sekunde, gemittelt über fünf Minuten. Es sind keine Durchsatzmessungen einzelner Endgeräte. uplinkBytesTotal und downlinkBytesTotal sind kumulative Byte-Zähler, die zurückgesetzt werden können; sie sind keine Tagessummen. vmUptimeSeconds ist die VM-Laufzeit in Sekunden. active meldet den systemd-Zustand eines Dienstes. core beschreibt die Erreichbarkeit der AMF-/SMF-Scrape-Ziele, gnb einen erfolgreichen gNB-Aufbau bei verfügbarer InfoAPI-Quelle.

Backhaul-Codes

backhaulMode: 0 = unbekannt, 1 = direktes Campus-Ethernet, 2 = OpenWrt/WireGuard. backhaulState: 0 = unbekannt, 1 = direkt mit N2 verbunden, 2 = WireGuard mit N2 verbunden, 3 = direkt mit N2 getrennt, 4 = WireGuard mit N2 getrennt. Null bedeutet keine Beobachtung. Diese Werte belegen keine Ende-zu-Ende-Erreichbarkeit einer Anwendung.

Umfang der öffentlichen Daten

Die Antwort enthält aggregierte Teilnehmer- und Sitzungszahlen, Netzverläufe, Namen und Zustände der Open5GS-Dienste sowie die VM-Laufzeit. Teilnehmeridentitäten, SIM-Geheimnisse, UE-Adressen, Verkehrsziele und Rohlogs werden nicht ausgegeben. Das OpenAPI-Dokument beschreibt sämtliche Antwortfelder.

Hinweise zur Interpretation im Dashboard