Checkmk
to checkmk.com

Nachdem Sie Checkmk auf einem Linux-Server installiert haben, erfahren Sie hier, was jetzt noch zu tun ist, um in wenigen Schritten eine Instanz (site) zu erstellen, zu starten und mit Leben zu füllen, indem Sie die ersten Geräte in das Monitoring aufnehmen.

Hinweis: Falls Sie Checkmk statt auf einem Linux-Server mit einer unserer Appliances oder im Docker-Container betreiben, läuft die Instanzverwaltung anders ab, als im folgenden beschrieben: Checkmk-Appliances werden über eine spezielle Weboberfläche administriert, die auch das Erstellen von Instanzen abdeckt, was im Artikel über die Appliance erklärt wird. Bei der Installation als Docker-Container wird die Instanz cmk gleich mit eingerichtet und gestartet. In beiden Fällen können Sie also gleich zur Anmeldung an der Weboberfläche springen.

1. Eine Instanz erstellen

Erstellen Sie die Instanz als root mit dem Befehl omd create, gefolgt vom Namen der Instanz. Der Name darf nur aus Buchstaben und Ziffern bestehen. Konvention sind dabei Kleinbuchstaben. Im Handbuch verwenden wir in Beispielen den Instanznamen mysite:

root@linux# omd create mysite
Adding /opt/omd/sites/mysite/tmp to /etc/fstab.
Creating temporary filesystem /omd/sites/mysite/tmp...OK
Updating core configuration...
Generating configuration for core (type nagios)...
Precompiling host checks...OK
Executing post-create script "01_create-sample-config.py"...OK
Restarting Apache...OK
Created new site mysite with version 2.1.0p1.cre.

  The site can be started with omd start mysite.
  The default web UI is available at http://linux/mysite/

  The admin user for the web applications is cmkadmin with password: YzxfoFZh
  For command line administration of the site, log in with 'omd su mysite'.
  After logging in, you can change the password for cmkadmin with 'htpasswd etc/htpasswd cmkadmin'.

Wie Sie in der Kommandoausgabe sehen, wird beim Erzeugen der Instanz automatisch ein administrativer Checkmk-Benutzer mit dem Namen cmkadmin erstellt, mit dem Sie sich an der Weboberfläche von Checkmk anmelden können. cmkadmin hat ein zufälliges Passwort erhalten. Notieren Sie sich dieses Passwort — oder ändern Sie es. Wie das geht, erfahren Sie im übernächsten Absatz.

Sobald Sie die neue Instanz erzeugt haben, erfolgt die weitere Administration nicht mehr als root, sondern als Instanzbenutzer. Zu diesem werden Sie am einfachsten mit dem folgenden Kommando:

root@linux# su - mysite
OMD[mysite]:~$

Als Instanzbenutzer können Sie das Passwort des Benutzers cmkadmin wie folgt ändern:

OMD[mysite]:~$ htpasswd -m etc/htpasswd cmkadmin
New password: ****
Re-type new password: \**
Updating password for user cmkadmin

2. Die Instanz starten

Eine Instanz kann gestartet oder gestoppt sein. Frisch angelegte Instanzen beginnen ihr Leben gestoppt. Daher müssen Sie die Instanz per Kommando starten:

OMD[mysite]:~$ omd start
Creating temporary filesystem /omd/sites/mysite/tmp...OK
Starting agent-receiver...OK
Starting mkeventd...OK
Starting rrdcached...OK
Starting npcd...OK
Starting nagios...OK
Starting apache...OK
Starting redis...OK
Initializing Crontab...OK

Tipp: Ausführlicher wird das Erstellen und Starten einer Instanz übrigens im Leitfaden für Einsteiger behandelt.

3. An der Weboberfläche anmelden

Wenn Ihr Checkmk-Server myserver heißt und Ihre Instanz mysite, erfolgt der Zugriff auf die Weboberfläche mit http://myserver/mysite/ im Browser:

Checkmk-Anmeldedialog.

Melden Sie sich nun mit dem Benutzernamen cmkadmin und dem anfangs ausgewürfelten bzw. von Ihnen geänderten Passwort an. Dadurch landen Sie auf der Startseite von Checkmk.

Hinweis: Im Docker-Container finden Sie das Passwort des Benutzers cmkadmin in den Log-Dateien des Containers. Bei Verwendung der Appliance haben Sie Benutzername und Passwort beim Erzeugen der Instanz selbst festgelegt.

4. Agent auf dem Monitoring-Server installieren

Als ersten Host nehmen Sie den Monitoring-Server selbst in die Überwachung auf. Dazu benötigen Sie zuerst einmal einen Monitoring-Agenten.

Hinweis: Auf den Appliances ist dieser Checkmk-Agent bereits vorinstalliert.

Wenn Sie mit einem eigenen Linux-Server oder im Docker-Container arbeiten, müssen Sie den Agenten installieren.

Für die Installation des Agenten benötigen Sie die passende Paketdatei — im RPM-Dateiformat für SLES und Red Hat Enterprise Linux (RHEL) basierte Systeme oder im DEB-Dateiformat für Debian und Ubuntu. Diese Paketdatei können Sie auf verschiedenen Wegen erhalten, zum Beispiel durch Download über die Checkmk-Oberfläche:

Download-Seite mit den RPM/DEB-Paketen.

In diesem Fall ist der Host, auf dem der Agent installiert werden soll, der Monitoring-Server selbst. Daher können Sie ohne Herunterladen direkt auf die Paketdateien zugreifen, die Sie in Ihrem Instanzverzeichnis (/omd/sites/mysite/) unter ~/share/check_mk/agents/ finden:

OMD[mysite]:~$ ls -la share/check_mk/agents/check-mk-agent*
-rw-r--r-- 1 root root 4537960 May 31 20:52 share/check_mk/agents/check-mk-agent-2.1.0p1-1.noarch.rpm
-rw-r--r-- 1 root root 4291230 May 31 20:52 share/check_mk/agents/check-mk-agent_2.1.0p1-1_all.deb

Installieren Sie das Paket — mit rpm -U für die RPM-Datei oder mit dpkg -i für die DEB-Datei, zum Beispiel so:

root@linux# dpkg -i /omd/sites/mysite/share/check_mk/agents/check-mk-agent_2.1.0p1-1_all.deb

Eine ausführliche Anleitung zur Installation des Agenten finden Sie im Artikel zum Linux-Agenten.

5. Monitoring-Server als Host registrieren

Vertrauen und TLS-verschlüsselter Datenaustausch zwischen Agent und Checkmk-Instanz sind ab Checkmk-Version 2.1.0 Pflicht — auch wenn auf dem gleichen Rechner (dem Monitoring-Server) kommuniziert wird. Daher ist nach der Installation der nächste Schritt die Registrierung des Agenten, genauer des Agent Controllers, bei der Instanz.

Bevor ein Host registriert werden kann, muss er in der Checkmk-Konfigurationsumgebung existieren. Die Verwaltung der zu überwachenden Hosts finden Sie im Setup-Menü, genauer unter Setup > Hosts > Hosts. Klicken Sie auf Add host, tragen Sie als Hostname localhost ein und klicken Sie auf Save & go to folder.

Die Registrierung erfolgt dann durch Aufruf des Agent Controllers cmk-agent-ctl auf der Kommandozeile. Für das Kommando benötigen Sie die Namen des Checkmk-Servers (im Beispiel linux), der Checkmk-Instanz (mysite) und des Hosts (localhost), wie er soeben in Checkmk eingerichtet wurde. Komplettiert werden die Optionen durch Name (und Passwort) eines Checkmk-Benutzers mit Zugriff auf die REST-API. Dazu können Sie cmkadmin verwenden:

root@linux# cmk-agent-ctl register --hostname localhost --server linux --site mysite --user cmkadmin

Waren die angegebenen Werte korrekt, wird Ihnen das Server-Zertifikat angezeigt und Sie werden zuerst aufgefordert, die Identität der Checkmk-Instanz mit Y zu bestätigen. Dann wird von Ihnen noch das Passwort des Benutzers cmkadmin abgefragt. Falls keine Fehlermeldung angezeigt wird, ist die verschlüsselte Verbindung hergestellt.

Detaillierter wird die Registrierung im Artikel zum Linux-Agenten beschrieben.

6. Host ins Monitoring aufnehmen

Den Rest erledigen Sie wieder über die Checkmk-Oberfläche, in den Eigenschaften des Hosts, die Sie erreichen über Setup > Hosts > Hosts und dann Symbol zum Bearbeiten eines Listeneintrags.Edit the properties of this host.

Kicken Sie auf Save & go to service configuration:

Liste der auf dem Host gefundenen Services zur Aufnahme ins Monitoring.

In dieser Liste fügen Sie alle gefundenen, aber noch nicht überwachten Services (Undecided) per Knopfdruck auf Accept all dem Monitoring hinzu.

Klicken Sie anschließend rechts oben auf der Hauptseite auf den orangen Knopf mit der Anzahl der changes, um auf der darauf folgenden Seite mit Activate on selected sites die Änderungen zu aktivieren. Damit wird der neue Host mit seinen Services aus der Konfigurationsumgebung in die Monitoring-Umgebung übernommen.

Das war alles!

Der Server wird mit Standardeinstellungen überwacht, was Sie sehen können, wenn sie sich im Monitor-Menü alle Hosts anzeigen lassen mit Monitor > Overview > All hosts und dann den neuen localhost auswählen:

Liste der Services im Monitoring.

7. Weitere Server und Netzwerkgeräte aufnehmen

Auf die gleiche Art können Sie weitere Geräte in das Monitoring aufnehmen. Dazu noch ein paar Hinweise:

  • Zur Überwachung von Windows nutzen Sie den Agenten im MSI-Paket. Der Windows-Agent installiert unter Windows den Dienst „Check MK Service“.

  • Zur Überwachung von SNMP-Geräten wie Router, Switches, Drucker oder Hardwaresensoren nutzen Sie die bereits vom Hersteller eingebaute Schnittstelle für das Monitoring: den SNMP-Agenten. Beim Einrichten des Hosts für ein SNMP-Gerät wählen Sie daher bei Checkmk agent / API integrations die Option No API integrations, no Checkmk agent und stattdessen bei SNMP den Eintrag SNMP v2 or v3. Falls die SNMP Community nicht public lautet, dann tragen Sie diese unter SNMP credentials ein.

  • Wenn der Host-Name nicht per DNS auflösbar ist, dann aktivieren Sie in den Eigenschaften des Hosts den Parameter IPv4 address und tragen die IP-Adresse manuell ein.

Tipp: Wenn Sie mal nicht weiter wissen, hoffen wir, dass Sie die Antwort auf Ihre Frage in diesem Handbuch finden. Bei Fragen zu Details der Checkmk-Oberfläche können Sie sich aber auch die kontext-sensitive Inline-Hilfe einblenden: auf der Hauptseite im Help-Menü mit Help > Show inline help.

Auf dieser Seite