Monitoring-Datenbank

in Arbeit...

Hinter dem Monitoring steht eine Datenbank, in der alle Router, deren Betreiber, die Hoods, die Gateways, der Traffik und vieles mehr aufgezeichnet wird. Angezeigt wird das über die Seite Monitoring und die dort verfügbaren Reiter, sowie über Abfragen auf der Datenbnank.

Reiter

Auf der Monitoring-Seite findet man folgende Reiter:

Reiter	Inhalt	Link
FFF Monitoring	Änderungen der Monitoring-Software	1
Home	Änderungen der Monitoring-Software	wie 1
Map	Monitoring-Karte	2 (Doku)
Routers		3
Users		4
Statistics		5
GWs	Gateways	6
API	Monitoring - API Guide	(Doku)
Freifunk Franken	Wiki von Freifunk-Franken	Wiki
Login/-out	Anmeldung im Monitoring, Liste der eigenen Router	Login/Logout

FFF Monitoring

Änderungen der Monitoring-Software, chronologisch.

Home

Änderungen der Monitoring-Software, chronologisch.

Map

Monitoring-Karte 1

Routers

Liste der Router.
Mit den Spalten: Router-Name (mit Link zur Monitoring-Seite des Routers, Doku), Status, Hood, Firmware, Hardware-Typ, Erstelldatum, Uptime, Clients.

Users

Liste aller Router-Betreiber.
Mit den Spalten: Nickname (mit Lind zur Benutzerseite und Liste der eigenen Router), E-Mail, Admin j/n, Benutzer seit, Anzahl Router, Anzahl Clients.

Freifunk Franken

Direktlink zum Wiki von Freifunk-Franken. Mit über 300 Seiten mit Anleitungen, technischen Hintergründen, Organisatorisches, Community-Info, usw. Hilfreich ist die Volltextsuche im Wiki.

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.

Datenbank-Abfragen

Abfragen beginnen mit: https://monitoring.freifunk-franken.de/ gefolgt von einem Schlüsselwort und einem Ausdruck.

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

allowed_filters = (
	'status',
	'hood',
	'nickname',
	'hardware',
	'firmware',
	'mac',
	'hostname',
	'contact',
	'community',
	'neighbor',
	'neighbour',
	'gw',
	'selected',
	'bat',
	'batselected',
)

Alle der o.g. Keywords können genutzt werden, um mittels des Eingabefeldes zu filtern. Dabei ist REGEX aktiviert.

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)