Monitoring-Datenbank
Hinter dem Monitoring steht eine Datenbank, in der alle Router, deren Betreiber, die Hoods, die Gateways, der Traffic und vieles mehr aufgezeichnet wird. Angezeigt wird das über die Seite Monitoring und die dort verfügbaren Reiter, sowie über Abfragen auf der Datenbank.
Reiter
Auf der Monitoring-Seite findet man folgende Reiter:
Reiter | Inhalt | Doku |
---|---|---|
FFF-Monitoring | Releases und Änderungen der Monitoring-Software | FFF-Monitoring |
Home (gleich wie oben) | Releases und Änderungen der Monitoring-Software | Home |
Map (Doku) | Monitoring-Karte | Map |
Routers | Liste aller FFF-Router | Routers |
users | Liste aller FFF-Benuter (Router-Betreiber) | Users |
Statistics | statistische Daten und Diagramme zu FFF Statistik:
|
Statistics |
GWs | Liste aller FFF-Gateways | GWs |
API-Doku | Monitoring - API Guide | API |
Wiki | Wiki von Freifunk-Franken | Freifunk Franken |
Login / Logout | Anmeldung im Monitoring, Liste der eigenen Router | Login/-out |
FFF Monitoring
Releases und Änderungen der Monitoring-Software, chronologisch.
Home
Releases und Änderungen der Monitoring-Software, chronologisch.
(das Gleiche wie "FFF Monitoring")
Map
Zeigt alle FF-Router und ihre Verbindungen auf der Karte. (Doku)
Routers
Routers - Liste der Router.
siehe auch: Monitoringseite eines Knotens (Doku)
Spalte | Bedeutung |
---|---|
Hostname | Routername (mit Link zur Monitoring-Seite des Routers, Doku) |
Status | online: Monitoring funktioniert orphaned: Monitoring seit 7 Tagen offline offline: Monitoring seit 180 Tagen offline |
Hood | Router ist dieser Hood zugeordnet |
User | Technisch zuständiger Betreuer des Routers |
Hardware | Hardware-Typ des Routers |
Created | Erste Inbetriebnahme des Routers |
Uptime | Kumulierte Online-Zeit des Routers seit Inbetriebnahme |
Last contact | Datum und Uhrzeit des letzten Kontaktes zwischen Router und Monitoring |
User | Welchem Benutzer der Router zugeordnet ist (geht über die Emailadresse) |
WAN Uplink | Wenn dieser Router direkten Internetzugriff hat, ist hier ein Haken) |
Users
Liste aller Router-Betreiber.
Spalte | Bedeutung |
---|---|
Nickname | Routername (mit Link zur Benutzerseite und Liste der eigenen Router) |
Mailadresse (vollständig sichtbar, wenn man im Monitoring eingeloggt ist) | |
Admin j/n | ??? |
Created | Datum der Erstanmeldung dieses Users |
V2 | Anteil der V2 Router dieses Nutzers |
Routers | Anzahl der Router, die der Benutzer technisch betreut |
Clients | Anzahl der Clients, die aktuell mit seinen Routern verbunden sind |
Statistics
Hoods (Liste)
Spalte | Bedeutung |
---|---|
Hood | Name der Hood (mit Link zu allen Routern der Hood) |
G | ??? |
On | ??? |
Off | ??? |
Unk. | ??? |
Sum | ??? |
User | ??? |
Stat | ??? |
Gateways (Liste)
Spalte | Bedeutung |
---|---|
Gateway | Name des Gateway |
On | ??? |
Off | ??? |
Sum | ??? |
Stat | ??? |
Routers (Diagramm)
Verlauf über 12 Monate für:
- total: ???
- online: ???
- offline: ???
- unknown: ???
- orphaned: ???
Clients (Diagramm)
Verlauf über 12 Monate für:
- total: ???
Traffic (Diagramm)
Verlauf über 6 Monate für:
- sent to clients (Mb/s)
- received from clients (Mb/s)
Newest Routers (Liste)
Sortiert nach Datum.
Spalte | Bedeutung |
---|---|
Hostname | Name des Routers (mit Link zur Monitoring-Seite des Routers) |
Hood | Router ist dieser Hood zugeordnet |
Created | erste Inbetriebnahme des Routers |
Router Firmwares (Kreisdiagramm)
Verteilung der Firmware-Versionen auf ??? Router.
Router Models (Kreisdiagramm)
Verteilung der Hardware-Typen auf alle aktiven Router.
Typ | 2018-12 | 2019-xx | Bemerkungen |
---|---|---|---|
alle | 3.584 | ||
TL WR-841/741 | 60,3 % | % | |
TL WR-1043 | 24,8 % | % | |
Rest | 14,9 % | % | alle weiteren je unter 3% |
Router Models per Client (Kreisdiagramm)
Verteilung der Hardware-Typen auf ???
GWs
Liste aller Gateways
Spalte | Bedeutung |
---|---|
Gateway | Routername |
On | Monitoring des Routers in Betrieb selected: ??? others: ??? |
Off | Monitoring des Routers seit ?? Minuten nicht in Betrieb (selected / others) |
Unkn. | ??? |
Sum | ??? |
DHCP ranges
Spalte | Bedeutung |
---|---|
Gateway | Routername |
VPN | ??? |
batX | ??? |
Range | ??? |
IPv4 List
Spalte | Bedeutung |
---|---|
Gateway | Routername |
VPN | ??? |
batX | ??? |
IPv6 | |
Stat |
IPv6 List
Spalte | Bedeutung |
---|---|
Gateway | Routername |
VPN | ??? |
batX | ??? |
IPv6 | ??? |
Stat | ??? |
API
Freifunk Franken
Direktlink zum Wiki von Freifunk-Franken. Mit über 300 Seiten Anleitungen, technischen Hintergründen, Organisatorisches, Community-Info, usw. Hilfreich ist die Volltextsuche im Wiki. Auch direkte Google-Suche hilft.
Login/-out
Hier kann man einen Benutzer-Account für das Monitoring erstellen,
und sich dann damit An- und Abmelden.
Angemeldet sieht man:
- den eigenen Benutzernamen und kann die Benutzerdaten pflegen.
- eine Liste der eigenen Router,
mit den Spalten: Hostname (mit Link zur Monitoring-Seite des Routers, Doku),
Status, Hood, Firmware, Hardware-Typ, Erstelldatum, Uptime, Clients. - die Mailadressen der Router-Betreiber ungekürzt.
Suche in Listen
Ganz simpel ist die Volltextsuche in Listen mit <Strg-f>
Listen können auch alphabetisch anhand der Spalten-Einträge sortiert werden.
Listen können auch mit einer Abfrage gefiltert werden. Wie ???
Datenbank-Abfragen
Abfragen beginnen mit:
https://monitoring.freifunk-franken.de/
gefolgt von Listen-Name und dahinter "?q="
gefolgt von einem Schlüsselwort, einem Doppelpunkt und einem Wert:
<listen-name>?q=<schlüsselwort>:<wert>
Listen-Namen
Es gibt folgende Listen-Namen, die in Datenbank-Abfragen direkt verwendet werden können:
Listen-Name | Inhalt | Bemerkungen |
---|---|---|
routers | Router | |
users | Router-Betreiber | |
gateways | Gateways | |
.. |
Identifikatoren für Router
FFF-Router sind durch drei Daten definiert:
- MAC-Adresse
- wird vom Hersteller vergeben
ist je Modell eindeutig
Tatsächlich haben die meisten Router sogar mehrere eindeutige MAC-Adressen (siehe Interfaces auf der Routerdetailseite im Monitoring). Die Firmware ist so gestaltet, dass für br-mesh (und damit auch die MAC im Monitoring-Link) die Adresse gewählt wird, die auf dem Router drauf steht. https://monitoring.freifunk-franken.de/mac/<MAC>
- Seriennummer
- wird vom Hersteller vergeben
ist je Modell eindeutig
wird im Monitoring nicht übertragen
- Router-ID
- ist ein AUTO_INCREMENT Key in der MySQL-Tabelle des Monitoring
ist aussagefrei, wenn man den Router löscht, kriegt er beim nächsten Mal vom Monitoring einfach die nächste freie Nummer zugewiesen. https://monitoring.freifunk-franken.de/routers/<router-id>
Nur die MAC-Adresse eignet sich als Permalink. Alle anderen Router-Nummern sind dafür nicht geeignet. (im alten Monitoring gab es noch eine Art unique ID, da fliegen auch noch diverse Links im Monitoring rum ...)
- Hostname/Routername
- wird vom Routeraufsteller im Konfigurations-Menü vergeben
kann mehrfach vergeben werden und ist nicht eindeutig.
Schlüsselwörter
Folgende Keywords können genutzt werden, um mittels des Eingabefeldes zu filtern. Dabei ist REGEX aktiviert:
Schlüsselwort | Wirkung | Wertebereich | Beispiel |
---|---|---|---|
status | |||
hood | sucht in einer Hood | Hood-Namen | schnaittach |
nickname | sucht einen Benutzer | Benutzernamen | r.funkt |
hardware | sucht einen Hardware-Typ | Typ-Bezeichnung | 841 |
firmware | sucht eine Firmware-Version | FW-Versionsnummer | 20180802 |
mac | sucht nach einer MAC-Adresse | MAC-Adressen | 002719CC7606 |
hostname | sucht nach einem Hostnamen oder Routernamen | Hostnamen | Little-Empire |
contact | sucht Routerbetreiber nach Mailadresse | eMail-Adresse | aaa.bbb@ccc.xxx |
community | |||
neighbor neighbour |
|||
gw | |||
selected | |||
bat | |||
batselected | |||
.. |
Reguläre Ausdrücke
- Beispiel
mac:0002
sucht alle Router mit "0002" in der MAC-Adresse.
mac:02$
sucht alle Router mit "02" am Ende ($) der MAC-Adresse.
contact:mail@test.com
sucht nach Mailadressen.
Alle Optionen lassen sich mit "!" verneinen:
mac:!02$
Alle Router, deren MAC-Adressen nicht auf "02" endet.
Optionen können kombiniert werden (mit UND-Verknüpfung), indem die Optionen hintereinander durch Leerzeichen getrennt genannt werden:
hood:LaufV1 mac:!^02
Alle Router in der Hood LaufV1, deren MAC-Adresse nicht (!) mit "02" beginnt (^).
Da das selten benutzt wird, ist aber bestimmt mindestens eine der Optionen kaputt.