MSSQL-Plugin

Übersicht

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

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

Das MSSQL-Plugin ist ein ladbares Plugin und ist im MSSQL-Plugin-Repository verfügbar und dort 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

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.MSSQL.CustomQueriesDir

Geben Sie den Pfad zum 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 gestoppt.

Standardwerte:
/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)

Plugins.MSSQL.CustomQueriesEnabled

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

Standard: false
Bereich: true/false

Plugins.MSSQL.Default.CACertPath

Geben Sie den Standard-Dateipfad zum öffentlichen Schlüsselszertifikat der Zertifizierungsstelle (CA) an, die das Zertifikat des MSSQL-Servers ausgestellt hat.
Das Zertifikat muss im PEM-Format vorliegen.

Plugins.MSSQL.Default.Database

Geben Sie den Namen der Standarddatenbank an.

Plugins.MSSQL.Default.Encrypt

Geben Sie den Standardverschlüsselungsgrad an.

Bereich:
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 mit TDS8;
disable - die Datenübertragung zwischen Plugin und Server ist nicht verschlüsselt.

Plugins.MSSQL.Default.HostNameInCertificate

Geben Sie standardmäßig den Common Name (CN) des MSSQL-Serverzertifikats an.

Plugins.MSSQL.Default.Password

Geben Sie das Standardkennwort für einen geschützten MSSQL-Server an.

Plugins.MSSQL.Default.TLSMinVersion

Geben Sie standardmäßig die minimale TLS-Version an.

Bereich: 1.0, 1.1, 1.2, 1.3

Plugins.MSSQL.Default.TrustServerCertificate

Das Serverzertifikat standardmäßig vertrauen, ohne es zu validieren.

Bereich: true, false

Plugins.MSSQL.Default.Uri

Geben Sie die Standard-URI für die Verbindung mit dem MSSQL-Server an.
Eingebettete Anmeldedaten werden ignoriert.
Das einzige unterstützte Schema ist sqlserver://.
Das Schema kann weggelassen werden.

Standard: sqlserver://localhost:1433

Plugins.MSSQL.Default.User

Geben Sie den Standard-Benutzernamen für einen geschützten MSSQL-Server an.

Plugins.MSSQL.KeepAlive

Geben Sie die maximale Wartezeit (in Sekunden) an, bevor ungenutzte Plugin-Verbindungen geschlossen werden.

Standard: 300
Bereich: 60-900

Plugins.MSSQL.Sessions.<SessionName>.CACertPath

Geben Sie den Dateipfad der benannten Sitzung zur öffentlichen Schlüsselzertifikatsdatei der Zertifizierungsstelle (CA) an, die das Zertifikat des MSSQL-Servers ausgestellt hat.
<SessionName> - definiert den Namen einer Sitzung zur Verwendung in Datenpunktschlüsseln.
Das Zertifikat muss im PEM-Format vorliegen.

Plugins.MSSQL.Sessions.<SessionName>.Database

Geben Sie den Namen der Datenbank für die benannte Sitzung an.
<SessionName> - definiert den Namen einer Sitzung zur Verwendung in Datenpunktschlüsseln.

Plugins.MSSQL.Sessions.<SessionName>.Encrypt

Gibt den Verschlüsselungsgrad der benannten Sitzung an.
<SessionName> - definiert den Namen einer Sitzung zur Verwendung in Datenpunkt-Schlüsseln.

Bereich:
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.Sessions.<SessionName>.HostNameInCertificate

Geben Sie den Common Name (CN) des MSSQL-Serverzertifikats für die benannte Sitzung an.
<SessionName> - definiert den Namen einer Sitzung zur Verwendung in Datenpunkt-Schlüsseln.

Plugins.MSSQL.Sessions.<SessionName>.Password

Geben Sie das Passwort der benannten Sitzung für einen geschützten MSSQL-Server an.
<SessionName> - Name einer Sitzung, die in Datenpunktschlüsseln verwendet wird.

Plugins.MSSQL.Sessions.<SessionName>.TLSMinVersion

Geben Sie die minimale TLS-Version für die benannte Sitzung an.
<SessionName> - Name einer Sitzung, die in Datenpunkt-Schlüsseln verwendet wird.

Bereich: 1.0, 1.1, 1.2, 1.3

Plugins.MSSQL.Sessions.<SessionName>.TrustServerCertificate

Dem Serverzertifikat der benannten Sitzung vertrauen, ohne es zu validieren.
<SessionName> - Namen einer Sitzung zur Verwendung in Datenpunkt-Schlüsseln definieren.

Bereich: true, false

Plugins.MSSQL.Sessions.<SessionName>.Uri

Geben Sie die URI der benannten Sitzung für die Verbindung zum MSSQL-Server an.
<SessionName> - definiert den Namen einer Sitzung zur Verwendung in Datenpunkt-Schlüsseln.
Eingebettete Anmeldedaten werden ignoriert.
Das einzige unterstützte Schema ist sqlserver://.
Das Schema kann weggelassen werden.

Standard: sqlserver://localhost:1433

Plugins.MSSQL.Sessions.<SessionName>.User

Geben Sie den Benutzernamen der benannten Sitzung für einen geschützten MSSQL-Server an.
<SessionName> - Name einer Sitzung, die in Datenpunkt-Schlüsseln verwendet wird.

Plugins.MSSQL.System.Path

Geben Sie den Pfad zur ausführbaren Datei des MSSQL-Plugins an.
Globale Einstellung für das MSSQL-Plugin. Wird auf alle Verbindungen angewendet.

Beispiel: Plugins.MSSQL.System.Path=/usr/libexec/zabbix/zabbix-agent2-plugin-mssql

Plugins.MSSQL.Timeout

Legt die Dauer in Sekunden fest, die beim ersten Verbindungsaufbau und bei nachfolgenden Vorgängen in der Sitzung auf eine Antwort des Servers gewartet wird.

Standard: global timeout
Bereich: 1-30

Optionen

Siehe auch

• Beschreibung der allgemeinen Konfigurationsparameter von Zabbix Agent 2: Zabbix agent 2 (UNIX) / Zabbix agent 2 (Windows)
• Anweisungen zum Konfigurieren von Plugins