1. Einleitung
In Checkmk können Sie für alle Hosts und Services einzeln und spezifisch oder für ganze Gruppen Anmerkungen (sogenannte custom notes) hinterlegen. Diese Anmerkungen werden in jeweils eigenen Spalten namens Custom services notes und Custom host notes angezeigt. Standardmäßig werden diese Spalten bereits in den detaillierten Tabellenansichten zu Hosts (Status of Host myhost) und Services (Service myservice, myhost) angezeigt. Weil es sich hierbei um reguläre Spalten handelt, können diese auch in viele andere Ansichten in Checkmk eingefügt werden.
2. Anmerkungen erstellen
Anmerkungen erstellen Sie direkt im Konfigurationsverzeichnis Ihrer Checkmk-Instanz.
Erzeugen Sie dazu zuerst das Verzeichnis notes unterhalb von ~/etc/check_mk/.
OMD[mysite]:~$ mkdir ~/etc/check_mk/notes2.1. Host-Anmerkungen
Um nun Anmerkungen zu Hosts zu erstellen, erzeugen Sie unterhalb des Verzeichnisses notes das Verzeichnis hosts.
OMD[mysite]:~$ mkdir ~/etc/check_mk/notes/hostsWollen Sie nun eine Anmerkung für einen bestimmten Host erstellen, so erzeugen Sie eine Datei, deren Namen exakt dem Host-Namen in Checkmk entspricht. Nutzen Sie dazu den Editor Ihrer Wahl oder die Shell Redirection, wie im folgenden Beispiel:
OMD[mysite]:~$ echo "My custom host note for myhost" > ~/etc/check_mk/notes/hosts/myhostGanz unten in der Ansicht Status of Host sieht diese Anmerkung dann so aus:
Wenn Sie möchten, dass sich eine einzelne solche Datei gleich auf mehrere Hosts bezieht und dort angezeigt wird, können Sie mit Suchmuster für Dateinamen (shell patterns) wie dem Stern, dem Fragezeichen und auch Zeichenklassen arbeiten.
Dazu muss dann tatsächlich der Dateiname im jeweiligen Verzeichnis diese Zeichen enthalten.
Eine Datei namens '*' im Verzeichnis ~/etc/check_notes/hosts/ würde sich also auf alle Host beziehen.
Der Inhalt der Datei '*' würde folgerichtig bei jedem einzelnen Host Ihrer Instanz angezeigt.
Wichtig: Die Namen solcher Dateien müssen in einfache Anführungsstriche eingefasst werden.
Möchten Sie - aus Gründen - bei allen Hosts deren Name auf t endet eine bestimmte Anmerkung anzeigen, dann erstellen Sie dazu eine Datei namens '*t'.
OMD[mysite]:~$ echo "The name auf this host ends with t" > ~/etc/check_mk/notes/hosts/'*t'Sollten mehrere Dateien zum Namen eines Hosts passen, werden im Feld Custom host notes auch alle passenden Anmerkungen angezeigt. Die verschiedenen Anmerkungen werden dabei von einer horizontale Linie von einander getrennt:
2.2. Service-Anmerkungen
Um auch für Services solche Anmerkungen einrichten zu können, benötigen Sie unterhalb von ~/etc/check_mk/notes/ noch das Verzeichnis services.
OMD[mysite]:~$ mkdir ~/etc/check_mk/notes/servicesIm Gegensatz zu den Hosts können Sie nicht gleich in diesem Verzeichnis mit den Dateien für Ihre Anmerkungen loslegen. Hier ist noch eine weitere Verzeichnisebene erforderlich, die festlegt, bei welchen Hosts eine Service-Anmerkung angezeigt werden soll.
Erzeugen Sie also als nächstes ein Verzeichnis, welches einen Host - oder nach den Mustern oben - mehrere Hosts bezeichnet.
Ein Verzeichnis namens '*' würde sich also wieder auf alle Hosts beziehen.
OMD[mysite]:~$ mkdir ~/etc/check_mk/notes/services/'*'In einem Verzeichnis, welches exakt einem Host-Namen entspricht, können Sie anschließend somit nur die Services dieses einen Hosts mit Anmerkungen versehen.
OMD[mysite]:~$ mkdir ~/etc/check_mk/notes/services/myhostMöchten Sie Anmerkungen für Services bei allen Hosts erstellen, die mit my beginnen, müssen Sie ein Verzeichnis namens 'my*' anlegen.
OMD[mysite]:~$ mkdir ~/etc/check_mk/notes/services/'my*'Achten Sie auch hier wieder darauf, die Verzeichnisnamen in einfache Anführungsstriche einzufassen.
Sobald Sie jetzt die Host-Ebene nach Ihren Wünschen erstellt haben, können Sie — analog zu den Host-Anmerkungen — wieder Dateien anlegen, die diesmal der gewünschten Service description entsprechen muss. Auch hier können Sie wieder mit Sternen, Fragezeichen und Zeichenklassen arbeiten.
Das folgende Beispiel erzeugt eine Anmerkung für den Service Check_MK auf jedem Host Ihrer Instanz.
OMD[mysite]:~$ echo "Note about service Check_MK for all hosts" > ~/etc/check_mk/notes/services/'*'/Check_MK3. Verwendbare Makros
Innerhalb der Anmerkungen können Sie Makros verwenden, welche dann in der Ansicht passend ersetzt werden. Folgende Makros stehen Ihnen hier zu Verfügung:
|
Host-Name |
|
Host-Name in Kleinbuchstaben |
|
Host-Name in Großbuchstaben |
|
Host-Name mit dem ersten Buchstaben als Großbuchstaben und dem Rest klein |
|
Diejenige IP-Adresse des Hosts, über die er überwacht wird. |
|
Service-Beschreibung (nur bei Service-Anmerkungen) |
|
ID der Checkmk-Instanz |
|
URL-Präfix der Instanz |
|
Ausgabe des Check-Plugins (nur für Host-Anmerkungen) |
|
Ausgabe des Check-Plugins (nur für Service-Anmerkungen) |
So könnten Sie beispielsweise mit einer einzigen Datei auf unterschiedliche Einträge in Ihrem firmeneigenen Wiki verweisen, welche immer zu dem gerade geöffneten Host passen.
Additional information about <a href="http://mywiki.local/page.php?host=$HOSTNAME$" target="_blank">this host in our wiki</a>