Présentation
HiveMQ est une plateforme de messagerie MQTT conçue pour le déplacement rapide, efficace et fiable de données depuis et vers des appareils IoT connectés. Cet agent est conforme aux protocoles MQTT 3.1, 3.1.1 et 5.0.
Configuration
Installation
Le check HiveMQ est inclus avec le package de l’Agent Datadog.
Vous n’avez donc rien d’autre à installer sur votre serveur.
Configuration
Host
Pour configurer ce check lorsque l’Agent est exécuté sur un host :
Collecte de métriques
Modifiez le fichier hivemq.d/conf.yaml
dans le dossier conf.d/
à la racine du
répertoire de configuration de votre Agent pour commencer à recueillir vos données de performance HiveMQ.
Consultez le fichier d’exemple hivemq.d/conf.yaml pour découvrir toutes les options de configuration disponibles.
Ce check prévoit une limite de 350 métriques par instance. Le nombre de métriques renvoyées est indiqué sur la page d’informations.
Choisissez les métriques qui vous intéressent en modifiant la configuration ci-dessous.
Pour découvrir comment modifier la liste des métriques à recueillir, consultez la documentation relative aux checks JMX afin d’obtenir des instructions détaillées.
Si vous devez surveiller davantage de métriques, contactez l’assistance Datadog.
Redémarrez l’Agent.
Collecte de logs
La collecte de logs est désactivée par défaut dans l’Agent Datadog. Vous devez l’activer dans datadog.yaml
:
Ajoutez le bloc de configuration suivant à votre fichier hivemq.d/conf.yaml
. Modifiez les valeurs des paramètres path
et service
en fonction de votre environnement. Consultez le fichier d’exemple hivemq.d/conf.yaml pour découvrir toutes les options de configuration disponibles.
logs:
- type: file
path: /var/log/hivemq.log
source: hivemq
service: <SERVICE>
log_processing_rules:
- type: multi_line
name: log_start_with_date
pattern: \d{4}\.\d{2}\.\d{2}
Redémarrez l’Agent.
Environnement conteneurisé
Collecte de métriques
Pour les environnements conteneurisés, consultez le guide Autodiscovery avec JMX.
Collecte de logs
La collecte des logs est désactivée par défaut dans l’Agent Datadog. Pour l’activer, consultez la section Collecte de logs avec Docker.
Paramètre | Valeur |
---|
<CONFIG_LOG> | {"source": "hivemq", "service": "<NOM_SERVICE>"} |
Validation
Lancez la sous-commande status de l’Agent et cherchez hivemq
dans la section JMXFetch :
========
JMXFetch
========
Initialized checks
==================
hivemq
instance_name : hivemq-localhost-9999
message :
metric_count : 46
service_check_count : 0
status : OK
Données collectées
Métriques
Checks de service
Dépannage
Besoin d’aide ? Contactez l’assistance Datadog.