TTI-Gateway-Monitoring

TTI-Gateway-Monitoring ist ein Node-RED-Flow zur Abfrage von Gateway-Informationen und Verbindungsstatistiken aus The Things Industries beziehungsweise The Things Stack. Ziel ist eine zentrale Datengrundlage für die Beobachtung der LoRaWAN-Gateway-Infrastruktur.

Der Flow ruft zunächst die Gateway-Liste über die API ab. Für jedes Gateway mit einer gültigen Kennung werden anschließend die verfügbaren Verbindungsstatistiken abgefragt. Die Authentifizierung erfolgt über einen API-Schlüssel, der aus einer Umgebungsvariable geladen wird.

Erfolgreiche Antworten werden als NGSI-LD-Entities vom Typ LorawanGatewayStatus aufbereitet. Übernommen werden unter anderem Uplink- und Downlink-Zähler, Sendebestätigungen, Laufzeitstatistiken sowie gültige Zeitstempel der zuletzt gemeldeten Kommunikation. Gateway-EUI und Antennenposition werden ergänzt, sofern entsprechende Daten vorhanden sind.

Fehlgeschlagene Statistikabfragen werden in einer lokalen Liste im Node-RED-Flow-Kontext erfasst. Die Einträge enthalten Gateway-Kennung, Fehlerangaben und Erfassungszeitpunkte. Nach einer erfolgreichen erneuten Abfrage wird der zugehörige Eintrag entfernt. Veraltete Einträge werden bei der weiteren Nachrichtenverarbeitung anhand einer konfigurierten Gültigkeitsdauer bereinigt.

Die im Flow verwendete Bezeichnung offline kennzeichnet eine fehlgeschlagene API-Abfrage. Sie ist kein eindeutiger Nachweis eines tatsächlichen Gateway-Ausfalls. Ebenso wird bei einer erfolgreichen Antwort keine zusätzliche Prüfung des Alters der letzten Statusmeldung durchgeführt.

Für die Übertragung an den Stellio Context Broker ist eine HTTP-POST-Gruppe vorbereitet. Im vorliegenden Export ist diese noch nicht mit dem Ausgang der NGSI-LD-Aufbereitung verbunden. Die Daten werden zunächst über einen Debug-Node ausgegeben. Auch die Hauptabfrage wird manuell ausgelöst; eine regelmäßige Zeitsteuerung muss separat eingerichtet werden.

Für den Betrieb werden Node-RED, API-Zugang und geeignete Berechtigungen für Gateway-Liste und Verbindungsstatistiken benötigt. Für die optionale Stellio-Anbindung sind zusätzlich ein erreichbarer Broker, ein passender JSON-LD-Kontext und die erforderlichen Zugriffsrechte notwendig.

Eine eigene Benutzeroberfläche, automatische Benachrichtigungen, Zeitreihenspeicherung und Grafana-Dashboards sind nicht Bestandteil des veröffentlichten Flows.