8 MSSQL-Plugin

Übersicht

Dieser Abschnitt listet die Parameter auf, die in der Konfigurationsdatei des MSSQL Zabbix Agent 2-Plugins (mssql.conf) unterstützt werden.

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.
  • 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 Hilfsinformationen aus (Kurzform).

Parameter

Parameter Mandatory Bereich Standard Beschreibung
Plugins.MSSQL.CustomQueriesDir no empty 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 im 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.Default.CACertPath no Der Standard-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 Standardname 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 mit TDS8 verschlüsselt;
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 item keys 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 item keys 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 mit TDS8 verschlüsselt;
disable - die Datenübertragung zwischen Plugin und Server ist nicht verschlüsselt.
<SessionName> - Name einer Sitzung, der in item keys 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 item keys 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 item keys 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 item keys 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 item keys verwendet wird.
Plugins.MSSQL.Sessions.<SessionName>.Uri no sqlserver://localhost:1433 Die URI für die Verbindung für die benannte Sitzung. Das einzige unterstützte Schema ist sqlserver://. Ein Schema kann weggelassen werden. Eingebettete Anmeldedaten werden ignoriert.
<SessionName> - Name einer Sitzung, der in item keys verwendet wird.
Plugins.MSSQL.Sessions.<SessionName>.User no Der Benutzername, der für die benannte Sitzung an einen geschützten MSSQL-Server gesendet werden soll.
<SessionName> - Name einer Sitzung, der in item keys verwendet wird.
Plugins.MSSQL.System.Path no Pfad zur ausführbaren MSSQL-Plugin-Datei.
Globale Einstellung für das MSSQL-Plugin. Wird auf alle Verbindungen angewendet.
Beispiel: Plugins.MSSQL.System.Path=/usr/sbin/zabbix-agent2-plugin/zabbix-agent2-plugin-mssql
Plugins.MSSQL.Timeout no 1-30 global timeout Die Wartezeit in Sekunden, bis ein Server bei der ersten Verbindung und bei nachfolgenden Vorgängen in der Sitzung antwortet.

Siehe auch: