8 MSSQL-Plugin

Übersicht

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

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

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

Beachten Sie:

  • Die Standardwerte entsprechen den Standardwerten des Prozesses, nicht den Werten 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 Anfang der Zeile 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 Verbindlich Bereich Standard Beschreibung
Plugins.MSSQL.CustomQueriesDir nein /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 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 nein false Wenn gesetzt, aktiviert dies die Ausführung des Datenpunktschlüssels mssql.custom.query. Wenn deaktiviert, werden keine Abfragen aus dem Verzeichnispfad für benutzerdefinierte Abfragen geladen.
Plugins.MSSQL.Default.CACertPath nein Der Standard-Dateipfad zum Zertifikat des öffentlichen Schlüssels der Zertifizierungsstelle (CA), die das Zertifikat des MSSQL-Servers ausgestellt hat. Das Zertifikat muss im PEM-Format vorliegen.
Plugins.MSSQL.Default.Database nein Der Standardname der Datenbank, zu der eine Verbindung hergestellt wird.
Plugins.MSSQL.Default.Encrypt nein Gibt den Standardtyp der Verbindungsverschlüsselung 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 Anmeldepaket 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 nein Der Common Name (CN) des Zertifikats des MSSQL-Servers als Standardwert.
Plugins.MSSQL.Default.Password nein Das Passwort, das standardmäßig an einen geschützten MSSQL-Server gesendet wird.
Plugins.MSSQL.Default.TLSMinVersion nein Die standardmäßig zu verwendende minimale TLS-Version. Mögliche Werte sind: 1.0, 1.1, 1.2, 1.3.
Plugins.MSSQL.Default.TrustServerCertificate nein Gibt an, ob das Plugin dem Serverzertifikat standardmäßig vertrauen soll, ohne es zu validieren. Mögliche Werte: true, false.
Plugins.MSSQL.Default.Uri nein sqlserver://localhost:1433 Die Standard-URI für die Verbindung. Das einzige unterstützte Schema ist sqlserver://. Ein Schema kann weggelassen werden. Eingebettete Zugangsdaten werden ignoriert.
Plugins.MSSQL.Default.User nein Der Standardbenutzername, der an einen geschützten MSSQL-Server gesendet wird.
Plugins.MSSQL.KeepAlive nein 60-900 300 Die maximale Wartezeit (in Sekunden), bevor ungenutzte Plugin-Verbindungen geschlossen werden.
Plugins.MSSQL.Sessions.<SessionName>.CACertPath nein Der Dateipfad zum Zertifikat des öffentlichen Schlüssels der Zertifizierungsstelle (CA), die das Zertifikat des MSSQL-Servers für die benannte Sitzung ausgestellt hat. Das Zertifikat muss im PEM-Format vorliegen.
<SessionName> - definiert den Namen einer Sitzung zur Verwendung in Datenpunktschlüsseln.
Plugins.MSSQL.Sessions.<SessionName>.Database nein Der Name der Datenbank, zu der für die benannte Sitzung eine Verbindung hergestellt wird.
<SessionName> - definiert den Namen einer Sitzung zur Verwendung in Datenpunktschlüsseln.
Plugins.MSSQL.Sessions.<SessionName>.Encrypt nein Gibt den Typ der Verbindungsverschlüsselung 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 Anmeldepaket 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> - definiert den Namen einer Sitzung zur Verwendung in Datenpunktschlüsseln.
Plugins.MSSQL.Sessions.<SessionName>.HostNameInCertificate nein Der Common Name (CN) des Zertifikats des MSSQL-Servers für die benannte Sitzung.
<SessionName> - definiert den Namen einer Sitzung zur Verwendung in Datenpunktschlüsseln.
Plugins.MSSQL.Sessions.<SessionName>.Password nein Das Passwort, das für die benannte Sitzung an einen geschützten MSSQL-Server gesendet wird.
<SessionName> - definiert den Namen einer Sitzung zur Verwendung in Datenpunktschlüsseln.
Plugins.MSSQL.Sessions.<SessionName>.TLSMinVersion nein Die für die benannte Sitzung zu verwendende minimale TLS-Version. Mögliche Werte sind: 1.0, 1.1, 1.2, 1.3.
<SessionName> - definiert den Namen einer Sitzung zur Verwendung in Datenpunktschlüsseln.
Plugins.MSSQL.Sessions.<SessionName>.TrustServerCertificate nein Gibt an, ob das Plugin dem Serverzertifikat für die benannte Sitzung vertrauen soll, ohne es zu validieren. Mögliche Werte: true, false.
<SessionName> - definiert den Namen einer Sitzung zur Verwendung in Datenpunktschlüsseln.
Plugins.MSSQL.Sessions.<SessionName>.Uri nein 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 Zugangsdaten werden ignoriert.
<SessionName> - definiert den Namen einer Sitzung zur Verwendung in Datenpunktschlüsseln.
Plugins.MSSQL.Sessions.<SessionName>.User nein Der Benutzername, der für die benannte Sitzung an einen geschützten MSSQL-Server gesendet wird.
<SessionName> - definiert den Namen einer Sitzung zur Verwendung in Datenpunktschlüsseln.
Plugins.MSSQL.System.Path nein Pfad zur ausführbaren Datei des MSSQL-Plugins.
Globale Einstellung für das MSSQL-Plugin. Wird auf alle Verbindungen angewendet.
Beispiel für die Verwendung: Plugins.MSSQL.System.Path=/usr/libexec/zabbix/zabbix-agent2-plugin-mssql
Plugins.MSSQL.Timeout nein 1-30 globales Timeout Die Zeitdauer in Sekunden, die beim ersten Verbindungsaufbau und bei nachfolgenden Operationen in der Sitzung auf eine Antwort des Servers gewartet wird.

Siehe auch: