8 MSSQL-Plugin

Übersicht

Die Konfigurationsdatei des Zabbix Agent 2 wird zur Konfiguration von Plugins verwendet. Diese Konfigurationsparameter des Zabbix Agent 2 werden für den Betrieb des MSSQL-Plugins unterstützt.

Es wird empfohlen, sie in einer eigenen Konfigurationsdatei (z. B. mssql.conf) anzugeben und anschließend die Direktive Include zu verwenden, um diese Datei zur Konfiguration des Zabbix Agent 2 hinzuzufügen.

Das MSSQL-Plugin ist ein ladbares Plugin und ist im MSSQL plugin repository verfügbar und dort vollständig beschrieben.

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.

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).

Parameter

Parameter Mandatory Range Default Beschreibung
Plugins.MSSQL.CustomQueriesDir no /usr/local/share/zabbix/custom-queries/mssql für Unix-Systeme

*:\Program Files\Zabbix Agent 2\Custom Queries\MSSQL für Windows-Systeme, wobei * der Laufwerksname aus der Umgebungsvariable ProgramFiles ist		 Gibt den Dateipfad zu einem Verzeichnis an, das vom Benutzer definierte .sql-Dateien mit benutzerdefinierten Abfragen enthält, die das Plugin ausführen kann. Das Plugin lädt beim Start alle verfügbaren .sql-Dateien aus dem konfigurierten Verzeichnis. Das bedeutet, dass Änderungen an den Dateien mit benutzerdefinierten Abfragen erst nach einem Neustart des Plugins wirksam werden. Das Plugin wird zusammen mit Zabbix Agent 2 gestartet und gestoppt.
Plugins.MSSQL.CustomQueriesEnabled no false Wenn gesetzt, wird die Ausführung des Datenpunktschlüssels mssql.custom.query aktiviert. Wenn deaktiviert, werden keine Abfragen aus dem Pfad des Verzeichnisses für benutzerdefinierte Abfragen geladen.
Plugins.MSSQL.Default.CACertPath no Der standardmäßige Dateipfad zum öffentlichen Schlüsselzertifikat der Zertifizierungsstelle (CA), die das Zertifikat des MSSQL-Servers ausgestellt hat. Das Zertifikat muss im PEM-Format vorliegen.
Plugins.MSSQL.Default.Database no Der standardmäßige Name der Datenbank, zu der eine Verbindung hergestellt werden soll.
Plugins.MSSQL.Default.Encrypt no Gibt den standardmäßigen Verschlüsselungstyp der Verbindung an. Mögliche Werte sind:
true - die Datenübertragung zwischen Plugin und Server ist verschlüsselt;
false - die Datenübertragung zwischen Plugin und Server ist über das Login-Paket hinaus nicht verschlüsselt;
strict - die Datenübertragung zwischen Plugin und Server ist Ende-zu-Ende verschlüsselt unter Verwendung von TDS8;
disable - die Datenübertragung zwischen Plugin und Server ist nicht verschlüsselt.
Plugins.MSSQL.Default.HostNameInCertificate no Der Common Name (CN) des Zertifikats des MSSQL-Servers standardmäßig.
Plugins.MSSQL.Default.Password no Das standardmäßig an einen geschützten MSSQL-Server zu sendende Passwort.
Plugins.MSSQL.Default.TLSMinVersion no Die standardmäßig zu verwendende minimale TLS-Version. Mögliche Werte sind: 1.0, 1.1, 1.2, 1.3.
Plugins.MSSQL.Default.TrustServerCertificate no Gibt an, ob das Plugin dem Serverzertifikat standardmäßig ohne Validierung vertrauen soll. Mögliche Werte: true, false.
Plugins.MSSQL.Default.Uri no sqlserver://localhost:1433 Die standardmäßige URI für die Verbindung. Das einzige unterstützte Schema ist sqlserver://. Ein Schema kann weggelassen werden. Eingebettete Anmeldedaten werden ignoriert.
Plugins.MSSQL.Default.User no Der standardmäßig an einen geschützten MSSQL-Server zu sendende Benutzername.
Plugins.MSSQL.KeepAlive no 60-900 300 Die maximale Wartezeit (in Sekunden), bevor ungenutzte Plugin-Verbindungen geschlossen werden.
Plugins.MSSQL.Sessions.<SessionName>.CACertPath no Der Dateipfad zum öffentlichen Schlüsselzertifikat der Zertifizierungsstelle (CA), die das Zertifikat des MSSQL-Servers für die benannte Sitzung ausgestellt hat. Das Zertifikat muss im PEM-Format vorliegen.
<SessionName> - Name einer Sitzung, der in Datenpunktschlüsseln verwendet wird.
Plugins.MSSQL.Sessions.<SessionName>.Database no Der Name der Datenbank, zu der für die benannte Sitzung eine Verbindung hergestellt werden soll.
<SessionName> - Name einer Sitzung, der in Datenpunktschlüsseln verwendet wird.
Plugins.MSSQL.Sessions.<SessionName>.Encrypt no Gibt den Verschlüsselungstyp der Verbindung für die benannte Sitzung an. Mögliche Werte sind:
true - die Datenübertragung zwischen Plugin und Server ist verschlüsselt;
false - die Datenübertragung zwischen Plugin und Server ist über das Login-Paket hinaus nicht verschlüsselt;
strict - die Datenübertragung zwischen Plugin und Server ist Ende-zu-Ende verschlüsselt unter Verwendung von TDS8;
disable - die Datenübertragung zwischen Plugin und Server ist nicht verschlüsselt.
<SessionName> - Name einer Sitzung, der in Datenpunktschlüsseln verwendet wird.
Plugins.MSSQL.Sessions.<SessionName>.HostNameInCertificate no Der Common Name (CN) des Zertifikats des MSSQL-Servers für die benannte Sitzung.
<SessionName> - Name einer Sitzung, der in Datenpunktschlüsseln verwendet wird.
Plugins.MSSQL.Sessions.<SessionName>.Password no Das an einen geschützten MSSQL-Server für die benannte Sitzung zu sendende Passwort.
<SessionName> - Name einer Sitzung, der in Datenpunktschlüsseln verwendet wird.
Plugins.MSSQL.Sessions.<SessionName>.TLSMinVersion no Die für die benannte Sitzung zu verwendende minimale TLS-Version. Mögliche Werte sind: 1.0, 1.1, 1.2, 1.3.
<SessionName> - Name einer Sitzung, der in Datenpunktschlüsseln verwendet wird.
Plugins.MSSQL.Sessions.<SessionName>.TrustServerCertificate no Gibt an, ob das Plugin dem Serverzertifikat für die benannte Sitzung ohne Validierung vertrauen soll. Mögliche Werte: true, false.
<SessionName> - Name einer Sitzung, der in Datenpunktschlüsseln verwendet wird.
Plugins.MSSQL.Sessions.<SessionName>.Uri no sqlserver://localhost:1433 Die URI für die Verbindung der benannten Sitzung. Das einzige unterstützte Schema ist sqlserver://. Ein Schema kann weggelassen werden. Eingebettete Anmeldedaten werden ignoriert.
<SessionName> - Name einer Sitzung, der in Datenpunktschlüsseln verwendet wird.
Plugins.MSSQL.Sessions.<SessionName>.User no Der Benutzername, der an einen geschützten MSSQL-Server für die benannte Sitzung gesendet wird.
<SessionName> - Name einer Sitzung, der in Datenpunktschlüsseln verwendet wird.
Plugins.MSSQL.System.Path no Pfad zur ausführbaren Datei des MSSQL-Plugins.
Globale Einstellung für das MSSQL-Plugin. Wird auf alle Verbindungen angewendet.
Beispielverwendung: Plugins.MSSQL.System.Path=/usr/libexec/zabbix/zabbix-agent2-plugin-mssql
Plugins.MSSQL.Timeout no 1-30 global timeout Die Zeitspanne in Sekunden, die beim ersten Verbindungsaufbau und bei nachfolgenden Vorgängen in der Sitzung auf eine Antwort des Servers gewartet wird.

Siehe auch: