FfsNodeAlarm

Der NodeAlarm ist ein Tool welches kontinuierlich überprüft ob Freifunk Stuttgart Nodes (auch allgemeinsprachlich Router genannt) online sind und alarmiert über E-Mail, sollte der Router offline bzw wieder online gehen.

Für die Nutzung muss ein Account mit einer gültigen E-Mail Adresse angelegt werden. An diese E-Mails werden dann auch die entsprechend eingestellten Alarme gesendet.

Nach der Registrierung oder Login kann im Menü über Monitoring tasks die Tasks angezeigt werden:

Ein Task besteht aus einem Node und einem Intervall. Der Nodealarm prüft dann in dem definierten Intervall den Status des jeweiligen Nodes. Ein Intervall sollte mindestens 10 Minuten betragen, da die Informationen der Nodes jede 5 Minuten aggregiert werden.

Der NodeAlarm greift auf die Datenbasis von http://netinfo.freifunk-stuttgart.de/json/nodes.json zurück und gleicht diese jede 5 Minuten ab. Mit dieser Abtastrate macht es somit keinen Sinn, ein Task mit einem Intervall unter 10 Minuten zu definieren.

URL: https://nodealarm.freifunk-stuttgart.de

Code: https://github.com/Philhil/FfsNodeAlarm

Server: VM on ffs11

API Der Nodealarm besitzt eine mini API. Hierüber lässt sich der Status auf Smartwatches, Hausautomatisierung etc. anzeigen.

Die API ist über die URL https://nodealarm.freifunk-stuttgart.de/api/ erreichbar und ist über HTTP Get nutzbar. Das Output-Format ist immer JSON.

Folgende routen sind über ein HTTP GET nutzbar:

• {mac} Alle Informationen des Nodes.
• {mac}/clientcount Anzahl der Clients/Nutzer des jeweiligen Nodes.
• {mac}/isonline Online Status des Nodes.