Wie hast du die iperf Daten ins CheckMK bekommen?
Den IPerf-Check von der Check-MK-Exchange habe ich nicht verwendet. Ich habe mir das selbst zusammen gebastelt. Checks mit Check-MK zu erstellen ist recht einfach und das macht mir Spass.
Hier sind mal die verwendeten Dateien von mir. Ich schreibe meine Code meistens recht generisch, so dass er möglichst einfach zu lesen bzw. zu warten und auch zu erweitern ist. D. h. aus den vielleicht jeweils 5-10 Zeilen, die auch reichen würden, wenn man einen minimalistischen Ansatz wählen würde, werden da schon mal 20-50. Das ist bewusst so gestaltet.
Das ist das Shell-Script dass ich stündlich per Cron aufrufe:
Code:
#!/bin/bash
export LC_ALL=C
export PATH=/bin:/usr/bin:/usr/local/bin
DIR=/var/speedtest
IPERF_IN_FILE=$DIR/iperf_in
IPERF_OUT_FILE=$DIR/iperf_out
REMOTE_SERVER=myserver.domain.tld
REMOTE_SERVER_SSH_PORT=12324
THIS_SERVER_PUBLIC_IP=1.2.3.4
IPERF_PORT=48111
iperf --format=b -p $IPERF_PORT -c $REMOTE_SERVER >$IPERF_OUT_FILE.tmp 2>$IPERF_OUT_FILE.err
# to be sure all things are settling after speedtest in one direction: wait for 30 seconds
sleep 30
ssh -p $REMOTE_SERVER_SSH_PORT -l iperf $REMOTE_SERVER \
iperf --format=b -p $IPERF_PORT -c $THIS_SERVER_PUBLIC_IP >$IPERF_IN_FILE.tmp 2>$IPERF_IN_FILE.err
# important: do not write files directly, else the check may get
# half written test files and this will cause failed check data very often,
# So I'm writing a temporary file and will do a move-operation as an instant atomic update of data.
mv $IPERF_OUT_FILE.tmp $IPERF_OUT_FILE.txt
mv $IPERF_IN_FILE.tmp $IPERF_IN_FILE.txt
Als nächstes brauche ich noch einen Check-MK Local-Check, der mir die IPerf-Daten ausliest. Das ist dieser hier:
Code:
#!/bin/bash
export PATH=/bin:/usr/bin:/usr/local/bin
export LC_ALL=C
export CHECK_DIR=/var/speedtest
export IPERF_IN_FILE=$CHECK_DIR/iperf_in.txt
export IPERF_OUT_FILE=$CHECK_DIR/iperf_out.txt
get_iperf_speed() {
local file="$1"
if [ -s $file ]; then
awk '/bits\/sec/ {print $(NF-1)}' $file
fi
}
my_speedtest_iperf() {
local bits_per_second
local iperf_in
local iperf_out
iperf_in=$(get_iperf_speed $IPERF_IN_FILE)
iperf_out=$(get_iperf_speed $IPERF_OUT_FILE)
echo $iperf_in $iperf_out
# normal iperf console output:
#
# ------------------------------------------------------------
# Client connecting to $REMOTE_SERVER, TCP port $REMOTE_PORT
# TCP window size: 87040 Byte (default)
# ------------------------------------------------------------
# [ 3] local $LOCAL_SERVER_IP port 34222 connected with $REMOTE_SERVER_IP port $REMOTE_PORT
# [ ID] Interval Transfer Bandwidth
# [ 3] 0.0000-10.0004 sec 1084883004 Bytes 867871862 bits/sec
#
}
main() {
read iperf_in iperf_out < <(my_speedtest_iperf)
echo "P speedtest3 iperf_downstream=$iperf_in|iperf_upstream=$iperf_out"
}
main
Wie man Local Checks in Check-MK schreibt ist in der wirklich sehr guten, auch in deutscher Sprache online lesbaren Doku beschrieben:
https://docs.checkmk.com/latest/de/localchecks.html
Last but not least braucht es noch die Metriken- und Graphen-Definition. Die ist seit einiger Zeit - ich glaube ab Version 2.x überarbeitet worden und richtig angenehm und einfach zu benutzen. Nur Doku dazu habe ich nicht gefunden. Die Check_MK Doku zeigt nur, wie man sich das in der Enterprise Version zusammenklickt. Aber zusammenklicken geht nicht mit der Raw-Edition. Da gehen nur die Konfigurationsdateien direkt.
Dieses Youtube Video
YT: Mathias Kettner | Check_MK's new metrics system ENG ist hilfreich für die Basics. Hier ist die Präsenation dazu:
Slides: Checkmk's new metric system
Ich erkläre es mal anhand meines Beispiels:
Das sind die Metriken- und Graphen-Definitionen für den IPerf-Test:
Code:
#!/usr/bin/python
# -*- encoding: utf-8; py-indent-offset: 4 -*-
metric_info["iperf_downstream"] = {
"title" : "iperf-1a-downstream",
"unit" : "bits/s",
"color" : "#02d75e"
}
metric_info["iperf_upstream"] = {
"title" : "iperf-1b-upstream",
"unit" : "bits/s",
"color" : "#017ddb"
}
graph_info["IPerf"] = {
"title": _("IPerf"),
"metrics": [
("iperf_downstream", "-area",),
("iperf_upstream", "area",),
],
}
Die Graphendatei wird abgelegt als my_iperf.py unter $OMD_INSTANZ_VERZEICHNIS/local/share/check_mk/web/plugins/metrics. Änderungen an der Datei benötigen anschließend einen Check_MK Restart (cmk -R) und evtl. ein löschen des Browser-Caches.
Man sieht das hier zwei Metriken definiert bzw. angepasst werden, nämlich iperf_downstream und iperf_upstream. Denen wird zum einen eine Farbe verpasst, der Anzeigename und es wird die richtige Einheit zugewiesen.
Die Einheit ist wichtig, damit Check_MK die Einheit nach oben(Kilo,Mega,Giga,...) und unten (Milli,Micro,Nano) richtig skalieren kann. Dabei hat Check_MK für alle Metriken die notwendigen Einheiten bereits definiert. Man muss nur die richtige verwenden. Die verfügbaren Einheiten stehen in der Datei unit.py. Bei mir ist das die Datei:
/omd/versions/default/lib/python3/cmk/gui/plugins/metrics/unit.py
Der 3. Block enthält dann die Graphendefinition. Hier ist der Graphentitel konfiguriert, die verwendeten Datenwerte und wie diese angezeigt werden. Für letzteres bedeutet, dass
-area als Fläche im negativen Y-Achsenbereich angezeigt wird und
area als Fläche im positiven Y-Achensbereich.
Wenn ein Datenwert nicht in einem Graphen verwendet wird, bekommt er seinen eigenen Graphen im Vorgabestil. D. h. eine eindeutige Farbe und Einzeldarstellung als Fläche im positiven Y-Achsenbereich.
Wenn gleich ich auch keine Dokumentation für dies Metriken- und Graphendefinition kenne, ist es sehr hilfreich, sich die ganzen vorhandenen Definition der von Check_MK mitgebrachten Checks anzuschauen. Von diesen umfangreichen Konfigurationsvorlagen unter
/omd/versions/default/lib/python3/cmk/gui/plugins/metrics
kann man sich dann recht leicht seine Metriken und Graphen zusammenbasteln. Meine eigenen Metriken, also die Farben und das mit area/-area habe ich mir aus der Interface-Metrik-definition abgeschaut, weil ich das imho ja schon recht gut gelöst ist bzgl. der farblichen Gestaltung und sehr leicht erfassbar ist.
Zum Schluß möchte ich nochmal auf das Check-MK Konferenz-Archiv hinweisen. Da sind alle Videos und Präsentationen drin:
https://checkmk.com/community/help-get-help/conference-8/archive
