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

Parameter

Parameter Mandatory Range Default Description
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 benutzerdefinierte .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 beendet.
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 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 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 mit TDS8 verschlüsselt;
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 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 Datenpunktschlüsseln verwendet wird.
Plugins.MSSQL.Sessions.<SessionName>.User no Der an einen geschützten MSSQL-Server für die benannte Sitzung zu sendende Benutzername.
<SessionName> - Name einer Sitzung, der in Datenpunktschlüsseln 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.
Beispielverwendung: Plugins.MSSQL.System.Path=/usr/libexec/zabbix/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: