Monitoringseite eines Knotens: Unterschied zwischen den Versionen

Aus Freifunk Franken
Wechseln zu:Navigation, Suche
(→‎Monitoring-Karte: Verbindungen)
 
(78 dazwischenliegende Versionen von 4 Benutzern werden nicht angezeigt)
Zeile 1: Zeile 1:
[[Datei:Monitoring eines Knotens.jpg|thumb|Monitoring eines Knotens]]
[[Datei:Monitoring eines Knotens.jpg|thumb|Monitoring eines Knotens]]
Mit einem Klick auf einen Knoten in der [https://monitoring.freifunk-franken.de/map?mapcenter=49.45000,11.10000,10 Monitoring-Map] öffnet sich ein Popup mit dem Knotennamen. Mit einem Klick auf den Knotennamen öffnet sich die  
Mit einem Klick auf einen Knoten in der [https://monitoring.freifunk-franken.de/map?mapcenter=49.45000,11.10000,10 Monitoring-Map] öffnet sich ein Popup mit dem Knotennamen. Mit einem Klick auf den Knotennamen öffnet sich die  
Monitoringseite des Knotens, auf der verschiedenen Parameter angezeigt werden.
Monitoringseite des Knotens, auf der verschiedenen Parameter angezeigt werden.


Nicht alle Router-Modelle zeigen alle Parameter. Hier werden die wichtigsten beschrieben.
Nicht alle Router-Modelle zeigen alle Parameter. Hier werden die wichtigsten beschrieben.
: [https://monitoring.freifunk-franken.de/map?mapcenter=49.45000,11.10000,10 → zur '''Monitoring-Map'''] <br> [[Monitoring|→ zur Hilfeseite über die '''Monitoring-Map''']] <br> [[Monitoring-Datenbank|→ zur Hilfeseite über die '''Monitoring-Datenbank''']]


__TOC__
__TOC__
Zeile 11: Zeile 15:
Der Router-Name (Hostname) ist oben links fettgedruckt:
Der Router-Name (Hostname) ist oben links fettgedruckt:
  Router: <Hostname>
  Router: <Hostname>
bzw. für ein Gateway:
Gateway: <Hostname>
Unter dem Router-Namen wird ein Perma-Link angezeigt, der zur Verlinkung auf diesen Router verwendet werden sollte.


== Actions ==
== Actions ==
Zeile 18: Zeile 28:
! Aktion || Beschreibung
! Aktion || Beschreibung
|-
|-
| Delete ||  
| Report abusive/illegal content || Informiert den Administrator, wenn auf einer Seite rechtswidrige Inhalte vorkommen (z.&nbsp;B.: Router-Name oder Beschreibung enthält Volksverhetzung)
|-
| Delete Router || Router aus dem Monitoring löschen (dies löscht ''alle'' Daten zu diesem  Router); sendet der Router weiter Daten, wird er entsprechend wieder neu angelegt. Damit die Option verfügbar ist, muss man angemeldet sein und einen „eigenen“ Router aufrufen.
|-
| … || Weitere Optionen für Administratoren
|}
|}


Zeile 24: Zeile 38:
[[Datei:Monitoring eines Knotens - Karte.jpg|thumb|Kartenausschnitt]]
[[Datei:Monitoring eines Knotens - Karte.jpg|thumb|Kartenausschnitt]]


Oben links wir der Knoten und seine direkte Umgebung in einem Kartenausschnitt von OpenStreetMap gezeigt. Der ausgewählte Knoten ist blau. Benachbarte funktionierende Knoten sind grün, nicht funktionierende rot. Miteinander vernetzte Knoten sind mit einer Linie verbunden, grün für funktionierende Verbindungen, rot für fehlerhafte.
Oben links wir der Knoten und seine direkte Umgebung in einem Kartenausschnitt von OpenStreetMap gezeigt. Der ausgewählte Knoten ist blau. Weitere Knoten sind grün, falls online, und rot, falls offline. Miteinander vernetzte Knoten sind mit einer Linie verbunden, grün für gut funktionierende Verbindungen, rot für schlechte Verbindungen.
 
{|class="wikitable"
! Knoten || &nbsp; || Verbindung
|-
|
: <span style="background:blue">&nbsp; &nbsp;</span> – für Monitoring ausgewählt
: <span style="background:green">&nbsp; &nbsp;</span> – in Betrieb
: <span style="background:red">&nbsp; &nbsp;</span> – nicht in Betrieb
: <span style="background:silver">&nbsp; &nbsp;</span> – länger als zehn Tage offline
| &nbsp; ||
: <span style="background:lightgreen"><small>&nbsp; &nbsp; &nbsp; &nbsp;</small></span> – gut
: <span style="background:gold"><small>&nbsp; &nbsp; &nbsp; &nbsp;</small></span> – mittel
: <span style="background:red"><small>&nbsp; &nbsp; &nbsp; &nbsp;</small></span> – schlecht
: <span style="background:DodgerBlue"><small>&nbsp; &nbsp; &nbsp; &nbsp;</small></span> – Layer-3-Verbindung
|}


Mit dem Mausrad oder mit "+" und "-" kann man rein- und rauszoomen.
Mit dem Mausrad oder mit +und „−“ kann man rein- und rauszoomen.


Unten links ist ein Massstab, mit dem man Entfernungen schätzen kann.
Unten links ist ein Maßstab, mit dem man Entfernungen schätzen kann.


Mit einem Klick auf einen anderen Knoten öffnet sich ein Popup mit dem Namen des Knotens und seinen mit ihm verbundenen Nachbarknoten. Mit Klick auf den Knotennamen öffnet sich dessen Monitoring-Seite.  
Mit einem Klick auf einen anderen Knoten öffnet sich ein Popup mit dem Namen des Knotens und seinen mit ihm verbundenen Nachbarknoten. Mit Klick auf den Knotennamen öffnet sich dessen Monitoring-Seite.  
Zeile 40: Zeile 69:
! Parameter || Beschreibung
! Parameter || Beschreibung
|-
|-
| Hostname || Name des Routers <br>mit dem Link "WebUI" kann ...
| Hostname || Name des Routers<br>
mit dem Link „WebUI“ kann der Router direkt konfiguriert werden (wenn man im Freifunk-Netz ist)
|-
|-
| Status || <span style="background:lightgreen">&nbsp; online &nbsp;</span> <nowiki>|</nowiki> <span style="background:tomato">&nbsp; offline &nbsp;</span>, in Betrieb seit ... Tagen
| Status || <span style="background:lightgreen">&nbsp; online &nbsp;</span> <nowiki>|</nowiki> <span style="background:tomato">&nbsp; offline &nbsp;</span><nowiki>|</nowiki> <span style="background:orange">&nbsp; unknown &nbsp;</span><nowiki>|</nowiki> <span style="background:grey">&nbsp; orphaned &nbsp;</span>, nicht in Betrieb seit zehn Tagen
|-
|-
| Created || Datum und Uhrzeit der Inbetriebnahme
| Created || Datum und Uhrzeit der Inbetriebnahme
Zeile 48: Zeile 78:
| Last contact || Datum und Uhrzeit des letzten Kontaktes
| Last contact || Datum und Uhrzeit des letzten Kontaktes
|-
|-
| Position || Beschreibung der Position
| Description || Beschreibung
|-
|-
| Hood || Name der Hood, in der der Knoten liegt <br>Link zur Liste aller Knoten in dieser Hood.
| Position || Standort
|-
|-
| User || Zuständiger Freifunker <br>mit Link zu seiner Benutzerseite im Wiki
| Hood || Name der Hood, in der der Knoten liegt<br>
Link zur Liste aller Knoten in dieser Hood.
|-
| User || Zuständiger Freifunker mit Link zu seiner Benutzerseite im Wiki
|-
|-
| Hardware || genaue Bezeichnung des Routermodells und Versionsnummer
| Hardware || genaue Bezeichnung des Routermodells und Versionsnummer
|-
|-
| WAN uplink || Haken: Router ist an Internet angeschlossen <br>"x": Router ist nicht direkt am Internet
| WAN uplink || : Router ist an Internet angeschlossen<br>
: Router ist nicht direkt am Internet<br>
WireGuard-Verbindungen, welche auf dezentralen Gateways Anwendung finden, werden nicht als Uplink erkannt
|-
|-
| Clients || Zahl der aktuell am Router eingewählten Mobilgeräte
| Traffic control || ✓: Bitratenbegrenzung ist aktiviert<br>
✕: Bitratenbegrenzung ist deaktiviert<br>
zeigt die Begrenzung für den Upload und Download in kBit/s an, wenn gesetzt und aktiviert
|-
| Clients || Zahl der aktuell am Router eingewählten Geräte, aufgeschlüsselt nach Verbindungsart: Ethernet, WLAN mit 2,4 GHz und 5 GHz
|-
| Airtime || zeigt die Airtime für das 2,4-GHz- und 5-GHz-Band in Prozent an
|}
|}


Zeile 69: Zeile 110:
| Firmware || Versionsnummer der Firmware
| Firmware || Versionsnummer der Firmware
|-
|-
| Operating System ||  
| Operating System || Betriebssystem, das auf den Knoten läuft
|-
| Kernel || Linux-Kernelversion, die am Knoten läuft
|-
|-
| Kernel ||  
| Babel version || [[Babel]]-Version, die am Gateway läuft
|-
|-
| B.A.T.M.A.N. adv ||  
| B.A.T.M.A.N. adv || [[B.A.T.M.A.N.|batman-adv]]-Version, die am Knoten läuft
|-
|-
| Nodewatcher ||  
| Nodewatcher || Nodwatcher-Version, die am Knoten läuft
|}
|}


Zeile 82: Zeile 125:


Zeigt mit Datum und Uhrzeit folgende Ereignisse:
Zeigt mit Datum und Uhrzeit folgende Ereignisse:
: <span style="background:lightgreen">&nbsp; online &nbsp;</span>
: <span style="background:lightgreen">&nbsp; online &nbsp;</span> – Router in Betrieb (sendet Daten)
: <span style="background:tomato">&nbsp; offline &nbsp;</span>
: <span style="background:tomato">&nbsp; offline &nbsp;</span> – Router nicht in Betrieb (sendet keine Daten)
: <span style="background:lightblue">&nbsp; update &nbsp;</span> (neue Firmware)
: <span style="background:grey">&nbsp; hostname &nbsp;</span> – neuer Routername
: <span style="background:grey">&nbsp; hood &nbsp;</span> – Hoodwechsel
: <span style="background:DeepSkyBlue">&nbsp; update &nbsp;</span> – Änderung der Firmwareversion
: <span style="background:lightblue">&nbsp; reboot &nbsp;</span> – Neustart des Routers
: <span style="background:DeepSkyBlue">&nbsp; created &nbsp;</span> – neuer Knoten
: <span style="background:orange">&nbsp; unknown &nbsp;</span> – Ausnahmefehler aufgetreten, Koordinaten falsch
<div style="clear:both">
 
== Analyse von Ausfällen ==
=== Online/offline ===
Online/offline sagen lediglich etwas darüber aus, ob das Monitoring Daten erhält oder nicht. Ein Logeintrag „offline“ gefolgt von „online“ kann daher verschiedenes bedeuten:
* Ein reiner Uplink-Router hat die Verbindung zum Internet verloren (selbstverschuldet oder durch Ausfall des Haus-Internets)
* Ein per Mesh angebundener Router hat seine Mesh-Verbindung verloren
* Der Alfred-Dienst (zur Übertragung der Router-Daten) ist auf dem Router ausgefallen
* Die Hood ist offline → Ich kann mich nicht auf dem Router einloggen
* Die Hood ist online, aber der Alfred-Dienst (zur Übertragung der Router-Daten) ist in der Hood ausgefallen → Ich kann mich auf dem Router einloggen
* Das Monitoring ist ausgefallen (in der globalen Statistik nachsehen, ob eine Veränderung der globalen Online/Offline-Kurve in diesem Zeitraum sichtbar ist)
 
Damit ein Router „offline“ ist, muss das Monitoring für mehr als 15 Minuten keine Daten erhalten.
 
=== Reboot ===
Das „reboot“-Ereignis bedeutet:
* Der Router wurde vom Strom getrennt und wieder eingesteckt
* Der Router wurde per Befehl rebootet
 
Das Reboot-Ereignis kann, je nach Länge der Downtime, von Offline/Online-Ereignissen begleitet sein oder auch nicht.
 
Aber: Ist ''kein'' „reboot“ geloggt, dann wurde der Router auch nicht vom Strom getrennt oder anderweitig neu gestartet. Ein Offline/Online-Ereignis ohne Reboot enthält also eine andere Information als eines mit!
 
== Detailansicht einer Grafik ==
[[Datei:Monitoring - Zoombereich in Grafik.jpg|miniatur|Ausschnitt, Zoombereich]]
 
Mit gedrückter linker Maustaste kann man in einer Grafik im einen Bereich markieren. Dadurch bekommt man eine Ausschnitt im Zeitverlauf (reinzoomen).
<br> Bei Detailansicht erscheint links unten ein Schalter „Reset“. Damit kommt man wieder in die Übersicht.
<br> Je nach Art der Daten ist eine unterschiedliche Zahl von Tagen als Historie verfügbar.
 
Der Abstand der Messpunkte ist ca. 5 Minuten. <br> Ist die Zeitspanne lang, wird das von einem Skript interpoliert. Die Interpolation erfolgt so, dass die Extremwerte betont werden.
<div style="clear:both">
<div style="clear:both">


Zeile 90: Zeile 169:
[[Datei:Monitoring eines Knotens - Neighbours.jpg|thumb|verbundene Nachbarn]]
[[Datei:Monitoring eines Knotens - Neighbours.jpg|thumb|verbundene Nachbarn]]


???
== Neighbours-Anzeige ==
Hier werden alle Nachbarn des Knoten angezeigt. Für [[B.A.T.M.A.N.]] gilt, dass nur Nachbarknoten angezeigt werden, die B.A.T.M.A.N. auch aktiv verwendet und die nicht per VPN verbunden sind. Layer-3-Verbindungen werden in blau angezeigt.
 
Ist ein Router offline, werden hier die Nachbarn VOR dem Ausfall angezeigt!


{|class="wikitable"
{|class="wikitable"
Zeile 97: Zeile 179:
| Hostname || Name des verbundenen Knotens <br>Link zur Monitoringseite des Knotens
| Hostname || Name des verbundenen Knotens <br>Link zur Monitoringseite des Knotens
|-
|-
| MAC Address || MAC-Adresse des verbundenen Knotens
| MAC Address || MAC-Adresse des verbundenen Knotens (auf diesem Interface, nicht die auf dem Aufkleber)
|-
|-
| Quality || Qualität der Verbindung (1 = schlecht, 255 = gut) <br>die Qualität wird auch in verschiednenen Stufen der Ampelfarben angezeigt
| Quality || Qualität der Verbindung (1 = schlecht, 255 = gut) <br>die Qualität wird auch in verschiednenen Stufen der Ampelfarben angezeigt. Für [[Babel]] wurde eine blaue Farbe eingeführt.
|-
|-
| Interface ||  
| Interface ||  
{|
| eth0.3/eth0 || Der Nachbar ist per Kabel über die VLAN ID 3 verbunden
|-
| w2mesh/w5mesh || Der Nachbar ist über das 2,4-GHz/5-GHz-WLAN-Netzwerk verbunden.
|}
|}
|}


In der Grafik hat jeder Knoten eine eigene Farbe.
In der Grafik ist die Historie der Verbindungsqualität ersichtlich.
 
Hier werden auch Nachbarn angezeigt, die im Augenblick nicht verbunden sind, aber dies in der Vergangenheit waren.
 
Der Standardausschnitt zeigt die letzten 24 Stunden, durch Klicken auf „Load full stats“ können die letzten 30 Tage geladen werden (dauert bis zu 30 Sekunden).
 
 
<div style="clear:both">
<div style="clear:both">


== Network Interfaces ==
== Network Interfaces ==
[[Datei:Monitoring eines Knotens - Network.jpg|thumb|???]]
[[Datei:Monitoring eines Knotens - Network.jpg|thumb|Monitoring der Ein- und Ausgänge am Router]]


???
Interfaces sind die Ein- und Ausgänge am Router (die gelben und die blaue LAN-Buchsen). Diese sind unterhalb der Grafik aufgelistet. Neben der Bezeichnung (fett) des Interfaces steht die Funktion, die dieses Interface gerade erfüllt.  Namen wird die IP-Adresse angezeigt die auf dem Knoten an das Interface gebunden ist. Rechts daneben wird die MAC-Adresse des Interfaces angezeigt.
Wenn man auf einen Interface-Eintrag klickt, dann wird dieser blau hinterlegt, und oben werden die Daten als Grafik angezeigt.
 
Beachte, dass nicht jeder Router alle Interfaces hat. Dies ist von Modell zu Modell leicht unterschiedlich. Das Monitoring zeigt manche Interfaces auch erst an, wenn damit etwas verbunden wurde (z.&nbsp;B. die ethX.Y).
 
Das Monitoring besitzt eine Logik, die für die Interfaces die jeweilige Funktion direkt anzeigt. Klicke unten auf einen Interface-Eintrag, dann wird dieser blau hinterlegt, und oben werden die Daten als Grafik angezeigt. 
 
Standardmäßig wird br-client angezeigt.
 
Wenn Du beispielsweise den '''Traffic''' sehen willst, der über deinen Router geht, dann willst du sehen, was über „WAN“ geht. WAN ist bei den meisten Geräten „eth0.2“, bei einigen „eth0“ oder „eth1“. Klicke also unten z.&nbsp;B. auf eth0.2.


Bedeutung der Farben:
Bedeutung der Farben:
{|class="wikitable"
{|class="wikitable"
| <span style="background:tomato">&nbsp;  &nbsp;</span> || gesendet
| <span style="background:tomato">&nbsp;  &nbsp;</span> || tx || gesendet
|-
|-
| <span style="background:lightblue">&nbsp;  &nbsp;</span> || empfangen
| <span style="background:lightblue">&nbsp;  &nbsp;</span> || rx || empfangen
|}
|}
Die Datenraten sind in Bit pro Sekunde (b/s) angegeben (1&nbsp;kb/s = 1000&nbsp;b/s, 1&nbsp;Mb/s = 1000&nbsp;kb/s).
Zusätzliche Angaben bei Wireless-Interfaces:
{|class="wikitable"
| Mode || Betriebsmodus: AP, IBSS, managed, mesh, monitor&nbsp;…
|-
| Channel || Funkkanal: 1, 2, 3 … 13, (14), 36, 40, 44 … 165
|-
| SSID || ''Service Set Identifier'': franken.freifunk.net&nbsp;…
|-
| Tx-Power || Sendeleistung ohne Antennengewinn: … 18&nbsp;dBm&nbsp;…
|-
|}
=== br-client ===
[[Datei:Monitoring Network-Interfaces-1.png|miniatur | br-client]]
''Client Bridge'' – [https://de.wikipedia.org/wiki/Bridge_%28Netzwerk%29 Bridge] in der das bat0 sowie alle Clientinterfaces hängen, die mit [[B.A.T.M.A.N.]] kommunizieren sollen (z.&nbsp;B. w2ap, w5ap und eth0.1 falls vorhanden). Ehemals als br-mesh betitelt.
<div style="clear:both">
<div style="clear:both">
=== bat0 ===
''Batman Interface'' – Hier sieht man den Traffic der ins B.A.T.M.A.N. (= der große Switch) geschickt wird oder der aus dem B.A.T.M.A.N. herauskommt. Das wäre z.&nbsp;B. wenn ein Client auf w2ap connectet ist und Traffic über das B.A.T.M.A.N.-VPN zu einen Gateway transferiert (Traffic kommt über w2ap rein und wird dann ins bat0 reingesteckt, somit wird er hier angezeigt). Traffic der im B.A.T.M.A.N. bleibt, ist hier nicht zu sehen (z.&nbsp;B. wenn Traffic von w2mesh (= B.A.T.M.A.N.-WLAN) oder eth0.3 (B.A.T.M.A.N.-Kabel) ankommt und per fffVPN (= B.A.T.M.A.N.-VPN) weiter zu einen Gateway geht).
=== ethX.Y ===
''Switch'' – Dies ist je nach Routermodell ein wenig unterschiedlich grundsätzlich gilt aber (falls vorhanden):
==== ethX.1 ====
<span style="color:orange">''Clients via Ethernet''</span> – Dies ist das VLAN an welches die Kabel-Clientports angebunden sind, dort ist der komplette Traffic aller Clients die per Kabel angebunden sind zu sehen.
==== ethX.2 ====
<span style="color:blue">''WAN''</span> – Dies ist bei manchen Routern das VLAN des WAN-Ports. Hier sieht man den kompletten Traffic der über das WAN in das Internet geht. Bei manchen Routern ist WAN auch eth0, und dann ist eth1.1 Client und eth1.3 ist B.A.T.M.A.N..
==== ethX.3 ====
<span style="color:#29c329">''Mesh via Ethernet''</span> – Dies ist das VLAN in welches die kabelgebunden B.A.T.M.A.N.-Geräte hängen. Hier sieht man den Traffic der über B.A.T.M.A.N.-Kabel hereinkommt oder herausgeht.
==== Router mit nur einem Ethernetport ====
Bei Routern mit nur einen Ethernetport ist meist eth0 das, als was der Port konfiguriert wurde. Dort gibt es meist keine VLANs.
=== fffVPN ===
<span style="color:red">''Fastd VPN Tunnel''</span> – Dies ist das Interface für das [[VPN]]. Dort ist der komplette Traffic der innerhalb des VPN verschickt wird zu sehen.
=== vxlanX ===
Interface bei Verbindung mit VXLAN (Virtual Extensible LAN) zum Gateway. Wird in der künftigen Firmware unterstützt.
=== w2ap/w5ap ===
<span style="color:orange">''Clients @ 2.4 GHz''</span>/<span style="color:orange">''Clients @ 2.4 GHz''</span> – Dies ist das WLAN-Interface auf welches Clients per WLAN zugreifen. Dort ist der komplette WLAN Traffic für Clients zu sehen. w2ap ist das 2,4-GHz-Band, w5ap ist das 5-GHz-Band.
=== w2configap/w5configap ===
<span style="color:grey">''Config @ 2.4 GHz''</span>/<span style="color:grey">''Config @ 5 GHz''</span> – Dies ist das Interface, welches die Konfiguration enthält. w2configap ist das 2,4-GHz-Band, w5configap ist das 5-GHz-Band.
=== w2mesh/w5mesh ===
<span style="color:#29c329">''Mesh @ 2.4 GHz''</span>/<span style="color:#29c329">''Mesh @ 5 GHz''</span> – Dies ist das WLAN-AdHoc-Interface über welches die Router anschließend mit B.A.T.M.A.N. verbunden werden. Hier ist der komplette Traffic zu sehen welcher per B.A.T.M.A.N. über WLAN verschickt wird. w2mesh ist das 2,4-GHz-B.A.T.M.A.N., w5mesh ist das 5-GHz-B.A.T.M.A.N..
=== br-ethmesh ===
''Ethernet Mesh Bridge'' – Nur bei der Firmware von Adrian.
=== ''Sonstige'' ===
Sonstige Einträge können andere VPN-Interfaces (z.&nbsp;B. BIRD, GRE oder WireGuard) und private Interfaces sein.


== Clients ==
== Clients ==
[[Datei:Monitoring eines Knotens - Clients.jpg|thumb|Eingewählte Geräte]]
[[Datei:Monitoring eines Knotens - Clients.jpg|thumb|Eingewählte Geräte]]


Zeigt die Anzahl der eingewählten Mobilgeräte in den letzten 9 Tagen. <br>("halbe" Geräte gibt es nicht)
Zeigt die Anzahl der eingewählten Geräte in den letzten 30 Tagen.
„Halbe“ Geräte gibt es nicht.


Andere Zeiträume können folgendermassen analysiert werden: ...?
Mit neueren Firmware wird der Graph zusätzlich nach 2,4&nbsp;GHz, 5&nbsp;GHz und Ethernet aufgeschlüsselt.
 
Details können folgendermaßen analysiert werden:  
Mit gedrückter linker Maustaste waagrecht in der Grafik „ziehen“ zoomt auf einen Ausschnitt. Damit kann man auch den genauen Verlauf eines gewählten Ausschnitts betrachten.  
 
In der Zoom-Ansicht erscheint links unten ein Button „Reset“. Damit kommt man wieder in die 30-Tage-Übersicht.
 
Davor liegende Zeiträume können nicht betrachtet werden.


Der Verlauf der Tageszeit kann folgendermassen analysiert werden: ...?
<div style="clear:both">
<div style="clear:both">


Zeile 133: Zeile 300:
[[Datei:Monitoring eines Knotens - Average Load.jpg|thumb|durchschnittliche Last]]
[[Datei:Monitoring eines Knotens - Average Load.jpg|thumb|durchschnittliche Last]]


???
Dieser Graph zeigt die [https://de.wikipedia.org/wiki/Load durchschnittliche Last] des Betriebssystems des Knotens an. Die Last entspricht in etwa der Auslastung einer CPU (1.0 = 1 CPU voll ausgelastet, 2.0 = 2 CPUs voll ausgelastet, 0.5 = 1 CPU halb ausgelastet)
 
Wir verwenden z. Zt. das Mittel über die letzten 15 Minuten, das alle 5 Minuten ermittelt und übertragen wird (adsc9-Firmware verwendet das 5-Minuten-Mittel).
 
Durch das 15-Minuten-Mittel ist die Entwicklung relativ träge.
 
Wenn der Wert konstant auf einem sehr hohen Wert steht (&gt;= 0.5), ist oft ein interner Software-„Hänger“ die Ursache. Oft hilft dann ein Reboot (Router kurz ausschalten). In Einzelfällen musste ein Firmwareupgrade durchgeführt werden.<br>
Mit mit „[https://wiki.ubuntuusers.de/top/ top]“ oder „[https://wiki.ubuntuusers.de/ps/ ps -w]“ kann man die laufenden Prozesse anzeigen lassen, dann analysieren.
 
<div style="clear:both">
<div style="clear:both">
Beispiele:
<gallery>
Monitoring Average-Load-1.png | […]
</gallery>


== Memory ==
== Memory ==
[[Datei:Monitoring eines Knotens - Memory.jpg|thumb|???]]
[[Datei:Monitoring eines Knotens - Memory.jpg|thumb|[…]]]


???
Hier werden die Werte des Arbeitsspeichers (RAM) des Knoten angezeigt.


Bedeutung der Farben:
Bedeutung der Farben:
{|class="wikitable"
{|class="wikitable"
| <span style="background:lightgreen">&nbsp;  &nbsp;</span> || frei
| <span style="background:lightgreen">&nbsp;  &nbsp;</span> || free || frei
|-
|-
| <span style="background:yellow">&nbsp;  &nbsp;</span> || gecached
| <span style="background:gold">&nbsp;  &nbsp;</span> || caching || gecached
|-
|-
| <span style="background:lightblue">&nbsp;  &nbsp;</span> || gepuffert
| <span style="background:lightblue">&nbsp;  &nbsp;</span> || buffering || gepuffert
|}
|}
1&nbsp;MB = 1000&nbsp;kB, 1&nbsp;kB = 1000&nbsp;Bit ([[wikipedia:de:Bit|Wikipedia: Bit]])
<div style="clear:both">
<div style="clear:both">
Beispiele:
<gallery>
Monitoring eines Knotens - Memory-2.jpg | Cache größer als Frei: <br>[…]
Monitoring eines Knotens - Memory-6.jpg | Frei größer als Cache: <br>[…]
Monitoring eines Knotens - Memory-3.jpg | Wechselnd: <br>[…]
Monitoring Memory-1.png | […]
</gallery>


== Processes ==
== Processes ==
[[Datei:Monitoring eines Knotens - Process.jpg|thumb|???]]
[[Datei:Monitoring eines Knotens - Process.jpg|thumb|[…]]]


???
Anzahl der Prozesse auf den Knoten.


Bedeutung der Farben:
Bedeutung der Farben:
{|class="wikitable"
{|class="wikitable"
| <span style="background:tomato">&nbsp;  &nbsp;</span> || ???
| <span style="background:tomato">&nbsp;  &nbsp;</span> || running
|-
|-
| <span style="background:yellow">&nbsp;  &nbsp;</span> || Total
| <span style="background:gold">&nbsp;  &nbsp;</span> || total
|}
|}
<div style="clear:both">
<div style="clear:both">

Aktuelle Version vom 8. Februar 2022, 19:52 Uhr

Monitoring eines Knotens

Mit einem Klick auf einen Knoten in der Monitoring-Map öffnet sich ein Popup mit dem Knotennamen. Mit einem Klick auf den Knotennamen öffnet sich die Monitoringseite des Knotens, auf der verschiedenen Parameter angezeigt werden.

Nicht alle Router-Modelle zeigen alle Parameter. Hier werden die wichtigsten beschrieben.

→ zur Monitoring-Map
→ zur Hilfeseite über die Monitoring-Map
→ zur Hilfeseite über die Monitoring-Datenbank


Titel

Der Router-Name (Hostname) ist oben links fettgedruckt:

Router: <Hostname>

bzw. für ein Gateway:

Gateway: <Hostname>


Unter dem Router-Namen wird ein Perma-Link angezeigt, der zur Verlinkung auf diesen Router verwendet werden sollte.

Actions

Oben rechts können aus einem Dropdown-Feld verschiedene Aktionen für den Knoten ausgeführt werden.

Aktion Beschreibung
Report abusive/illegal content Informiert den Administrator, wenn auf einer Seite rechtswidrige Inhalte vorkommen (z. B.: Router-Name oder Beschreibung enthält Volksverhetzung)
Delete Router Router aus dem Monitoring löschen (dies löscht alle Daten zu diesem Router); sendet der Router weiter Daten, wird er entsprechend wieder neu angelegt. Damit die Option verfügbar ist, muss man angemeldet sein und einen „eigenen“ Router aufrufen.
Weitere Optionen für Administratoren

Kartenausschnitt

Kartenausschnitt

Oben links wir der Knoten und seine direkte Umgebung in einem Kartenausschnitt von OpenStreetMap gezeigt. Der ausgewählte Knoten ist blau. Weitere Knoten sind grün, falls online, und rot, falls offline. Miteinander vernetzte Knoten sind mit einer Linie verbunden, grün für gut funktionierende Verbindungen, rot für schlechte Verbindungen.

Knoten   Verbindung
    – für Monitoring ausgewählt
    – in Betrieb
    – nicht in Betrieb
    – länger als zehn Tage offline
 
        – gut
        – mittel
        – schlecht
        – Layer-3-Verbindung

Mit dem Mausrad oder mit „+“ und „−“ kann man rein- und rauszoomen.

Unten links ist ein Maßstab, mit dem man Entfernungen schätzen kann.

Mit einem Klick auf einen anderen Knoten öffnet sich ein Popup mit dem Namen des Knotens und seinen mit ihm verbundenen Nachbarknoten. Mit Klick auf den Knotennamen öffnet sich dessen Monitoring-Seite.

System

System

Neben dem Kartenausschnitt werden die aktuellen Systemdaten in einer Tabelle angezeigt:

Parameter Beschreibung
Hostname Name des Routers

mit dem Link „WebUI“ kann der Router direkt konfiguriert werden (wenn man im Freifunk-Netz ist)

Status   online   |   offline  |   unknown  |   orphaned  , nicht in Betrieb seit zehn Tagen
Created Datum und Uhrzeit der Inbetriebnahme
Last contact Datum und Uhrzeit des letzten Kontaktes
Description Beschreibung
Position Standort
Hood Name der Hood, in der der Knoten liegt

Link zur Liste aller Knoten in dieser Hood.

User Zuständiger Freifunker mit Link zu seiner Benutzerseite im Wiki
Hardware genaue Bezeichnung des Routermodells und Versionsnummer
WAN uplink ✓: Router ist an Internet angeschlossen

✕: Router ist nicht direkt am Internet
WireGuard-Verbindungen, welche auf dezentralen Gateways Anwendung finden, werden nicht als Uplink erkannt

Traffic control ✓: Bitratenbegrenzung ist aktiviert

✕: Bitratenbegrenzung ist deaktiviert
zeigt die Begrenzung für den Upload und Download in kBit/s an, wenn gesetzt und aktiviert

Clients Zahl der aktuell am Router eingewählten Geräte, aufgeschlüsselt nach Verbindungsart: Ethernet, WLAN mit 2,4 GHz und 5 GHz
Airtime zeigt die Airtime für das 2,4-GHz- und 5-GHz-Band in Prozent an

Software

Software/Firmware
Parameter Beschreibung
Firmware Versionsnummer der Firmware
Operating System Betriebssystem, das auf den Knoten läuft
Kernel Linux-Kernelversion, die am Knoten läuft
Babel version Babel-Version, die am Gateway läuft
B.A.T.M.A.N. adv batman-adv-Version, die am Knoten läuft
Nodewatcher Nodwatcher-Version, die am Knoten läuft

Events

Ereignisse

Zeigt mit Datum und Uhrzeit folgende Ereignisse:

  online   – Router in Betrieb (sendet Daten)
  offline   – Router nicht in Betrieb (sendet keine Daten)
  hostname   – neuer Routername
  hood   – Hoodwechsel
  update   – Änderung der Firmwareversion
  reboot   – Neustart des Routers
  created   – neuer Knoten
  unknown   – Ausnahmefehler aufgetreten, Koordinaten falsch

Analyse von Ausfällen

Online/offline

Online/offline sagen lediglich etwas darüber aus, ob das Monitoring Daten erhält oder nicht. Ein Logeintrag „offline“ gefolgt von „online“ kann daher verschiedenes bedeuten:

  • Ein reiner Uplink-Router hat die Verbindung zum Internet verloren (selbstverschuldet oder durch Ausfall des Haus-Internets)
  • Ein per Mesh angebundener Router hat seine Mesh-Verbindung verloren
  • Der Alfred-Dienst (zur Übertragung der Router-Daten) ist auf dem Router ausgefallen
  • Die Hood ist offline → Ich kann mich nicht auf dem Router einloggen
  • Die Hood ist online, aber der Alfred-Dienst (zur Übertragung der Router-Daten) ist in der Hood ausgefallen → Ich kann mich auf dem Router einloggen
  • Das Monitoring ist ausgefallen (in der globalen Statistik nachsehen, ob eine Veränderung der globalen Online/Offline-Kurve in diesem Zeitraum sichtbar ist)

Damit ein Router „offline“ ist, muss das Monitoring für mehr als 15 Minuten keine Daten erhalten.

Reboot

Das „reboot“-Ereignis bedeutet:

  • Der Router wurde vom Strom getrennt und wieder eingesteckt
  • Der Router wurde per Befehl rebootet

Das Reboot-Ereignis kann, je nach Länge der Downtime, von Offline/Online-Ereignissen begleitet sein oder auch nicht.

Aber: Ist kein „reboot“ geloggt, dann wurde der Router auch nicht vom Strom getrennt oder anderweitig neu gestartet. Ein Offline/Online-Ereignis ohne Reboot enthält also eine andere Information als eines mit!

Detailansicht einer Grafik

Ausschnitt, Zoombereich

Mit gedrückter linker Maustaste kann man in einer Grafik im einen Bereich markieren. Dadurch bekommt man eine Ausschnitt im Zeitverlauf (reinzoomen).
Bei Detailansicht erscheint links unten ein Schalter „Reset“. Damit kommt man wieder in die Übersicht.
Je nach Art der Daten ist eine unterschiedliche Zahl von Tagen als Historie verfügbar.

Der Abstand der Messpunkte ist ca. 5 Minuten.
Ist die Zeitspanne lang, wird das von einem Skript interpoliert. Die Interpolation erfolgt so, dass die Extremwerte betont werden.

Neighbours

verbundene Nachbarn

Neighbours-Anzeige

Hier werden alle Nachbarn des Knoten angezeigt. Für B.A.T.M.A.N. gilt, dass nur Nachbarknoten angezeigt werden, die B.A.T.M.A.N. auch aktiv verwendet und die nicht per VPN verbunden sind. Layer-3-Verbindungen werden in blau angezeigt.

Ist ein Router offline, werden hier die Nachbarn VOR dem Ausfall angezeigt!

Parameter Bedeutung
Hostname Name des verbundenen Knotens
Link zur Monitoringseite des Knotens
MAC Address MAC-Adresse des verbundenen Knotens (auf diesem Interface, nicht die auf dem Aufkleber)
Quality Qualität der Verbindung (1 = schlecht, 255 = gut)
die Qualität wird auch in verschiednenen Stufen der Ampelfarben angezeigt. Für Babel wurde eine blaue Farbe eingeführt.
Interface
eth0.3/eth0 Der Nachbar ist per Kabel über die VLAN ID 3 verbunden
w2mesh/w5mesh Der Nachbar ist über das 2,4-GHz/5-GHz-WLAN-Netzwerk verbunden.

In der Grafik ist die Historie der Verbindungsqualität ersichtlich.

Hier werden auch Nachbarn angezeigt, die im Augenblick nicht verbunden sind, aber dies in der Vergangenheit waren.

Der Standardausschnitt zeigt die letzten 24 Stunden, durch Klicken auf „Load full stats“ können die letzten 30 Tage geladen werden (dauert bis zu 30 Sekunden).


Network Interfaces

Monitoring der Ein- und Ausgänge am Router

Interfaces sind die Ein- und Ausgänge am Router (die gelben und die blaue LAN-Buchsen). Diese sind unterhalb der Grafik aufgelistet. Neben der Bezeichnung (fett) des Interfaces steht die Funktion, die dieses Interface gerade erfüllt. Namen wird die IP-Adresse angezeigt die auf dem Knoten an das Interface gebunden ist. Rechts daneben wird die MAC-Adresse des Interfaces angezeigt. Wenn man auf einen Interface-Eintrag klickt, dann wird dieser blau hinterlegt, und oben werden die Daten als Grafik angezeigt.

Beachte, dass nicht jeder Router alle Interfaces hat. Dies ist von Modell zu Modell leicht unterschiedlich. Das Monitoring zeigt manche Interfaces auch erst an, wenn damit etwas verbunden wurde (z. B. die ethX.Y).

Das Monitoring besitzt eine Logik, die für die Interfaces die jeweilige Funktion direkt anzeigt. Klicke unten auf einen Interface-Eintrag, dann wird dieser blau hinterlegt, und oben werden die Daten als Grafik angezeigt.

Standardmäßig wird br-client angezeigt.

Wenn Du beispielsweise den Traffic sehen willst, der über deinen Router geht, dann willst du sehen, was über „WAN“ geht. WAN ist bei den meisten Geräten „eth0.2“, bei einigen „eth0“ oder „eth1“. Klicke also unten z. B. auf eth0.2.

Bedeutung der Farben:

    tx gesendet
    rx empfangen

Die Datenraten sind in Bit pro Sekunde (b/s) angegeben (1 kb/s = 1000 b/s, 1 Mb/s = 1000 kb/s).

Zusätzliche Angaben bei Wireless-Interfaces:

Mode Betriebsmodus: AP, IBSS, managed, mesh, monitor …
Channel Funkkanal: 1, 2, 3 … 13, (14), 36, 40, 44 … 165
SSID Service Set Identifier: franken.freifunk.net …
Tx-Power Sendeleistung ohne Antennengewinn: … 18 dBm …

br-client

br-client

Client BridgeBridge in der das bat0 sowie alle Clientinterfaces hängen, die mit B.A.T.M.A.N. kommunizieren sollen (z. B. w2ap, w5ap und eth0.1 falls vorhanden). Ehemals als br-mesh betitelt.

bat0

Batman Interface – Hier sieht man den Traffic der ins B.A.T.M.A.N. (= der große Switch) geschickt wird oder der aus dem B.A.T.M.A.N. herauskommt. Das wäre z. B. wenn ein Client auf w2ap connectet ist und Traffic über das B.A.T.M.A.N.-VPN zu einen Gateway transferiert (Traffic kommt über w2ap rein und wird dann ins bat0 reingesteckt, somit wird er hier angezeigt). Traffic der im B.A.T.M.A.N. bleibt, ist hier nicht zu sehen (z. B. wenn Traffic von w2mesh (= B.A.T.M.A.N.-WLAN) oder eth0.3 (B.A.T.M.A.N.-Kabel) ankommt und per fffVPN (= B.A.T.M.A.N.-VPN) weiter zu einen Gateway geht).

ethX.Y

Switch – Dies ist je nach Routermodell ein wenig unterschiedlich grundsätzlich gilt aber (falls vorhanden):

ethX.1

Clients via Ethernet – Dies ist das VLAN an welches die Kabel-Clientports angebunden sind, dort ist der komplette Traffic aller Clients die per Kabel angebunden sind zu sehen.

ethX.2

WAN – Dies ist bei manchen Routern das VLAN des WAN-Ports. Hier sieht man den kompletten Traffic der über das WAN in das Internet geht. Bei manchen Routern ist WAN auch eth0, und dann ist eth1.1 Client und eth1.3 ist B.A.T.M.A.N..

ethX.3

Mesh via Ethernet – Dies ist das VLAN in welches die kabelgebunden B.A.T.M.A.N.-Geräte hängen. Hier sieht man den Traffic der über B.A.T.M.A.N.-Kabel hereinkommt oder herausgeht.

Router mit nur einem Ethernetport

Bei Routern mit nur einen Ethernetport ist meist eth0 das, als was der Port konfiguriert wurde. Dort gibt es meist keine VLANs.

fffVPN

Fastd VPN Tunnel – Dies ist das Interface für das VPN. Dort ist der komplette Traffic der innerhalb des VPN verschickt wird zu sehen.

vxlanX

Interface bei Verbindung mit VXLAN (Virtual Extensible LAN) zum Gateway. Wird in der künftigen Firmware unterstützt.

w2ap/w5ap

Clients @ 2.4 GHz/Clients @ 2.4 GHz – Dies ist das WLAN-Interface auf welches Clients per WLAN zugreifen. Dort ist der komplette WLAN Traffic für Clients zu sehen. w2ap ist das 2,4-GHz-Band, w5ap ist das 5-GHz-Band.

w2configap/w5configap

Config @ 2.4 GHz/Config @ 5 GHz – Dies ist das Interface, welches die Konfiguration enthält. w2configap ist das 2,4-GHz-Band, w5configap ist das 5-GHz-Band.

w2mesh/w5mesh

Mesh @ 2.4 GHz/Mesh @ 5 GHz – Dies ist das WLAN-AdHoc-Interface über welches die Router anschließend mit B.A.T.M.A.N. verbunden werden. Hier ist der komplette Traffic zu sehen welcher per B.A.T.M.A.N. über WLAN verschickt wird. w2mesh ist das 2,4-GHz-B.A.T.M.A.N., w5mesh ist das 5-GHz-B.A.T.M.A.N..

br-ethmesh

Ethernet Mesh Bridge – Nur bei der Firmware von Adrian.

Sonstige

Sonstige Einträge können andere VPN-Interfaces (z. B. BIRD, GRE oder WireGuard) und private Interfaces sein.

Clients

Eingewählte Geräte

Zeigt die Anzahl der eingewählten Geräte in den letzten 30 Tagen. „Halbe“ Geräte gibt es nicht.

Mit neueren Firmware wird der Graph zusätzlich nach 2,4 GHz, 5 GHz und Ethernet aufgeschlüsselt.

Details können folgendermaßen analysiert werden: Mit gedrückter linker Maustaste waagrecht in der Grafik „ziehen“ zoomt auf einen Ausschnitt. Damit kann man auch den genauen Verlauf eines gewählten Ausschnitts betrachten.

In der Zoom-Ansicht erscheint links unten ein Button „Reset“. Damit kommt man wieder in die 30-Tage-Übersicht.

Davor liegende Zeiträume können nicht betrachtet werden.

Average Load

durchschnittliche Last

Dieser Graph zeigt die durchschnittliche Last des Betriebssystems des Knotens an. Die Last entspricht in etwa der Auslastung einer CPU (1.0 = 1 CPU voll ausgelastet, 2.0 = 2 CPUs voll ausgelastet, 0.5 = 1 CPU halb ausgelastet)

Wir verwenden z. Zt. das Mittel über die letzten 15 Minuten, das alle 5 Minuten ermittelt und übertragen wird (adsc9-Firmware verwendet das 5-Minuten-Mittel).

Durch das 15-Minuten-Mittel ist die Entwicklung relativ träge.

Wenn der Wert konstant auf einem sehr hohen Wert steht (>= 0.5), ist oft ein interner Software-„Hänger“ die Ursache. Oft hilft dann ein Reboot (Router kurz ausschalten). In Einzelfällen musste ein Firmwareupgrade durchgeführt werden.
Mit mit „top“ oder „ps -w“ kann man die laufenden Prozesse anzeigen lassen, dann analysieren.

Beispiele:

Memory

[…]

Hier werden die Werte des Arbeitsspeichers (RAM) des Knoten angezeigt.

Bedeutung der Farben:

    free frei
    caching gecached
    buffering gepuffert

1 MB = 1000 kB, 1 kB = 1000 Bit (Wikipedia: Bit)

Beispiele:

Processes

[…]

Anzahl der Prozesse auf den Knoten.

Bedeutung der Farben:

    running
    total