MQTT-Plugin

Übersicht

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

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

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 Standardwerte des Prozesses 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.MQTT.Default.Password

Geben Sie das Standardpasswort für die Verbindung zu MQTT an.
Wird verwendet, wenn in einem Datenpunkt-Schlüssel oder einer benannten Sitzung kein Wert angegeben ist.

Plugins.MQTT.Default.TLSCAFile

Geben Sie den vollständigen Pfadnamen der Datei an, die die CA-Zertifikate der obersten Ebene für die Überprüfung des Peer-Zertifikats bei verschlüsselter Kommunikation zwischen Zabbix Agent 2 und dem MQTT-Broker enthält.
Wird verwendet, wenn in einer benannten Sitzung kein Wert angegeben ist.

Plugins.MQTT.Default.TLSCertFile

Geben Sie den vollständigen Pfadnamen der Datei an, die das Agent-Zertifikat oder die Zertifikatskette für verschlüsselte Kommunikation zwischen Zabbix Agent 2 und dem MQTT-Broker enthält.
Wird verwendet, wenn in einer benannten Sitzung kein Wert angegeben ist.

Plugins.MQTT.Default.TLSKeyFile

Geben Sie den vollständigen Pfadnamen der Datei an, die den privaten MQTT-Schlüssel für die verschlüsselte Kommunikation zwischen Zabbix Agent 2 und dem MQTT-Broker enthält.
Wird verwendet, wenn in einer benannten Sitzung kein Wert angegeben ist.

Plugins.MQTT.Default.Topic

Geben Sie das Standard-Topic für das MQTT-Subscription an.
Wird verwendet, wenn im Datenpunkt-Schlüssel oder in der benannten Sitzung kein Wert angegeben ist.
Das Topic kann Platzhalter enthalten ("+","#").

Beispiele:

path/to/file
path/to/#
path/+/topic

Plugins.MQTT.Default.Url

Geben Sie die Standard-Verbindungszeichenfolge für den MQTT-Broker an.
Wird verwendet, wenn in einem Datenpunkt-Schlüssel oder einer benannten Sitzung kein Wert angegeben ist.
Sollte keine Abfrageparameter enthalten.
Muss dem URL-Format entsprechen.
Unterstützte Schemas: tcp (Standard), ws, tls
Ein Schema kann weggelassen werden.
Ein Port kann weggelassen werden (Standard=1883)

Standard: tcp://localhost:1883

Beispiele:

tcp://host:1883
localhost
ws://host:8080

Plugins.MQTT.Default.User

Geben Sie den Standard-Benutzernamen für die Verbindung zu MQTT an.
Wird verwendet, wenn im Datenpunkt-Schlüssel oder in einer benannten Sitzung kein Wert angegeben ist.

Plugins.MQTT.Sessions.<SessionName>.Password

Geben Sie das Passwort der benannten Sitzung für die Verbindung zu MQTT an.
<SessionName> - Name einer Sitzung, der in Datenpunkt-Schlüsseln verwendet wird.

Plugins.MQTT.Sessions.<SessionName>.TLSCAFile

Geben Sie den vollständigen Pfadnamen der Datei an, die die Zertifikate der obersten CA(s) für die Überprüfung des Peer-Zertifikats für die benannte Sitzung enthält und für verschlüsselte Kommunikation zwischen Zabbix Agent 2 und dem MQTT-Broker verwendet wird.
<SessionName> - definiert den Namen einer Sitzung zur Verwendung in Datenpunkt-Schlüsseln.

Plugins.MQTT.Sessions.<SessionName>.TLSCertFile

Geben Sie den vollständigen Pfad zur Datei an, die das Agent-Zertifikat oder die Zertifikatskette für die benannte Sitzung enthält. Diese wird für verschlüsselte Kommunikation zwischen Zabbix Agent 2 und dem MQTT-Broker verwendet.
<SessionName> - definiert den Namen einer Sitzung zur Verwendung in Datenpunkt-Schlüsseln.

Plugins.MQTT.Sessions.<SessionName>.TLSKeyFile

Geben Sie den vollständigen Pfadnamen der Datei an, die den MQTT-privaten Schlüssel für die benannte Sitzung enthält und für verschlüsselte Kommunikation zwischen Zabbix Agent 2 und dem MQTT-Broker verwendet wird.
<SessionName> - definiert den Namen einer Sitzung zur Verwendung in Datenpunkt-Schlüsseln.

Plugins.MQTT.Sessions.<SessionName>.Topic

Geben Sie das benannte Sitzungsthema für das MQTT-Subscription an.
<SessionName> - Name einer Sitzung für die Verwendung in Datenpunkt-Schlüsseln definieren.
Das Thema kann Platzhalter ("+","#") enthalten.

Beispiele:

path/to/file
path/to/#
path/+/topic

Plugins.MQTT.Sessions.<SessionName>.Url

Geben Sie die Verbindungszeichenfolge des MQTT-Brokers für die benannte Sitzung an.
<SessionName> - Name einer Sitzung definieren, der in Datenpunkt-Schlüsseln verwendet wird.
Darf keine Abfrageparameter enthalten.
Muss dem URL-Format entsprechen.
Unterstützte Schemas: tcp (Standard), ws, tls
Ein Schema kann weggelassen werden.
Ein Port kann weggelassen werden (Standard=1883)

Standard: tcp://localhost:1883

Beispiele:

tcp://host:1883
localhost
ws://host:8080

Plugins.MQTT.Sessions.<SessionName>.User

Geben Sie den Benutzernamen der benannten Sitzung für die Verbindung zu MQTT an.
<SessionName> - Name einer Sitzung definieren, die in Datenpunkt-Schlüsseln verwendet wird.

Wenn Sie das Timeout für die Ausführung von Anfragen festlegen müssen (also wie lange auf den Abschluss einer Anfrage gewartet werden soll, bevor sie beendet wird), verwenden Sie das Formular Datenpunktkonfiguration.

Siehe auch

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