Checkmk#

Check_MK ist eine Software für Network Monitoring, die du aus i-doit heraus konfigurieren kannst.

Das Add-on exportiert WATO-Konfigurationsdateien an Check_MK. WATO verwaltet Änderungen an der Monitoring-Konfiguration und prüft deren Gültigkeit. Die exportierten Konfigurationen enthalten IP-Adressen oder DNS-Namen der Hosts und Cluster, zugeordnete Hostmerkmale (Tags) sowie verknüpfte Kontakte. Weitere Monitoring-spezifische Konfigurationen verbleiben in Check_MK.

Der Vorteil: Du vermeidest doppelte Datenpflege. Hostmerkmale, die in Check_MK das Monitoring regelbasiert steuern, werden automatisch aus CMDB-Informationen wie dem Standort eines Objekts generiert.

Grundkonfiguration#

Richte die Konfiguration unter Verwaltung → Schnittstellen → Monitoring → Exportkonfiguration ein:

1. Lege den lokalen Pfad fest -- einen absoluten oder relativen Pfad im Dateisystem, in dem die erzeugte Konfiguration abgelegt wird.
2. Gib den Link zum Monitoring-Tool an, damit i-doit Links auf die Monitoring-Instanz generieren kann.
3. Wähle Check_MK als Typ -- weitere Parameter erscheinen.

Die wichtigsten Parameter:

• Zugewiesene Kontakte exportieren: Legt die den Objekten zugewiesenen Kontakte inklusive Objekttitel in der Konfiguration ab.
• Site: Definiert die Site, an die die Konfiguration weitergereicht wird. Setze dafür Multisite (Distributed Monitoring) auf "Ja".
• Hosts/Ordner sperren: Verhindert, dass die exportierte Konfiguration in Check_MK bearbeitet wird -- so werden deine Einstellungen beim nächsten Export nicht überschrieben.
• Master Site: Wähle hier die Site aus, die über mehrere Exportkonfigurationen hinzugekommen ist. Bei nur einer Konfiguration lässt du das Feld leer.

Kategorien#

Ordne den gewünschten Objekttypen über Datenstruktur bearbeiten den Kategorie-Ordner Check_MK (Host) zu.

In der Kategorie Check_MK (Host) wählst du eine Export-Konfiguration aus und definierst den Hostnamen bzw. die Hostadresse. Optional verhinderst du den Export der IP-Adresse -- z. B. wenn diese per DHCP zugewiesen wird und sich ändert.

Hostmerkmale#

Über die Kategorie Hostmerkmale werden diese zugewiesen oder angezeigt. Es wird unterschieden zwischen:

• Hostmerkmale: einfache manuelle Zuweisung von Merkmalen (daher statisch)

• CMDB Merkmale: Merkmale, die durch ein Attribut aus der CMDB ausgeprägt werden

• Dynamische Merkmale: Hostmerkmale, die durch Regelungen generiert werden

Alle Arten von Hostmerkmalen werden unter Extras → Check_MK konfiguriert.

Die statischen Hostmerkmale werden manuell gepflegt. Die Standardmerkmale von Check_MK werden bereits vorkonfiguriert ausgeliefert.

Die CMDB-Merkmale greifen auf Inhalte aus der CMDB zu. In der Konfiguration siehst du nur Objekttypen, denen der Kategorieordner Check_MK zugeordnet ist. Du kannst einzelne Attribute auswählen und eine globale Definition einrichten, die für alle Objekttypen ohne spezielle Konfiguration gilt. Über Generisches Standort-Merkmal exportieren fuegst du den Objekttitel des Standorts als Tag zu den Hostmerkmalen hinzu.

Im folgenden Beispiel wird das Attribut Betriebssystem aus der CMDB in ein Hostmerkmal umgewandelt.

Der Server im Beispiel hat als Betriebssystem Debian 7.1 zugewiesen. Dieser Wert wird beim Export der Konfiguration zu dem entsprechenden Hostmerkmal übernommen.

Die dynamischen Merkmale arbeiten regelbasiert. Im folgenden Beispiel wird der Standort eines Objekts ausgewertet: Steht ein Server unterhalb des Standorts "Muenchen", erhält er beim Export automatisch das Hostmerkmal "WAN".

Kategorie Hostmerkmale#

In der Kategorie Hostmerkmale eines Objektes werden die dynamischen Hostmerkmale angezeigt und die manuellen, statischen Hostmerkmale zugewiesen.

Kategorie Servicezuweisung#

Über die Servicezuweisung verknüpfst du installierte Software mit Service-Checks, die per Livestatus ausgelesen werden. So kann das Analyse-Modul anhand von Monitoring-Ausfaellen ermitteln, welche IT-Services direkt oder indirekt betroffen sind.

Export der Konfiguration#

Den Export startest du manuell unter Extras → Check_MK → Check_MK Export.

Dabei werden .mk-Dateien erzeugt und im konfigurierten Verzeichnis abgelegt. Zur einfachen Übertragung in die OMD Site werden die Daten zusätzlich als .zip und als Tarball gepackt.

Die Export-Struktur bestimmt, wie die Objekte in Check_MK organisiert werden: Du kannst wählen, ob Standorte oder Objekttypen als Ordnerstruktur angelegt werden.

Transfer Script#

Im Installationsverzeichnis von i-doit findest du das Shellscript checkmk_transfer.sh. Dieses Script automatisiert den gesamten Transfer:

1. Es steuert die i-doit Console an.
2. Es baut eine SSH-Verbindung zur Check_MK-Instanz auf.
3. Es überträgt die Daten in die OMD Site und entpackt sie.
4. Es signalisiert WATO, dass Änderungen vorliegen.

Voraussetzung: Public-Key-Authentifizierung zwischen der i-doit-Instanz und der Check_MK OMD Site. Eine detaillierte Anleitung findest du im Installationsverzeichnis unter docs/checkmk/README bzw. README.german.

Releases#