ActiveMQ

Supported OS Linux Windows Mac OS

Intégration3.0.0

Présentation

Le check ActiveMQ recueille des métriques sur les agents, les files d’attente, les producteurs, les consommateurs, et plus encore.

Remarque : ce check prend également en charge ActiveMQ Artemis (future version 6 d’ActiveMQ) et transmet les métriques sous l’espace de nommage activemq.artemis. Consultez metadata.csv pour découvrir la liste complète des métriques fournies par cette intégration.

Remarque : si vous utilisez une version d’ActiveMQ antérieure à 5.8.0, consultez les exemples de fichiers pour l’Agent 5.10.x.

Implémentation

Installation

Le check ActiveMQ de l’Agent est inclus avec le package de l’Agent Datadog : vous n’avez donc rien d’autre à installer sur vos nœuds ActiveMQ.

Le check recueille des métriques à partir de JMX via JMXFetch. Une JVM est donc nécessaire sur chaque nœud pour que l’Agent puisse exécuter JMXFetch. Datadog vous conseille d’utiliser une JVM fournie par Oracle.

Configuration

Host

Pour configurer ce check lorsque l’Agent est exécuté sur un host :

Vérifiez que l’accès distant à JMX est activé sur votre serveur ActiveMQ.
Configurez l’Agent pour le connecter à ActiveMQ. Modifiez activemq.d/conf.yaml dans le dossier conf.d/ à la racine du répertoire de configuration de votre Agent. Consultez le fichier d’exemple activemq.d/conf.yaml pour découvrir toutes les options de configuration disponibles. La liste des métriques recueillies par défaut est disponible dans le fichier metrics.yaml.
```
init_config:
  is_jmx: true
  collect_default_metrics: true

instances:
  - host: localhost
    port: 1616
    user: username
    password: password
    name: activemq_instance
```
Redémarrez l’Agent.

Collecte de logs

Disponible à partir des versions > 6.0 de l’Agent

La collecte de logs est désactivée par défaut dans l’Agent Datadog. Vous devez l’activer dans datadog.yaml :
```
logs_enabled: true
```

Ajoutez ce bloc de configuration à votre fichier activemq.d/conf.yaml pour commencer à recueillir vos logs ActiveMQ :

logs:
  - type: file
    path: "<ACTIVEMQ_BASEDIR>/data/activemq.log"
    source: activemq
    service: "<SERVICE_NAME>"
  - type: file
    path: "<ACTIVEMQ_BASEDIR>/data/audit.log"
    source: activemq
    service: "<SERVICE_NAME>"

Redémarrez l’Agent.

Environnement conteneurisé

Consultez la documentation relative aux modèles d’intégration Autodiscovery pour découvrir comment appliquer les paramètres ci-dessous à un environnement conteneurisé.

Collecte de métriques

Paramètre	Valeur
`<NOM_INTÉGRATION>`	`activemq`
`<CONFIG_INIT>`	vide ou `{}`
`<CONFIG_INSTANCE>`	`{"host": "%%host%%","port":"1099"}`

Collecte de logs

Disponible à partir des versions > 6.0 de l’Agent

La collecte des logs est désactivée par défaut dans l’Agent Datadog. Pour l’activer, consultez la section Collecte de logs Kubernetes.

Paramètre	Valeur
`<CONFIG_LOG>`	`{"source": "activemq", "service": "<VOTRE_NOM_APPLICATION>"}`

Validation

Lancez la sous-commande status de l’Agent et cherchez activemq dans la section Checks.

Données collectées

Métriques

Les noms des métriques associées à ActiveMQ Artemis comportent l’indicateur artemis. Toutes les autres métriques transmises correspondent à la version classique d’ActiveMQ.

Événements

Le check ActiveMQ n’inclut aucun événement.

Checks de service

activemq.can_connect
Renvoie CRITICAL si l’Agent n’est pas capable de se connecter à l’instance ActiveMQ qu’il surveille et d’y recueillir des métriques. Si ce n’est pas le cas, renvoie OK.
Statuses: ok, critical

Dépannage

Besoin d’aide ? Contactez l’assistance Datadog.

Pour aller plus loin

Documentation, liens et articles supplémentaires utiles :

Intégration ActiveMQ XML

Présentation

Recueillez des métriques d’ActiveMQ XML en temps réel pour :

Visualiser et surveiller les états d’ActiveMQ XML
Être informé des failovers et des événements d’ActiveMQ XML

Implémentation

Installation

Le check ActiveMQ XML est inclus avec le package de l’Agent Datadog : vous n’avez donc rien d’autre à installer sur vos serveurs.

Configuration

Suivez les instructions ci-dessous pour configurer ce check lorsque l’Agent est exécuté sur un host. Consultez la section Environnement conteneurisé pour la configuration dans un environnement conteneurisé.

Host

Pour configurer ce check lorsque l’Agent est exécuté sur un host :

Modifiez le fichier activemq_xml.d/conf.yaml dans le dossier conf.d/ à la racine du répertoire de configuration de votre Agent avec votre url stats. Consultez le fichier d’exemple activemq_xml.d/conf.yaml pour découvrir toutes les options de configuration disponibles.
Remarque : l’intégration ActiveMQ XML peut potentiellement générer des métriques custom, ce qui peut avoir une incidence sur votre facture. Par défaut, une limite de 350 métriques est appliquée. Si vous souhaitez utiliser 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 :
```
logs_enabled: true
```

Ajoutez ce bloc de configuration à votre fichier activemq_xml.d/conf.yaml ou activemq.d/conf.yaml pour commencer à recueillir vos logs ActiveMQ :

logs:
  - type: file
    path: "<ACTIVEMQ_BASEDIR>/data/activemq.log"
    source: activemq
    service: "<SERVICE_NAME>"
  - type: file
    path: "<ACTIVEMQ_BASEDIR>/data/audit.log"
    source: activemq
    service: "<SERVICE_NAME>"

Redémarrez l’Agent.

Environnement conteneurisé

Pour les environnements conteneurisés, consultez le guide Autodiscovery avec JMX.

Validation

Lancez la sous-commande status de l’Agent et cherchez activemq_xml dans la section Checks.