Monitoring-Datenbank: Unterschied zwischen den Versionen

Aus Freifunk Franken
Wechseln zu:Navigation, Suche
(Die Seite wurde neu angelegt: „<div style="padding:1em 1em 0.5em 1em;background-color:#ffb400;"><b>in Arbeit...</b></div> Hinter dem Monitoring steht eine Datenbank, in der alle Router, der…“)
 
Keine Bearbeitungszusammenfassung
Zeile 7: Zeile 7:


{| class="wikitable"
{| class="wikitable"
! Reiter || Inhalt || Link
! Reiter || Inhalt || Doku
|-
|-
| [[#FFF Monitoring|FFF Monitoring]]
| [https://monitoring.freifunk-franken.de/ FFF-Monitoring]
| Änderungen der Monitoring-Software  
| Releases und Änderungen der Monitoring-Software  
| [https://monitoring.freifunk-franken.de/ 1]
| [[#FFF Monitoring|FFF-Monitoring]]
|-
|-
| [https://monitoring.freifunk-franken.de/ Home (gleich wie oben)]
| Releases und Änderungen der Monitoring-Software
| [[#Home|Home]]
| [[#Home|Home]]
| Änderungen der Monitoring-Software
| [https://monitoring.freifunk-franken.de/ wie 1]
|-
|-
| [https://monitoring.freifunk-franken.de/map Map] [https://wiki.freifunk-franken.de/w/Monitoring (Doku)]
| Monitoring-Karte
| [[#Map|Map]]
| [[#Map|Map]]
| Monitoring-Karte
| [https://monitoring.freifunk-franken.de/map 2] [https://wiki.freifunk-franken.de/w/Monitoring (Doku)]
|-
|-
| [https://monitoring.freifunk-franken.de/routers Routers]
| Liste aller FFF-Router
| [[#Routers|Routers]]  
| [[#Routers|Routers]]  
| 
| [https://monitoring.freifunk-franken.de/routers 3]
|-
|-
| [https://monitoring.freifunk-franken.de/users users]
| Liste aller FFF-Benuter (Router-Betreiber)
| [[#Users|Users]]  
| [[#Users|Users]]  
| 
| [https://monitoring.freifunk-franken.de/users 4]
|-
|-
| [[#Statistics|Statistics]]
| [https://monitoring.freifunk-franken.de/statistics Statistics]
| 
| statistische Daten und Diagramme zu FFF <br> Statistik:
| [https://monitoring.freifunk-franken.de/statistics 5]
* Liste der Hoods, Gateways, neue Router
* Diagramm Router-Status, Clients, Traffik;
* Tortendiagramm Router-FW, Router-Modell, Modell per Client
| [[#Users|Statistics]]  
|-
|-
| [https://monitoring.freifunk-franken.de/gateways GWs]
| Liste aller FFF-Gateways
| [[#GWs|GWs]]  
| [[#GWs|GWs]]  
| Gateways
| [https://monitoring.freifunk-franken.de/gateways 6]
|-
|-
| [[#API|API]]  
| [https://monitoring.freifunk-franken.de/apidoc API-Doku]
| Monitoring - API Guide  
| Monitoring - API Guide  
| [https://monitoring.freifunk-franken.de/apidoc (Doku)]
| [[#API|API]]
|-
|-
| [https://wiki.freifunk-franken.de/w/Hauptseite Wiki]
| Wiki von Freifunk-Franken
| [[#Freifunk Franken|Freifunk Franken]]  
| [[#Freifunk Franken|Freifunk Franken]]  
| Wiki von Freifunk-Franken
| [https://wiki.freifunk-franken.de/w/Hauptseite Wiki]
|-
|-
| [https://monitoring.freifunk-franken.de/login Login] / [https://monitoring.freifunk-franken.de/logout Logout]
| Anmeldung im Monitoring, Liste der eigenen Router
| [[#Login/-out|Login/-out]]  
| [[#Login/-out|Login/-out]]  
| Anmeldung im Monitoring, Liste der eigenen Router
| [https://monitoring.freifunk-franken.de/login Login]/[https://monitoring.freifunk-franken.de/logout Logout]
|}
|}


== [https://monitoring.freifunk-franken.de/ FFF Monitoring] ==
== FFF Monitoring ==
Änderungen der Monitoring-Software, chronologisch.
[https://monitoring.freifunk-franken.de/ FFF Monitoring]  
 
Releases und Änderungen der Monitoring-Software, chronologisch.
 
== Home ==
[https://monitoring.freifunk-franken.de/ Home]


== [https://monitoring.freifunk-franken.de/ Home] ==
Releases und Änderungen der Monitoring-Software, chronologisch. <br> (das Gleiche wie "FFF Monitoring")
Änderungen der Monitoring-Software, chronologisch.


== Map ==
== Map ==
Monitoring-Karte  
[https://wiki.freifunk-franken.de/w/Monitoring Monitoring-Karte]
[https://wiki.freifunk-franken.de/w/Monitoring 1]
 
Zeigt alle FF-Router und ihre Verbindungen auf der Karte. [https://wiki.freifunk-franken.de/w/Monitoring (Doku)]


== Routers ==
== Routers ==
Liste der Router. <br> Mit den Spalten: Router-Name (mit Link zur Monitoring-Seite des Routers, [https://wiki.freifunk-franken.de/w/Monitoringseite_eines_Knotens Doku]), Status, Hood, Firmware, Hardware-Typ, Erstelldatum, Uptime, Clients.
[https://monitoring.freifunk-franken.de/routers Routers] - Liste der Router.  
 
{|class="wikitable"
! Spalte || Bedeutung
|-
| Hostname || Routername (mit Link zur Monitoring-Seite des Routers, [https://wiki.freifunk-franken.de/w/Monitoringseite_eines_Knotens Doku])
|-
| Status || online: Monitoring funktioniert <br> orphaned: Monitoring seit ?? Tagen offline <br> offline: Momitoring seit ?? Tagen offline
|-
| Hood || Router ist dieser Hood zugeordnet
|-
| User || technisch zuständiger Betreuer des Routers
|-
| Hardware || Hardware-Typ des Routers
|-
| Created || erste Inbetriebnahe des Routers
|-
| Uptime || ??
|-
| Last contact || ??
|-
| Users || ??
|}


== Users ==
== Users ==
Liste aller Router-Betreiber. <br> Mit den Spalten: Nickname (mit Lind zur Benutzerseite und Liste der eigenen Router), E-Mail, Admin j/n,  Benutzer seit, Anzahl Router, Anzahl Clients.
[https://monitoring.freifunk-franken.de/users Users]
 
Liste aller Router-Betreiber.  
 
{|class="wikitable"
! Spalte || Bedeutung
|-
| Nickname || Routername (mit Link zur Benutzerseite und Liste der eigenen Router)
|-
| E-Mail || Mailadresse (vollständig, wenn man im Monitoring eingeloggt ist)
|-
| Admin j/n || ???
|-
| Created || ???
|-
| V2 || ???
|-
| Routers || Anzahl der Router, die der Benutzer technisch betreut
|-
| Clients || ???
|}


== Statistics ==
== Statistics ==
[https://monitoring.freifunk-franken.de/statistics Statistics]
=== Hoods (Liste) ===
{|class="wikitable"
! Spalte || Bedeutung
|-
| Hood|| Name der Hood (mit Link zu allen Routern der Hood)
|-
| G || ???
|-
| On || ???
|-
| Off || ???
|-
| Unk. || ???
|-
| Sum || ???
|-
| User || ???
|-
| Stat || ???
|}
=== Gateways (Liste) ===
{|class="wikitable"
! 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.
{|class="wikitable"
! 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 ??? Router.
=== Router Models per Client (Kreisdiagramm) ===
Verteilung der Hardwer-Typen auf ???




== GWs ==
== GWs ==
[https://monitoring.freifunk-franken.de/gateways GWs]
=== Liste aller Gateways ===
{|class="wikitable"
! Spalte || Bedeutung
|-
| Gateway || Routername
|-
| On || Monitoring des Routers in Betrieb <br> selected: ??? <br> others: ???
|-
| Off || Monitoring des Routers seit ?? Minuten nicht in Betrieb (selected / others)
|-
| Unkn. || ???
|-
| Sum || ???
|}
=== DHCP ranges ===
{|class="wikitable"
! Spalte || Bedeutung
|-
| Gateway || Routername
|-
| VPN || ???
|-
| batX || ???
|-
| Range || ???
|}
=== IPv4 List ===
{|class="wikitable"
! Spalte || Bedeutung
|-
| Gateway || Routername
|-
| VPN || ???
|-
| batX || ???
|-
| IPv6 ||
|-
| Stat ||
|}
=== IPv6 List ===
{|class="wikitable"
! Spalte || Bedeutung
|-
| Gateway || Routername
|-
| VPN || ???
|-
| batX || ???
|-
| IPv6 || ???
|-
| Stat || ???
|}




== API ==
== API ==
[https://monitoring.freifunk-franken.de/apidoc API (leider unvollständig)]


== Freifunk Franken ==
[https://wiki.freifunk-franken.de/w/hauptseite Freifunk Franken]


== 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. Auch direkte Google-Suche hilft.
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 ==
== Login/-out ==
Zeile 85: Zeile 277:
* eine Liste der eigenen Router, <br> mit den Spalten: Hostname (mit Link zur Monitoring-Seite des Routers, [https://wiki.freifunk-franken.de/w/Monitoringseite_eines_Knotens Doku]), <br> Status, Hood, Firmware, Hardware-Typ, Erstelldatum, Uptime, Clients.  
* eine Liste der eigenen Router, <br> mit den Spalten: Hostname (mit Link zur Monitoring-Seite des Routers, [https://wiki.freifunk-franken.de/w/Monitoringseite_eines_Knotens Doku]), <br> Status, Hood, Firmware, Hardware-Typ, Erstelldatum, Uptime, Clients.  
* die Mailadressen der Router-Betreiber ungekürzt.
* 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 ==
== Datenbank-Abfragen ==
Abfragen beginnen mit:
Abfragen beginnen mit:
<code> https://monitoring.freifunk-franken.de/ </code>
<code> https://monitoring.freifunk-franken.de/ </code>
gefolgt von einem Schlüsselwort und einem Ausdruck.
gefolgt von Listen-Name und dahinter "?q="
gefolgt von einem Schlüsselwort, einem Doppelpunkt und einem Wert:
<code><span style="background:yellow">  </span><span style="background:yellow"><listen-name></span>?q=<span style="background:yellow"><schlüsselwort></span>:<span style="background:yellow"><wert></span></code>
 
=== Listen-Namen ===
Es gibt folgende Listen-Namen, die in Datenbank-Abfragen direkt verwendet werden können:
 
{| class="wikitable"
! Listen-Name || Inhalt || Bemerkungen
|-
| routers || Router ||
|-
| users || Router-Betreiber ||
|-
| gateways || Gateways ||
|-
| .. ||  ||
|}


=== Identifikatoren für Router ===
=== Identifikatoren für Router ===
Zeile 111: Zeile 328:


=== Schlüsselwörter ===
=== Schlüsselwörter ===
<pre>
Folgende Keywords können genutzt werden, um mittels des Eingabefeldes zu filtern. Dabei ist [[wikipedia:de:Regulärer Ausdruck|REGEX]] aktiviert:
allowed_filters = (
'status',
'hood',
'nickname',
'hardware',
'firmware',
'mac',
'hostname',
'contact',
'community',
'neighbor',
'neighbour',
'gw',
'selected',
'bat',
'batselected',
)
</pre>


Alle der o.g. Keywords können genutzt werden, um mittels des Eingabefeldes zu filtern. Dabei ist [[wikipedia:de:Regulärer Ausdruck|REGEX]] aktiviert.
{| class="wikitable"
! 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 <br> neighbour ||  ||  ||
|-
| gw ||  ||  ||
|-
| selected ||  ||  ||
|-
| bat ||  ||  ||
|-
| batselected ||  ||  ||
|-
| .. ||  ||  ||
|}


=== Reguläre Ausdrücke ===
=== Reguläre Ausdrücke ===

Version vom 1. Oktober 2018, 13:49 Uhr

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 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

FFF Monitoring

Releases und Änderungen der Monitoring-Software, chronologisch.

Home

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.

Spalte Bedeutung
Hostname Routername (mit Link zur Monitoring-Seite des Routers, Doku)
Status online: Monitoring funktioniert
orphaned: Monitoring seit ?? Tagen offline
offline: Momitoring seit ?? Tagen offline
Hood Router ist dieser Hood zugeordnet
User technisch zuständiger Betreuer des Routers
Hardware Hardware-Typ des Routers
Created erste Inbetriebnahe des Routers
Uptime ??
Last contact ??
Users ??

Users

Users

Liste aller Router-Betreiber.

Spalte Bedeutung
Nickname Routername (mit Link zur Benutzerseite und Liste der eigenen Router)
E-Mail Mailadresse (vollständig, wenn man im Monitoring eingeloggt ist)
Admin j/n ???
Created ???
V2 ???
Routers Anzahl der Router, die der Benutzer technisch betreut
Clients ???

Statistics

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 ??? Router.

Router Models per Client (Kreisdiagramm)

Verteilung der Hardwer-Typen auf ???


GWs

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

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. 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)

Abgerufen von „https://wiki.freifunk-franken.de/mediawiki/index.php?title=Monitoring-Datenbank&oldid=12709“
Creative Commons „Namensnennung, Weitergabe unter gleichen Bedingungen“
Powered by MediaWiki