Speedtest
speedtest | |
---|---|
Zweck / Funktion | |
Testet die Internetgeschwindigkeit | |
Allgemein | |
Typ | Gerätemodul |
Details | |
Dokumentation | EN / DE |
Support (Forum) | Sonstiges |
Modulname | 32_speedtest.pm |
Ersteller | Andre / justme1968 (Forum / Wiki) |
Wichtig: sofern vorhanden, gilt im Zweifel immer die (englische) Beschreibung in der commandref! |
Speedtest ist ein Modul, mit dem in regelmäßigen Abständen die Internet-Geschwindigket (Download, Upload, Ping) gemessen werden kann. Dabei wird auf das externe Python-Script speedtest-cli zurückgegriffen.
Mit dem Stand vom 05.10.2020 kann alternativ auch das offizielle CLI Binary von ookla verwendet werden. Dies liefert in der Regel genauere Werte, vor allem bei höheren Bandbreiten.
Voraussetzungen
Für diese Anleitung ist notwendig:
- Debian-Derivat (Debian, Ubuntu, Raspbian, ...)
- Linux-Grundkenntnisse
- Paket- und Quellenverwaltung apt-get
- Python 2.4 - 3.4
- wget
Alle in diesen Kapitel genannten Befehle müssen auf der Kommandozeile abgesetzt werden.
Installation von speedtest-cli
Zuerst muss das speedtest-cli - Script heruntergeladen werden. Der folgende Befehl erledigt das mit Hilfe von wget und speichert die Datei im Verzeichnis /usr/local/bin:
sudo wget -O /usr/local/bin/speedtest-cli https://raw.githubusercontent.com/sivel/speedtest-cli/master/speedtest.py
Anschließend muss die Datei noch als "ausführbar" markiert werden:
sudo chmod +x /usr/local/bin/speedtest-cli
Ob alles funktioniert hat, kann man dann mit einem einfachen Aufruf überprüfen:
speedtest-cli --help
Weitere Installationsanleitungen sind auf der speedtest-cli - Webseite zu finden.
Alternativ CLI Binary von ookla: https://www.speedtest.net/apps/cli und setzen des ookla Attributs.
Falls damit der folgende Fehler im FHEM-Log angezeigt wird
2020.10.07 11:52:14.721 5: speedtest done what(): basic_string::_M_construct null not valid terminate called after throwing an instance of 'std::logic_error'
muss das FHEM-Start -Script angepasst werden. Beispiel in diesem Forenbeitrag.
Definition
Das Modul wird folgendermaßen definiert:
define <name> speedtest [interval] [server]
Optionen
<interval>
: Optional. Der Wert bestimmt, in welchen Zeitabständen ein Geschwindigkeitstest durchgeführt wird. Wird kein Intervall angegeben, wird der Standard-Wert (3600s) verwendet. Minimum sind 1800 Sekunden.<server>
: Optional. Hier kann die ID eines Speedtest-Servers eingetragen werden, gegen den die Geschwindigkeits-Tests gefahren werden. Ist kein Wert angegeben, wird der "nächstgelegene" Server verwendet.
speedtest-cli --list
bzw. speedtest-cli --list | grep Germany
angezeigt werden
Readings
ping
(ms)download
(MBit/s)upload
(MBit/s)
Set
statusRequest
: Startet einen manuellen Durchlauf des definierten Tests
Attribute
Bei der Definition des Moduls können folgende Attribute gesetzt werden:
path
: Hier kann das Verzeichnis des speedtest-cli-Scripts angegeben werden (z.B.: /usr/local/bin).checks-till-disable
: Über dieses Attribut lässt sich festlegen, wie häufig speedtest-cli ausgeführt werden soll, bevor der automatische Aufruf deaktiviert wird. Nach Ablauf des Zählers wird das Modul automatisch auf disable gesetzt. Bei jedem Durchlauf wird der Zähler um 1 reduziert.disable
: Ist dieses Attribut auf 1 gesetzt, ist die automatische Ausführung deaktiviert. Das manuelle Ausführen überset
ist trotzdem möglich.
Beispiel
Definition des Moduls
define MySpeedtest speedtest 1800 5255
attr MySpeedtest path /usr/local/bin
Logging in eine Datei
Das Speichern der Ergebnisse in ein Logfile erreicht man z.B. so:
define FileLog_MySpeedtest FileLog ./log/MySpeedtest-%Y%m.log MySpeedtest:.*
attr FileLog_MySpeedtest logtype text
Plot (FileLog)
Ein zugehörige SVG-Plot könnte wie folgt aussehen:
############################
# Display speedtest results
set terminal png transparent size <SIZE> crop
set output '<OUT>.png'
set xdata time
set timefmt "%Y-%m-%d_%H:%M:%S"
set xlabel " "
set title '<L1>'
set yrange [0:1]
set y2range [0:12]
set y3range [0:120]
set ylabel "Mbit/s"
set y2label "Mbit/s"
set y3label "ms"
#FileLog 4:speedtest.download\x3a::
#FileLog 4:speedtest.upload\x3a::
#FileLog 4:speedtest.ping\x3a::
plot
using 1:2 ls l0 axes x1y2 title 'download (Mbit/s)' with lines,
using 1:2 ls l1 axes x1y1 title 'upload (Mbit/s)' with lines,
using 1:2 ls l2 axes x1y3 title 'ping (ms)' with lines
Der Weblink dazu wird wie folgt definiert:
define wl_speedtest SVG FileLog_speedtest:speedtest3:CURRENT
Logging mit Hilfe von DbLog
Das Loggen in eine Datenbank erfolgt, wenn ein Reading explizit oder generell alle Readings bei der Definition von DbLog angegeben worden sind und bei der Definition des Moduls Speedtest die Readings nicht über DbLogExclude ausgeschlossen wurden.
Plot (DbLog)
Definition des Plots bei Verwendung von DbLog:
define wl_speedtest SVG myDbLog:speedtest:HISTORY
attr wl_speedtest label "DL $data{currval1} / UL $data{currval2} / ping $data{currval3}"
attr wl_speedtest plotfunction speedtest
Definition der Datei speedtest.gplots:
############################
# Display speedtest results
set terminal png transparent size <SIZE> crop
set output '<OUT>.png'
set xdata time
set timefmt "%Y-%m-%d_%H:%M:%S"
set xlabel " "
set title '<L1>'
set yrange [0:1]
set y2range [0:12]
set y3range [0:120]
set ylabel "Mbit/s"
set y2label "Mbit/s"
set y3label "ms"
#myDbLog <SPEC1>:download:::$val=~s/([\d.]*).*/$1/eg
#myDbLog <SPEC1>:upload:::$val=~s/([\d.]*).*/$1/eg
#myDbLog <SPEC1>:ping:::$val=~s/([\d.]*).*/$1/eg
plot
using 1:2 ls l0 axes x1y2 title 'download (Mbit/s)' with lines,
using 1:2 ls l1 axes x1y1 title 'upload (Mbit/s)' with lines,
using 1:2 ls l2 axes x1y3 title 'ping (ms)' with lines
Bekannte Probleme
- Für den Betrieb ist Python notwendig. Daher läuft das Script nicht ohne Weiteres auf einer FritzBox.
- Zwischenzeitlich wurde das Script umbenannt. Das Modul erwartet nach wie vor den ursprünglichen Namen. Daher ist wie oben beschrieben darauf zu achten, dass das abgelegte Script
speedtest-cli
heißt und notfalls dementsprechend umbenannt wird. - Das Modul bricht ggf. mit einer Perl-Fehlermeldung im FHEM-Log ab, obwohl das Script von der Konsole aus einwandfrei läuft. Dies tritt z.B. bei Verwendung von Rasbian mit installierten Python 2.7 und Python 3 auf. Zur Behebung muss im Script
speedtest-cli
die erste Zeile auf#!/usr/bin/env python3
geändert werden. - Auf manchen Systemen muss in aktuellen speedtest-cli Versionen die Zeile
'(%s; U; %s; en-us)' % (platform.system(), platform.architecture()[0]),
auskommentiert werden.
Troubleshooting
Im Folgenden sind ein paar Ansatzpunkte genannt, um beim Troubleshooting zu unterstützen:
- Das Script läuft auf der Kommandzeile problemlos, das Modul bringt aber Fehler:
- Script ist nicht ausführbar (
chmod +x speedtest-cli
) - Der FHEM-User (fhem) hat keine Berechtigung das Script auszuführen
- Script ist nicht ausführbar (
- SVG-Plot zeigt nichts an:
- Verweis auf Filelog oder DbLog falsch
- Falsches gplot-File angegeben
- Übergabe der Plotfunktion (bei DbLog) nicht korrekt
- Falsche Groß-/Kleinschreibung verwendet (case sensitive)
- Fehlermeldung isn't numeric in sprintf at ./FHEM/98_SVG.pm
- Dieses kommt grundsätzlich immer dann vor, wenn SVG versucht einen Wert einzulesen, der neben der Zahl auch die Einheit enthält. Dieses kann bei der Verwendung von DbLog vorkommen, weil DbLog nicht weiß, wie es Wert und Einheit trennen soll. Abhilfe schafft eine entsprechende Regular Expression, die nur den Zahlenwert liefert.
Weblinks
- Beschreibung des Scripts binarynature.blogspot.de
- speedtest-cli auf pypi.python.org
- speedtest-cli auf github.com
- Forumseintrag über die Entwicklung des Moduls Thema: Internetgeschwindigkeit überwachen
- Forumseintrag darüber, dass das Binary nicht auf der Fritzbox läuft Thema: Internetgeschwindigkeit - speedtest
- Forumseintrag über aus der Idee wird ein Modul Thema: Internetgeschwindigkeit überwachen
- Forumsbeitrag zum Einsatz unter Windows Thema: Speedtest für windows
Sonstiges
Besten Dank an wkarl, Puschel74, justme1968 für Idee, Modulerstellung/Pflege und Installationsanleitung.