MySQL überwachen

Die einzige Voraussetzung für die Einrichtung der Überwachung innerhalb von MySQL ist, dass ein Datenbanknutzer und dessen Passwort vorhanden sein müssen. Dieser Benutzer benötigt lediglich lesende Rechte auf die MySQL-Instanzen. Sollte noch kein solcher Benutzer vorhanden sein, legen Sie diesen in den zu überwachenden Instanzen an. Melden Sie sich dazu mit einem Benutzer mit ausreichenden Zugriffsberechtigungen in MySQL an und erzeugen Sie anschließend einen neuen Datenbanknutzer:

Dieser neu angelegte Benutzer benötigt die Berechtigung, die Instanzen zu lesen. Prüfen Sie daher, ob der Benutzer die notwendigen Berechtigungen hat, oder fügen Sie sie mit dem folgenden Befehl hinzu. Im folgenden Beispiel wird das für den Benutzer checkmk erledigt:

Sollten Sie die MySQL Replikation einsetzen so muss dem Nutzer zur Überwachung der Replica Server noch mindestens das Recht REPLICATION CLIENT erteilt werden:

Das benötigte Plugin mk_mysql finden Sie auf ihrem Checkmk-Server im Verzeichnis ~/share/check_mk/agents/plugins/. Kopieren Sie dieses nun in einem ersten Schritt in das Plugins-Verzeichnis des Agenten auf dem zu überwachenden Host. Das Plugins-Verzeichnis lautet im Regelfall /usr/lib/check_mk_agent/plugins. Sobald das Skript im angegebenen Verzeichnis liegt, machen Sie dieses noch ausführbar:

Selbstverständlich kann auch dieses Plugin auf Wunsch asynchron ausgeführt werden.

Der Agent für Windows wird standardmäßig bereits mit einer ganzen Reihe von Plugins ausgeliefert. Deshalb finden Sie auch das Plugin für die Überwachung von MySQL nach der Installation des Agenten bereits auf Ihrem Host. Dieses kopieren Sie für die Verwendung nur noch in das richtige Verzeichnis.

Erzeugen Sie anschließend eine Datei mit dem Namen mysql.cfg im Konfigurationsverzeichnis (regulär: /etc/check_mk) des Checkmk-Agenten auf dem Ziel-Host. Unter Verwendung der darin eingetragenen Nutzerdaten, kann der Agent die gewünschten Informationen aus Ihrer MySQL-Instanz abrufen. Zwar ist die Angabe eines Datenbanknutzers optional, wir empfehlen diese allerdings, da der Agent das Plugin in der Regel als root ausführt. Diese Angabe wird im üblichen Format für MySQL Konfigurationsdateien vorgenommen:

Die so gespeicherten Zugangsdaten werden durch das folgende Kommando noch vor unbefugtem Zugriff geschützt:

Auf einem Windows-Host legen Sie im unten angegebenen Verzeichnis eine Datei names mysql.ini an.

Sollten Sie auf dem Host mehrere MySQL-Instanzen mit verschiedenen Nutzernamen und Passwörtern betreiben, erstellen einfach Sie pro Instanz eine .ini-Datei nach dem folgenden Namensschema: mysql_INSTANZ-ID.ini

Auf einem Linux-Host wird das Plugin dafür nur in ein Unterverzeichnis des Plugin-Verzeichnisses verschoben. Möchten Sie das Plugin beispielsweise nur alle 5 Minuten ausführen, so verschieben Sie das Skript mk_mysql einfach in ein Unterverzeichnis mit dem Namen 300. Eine detaillierte Anleitung zur asynchronen Ausführung von Plugins finden Sie im Artikel über den Linux-Agenten.

Um das Plugin unter Windows asynchron auszuführen, passen Sie die Konfiguration des Agenten an und erweitern die Sektion execution unter plugins um den folgenden Eintrag:

Eine detaillierte Anleitung zur asynchronen Ausführung von Plugins auf einem Windows-Host finden Sie im Artikel über den Windows-Agenten.

Statt den Agenten über TCP mit MySQL kommunizieren zu lassen, können Sie Checkmk anweisen den Socket anzusprechen. Dazu definieren Sie in der Datei mysql.cfg lediglich die Variable socket. Hier an dem Beispiel der Windows-Konfigurationsdatei:

Des Weiteren ist es über die Konfigurationsdateien auch möglich den MySQL-Host manuell zu setzen. Die entsprechende Variable dazu heißt schlicht host. Auch hier wieder an dem Beispiel von Windows:

Einige der so eingerichteten Checks haben keine voreingestellten Schwellwerte. Meistens ist das der Fall, weil es keine sinnvollen Standardwerte gibt, die in den meisten Anwendungsfällen ausreichend wären. Diese können aber mit wenigen Handgriffen eingerichtet werden. Über die bekannten Host & Service Parameters finden Sie beispielsweise die Regel MySQL Sessions & Connections. Hiermit lassen sich die für ihre MySQL-Instanz sinnvollen Schwellwerte für den Service MySQL sessions festlegen.

Auch für die Auslastung der durch MySQL vorgegebenen maximalen Anzahl an gleichzeitigen Verbindungen haben wir keine Schwellwerte vorgegeben, da diese viel stärker als bei anderen Services vom Aufbau Ihrer MySQL-Instanz abhängig sind. Die Einrichtung entsprechender Schwellwerte lässt sich mit einer Regel aus dem Satz MySQL Connections im Handumdrehen bewerkstelligen. Gleiches gilt dann auch für die Anzahl der offenen Verbindungen.

Die Größe einzelner Datenbanken in MySQL wird durch das Check-Plugin MySQL: Capacity überwacht. Schwellwerte hierfür lassen sich mit der Regel Size of MySQL databases festlegen.

Die Fehlermeldung connect to server at xyz failed deutet darauf hin, dass der in der Konfigurationsdatei angegebene Nutzer keinen Zugriff auf MySQL hat. Prüfen Sie zuerst, dass sich keine Übertragungsfehler beim Anlegen der Konfigurationsdatei (mysql.cfg bzw. mysql.ini) eingeschlichen haben.

Sollte der in der Konfigurationsdatei angegebene Nutzername oder das Passwort falsch sein, erhalten Sie in etwa die folgende Fehlermeldung:

Sollten Sie in Checkmk zwar eine ganze Reihe von Daten Ihrer MySQL-Instanz sehen, es jedoch keinen Service geben, welcher die Größe der enthaltenen Datenbanken überwacht, so ist dies ein Indiz dafür, dass der Datenbanknutzer nicht über das Recht SELECT verfügt.

Prüfen Sie Ihren Datenbanknutzer aus MySQL heraus mit dem folgenden Befehl:

Sollte hier in Ihrer Ausgabe das Schlüsselwort SELECT fehlen, so erteilen Sie dem Datenbanknutzer die entsprechenden Rechte, wie im Abschnitt Benutzer einrichten angegeben.