PostgreSQL-Plugin

Übersicht

Konfigurationsparameter ermöglichen die Anpassung des Verhaltens des PostgreSQL-Plugins.

Es wird empfohlen, sie in einer eigenen Konfigurationsdatei anzugeben (z. B. postgresql.conf) und nicht in der Konfigurationsdatei von Agent 2. Verwenden Sie dann die Direktive Include, um diese Datei in die Zabbix Agent 2-Konfiguration einzubinden.

Das PostgreSQL-Plugin ist ein ladbares Plugin und ist im Repository des PostgreSQL-Plugins verfügbar und vollständig beschrieben.

Alle Parameter sind optional, sofern nicht ausdrücklich angegeben ist, dass der Parameter obligatorisch ist.

Diese Seite ist wie folgt aufgebaut:

  • Parameterübersicht (um die vollständigen Details eines Parameters anzuzeigen, klicken Sie auf seinen Namen)
  • Parameterdetails
Parameter Beschreibung
Plugins.PostgreSQL.CallTimeout Legt die maximale Wartezeit in Sekunden fest, bis eine Anfrage abgeschlossen ist.
Plugins.PostgreSQL.CustomQueriesPath Geben Sie den vollständigen Pfad des Verzeichnisses an, das .sql-Dateien mit benutzerdefinierten Abfragen enthält.
Plugins.PostgreSQL.CustomQueriesEnabled Aktiviert die Ausführung des Datenpunkt-Schlüssels postgresql.custom.query.
Plugins.PostgreSQL.Default.CacheMode Geben Sie den Standard-Cachemodus für die PostgreSQL-Verbindung an.
Plugins.PostgreSQL.Default.Database Geben Sie den Standard-Datenbanknamen an.
Plugins.PostgreSQL.Default.Password Geben Sie das Standardpasswort an.
Plugins.PostgreSQL.Default.TLSCAFile Geben Sie den vollständigen Pfad der Datei an, die das Zertifikat der obersten CA(s) für die Peer-Zertifikatsprüfung enthält.
Plugins.PostgreSQL.Default.TLSCertFile Geben Sie den vollständigen Pfad der Datei an, die das PostgreSQL-Zertifikat oder die Zertifikatskette enthält.
Plugins.PostgreSQL.Default.TLSConnect Geben Sie den Standard-Verschlüsselungsgrad für die Kommunikation zwischen Zabbix Agent 2 und den überwachten Datenbanken an.
Plugins.PostgreSQL.Default.TLSKeyFile Geben Sie den vollständigen Pfad der Datei an, die den privaten PostgreSQL-Schlüssel enthält.
Plugins.PostgreSQL.Default.Uri Geben Sie die Standard-URI an.
Plugins.PostgreSQL.Default.User Geben Sie den Standard-Benutzernamen an.
Plugins.PostgreSQL.KeepAlive Legt die maximale Wartezeit in Sekunden fest, bevor ungenutzte Plugin-Verbindungen geschlossen werden.
Plugins.PostgreSQL.Sessions.<SessionName>.CacheMode Geben Sie den Cachemodus der benannten Sitzung für die PostgreSQL-Verbindung an.
Plugins.PostgreSQL.Sessions.<SessionName>.Database Geben Sie den Datenbanknamen der benannten Sitzung an.
Plugins.PostgreSQL.Sessions.<SessionName>.Password Geben Sie das Passwort der benannten Sitzung an.
Plugins.PostgreSQL.Sessions.<SessionName>.TLSCAFile Geben Sie den vollständigen Pfad der Datei an, die das Zertifikat der obersten CA(s) für die Peer-Zertifikatsprüfung enthält.
Plugins.PostgreSQL.Sessions.<SessionName>.TLSCertFile Geben Sie den vollständigen Pfad der Datei an, die das PostgreSQL-Zertifikat oder die Zertifikatskette enthält.
Plugins.PostgreSQL.Sessions.<SessionName>.TLSConnect Geben Sie den Verschlüsselungsgrad der benannten Sitzung für die Kommunikation zwischen Zabbix Agent 2 und den überwachten Datenbanken an.
Plugins.PostgreSQL.Sessions.<SessionName>.TLSKeyFile Geben Sie den vollständigen Pfad der Datei an, die den privaten PostgreSQL-Schlüssel enthält.
Plugins.PostgreSQL.Sessions.<SessionName>.Uri Geben Sie die URI der benannten Sitzung an.
Plugins.PostgreSQL.Sessions.<SessionName>.User Geben Sie den Benutzernamen der benannten Sitzung an.

|Plugins.PostgreSQL.System.Path|Geben Sie den Pfad zur ausführbaren Datei des PostgreSQL-Plugins an.| |Plugins.PostgreSQL.Timeout|Legt das Timeout für die Ausführung von Anfragen fest.|

Beachten Sie:

  • Die Standardwerte spiegeln die Prozess-Standardeinstellungen wider, nicht die Werte in den mitgelieferten Konfigurationsdateien.
  • Werte unterstützen Umgebungsvariablen;
  • Zabbix unterstützt Konfigurationsdateien nur in UTF-8-Kodierung ohne BOM.
  • Kommentare, die mit "#" beginnen, werden nur am Zeilenanfang unterstützt.

Parameterdetails

Plugins.PostgreSQL.CallTimeout

Legt die maximale Wartezeit in Sekunden fest, bis eine Anfrage abgeschlossen ist.

Standard: global timeout
Bereich: 1-30

Plugins.PostgreSQL.CustomQueriesPath

Geben Sie den vollständigen Pfadnamen des Verzeichnisses an, das .sql-Dateien mit benutzerdefinierten Abfragen enthält.

Standardwerte:
/usr/local/share/zabbix/custom-queries/postgreSQL - für Unix-Systeme,
*:\Program Files\Zabbix Agent 2\Custom Queries\PostgreSQL - für Windows-Systeme (wobei * der Laufwerksname aus der Umgebungsvariable ProgramFiles ist)

Beispiel:

/etc/zabbix/oracle/sql
Plugins.PostgreSQL.CustomQueriesEnabled

Aktiviert die Ausführung des Datenpunkt-Schlüssels postgresql.custom.query.
Wenn diese Option deaktiviert ist, werden keine Abfragen aus dem Verzeichnispfad für benutzerdefinierte Abfragen geladen.

Standard: false
Bereich: true/false

Plugins.PostgreSQL.Default.CacheMode

Geben Sie den Standard-Cache-Modus für die PostgreSQL-Verbindung an.

Standard: prepare
Bereich:
prepare - vorbereitete Anweisungen auf dem PostgreSQL-Server erstellen;
describe - die anonyme vorbereitete Anweisung verwenden, um eine Anweisung zu beschreiben, ohne eine Anweisung auf dem Server zu erstellen.

Beachten Sie, dass describe vor allem dann nützlich ist, wenn die Umgebung keine vorbereiteten Anweisungen zulässt, z. B. beim Einsatz eines Connection Poolers wie PgBouncer.

Plugins.PostgreSQL.Default.Database

Geben Sie die Standarddatenbank für die Verbindung zu PostgreSQL an.
Wird verwendet, wenn in einem Datenpunkt-Schlüssel oder einer benannten Sitzung kein Wert angegeben ist.

Plugins.PostgreSQL.Default.Password

Geben Sie das Standardpasswort für die Verbindung zu PostgreSQL an.
Wird verwendet, wenn im Datenpunkt-Schlüssel oder in der benannten Sitzung kein Wert angegeben ist.

Plugins.PostgreSQL.Default.TLSCAFile

Geben Sie den vollständigen Pfadnamen der Datei an, die das Zertifikat der obersten CA(s) für die Überprüfung des Peer-Zertifikats bei verschlüsselter Kommunikation zwischen Zabbix Agent 2 und den überwachten Datenbanken enthält.
Wird verwendet, wenn in einer benannten Sitzung kein Wert angegeben ist.

Pflicht: yes, wenn Plugins.PostgreSQL.Default.TLSConnect auf verify_ca oder verify_full gesetzt ist

Plugins.PostgreSQL.Default.TLSCertFile

Geben Sie den vollständigen Pfadnamen der Datei an, die das PostgreSQL-Zertifikat oder die Zertifikatskette für verschlüsselte Kommunikation zwischen Zabbix Agent 2 und überwachten Datenbanken enthält.
Wird verwendet, wenn in einer benannten Sitzung kein Wert angegeben ist.

Erforderlich: yes, wenn Plugins.PostgreSQL.Default.TLSKeyFile angegeben ist

Plugins.PostgreSQL.Default.TLSConnect

Geben Sie den standardmäßigen Verschlüsselungsgrad für die Kommunikation zwischen Zabbix Agent 2 und den überwachten Datenbanken an.
Wird verwendet, wenn in einer benannten Sitzung kein Wert angegeben ist.

Bereich:
required - Verbindung mit TLS als Transportmodus ohne Identitätsprüfung herstellen;
verify_ca - Verbindung mit TLS herstellen und das Zertifikat überprüfen;
verify_full - Verbindung mit TLS herstellen, das Zertifikat überprüfen und verifizieren, dass die von DBHost angegebene Datenbankidentität (CN) mit ihrem Zertifikat übereinstimmt.

Ein nicht definierter Verschlüsselungstyp bedeutet eine unverschlüsselte Verbindung.

Plugins.PostgreSQL.Default.TLSKeyFile

Geben Sie den vollständigen Pfadnamen der Datei an, die den privaten PostgreSQL-Schlüssel für verschlüsselte Kommunikation zwischen Zabbix Agent 2 und überwachten Datenbanken enthält.
Wird verwendet, wenn in einer benannten Sitzung kein Wert angegeben ist.

Erforderlich: yes, wenn Plugins.PostgreSQL.Default.TLSCertFile angegeben ist

Plugins.PostgreSQL.Default.Uri

Geben Sie den Standard-URI für die Verbindung zu PostgreSQL an.
Wird verwendet, wenn in einem Datenpunkt-Schlüssel oder einer benannten Sitzung kein Wert angegeben ist.
Eingebettete Anmeldedaten werden ignoriert.
Muss dem URI-Format entsprechen.
Unterstützte Schemas: tcp, unix

Beispiele:

tcp://127.0.0.1:5432
tcp://localhost
unix:/var/run/postgresql/.s.PGSQL.5432
Plugins.PostgreSQL.Default.User

Geben Sie den Standard-Benutzernamen für die Verbindung zu PostgreSQL an.
Wird verwendet, wenn in einem Datenpunkt-Schlüssel oder einer benannten Sitzung kein Wert angegeben ist.

Plugins.PostgreSQL.KeepAlive

Legt die maximale Wartezeit (in Sekunden) fest, bevor ungenutzte Plugin-Verbindungen geschlossen werden.

Plugins.PostgreSQL.Sessions.<SessionName>.CacheMode

Geben Sie den benannten Sitzungscachemodus für die PostgreSQL-Verbindung an.
<SessionName> - definiert den Namen einer Sitzung zur Verwendung in Datenpunkt-Schlüsseln.

Standard: prepare
Bereich:
prepare - erstellt vorbereitete Anweisungen auf dem PostgreSQL-Server;
describe - verwendet die anonyme vorbereitete Anweisung, um eine Anweisung zu beschreiben, ohne eine Anweisung auf dem Server zu erstellen.

Beachten Sie, dass describe vor allem dann nützlich ist, wenn die Umgebung keine vorbereiteten Anweisungen zulässt, z. B. beim Einsatz eines Connection Poolers wie PgBouncer.

Plugins.PostgreSQL.Sessions.<SessionName>.Database

Geben Sie die Datenbank für die benannte Sitzung an, um eine Verbindung zu PostgreSQL herzustellen.
<SessionName> - Name einer Sitzung festlegen, die in Datenpunkt-Schlüsseln verwendet wird.

Plugins.PostgreSQL.Sessions.<SessionName>.Password

Geben Sie das Passwort für die benannte Sitzung an, um eine Verbindung zu PostgreSQL herzustellen.
<SessionName> - Definieren Sie den Namen einer Sitzung zur Verwendung in Datenpunktschlüsseln.
Muss dem Passwortformat entsprechen.

Plugins.PostgreSQL.Sessions.<SessionName>.TLSCAFile

Geben Sie den vollständigen Pfadnamen der Datei an, die das Zertifikat der obersten CA(s) für die Überprüfung des Peer-Zertifikats bei verschlüsselter Kommunikation zwischen Zabbix Agent 2 und den überwachten Datenbanken enthält.
<SessionName> - definiert den Namen einer Sitzung zur Verwendung in Datenpunkt-Schlüsseln.

Pflicht: yes, wenn Plugins.PostgreSQL.Sessions.<SessionName>.TLSConnect auf verify_ca oder verify_full gesetzt ist

Plugins.PostgreSQL.Sessions.<SessionName>.TLSCertFile

Geben Sie den vollständigen Pfadnamen der Datei an, die das PostgreSQL-Zertifikat oder die Zertifikatskette für verschlüsselte Verbindungen zwischen Zabbix Agent 2 und überwachten Datenbanken enthält.
<SessionName> - definiert den Namen einer Sitzung zur Verwendung in Datenpunkt-Schlüsseln.

Pflicht: yes, wenn Plugins.PostgreSQL.Sessions.<SessionName>.TLSKeyFile angegeben ist

Plugins.PostgreSQL.Sessions.<SessionName>.TLSConnect

Geben Sie die benannte Verschlüsselungsstufe auf Sitzungsebene für die Kommunikation zwischen Zabbix Agent 2 und den überwachten Datenbanken an.
<SessionName> - definiert den Namen einer Sitzung zur Verwendung in Datenpunkt-Schlüsseln.

Bereich:
required - Verbindung über TLS als Transportmodus ohne Identitätsprüfung;
verify_ca - Verbindung über TLS und Zertifikatsprüfung;
verify_full - Verbindung über TLS, Zertifikatsprüfung und Prüfung, dass die von DBHost angegebene Datenbankidentität (CN) mit ihrem Zertifikat übereinstimmt.

Ein nicht definierter Verschlüsselungstyp bedeutet eine unverschlüsselte Verbindung.

Plugins.PostgreSQL.Sessions.<SessionName>.TLSKeyFile

Geben Sie den vollständigen Pfadnamen der Datei an, die den privaten PostgreSQL-Schlüssel für die verschlüsselte Kommunikation zwischen Zabbix Agent 2 und den überwachten Datenbanken enthält.
<SessionName> - definieren Sie den Namen einer Sitzung zur Verwendung in Datenpunkt-Schlüsseln.

Erforderlich: yes, wenn Plugins.PostgreSQL.Sessions.<SessionName>.TLSCertFile angegeben ist.

Plugins.PostgreSQL.Sessions.<SessionName>.Uri

Geben Sie die URI der benannten Sitzung für die Verbindung zu PostgreSQL an.
<SessionName> - definiert den Namen einer Sitzung zur Verwendung in Datenpunkt-Schlüsseln.
Eingebettete Anmeldedaten werden ignoriert.
Muss dem URI-Format entsprechen.
Unterstützte Schemas: tcp, unix

Beispiele:

tcp://127.0.0.1:5432
tcp://localhost
unix:/var/run/postgresql/.s.PGSQL.5432
Plugins.PostgreSQL.Sessions.<SessionName>.User

Geben Sie den Benutzernamen der benannten Sitzung für die Verbindung zu PostgreSQL an.
<SessionName> - Name einer Sitzung definieren, die in Datenpunktschlüsseln verwendet wird.

Plugins.PostgreSQL.System.Path

Geben Sie den Pfad zur ausführbaren Datei des PostgreSQL-Plugins an.

Erforderlich: yes

Beispiel:

Plugins.PostgreSQL.System.Path=/usr/libexec/zabbix/zabbix-agent2-plugin-postgresql
Plugins.PostgreSQL.Timeout

Legt das Timeout für die Ausführung von Anfragen fest (die Dauer in Sekunden, die auf den Abschluss einer Anfrage gewartet wird, bevor sie beendet wird).

Standard: global timeout
Bereich: 1-30

Optionen

Parameter Beschreibung
-V --version Gibt die Plugin-Version und Lizenzinformationen aus.
-h --help Gibt Hilfeinformationen aus (Kurzform).
-t, --test <item key> Startet das Plugin zum Testen (Plugin-Konfiguration wird ignoriert).

Siehe auch