Complemento MQTT

Resumen

Los parámetros de configuración permiten personalizar el comportamiento del plugin MQTT.

Se recomienda especificarlos en su propio archivo de configuración (por ejemplo, mqtt.conf), en lugar de en el archivo de configuración de agent 2. Luego use la directiva Include para incluir este archivo en la configuración de Zabbix agent 2.

Todos los parámetros son opcionales, salvo que se indique explícitamente que el parámetro es obligatorio.

Esta página está estructurada de la siguiente manera:

  • Resumen de parámetros (para ver los detalles completos de un parámetro, haga clic en su nombre)
  • Detalles de los parámetros
Parameter Description
Plugins.MQTT.Default.Password Especifique la contraseña predeterminada para conectarse a MQTT.
Plugins.MQTT.Default.TLSCAFile Especifique la ruta completa del archivo que contiene los certificados de la(s) CA de nivel superior para la verificación del certificado del par.
Plugins.MQTT.Default.TLSCertFile Especifique la ruta completa del archivo que contiene el certificado del agent o la cadena de certificados.
Plugins.MQTT.Default.TLSKeyFile Especifique la ruta completa del archivo que contiene la clave privada de MQTT.
Plugins.MQTT.Default.Topic Especifique el tema predeterminado para la suscripción MQTT.
Plugins.MQTT.Default.Url Especifique la cadena de conexión predeterminada del broker MQTT.
Plugins.MQTT.Default.User Especifique el nombre de usuario predeterminado para conectarse a MQTT.
Plugins.MQTT.Sessions.<SessionName>.Password Especifique la contraseña de la sesión con nombre para conectarse a MQTT.
Plugins.MQTT.Sessions.<SessionName>.TLSCAFile Especifique la ruta completa del archivo que contiene los certificados de la(s) CA de nivel superior para la verificación del certificado del par para la sesión con nombre.
Plugins.MQTT.Sessions.<SessionName>.TLSCertFile Especifique la ruta completa del archivo que contiene el certificado del agent o la cadena de certificados para la sesión con nombre.
Plugins.MQTT.Sessions.<SessionName>.TLSKeyFile Especifique la ruta completa del archivo que contiene la clave privada de MQTT para la sesión con nombre.
Plugins.MQTT.Sessions.<SessionName>.Topic Especifique el tema de la sesión con nombre para la suscripción MQTT.
Plugins.MQTT.Sessions.<SessionName>.Url Especifique la cadena de conexión del broker MQTT para la sesión con nombre.
Plugins.MQTT.Sessions.<SessionName>.User Especifique el nombre de usuario de la sesión con nombre para conectarse a MQTT.

Tenga en cuenta que:

  • Los valores predeterminados reflejan los valores predeterminados del proceso, no los valores de los archivos de configuración suministrados;
  • Los valores admiten variables de entorno;
  • Zabbix solo admite archivos de configuración en codificación UTF-8 sin BOM;
  • Los comentarios que comienzan con "#" solo se admiten al principio de la línea.

Detalles del parámetro

Plugins.MQTT.Default.Password

Especifique la contraseña predeterminada para conectarse a MQTT.
Se usa si no se especifica ningún valor en una clave de item o en una sesión con nombre.

Plugins.MQTT.Default.TLSCAFile

Especifique la ruta completa del archivo que contiene los certificados de CA de nivel superior para la verificación del certificado del par en las comunicaciones cifradas entre Zabbix agent 2 y el broker MQTT.
Se usa si no se especifica ningún valor en una sesión con nombre.

Plugins.MQTT.Default.TLSCertFile

Especifique la ruta completa del archivo que contiene el certificado del agent o la cadena de certificados para las comunicaciones cifradas entre Zabbix agent 2 y el broker MQTT.
Se usa si no se especifica ningún valor en una sesión con nombre.

Plugins.MQTT.Default.TLSKeyFile

Especifique la ruta completa del archivo que contiene la clave privada de MQTT para las comunicaciones cifradas entre Zabbix agent 2 y el broker MQTT.
Se usa si no se especifica ningún valor en una sesión con nombre.

Plugins.MQTT.Default.Topic

Especifique el tema predeterminado para la suscripción MQTT.
Se usa si no se especifica ningún valor en una clave de item o en una sesión con nombre.
El tema puede contener comodines ("+","#").

Ejemplos:

path/to/file
path/to/#
path/+/topic
Plugins.MQTT.Default.Url

Especifica la cadena de conexión predeterminada del broker MQTT.
Se usa si no se especifica ningún valor en una clave de item o en una sesión con nombre.
No debe incluir parámetros de consulta.
Debe coincidir con el formato de URL.
Esquemas admitidos: tcp (predeterminado), ws, tls
Se puede omitir un esquema.
Se puede omitir un puerto (predeterminado=1883)

Predeterminado: tcp://localhost:1883

Ejemplos:

tcp://host:1883
localhost
ws://host:8080
Plugins.MQTT.Default.User

Especifica el nombre de usuario predeterminado para conectarse a MQTT.
Se usa si no se especifica ningún valor en una clave de item o en una sesión con nombre.

Plugins.MQTT.Sessions.<SessionName>.Password

Especifique la contraseña de la sesión con nombre para conectarse a MQTT.
<SessionName> - defina el nombre de una sesión para usarlo en las claves de item.

Plugins.MQTT.Sessions.<SessionName>.TLSCAFile

Especifique la ruta completa del archivo que contiene los certificados de CA de nivel superior para la verificación del certificado del par para la sesión nombrada, utilizado para las comunicaciones cifradas entre Zabbix agent 2 y el broker MQTT.
<SessionName> - define el nombre de una sesión para usarlo en las claves de item.

Plugins.MQTT.Sessions.<SessionName>.TLSCertFile

Especifique la ruta completa del archivo que contiene el certificado del agent o la cadena de certificados para la sesión especificada, utilizado para las comunicaciones cifradas entre Zabbix agent 2 y el broker MQTT.
<SessionName> - defina el nombre de una sesión para usarlo en las claves de item.

Plugins.MQTT.Sessions.<SessionName>.TLSKeyFile

Especifique la ruta completa del archivo que contiene la clave privada de MQTT para la sesión indicada, utilizada para las comunicaciones cifradas entre Zabbix agent 2 y el broker MQTT.
<SessionName> - defina el nombre de una sesión para usarlo en las claves de item.

Plugins.MQTT.Sessions.<SessionName>.Topic

Especifique el tema de la sesión con nombre para la suscripción MQTT.
<SessionName> - defina el nombre de una sesión para usarlo en las claves de item.
El tema puede contener comodines ("+","#").

Ejemplos:

path/to/file
path/to/#
path/+/topic
Plugins.MQTT.Sessions.<SessionName>.Url

Especifica la cadena de conexión del broker MQTT para la sesión con nombre.
<SessionName> - define el nombre de una sesión para usarlo en las claves de item.
No debe incluir parámetros de consulta.
Debe coincidir con el formato de URL.
Esquemas admitidos: tcp (predeterminado), ws, tls
Se puede omitir un esquema.
Se puede omitir un puerto (predeterminado=1883)

Predeterminado: tcp://localhost:1883

Ejemplos:

tcp://host:1883
localhost
ws://host:8080
Plugins.MQTT.Sessions.<SessionName>.User

Especifica el nombre de usuario de la sesión con nombre para conectarse a MQTT.
<SessionName> - define el nombre de una sesión para usar en las claves de item.

Si necesita establecer el tiempo de espera de ejecución de la solicitud (cuánto tiempo esperar a que una solicitud se complete antes de cerrarla), use el formulario de configuración del item.

Véase también