Zum Hauptinhalt springen
Datenbanken & Anwendungen

MySQL-/MariaDB-Zustand

Prüfe Erreichbarkeit, Verbindungszeit, Threads und Laufzeit eines MySQL- oder MariaDB-Servers.

Der Check MySQL-/MariaDB-Zustand verbindet sich als gewöhnlicher Client mit einem MySQL- oder MariaDB-Server und meldet, ob die Verbindung klappt, wie lange der Verbindungsaufbau dauert, wie viele Threads verbunden sind und wie lange der Server schon läuft. 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 auf dem Datenbankserver anlegst, erfährst du unter Das Monitoring-Konto für Datenbank-Checks einrichten.
  • Für eine aussagekräftige Thread-Zahl braucht das Konto das globale Privileg PROCESS. Ohne es sieht das Konto nur die eigene Verbindung, und der Check meldet bei jedem Lauf einen Thread.

Schritte

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

Einstellungen

FeldTypErforderlichStandardBeschreibung
HostTextJa—Hostname oder IP-Adresse des Datenbankservers, aus Sicht des Agent-Geräts
PortGanzzahlNein3306TCP-Port des Servers. Werte außerhalb von 1–65535 ersetzt der Check durch 3306
Datenbank (optional)TextNein—Datenbank, mit der sich der Check verbindet. Leer lassen, um ohne Standarddatenbank zu verbinden
BenutzernameTextJa—Konto, mit dem sich der Check anmeldet
PasswortTextNein—Passwort des Kontos
SSL-ModusAuswahlNeinPreferredPreferred verschlüsselt, wenn der Server es anbietet; Required verlangt eine verschlüsselte Verbindung; None verbindet unverschlüsselt
Warnung Verbindungszeit (ms)GanzzahlNein1000Dauer des Verbindungsaufbaus, ab der eine Warnung gemeldet wird
Fehler Verbindungszeit (ms)GanzzahlNein3000Dauer des Verbindungsaufbaus, ab der ein kritisches Ergebnis gemeldet wird

Die beiden Verbindungszeit-Felder stehen im Formular unter Schwellenwerte Verbindungszeit.

Ergebnisse

SituationErgebnis
Verbindung aufgebaut, Verbindungszeit unter Warnung Verbindungszeit (ms)OK
Verbindungszeit mindestens Warnung Verbindungszeit (ms)Warnung
Verbindungszeit mindestens Fehler Verbindungszeit (ms)Kritisch
Anmeldung abgewiesen (Authentifizierung fehlgeschlagen)Kritisch
Server nicht erreichbar, Verbindungsfehler oder ZeitüberschreitungKritisch
Kein Host eingetragenWarnung
Unerwarteter Fehler im CheckFehler

Die Schwellenwerte greifen auch bei Gleichheit. Ist Warnung Verbindungszeit (ms) größer als Fehler Verbindungszeit (ms), vertauscht der Check die beiden Werte vor der Auswertung. Der Verbindungsaufbau hat ein festes Timeout von 10 Sekunden.

Erfasste Metriken

  • Verbunden (ja/nein)
  • Verbindungszeit in Millisekunden
  • Anzahl der Threads, gezählt über information_schema.PROCESSLIST
  • Laufzeit des Servers in Sekunden (Statuswert Uptime)

Hinweise

  • Der Check öffnet bei jedem Lauf eine neue Verbindung und schließt sie danach wieder.
  • Der Host ist Teil der Check-Konfiguration. Weist du den Check über ein Konfigurationspaket vielen Geräten zu, verbindet sich jedes dieser Geräte mit demselben Server. Weise ihn deshalb einem einzelnen Gerät zu, idealerweise dem Datenbankserver selbst.