Plugin MQTT

Panoramica

I parametri di configurazione consentono di personalizzare il comportamento del plugin MQTT.

Si consiglia di specificarli in un file di configurazione separato (ad esempio mqtt.conf), anziché nel file di configurazione di agent 2. Utilizzare quindi la direttiva Include per includere questo file nella configurazione di Zabbix agent 2.

Tutti i parametri sono facoltativi, a meno che non sia esplicitamente indicato che il parametro è obbligatorio.

Questa pagina è strutturata come segue:

• Panoramica dei parametri (per vedere i dettagli completi di un parametro, fare clic sul suo nome)
• Dettagli dei parametri

Si noti che:

• I valori predefiniti riflettono i valori predefiniti del processo, non i valori presenti nei file di configurazione distribuiti;
• I valori supportano variabili di ambiente;
• Zabbix supporta i file di configurazione solo in codifica UTF-8 senza BOM;
• I commenti che iniziano con "#" sono supportati solo all'inizio della riga.

Dettagli del parametro

Plugins.MQTT.Default.Password

Specifica la password predefinita per la connessione a MQTT.
Utilizzata se non viene specificato alcun valore in una chiave item o in una sessione denominata.

Plugins.MQTT.Default.TLSCAFile

Specifica il percorso completo del file contenente i certificati CA di livello superiore per la verifica del certificato del peer nelle comunicazioni crittografate tra Zabbix agent 2 e il broker MQTT.
Utilizzato se non è specificato alcun valore in una sessione denominata.

Plugins.MQTT.Default.TLSCertFile

Specifica il percorso completo del file contenente il certificato dell'agent o la catena di certificati per le comunicazioni crittografate tra Zabbix agent 2 e il broker MQTT.
Utilizzato se non è specificato alcun valore in una sessione denominata.

Plugins.MQTT.Default.TLSKeyFile

Specificare il percorso completo del file contenente la chiave privata MQTT per le comunicazioni crittografate tra Zabbix agent 2 e il broker MQTT.
Utilizzato se non viene specificato alcun valore in una sessione denominata.

Plugins.MQTT.Default.Topic

Specifica il topic predefinito per la sottoscrizione MQTT.
Utilizzato se non viene specificato alcun valore in una chiave item o in una sessione denominata.
Il topic può contenere caratteri jolly ("+","#").

Esempi:

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

Plugins.MQTT.Default.Url

Specifica la stringa di connessione predefinita del broker MQTT.
Usata se non è specificato alcun valore in una chiave item o in una sessione denominata.
Non deve includere parametri di query.
Deve corrispondere al formato URL.
Schemi supportati: tcp (predefinito), ws, tls
Uno schema può essere omesso.
Una porta può essere omessa (predefinita=1883)

Predefinito: tcp://localhost:1883

Esempi:

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

Plugins.MQTT.Default.User

Specifica il nome utente predefinito per la connessione a MQTT.
Utilizzato se non viene specificato alcun valore in una chiave item o in una sessione denominata.

Plugins.MQTT.Sessions.<SessionName>.Password

Specifica la password della sessione denominata per la connessione a MQTT.
<SessionName> - definisce il nome di una sessione da utilizzare nelle chiavi degli item.

Plugins.MQTT.Sessions.<SessionName>.TLSCAFile

Specifica il percorso completo del file contenente i certificati CA di livello superiore per la verifica del certificato del peer per la sessione specificata, utilizzato per le comunicazioni crittografate tra Zabbix agent 2 e il broker MQTT.
<SessionName> - definisce il nome di una sessione da usare nelle chiavi degli item.

Plugins.MQTT.Sessions.<SessionName>.TLSCertFile

Specifica il percorso completo del file contenente il certificato dell'agent o la catena di certificati per la sessione specificata, utilizzato per le comunicazioni crittografate tra Zabbix agent 2 e il broker MQTT.
<SessionName> - definisce il nome di una sessione da usare nelle chiavi degli item.

Plugins.MQTT.Sessions.<SessionName>.TLSKeyFile

Specificare il percorso completo del file contenente la chiave privata MQTT per la sessione nominata, utilizzata per le comunicazioni crittografate tra Zabbix agent 2 e il broker MQTT.
<SessionName> - definire il nome di una sessione da usare nelle chiavi degli item.

Plugins.MQTT.Sessions.<SessionName>.Topic

Specifica il topic della sessione denominata per la sottoscrizione MQTT.
<SessionName> - definisce il nome di una sessione da usare nelle chiavi degli item.
Il topic può contenere caratteri jolly ("+","#").

Esempi:

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

Plugins.MQTT.Sessions.<SessionName>.Url

Specifica la stringa di connessione al broker MQTT della sessione denominata.
<SessionName> - definisce il nome di una sessione da usare nelle chiavi degli item.
Non deve includere parametri di query.
Deve corrispondere al formato URL.
Schemi supportati: tcp (predefinito), ws, tls
Uno schema può essere omesso.
Una porta può essere omessa (predefinita=1883)

Predefinito: tcp://localhost:1883

Esempi:

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

Plugins.MQTT.Sessions.<SessionName>.User

Specifica il nome utente della sessione denominata per la connessione a MQTT.
<SessionName> - definisce il nome di una sessione da usare nelle chiavi degli item.

Se è necessario impostare il timeout di esecuzione della richiesta (per quanto tempo attendere il completamento di una richiesta prima di interromperla), utilizzare il modulo configurazione dell'item.

Vedi anche

• Descrizione dei parametri di configurazione generali di Zabbix agent 2: Zabbix agent 2 (UNIX) / Zabbix agent 2 (Windows)
• Istruzioni per la configurazione dei plugin