Quelle: https://open5g.cs.hs-rm.de/de/api-docs

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.

[Monitoring-Snapshot (JSON)](https://open5g.cs.hs-rm.de/api/monitoring)[OpenAPI 3.1](https://open5g.cs.hs-rm.de/openapi.json)[API Catalog](https://open5g.cs.hs-rm.de/.well-known/api-catalog)

## 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](https://open5g.cs.hs-rm.de/de/live#reading-guide)