SYSSTAT

Aus FHEMWiki

FHEM-Modul sysstat

Vorbemerkungen

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

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.cfgeingetragen werden, da hier der autocreate-Mechanismus nicht greift (greifen kann).

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:

############################
# 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: Ankündigung als offizielles Modul

FHEM-Forum: Inoffizielles Modul