SYSSTAT: Unterschied zwischen den Versionen
Justme (Diskussion | Beiträge) |
K (Link auf forum.fhem korrigiert) |
||
Zeile 1: | Zeile 1: | ||
Seit dem 06.02.2013 gibt es ein neues und offizielles FHEM-Modul namens '''sysstat'''. Es ermöglicht das Logging und die (grafische) Anzeige der Auslastung (load) ihres '''Linux'''-Systems, auf dem FHEM läuft. Daneben ermöglicht es auch die gleichen Auswertungsmöglichkeiten für die Belegung (in Bytes oder Prozent) einer von Ihnen anzugebenden Festplatten-Partition. Gleiches kann auch mit einem Remote-System durchgeführt werden (per SSH mittels Key). | |||
Seit dem 06.02.2013 gibt es ein neues und offizielles FHEM-Modul namens ''sysstat''. Es ermöglicht das Logging und die (grafische) Anzeige der Auslastung (load) ihres '''Linux'''-Systems, auf dem FHEM läuft. Daneben ermöglicht es auch die gleichen Auswertungsmöglichkeiten für die Belegung (in Bytes oder Prozent) einer von Ihnen anzugebenden Festplatten-Partition. Gleiches kann auch mit einem Remote-System durchgeführt werden (per SSH mittels Key). | |||
Mit der aktuellen Version lassen sich auch CPU Temperatur und Frequenz eines Raspberry Pi lokal und remote überwachen. | Mit der aktuellen Version lassen sich auch CPU Temperatur und Frequenz eines Raspberry Pi lokal und remote überwachen. | ||
Zeile 7: | Zeile 5: | ||
Weitere Informationen zum Modul und zur Syntax finden Sie in der [http://fhem.de/commandref.html#SYSSTAT commandref]. | Weitere Informationen zum Modul und zur Syntax finden Sie in der [http://fhem.de/commandref.html#SYSSTAT commandref]. | ||
= Beispiel = | == Beispiel == | ||
Die Definitionen und Eigenschaften (Attribute) müssen von Hand in der ''fhem.cfg''eingetragen werden, da hier der ''autocreate''-Mechanismus nicht greift (greifen kann). | Die Definitionen und Eigenschaften (Attribute) müssen von Hand in der ''fhem.cfg'' eingetragen werden, da hier der ''autocreate''-Mechanismus nicht greift (greifen kann). | ||
=== Definition === | |||
Aus der ''fhem.cfg'': | Aus der ''fhem.cfg'': | ||
Zeile 16: | Zeile 15: | ||
attr BBxM room <Ihr Raum> | attr BBxM room <Ihr Raum> | ||
attr BBxM showpercent 1</nowiki> | attr BBxM showpercent 1</nowiki> | ||
=== Anmerkungen === | |||
* Die Load-Daten werden alle 120 (Default-Wert: 60) '''Sekunden''' gelesen und es wird dabei die Partition ''/dev/mmcblk0p2'' alle 600 Sekunden überwacht. Die Belegung der Partition wird in Prozent angegeben. Wie die Partitionen auf ihrem Linux-System benannt sind erfahren Sie z.B. über den ''mount''-Befehl. | * Die Load-Daten werden alle 120 (Default-Wert: 60) '''Sekunden''' gelesen und es wird dabei die Partition ''/dev/mmcblk0p2'' alle 600 Sekunden überwacht. Die Belegung der Partition wird in Prozent angegeben. Wie die Partitionen auf ihrem Linux-System benannt sind erfahren Sie z.B. über den ''mount''-Befehl. | ||
Zeile 32: | Zeile 32: | ||
attr Stats_BBxM label "Systemlast von BBxM Min: $data{min1}, Max: $data{max1}, Aktuell: $data{currval1}" | attr Stats_BBxM label "Systemlast von BBxM Min: $data{min1}, Max: $data{max1}, Aktuell: $data{currval1}" | ||
attr Stats_BBxM room <Ihr Raum></nowiki> | attr Stats_BBxM room <Ihr Raum></nowiki> | ||
== Plot == | |||
Standard ist die Angabe von ''define Stats_BBxM weblink fileplot FileLog_BBxM:'''sysstat''':CURRENT''. Dadurch wird nur die Systemlast grafisch (Plot) dargestellt. Wenn Sie auch die Belegung einer Partition im Plot sehen wollen, können Sie folgende Datei (die Sie sich als ''mysysstat.gplot''unterhalb von ''<Ihr-FHEM-Verzeichnis>/www/gplot''speichern müssten, damit die o.a. Konfiguration greift) verwenden | |||
=== Definition === | |||
<nowiki>############################ | <nowiki>############################ | ||
# Display the sysload and diskusage values | # Display the sysload and diskusage values | ||
Zeile 52: | Zeile 54: | ||
plot "< awk '/load:/ {print $1, $4}' <IN>" using 1:2 ls l0 axes x1y1 title 'Load' with lines | plot "< awk '/load:/ {print $1, $4}' <IN>" using 1:2 ls l0 axes x1y1 title 'Load' with lines | ||
plot "< awk '//:/ {print $1, $4}' <IN>" using 1:2 ls l2fill axes x1y2 title 'Disk' with lines</nowiki> | plot "< awk '//:/ {print $1, $4}' <IN>" using 1:2 ls l2fill axes x1y2 title 'Disk' with lines</nowiki> | ||
=== Anmerkungen === | |||
* Die Zeile "#FileLog 4:/\x3a:0:" muss evtl. an ihre Gegebenheiten angepasst werden, wenn Sie nicht das root-Volume überwachen (wollen). | * Die Zeile "#FileLog 4:/\x3a:0:" muss evtl. an ihre Gegebenheiten angepasst werden, wenn Sie nicht das root-Volume überwachen (wollen). | ||
* Beachten Sie, dass die Sequenz "\x3a" der vorgenannten Zeile den Filter auf "/:" legt. Eine Angabe wie "#FileLog 4:/:''':'''0:" funktioniert nicht, da der Doppelpunkt eine besondere Bedeutung hat. Er muss also "maskiert" werden. Die ''awk''-Sequenz ("awk '//:/") ist für die Plot-Ausgabe nicht relevant. | * Beachten Sie, dass die Sequenz "\x3a" der vorgenannten Zeile den Filter auf "/:" legt. Eine Angabe wie "#FileLog 4:/:''':'''0:" funktioniert nicht, da der Doppelpunkt eine besondere Bedeutung hat. Er muss also "maskiert" werden. Die ''awk''-Sequenz ("awk '//:/") ist für die Plot-Ausgabe nicht relevant. | ||
* Regulär würde ein "#FileLog 4:/:0:" für die root-Partition ausreichen (was den Filter auf "/" legt), aber spätestens, wenn Sie ein 2. Volume (z.B. "/mount/usb") im Plot anzeigen wollen, trifft der Filter "/" auf beide Volumes zu. Dies führt dann zu eigenartigen Effekten im Plot. | * Regulär würde ein "#FileLog 4:/:0:" für die root-Partition ausreichen (was den Filter auf "/" legt), aber spätestens, wenn Sie ein 2. Volume (z.B. "/mount/usb") im Plot anzeigen wollen, trifft der Filter "/" auf beide Volumes zu. Dies führt dann zu eigenartigen Effekten im Plot. | ||
FHEM-Forum: [http://forum.fhem.de/index.php | == Links == | ||
* FHEM-Forum: [http://forum.fhem.de/index.php/topic,10573.0.html Inoffizielles Modul] | |||
* FHEM-Forum: [http://forum.fhem.de/index.php/topic,10888.0.html Ankündigung als offizielles Modul] | |||
[[Kategorie:Glossary]] | [[Kategorie:Glossary]] |
Version vom 20. Oktober 2013, 15:09 Uhr
Seit dem 06.02.2013 gibt es ein neues und offizielles FHEM-Modul namens sysstat. Es ermöglicht das Logging und die (grafische) Anzeige der Auslastung (load) ihres Linux-Systems, auf dem FHEM läuft. Daneben ermöglicht es auch die gleichen Auswertungsmöglichkeiten für die Belegung (in Bytes oder Prozent) einer von Ihnen anzugebenden Festplatten-Partition. Gleiches kann auch mit einem Remote-System durchgeführt werden (per SSH mittels Key).
Mit der aktuellen Version lassen sich auch CPU Temperatur und Frequenz eines Raspberry Pi lokal und remote überwachen.
Weitere Informationen zum Modul und zur Syntax finden Sie in der commandref.
Beispiel
Die Definitionen und Eigenschaften (Attribute) müssen von Hand in der fhem.cfg eingetragen werden, da hier der autocreate-Mechanismus nicht greift (greifen kann).
Definition
Aus der fhem.cfg:
define BBxM SYSSTAT 120 600 attr BBxM filesystems /dev/mmcblk0p2 attr BBxM room <Ihr Raum> attr BBxM showpercent 1
Anmerkungen
- Die Load-Daten werden alle 120 (Default-Wert: 60) Sekunden gelesen und es wird dabei die Partition /dev/mmcblk0p2 alle 600 Sekunden überwacht. Die Belegung der Partition wird in Prozent angegeben. Wie die Partitionen auf ihrem Linux-System benannt sind erfahren Sie z.B. über den mount-Befehl.
- Wird kein Auslese-Interval für die Partitionen angegeben, so wird dieses auf den ersten Wert mit 60 multipliziert gesetzt. So würde im o.a. Beispiel aus dem ersten Wert 120 (für das System-load) ein Auslesewert von 7.200 Sekunden, also 120 Minuten bzw. 2 Stunden.
Weitere Definitionen in der fhem.cfg:
define FileLog_BBxM FileLog /opt/fhem/log/BBxM-%Y-%m.log BBxM attr FileLog_BBxM archivedir /opt/fhem/archive/ attr FileLog_BBxM logtype sysstat:Plot,text attr FileLog_BBxM nrarchive 1 attr FileLog_BBxM room <Ihr Raum> define Stats_BBxM weblink fileplot FileLog_BBxM:mysysstat:CURRENT <<<==== siehe unten attr Stats_BBxM alias Systemlast attr Stats_BBxM label "Systemlast von BBxM Min: $data{min1}, Max: $data{max1}, Aktuell: $data{currval1}" attr Stats_BBxM room <Ihr Raum>
Plot
Standard ist die Angabe von define Stats_BBxM weblink fileplot FileLog_BBxM:sysstat:CURRENT. Dadurch wird nur die Systemlast grafisch (Plot) dargestellt. Wenn Sie auch die Belegung einer Partition im Plot sehen wollen, können Sie folgende Datei (die Sie sich als mysysstat.gplotunterhalb von <Ihr-FHEM-Verzeichnis>/www/gplotspeichern müssten, damit die o.a. Konfiguration greift) verwenden
Definition
############################ # Display the sysload and diskusage values # Corresponding FileLog definition: # define deviceLog FileLog ./log/device-%Y-%m.log device 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 ylabel "Load" set y2label "/ belegt %" set y2range [0:100] #FileLog 4:load:0: #FileLog 4:/\x3a:0: plot "< awk '/load:/ {print $1, $4}' <IN>" using 1:2 ls l0 axes x1y1 title 'Load' with lines plot "< awk '//:/ {print $1, $4}' <IN>" using 1:2 ls l2fill axes x1y2 title 'Disk' with lines
Anmerkungen
- Die Zeile "#FileLog 4:/\x3a:0:" muss evtl. an ihre Gegebenheiten angepasst werden, wenn Sie nicht das root-Volume überwachen (wollen).
- Beachten Sie, dass die Sequenz "\x3a" der vorgenannten Zeile den Filter auf "/:" legt. Eine Angabe wie "#FileLog 4:/::0:" funktioniert nicht, da der Doppelpunkt eine besondere Bedeutung hat. Er muss also "maskiert" werden. Die awk-Sequenz ("awk '//:/") ist für die Plot-Ausgabe nicht relevant.
- Regulär würde ein "#FileLog 4:/:0:" für die root-Partition ausreichen (was den Filter auf "/" legt), aber spätestens, wenn Sie ein 2. Volume (z.B. "/mount/usb") im Plot anzeigen wollen, trifft der Filter "/" auf beide Volumes zu. Dies führt dann zu eigenartigen Effekten im Plot.
Links
- FHEM-Forum: Inoffizielles Modul
- FHEM-Forum: Ankündigung als offizielles Modul