MySQL-/MariaDB-Abfrage

Führe eine eigene SELECT-Abfrage auf einem MySQL- oder MariaDB-Server aus und lass dich anhand von Zeilenanzahl oder Ausführungszeit warnen.

Der Check MySQL-/MariaDB-Abfrage führt eine eigene SQL-Abfrage auf einem MySQL- oder MariaDB-Server aus und bewertet entweder die Anzahl der zurückgegebenen Zeilen oder die Ausführungszeit. So kannst du zum Beispiel hängende Aufträge, fehlgeschlagene Jobs oder langsame Abfragen überwachen. Der Check läuft auf dem Agent-Gerät, dem du ihn zuweist, und verbindet sich von dort über TCP mit dem eingetragenen Host. Er läuft unter Windows, Linux und macOS (jeweils x64 und Arm64), standardmäßig alle 5 Minuten. Der Datenbankserver selbst muss kein Agent-Gerät sein; es genügt ein Agent-Gerät, das ihn über das Netzwerk erreicht.

Voraussetzungen

Ein Konto auf dem Datenbankserver, das sich von der Adresse des Agent-Geräts aus anmelden darf. Wie du das Monitoring-Konto anlegst, erfährst du unter Das Monitoring-Konto für Datenbank-Checks einrichten.
SELECT-Rechte auf genau die Tabellen, die deine Abfrage liest.

Schritte

Gehe zu Geräte und öffne das Gerät.
Klicke auf den Tab Checks → Check hinzufügen → MySQL-/MariaDB-Abfrage.

Einstellungen

Feld	Typ	Erforderlich	Standard	Beschreibung
Host	Text	Ja	—	Hostname oder IP-Adresse des Datenbankservers, aus Sicht des Agent-Geräts
Port	Ganzzahl	Nein	3306	TCP-Port des Servers. Werte außerhalb von 1–65535 ersetzt der Check durch 3306
Datenbank (optional)	Text	Nein	—	Standarddatenbank der Verbindung. Leer lassen, wenn die Abfrage Tabellen voll qualifiziert anspricht (`schema.tabelle`)
Benutzername	Text	Ja	—	Konto, mit dem sich der Check anmeldet
Passwort	Text	Nein	—	Passwort des Kontos
SSL-Modus	Auswahl	Nein	Preferred	`Preferred` verschlüsselt, wenn der Server es anbietet; `Required` verlangt eine verschlüsselte Verbindung; `None` verbindet unverschlüsselt
Abfrage (schreibgeschütztes SELECT)	Text	Ja	—	Die auszuführende Anweisung. Der Check setzt die Sitzung vorher auf `READ ONLY`
Warnen bei	Auswahl	Nein	Zeilenanzahl	Zeilenanzahl bewertet die Anzahl der zurückgegebenen Zeilen, Ausführungszeit (ms) die Dauer der Abfrage in Millisekunden
Warnen, wenn unter Schwellenwert	Ja/Nein	Nein	Nein	Kehrt den Vergleich um: Alarm, wenn der Wert die Schwellenwerte erreicht oder unterschreitet
Warnungs-Schwellenwert	Zahl	Nein	1	Wert, ab dem eine Warnung gemeldet wird
Fehler-Schwellenwert	Zahl	Nein	1	Wert, ab dem ein kritisches Ergebnis gemeldet wird

Der Check zählt Zeilen, keine Werte. SELECT count(*) FROM orders WHERE status = 'stuck' liefert immer genau eine Zeile und wird deshalb immer als 1 bewertet, egal wie viele Einträge betroffen sind. Schreibe die Abfrage so, dass sie eine Zeile pro Problem zurückgibt, zum Beispiel SELECT id FROM orders WHERE status = 'stuck'.

Ergebnisse

Der Check vergleicht den gewählten Wert (Zeilenanzahl oder Ausführungszeit) mit beiden Schwellenwerten. Die Schwellenwerte greifen auch bei Gleichheit.

Situation	Ergebnis
Wert mindestens Fehler-Schwellenwert (mit Warnen, wenn unter Schwellenwert: höchstens)	Kritisch
Wert mindestens Warnungs-Schwellenwert (mit Warnen, wenn unter Schwellenwert: höchstens)	Warnung
Sonst	OK
Anmeldung abgewiesen, Server nicht erreichbar, Abfragefehler oder Zeitüberschreitung	Kritisch
Kein Host oder keine Abfrage eingetragen	Warnung
Unerwarteter Fehler im Check	Fehler

Mit den Standardwerten (beide Schwellenwerte 1, Modus Zeilenanzahl) ist der Check also kritisch, sobald die Abfrage mindestens eine Zeile zurückgibt, und sonst OK. Liegen die beiden Schwellenwerte in der falschen Reihenfolge, vertauscht der Check sie vor der Auswertung. Verbindungsaufbau und Abfrage haben ein festes Timeout von 15 Sekunden.

Erfasste Metriken

Anzahl der zurückgegebenen Zeilen
Ausführungszeit der Abfrage in Millisekunden (ohne Verbindungsaufbau)

Hinweise

Die Sitzung auf READ ONLY zu setzen ist ein Sicherheitsnetz, kein Ersatz für ein Konto mit reinen Leserechten. Gib dem Monitoring-Konto nur SELECT.
Der Host ist Teil der Check-Konfiguration. Weist du den Check über ein Konfigurationspaket vielen Geräten zu, führt jedes dieser Geräte dieselbe Abfrage auf demselben Server aus. Weise ihn deshalb einem einzelnen Gerät zu.

War dies hilfreich?

Brauchen Sie noch Hilfe? Team fragen