Server Dokumentation: Unterschied zwischen den Versionen

Aus FreifunkNordheide
Wechseln zu:Navigation, Suche
(statistik.freifunk-nordheide.de)
 
Zeile 64: Zeile 64:
 
* Das Script liegt unter '''/opt/ffnh-stats/scripts/'''.  
 
* Das Script liegt unter '''/opt/ffnh-stats/scripts/'''.  
 
* Es läuft via <code>[https://manpages.debian.org/jessie/systemd/systemctl.1.en.html systemctl] status freifunk-collector@ffnh.service</code>.
 
* Es läuft via <code>[https://manpages.debian.org/jessie/systemd/systemctl.1.en.html systemctl] status freifunk-collector@ffnh.service</code>.
 +
 +
Dabei nutzt es die beiden JSONs:
 +
* graph_json = http://map.freifunk-nordheide.de/hopglass/graph.json
 +
* nodes_json = http://map.freifunk-nordheide.de/hopglass/mv1/nodes.json
  
 
=== InfluxDB ===
 
=== InfluxDB ===
Zeile 74: Zeile 78:
 
* die Statistik zu jedem [http://map.freifunk-nordheide.de/grafana/dashboard/db/knotenid?orgId=1 Knoten]
 
* die Statistik zu jedem [http://map.freifunk-nordheide.de/grafana/dashboard/db/knotenid?orgId=1 Knoten]
 
* die Statistik zu jeder [http://map.freifunk-nordheide.de/grafana/dashboard/db/verbindung?orgId=1 Verbindung]
 
* die Statistik zu jeder [http://map.freifunk-nordheide.de/grafana/dashboard/db/verbindung?orgId=1 Verbindung]
 +
 +
Einbindungen der Charts über PNG-Bilder anstatt der iFrames legen die Bilder lokal unter '''/srv/ff/grafana/lib/png/''' ab.
 +
 +
Das gesamte Grafana-Frontend wird, wie Hopglass via Apache Reverse Proxy unter /grafana/ auf map.freifunk-nordheide.de ausgeliefert.

Aktuelle Version vom 1. Januar 2018, 18:49 Uhr

Dokumentation

Auch Server brauch hin und wieder mal einen Klapps oder etwas Hilfe. Hier einfach mal ein paar Hilfestellungen

Github vom Freifunk Nordheide

Freifunk Nordheide Github Repo

Wiki nordheide.freifunk.net

SSL Certificate

Wir verwenden für nordheide.freifunk.net SSL-Certificates von Let's Encrypt. D.h. über die root crontab wird regelmässig geprüft ob das Certificate demnächst ausläuft und die Aktualisierung angefordert. Leider gibt es verschiedene Gründe warum das evtl. schief gehen kann.

Das Log liegt unter

/var/log/le-renew.log

Manuell kann man die evtl. anstehende Aktualisierung so anstoßen:

sudo /usr/local/sbin/le-renew nordheide.freifunk.net

map.freifunk-nordheide.net

Freifunkkarte

Karten-Backend Hopglass Server

Die Daten der Freifunkkonten werden mit einem Hopglass Server aggregiert dem Karten-Frontend (s.u.) zur Darstellung übergeben.

Der Server ist unter /opt/hopglass/server/ installiert und liefert via Apache Reverse Proxy und /hopglass/ aus. Das ermöglicht Komprimierung der JSON-Responses und die Nutzung eines SSL-Zertifikats. Seine Einstellungen und Daten liegen unter /etc/hopglass-server/ffnh/. Die Daten werden alle 5 Minuten zwischengespeichert und jede Stunde auf die letzten 7 Tage reduziert.

Achtung: das letzte Release ist sehr alt und läuft nicht richtig mit der aktuellen Knotenliste. Daher mit git clone https://github.com/hopglass/hopglass-server server (ohne Release) klonen.

Betrieben wird er über systemctl restart hopglass-server@ffnh.service.

Bereitgestellte URLs:

Karten-Frontend Hopglass

Die Hopglass-Karte unter map.freifunk-nordheide.de wird im Browser zusammengestellt und zeigt den aktuellen Zustand und Vernetzung der Knoten in Freifunk Nordheide. Sie nutzt eine wählbare Leaflet-Karte als Hintergrund und stellt darauf u.a. folgendes dar:

  • Freifunkknoten mit Geo-Koordinaten
  • Netzverbindung und Verbindungsqualität
  • Anzahl der Nutzer/Geräte am jeweiingen Knoten

Die Kartenanwendung ist unter /home/freifunker/hopglass/build installiert und die Einstellungen in der config.json abgelegt. Diese zeigt den Kartenbereich von mindestens 25Km rund um Buchholz und die neuen Knoten werden für einen Tag als grün gekennzeichnet.

Sie wird über den Apache ausgeliefert.

Nodelist

Die Kontenliste unter map.freifunk-nordheide.de/nodelist zeigt alle verfügbaren Knotendaten im Netz. Sie visualisiert die Daten (/nodes.json und /graph.json) aus obigem Hopglass-Server.

Die Karten-Anwendung ist unter /home/freifunker/nodelist installiert und wird über den Apache ausgeliefert.

statistik.freifunk-nordheide.de

Freifunk-Collector

Ein Ruby-Script bereitet die Knoten- und Graph-Daten aus dem Hopglass-Backend kontinuierlich auf und befüllt damit die InfluxDB.

  • Seine Einstellungen liegen unter /etc/freifunk-collector/ffnh/.
  • Das Script liegt unter /opt/ffnh-stats/scripts/.
  • Es läuft via systemctl status freifunk-collector@ffnh.service.

Dabei nutzt es die beiden JSONs:

InfluxDB

Die InfluxDB speichert zeitlich anfallende Statistik-Daten. Die genutzte Datenbank ist freifunk.

Grafana

Das Analyse-Werkzeug Grafana erlabut die Visualisierung und Analyse der Daten aus der InfluxDB. Eine Reihe von Dashboards wird vom Karten-Frontend Hopglass eingebunden (siehe config.json) und sind so leicht aus der Karte erreichbar. Dies sind:

  • das Status Dashboard, welches den Gesamtüberblick über Anzahl/Qualität von Clients und Verbindungen abbildet
  • die Statistik zu jedem Knoten
  • die Statistik zu jeder Verbindung

Einbindungen der Charts über PNG-Bilder anstatt der iFrames legen die Bilder lokal unter /srv/ff/grafana/lib/png/ ab.

Das gesamte Grafana-Frontend wird, wie Hopglass via Apache Reverse Proxy unter /grafana/ auf map.freifunk-nordheide.de ausgeliefert.