Plugin MQTT

Vue d'ensemble

Les paramètres de configuration permettent de personnaliser le comportement du plugin MQTT.

Il est recommandé de les spécifier dans leur propre fichier de configuration (par exemple mqtt.conf), plutôt que dans le fichier de configuration de l'agent 2. Utilisez ensuite la directive Include pour inclure ce fichier dans la configuration de Zabbix agent 2.

Tous les paramètres sont facultatifs, sauf indication explicite que le paramètre est obligatoire.

Cette page est structurée comme suit :

  • Vue d'ensemble des paramètres (pour voir tous les détails d'un paramètre, cliquez sur son nom)
  • Détails des paramètres
Parameter Description
Plugins.MQTT.Default.Password Spécifie le mot de passe par défaut pour la connexion à MQTT.
Plugins.MQTT.Default.TLSCAFile Spécifie le chemin complet du fichier contenant le ou les certificats de l'AC racine pour la vérification du certificat du pair.
Plugins.MQTT.Default.TLSCertFile Spécifie le chemin complet du fichier contenant le certificat de l'agent ou la chaîne de certificats.
Plugins.MQTT.Default.TLSKeyFile Spécifie le chemin complet du fichier contenant la clé privée MQTT.
Plugins.MQTT.Default.Topic Spécifie le topic par défaut pour l'abonnement MQTT.
Plugins.MQTT.Default.Url Spécifie la chaîne de connexion par défaut au broker MQTT.
Plugins.MQTT.Default.User Spécifie le nom d'utilisateur par défaut pour la connexion à MQTT.
Plugins.MQTT.Sessions.<SessionName>.Password Spécifie le mot de passe de la session nommée pour la connexion à MQTT.
Plugins.MQTT.Sessions.<SessionName>.TLSCAFile Spécifie le chemin complet du fichier contenant le ou les certificats de l'AC racine pour la vérification du certificat du pair pour la session nommée.
Plugins.MQTT.Sessions.<SessionName>.TLSCertFile Spécifie le chemin complet du fichier contenant le certificat de l'agent ou la chaîne de certificats pour la session nommée.
Plugins.MQTT.Sessions.<SessionName>.TLSKeyFile Spécifie le chemin complet du fichier contenant la clé privée MQTT pour la session nommée.
Plugins.MQTT.Sessions.<SessionName>.Topic Spécifie le topic de la session nommée pour l'abonnement MQTT.
Plugins.MQTT.Sessions.<SessionName>.Url Spécifie la chaîne de connexion au broker MQTT pour la session nommée.
Plugins.MQTT.Sessions.<SessionName>.User Spécifie le nom d'utilisateur de la session nommée pour la connexion à MQTT.

Notez que :

  • Les valeurs par défaut reflètent les valeurs par défaut du processus, et non celles des fichiers de configuration fournis ;
  • Les valeurs prennent en charge les variables d'environnement ;
  • Zabbix ne prend en charge les fichiers de configuration qu'en encodage UTF-8 sans BOM ;
  • Les commentaires commençant par "#" ne sont pris en charge qu'au début de la ligne.

Détails du paramètre

Plugins.MQTT.Default.Password

Spécifiez le mot de passe par défaut pour la connexion à MQTT.
Utilisé si aucune valeur n'est spécifiée dans une clé d'élément ou une session nommée.

Plugins.MQTT.Default.TLSCAFile

Spécifiez le chemin complet du fichier contenant le ou les certificats d'autorité de certification racine pour la vérification du certificat du pair lors des communications chiffrées entre l'agent 2 Zabbix et le broker MQTT.
Utilisé si aucune valeur n'est spécifiée dans une session nommée.

Plugins.MQTT.Default.TLSCertFile

Spécifiez le chemin complet du fichier contenant le certificat de l'agent ou la chaîne de certificats pour les communications chiffrées entre l'agent 2 Zabbix et le broker MQTT.
Utilisé si aucune valeur n'est spécifiée dans une session nommée.

Plugins.MQTT.Default.TLSKeyFile

Spécifiez le chemin d'accès complet du fichier contenant la clé privée MQTT pour les communications chiffrées entre l'agent 2 Zabbix et le broker MQTT.
Utilisé si aucune valeur n'est spécifiée dans une session nommée.

Plugins.MQTT.Default.Topic

Spécifie le topic par défaut pour l'abonnement MQTT.
Utilisé si aucune valeur n'est spécifiée dans une clé d'élément ou une session nommée.
Le topic peut contenir des caractères génériques ("+","#").

Exemples :

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

Spécifie la chaîne de connexion par défaut du courtier MQTT.
Utilisé si aucune valeur n'est spécifiée dans une clé d'élément ou une session nommée.
Ne doit pas inclure de paramètres de requête.
Doit correspondre au format d'URL.
Schémas pris en charge: tcp (par défaut), ws, tls
Un schéma peut être omis.
Un port peut être omis (par défaut=1883)

Par défaut: tcp://localhost:1883

Exemples:

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

Spécifiez le nom d'utilisateur par défaut pour la connexion à MQTT.
Utilisé si aucune valeur n'est spécifiée dans une clé d'élément ou une session nommée.

Plugins.MQTT.Sessions.<SessionName>.Password

Spécifiez le mot de passe de la session nommée pour la connexion à MQTT.
<SessionName> - définissez le nom d'une session à utiliser dans les clés d'élément.

Plugins.MQTT.Sessions.<SessionName>.TLSCAFile

Spécifiez le chemin d'accès complet du fichier contenant le ou les certificats d'AC racine pour la vérification du certificat du pair pour la session nommée, utilisé pour les communications chiffrées entre l'agent 2 Zabbix et le broker MQTT.
<SessionName> - définit le nom d'une session à utiliser dans les clés d'élément.

Plugins.MQTT.Sessions.<SessionName>.TLSCertFile

Spécifiez le chemin complet du fichier contenant le certificat de l'agent ou la chaîne de certificats pour la session nommée, utilisé pour les communications chiffrées entre Zabbix agent 2 et le broker MQTT.
<SessionName> - définit le nom d'une session à utiliser dans les clés d'élément.

Plugins.MQTT.Sessions.<SessionName>.TLSKeyFile

Spécifiez le chemin d'accès complet du fichier contenant la clé privée MQTT pour la session nommée, utilisé pour les communications chiffrées entre l'agent Zabbix 2 et le broker MQTT.
<SessionName> - définissez le nom d'une session à utiliser dans les clés d'élément.

Plugins.MQTT.Sessions.<SessionName>.Topic

Spécifiez le topic de session nommé pour l'abonnement MQTT.
<SessionName> - définissez le nom d'une session à utiliser dans les clés d'élément.
Le topic peut contenir des caractères génériques ("+","#").

Exemples :

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

Spécifie la chaîne de connexion du courtier MQTT de la session nommée.
<SessionName> - définit le nom d'une session à utiliser dans les clés d'élément.
Ne doit pas inclure de paramètres de requête.
Doit correspondre au format d'URL.
Schémas pris en charge: tcp (par défaut), ws, tls
Un schéma peut être omis.
Un port peut être omis (par défaut=1883)

Par défaut: tcp://localhost:1883

Exemples:

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

Spécifiez le nom d'utilisateur de la session nommée pour la connexion à MQTT.
<SessionName> - définissez le nom d'une session à utiliser dans les clés d'élément.

Si vous devez définir le délai d'attente d'exécution de la requête (durée d'attente avant d'interrompre une requête pour qu'elle se termine), utilisez le formulaire de configuration de l'élément.

Voir aussi