Monitoring-Datenbank

in Arbeit...

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: Liste der Hoods, Gateways, neue Router Diagramm Router-Status, Clients, Traffik; Tortendiagramm Router-FW, Router-Modell, Modell per Client	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

Monitoring-Karte

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)
E-Mail	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

API (leider unvollständig)

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.

Doku

API-Doku (leider unvollständig)