PostgreSQL-Abfrage

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

Der Check PostgreSQL-Abfrage führt eine eigene SQL-Abfrage auf einem PostgreSQL-Server aus und bewertet entweder die Anzahl der zurückgegebenen Zeilen oder die Ausführungszeit. So kannst du zum Beispiel fehlgeschlagene Jobs, hängende Aufträge 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

Eine Login-Rolle und eine host-Zeile in pg_hba.conf, die diese Rolle von der Adresse des Agent-Geräts aus zulässt.
CONNECT auf die Datenbank, USAGE auf das Schema und SELECT auf die Tabellen, die deine Abfrage liest.

Wie du die Monitoring-Rolle, ihre Leserechte und den Eintrag in pg_hba.conf anlegst, erfährst du unter Das Monitoring-Konto für Datenbank-Checks einrichten.

Schritte

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

Einstellungen

Feld	Typ	Erforderlich	Standard	Beschreibung
Host	Text	Ja	—	Hostname oder IP-Adresse des PostgreSQL-Servers, aus Sicht des Agent-Geräts
Port	Ganzzahl	Nein	5432	TCP-Port des Servers. Werte außerhalb von 1–65535 ersetzt der Check durch 5432
Datenbank	Text	Nein	postgres	Datenbank, in der die Abfrage läuft. Ein leeres Feld wird als `postgres` behandelt
Benutzername	Text	Ja	—	Rolle, mit der sich der Check anmeldet
Passwort	Text	Nein	—	Passwort der Rolle
SSL-Modus	Auswahl	Nein	Prefer	`Prefer` verschlüsselt, wenn der Server es anbietet; `Require` verlangt eine verschlüsselte Verbindung; `Disable` verbindet unverschlüsselt
Abfrage (schreibgeschütztes SELECT)	Text	Ja	—	Die auszuführende Anweisung. Sie läuft in einer `READ ONLY`-Transaktion, die danach zurückgerollt wird
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 jobs WHERE failed liefert immer genau eine Zeile und wird deshalb immer als 1 bewertet, egal wie viele Jobs fehlgeschlagen sind. Schreibe die Abfrage so, dass sie eine Zeile pro Problem zurückgibt, zum Beispiel SELECT id FROM jobs WHERE failed.

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 READ ONLY-Transaktion ist ein Sicherheitsnetz, kein Ersatz für eine Rolle mit reinen Leserechten. Gib der Monitoring-Rolle 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