Apache ActiveMQ

L'intégration Apache ActiveMQ collecte les métriques d'utilisation du stockage et de message. Les métriques de stockage incluent l'utilisation de la mémoire et du disque. Les métriques de message incluent le nombre de messages en attente, le temps d'attente moyen et les messages expirés.

Pour en savoir plus sur ActiveMQ, consultez la page activemq.apache.org/.

Prérequis

Pour collecter et ingérer des métriques ActiveMQ, vous devez installer l'agent Ops version 2.11.0 ou ultérieure.

Vous devez activer la compatibilité avec JMX dans la configuration de l'agent.

Ce récepteur est compatible avec les versions Apache ActiveMQ suivantes :

ActiveMQ Classic versions 5.8.x à 5.16.x
ActiveMQ Artemis version 2.x.

Configurer l'agent Ops pour ActiveMQ

En suivant le guide de configuration de l'agent Ops, ajoutez les éléments requis pour collecter les métriques de vos instances ActiveMQ, puis redémarrez l'agent.

Exemple de configuration

La commande suivante crée le fichier de configuration permettant de collecter et d'ingérer les métriques de ActiveMQ, et redémarre l'agent Ops sous Linux.

sudo tee /etc/google-cloud-ops-agent/config.yaml > /dev/null << EOF
metrics:
  receivers:
    activemq:
      type: activemq
  service:
    pipelines:
      activemq:
        receivers:
          - activemq
EOF
sudo service google-cloud-ops-agent restart

Configurer la collecte de métriques

Pour collecter des métriques à partir d'ActiveMQ, vous devez créer un récepteur pour les métriques ActiveMQ, puis créer un pipeline pour le nouveau récepteur. Pour configurer un récepteur pour vos métriques ActiveMQ, spécifiez les champs suivants :

Champ	Par défaut	Description
`type`		Cette valeur doit être `activemq`.
`endpoint`	`http://localhost:1099`	URL du nœud à surveiller.
`username`		Le nom d'utilisateur configuré si JMX est configuré pour exiger une authentification.
`password`		Le mot de passe configuré si JMX est configuré pour exiger une authentification.
`collection_interval`	`60s`	Une valeur time.Duration, telle que `30s` ou `5m`.

Métriques surveillées

Le tableau suivant fournit la liste des métriques que l'agent Ops collecte à partir de l'instance ActiveMQ.

Type de métrique
Genre, type Ressources surveillées	Libellés
`workload.googleapis.com/activemq.connection.count`
`GAUGE`, `INT64` gce_instance
`workload.googleapis.com/activemq.consumer.count`
`GAUGE`, `INT64` gce_instance	`broker` `destination`
`workload.googleapis.com/activemq.disk.store_usage`
`GAUGE`, `DOUBLE` gce_instance
`workload.googleapis.com/activemq.disk.temp_usage`
`GAUGE`, `DOUBLE` gce_instance
`workload.googleapis.com/activemq.memory.usage`
`GAUGE`, `DOUBLE` gce_instance	`broker` `destination`
`workload.googleapis.com/activemq.message.current`
`GAUGE`, `INT64` gce_instance	`broker` `destination`
`workload.googleapis.com/activemq.message.dequeued`
`CUMULATIVE`, `INT64` gce_instance	`broker` `destination`
`workload.googleapis.com/activemq.message.enqueued`
`CUMULATIVE`, `INT64` gce_instance	`broker` `destination`
`workload.googleapis.com/activemq.message.expired`
`CUMULATIVE`, `INT64` gce_instance	`broker` `destination`
`workload.googleapis.com/activemq.message.wait_time.avg`
`GAUGE`, `DOUBLE` gce_instance	`broker` `destination`
`workload.googleapis.com/activemq.producer.count`
`GAUGE`, `INT64` gce_instance	`broker` `destination`

Collecter des journaux

ActiveMQ écrit les journaux dans syslog, qui est capturé par défaut par l'agent Ops. Aucune configuration utilisateur supplémentaire n'est requise.

Exemple de tableau de bord

Vous pouvez afficher les métriques de cette intégration à l'aide d'un exemple de tableau de bord Cloud Monitoring. Suivez les procédures décrites dans la section Installer des exemples de tableaux de bord pour importer le tableau de bord Présentation d'ActiveMQ GCE à partir de l'exemple de bibliothèque et afficher les graphiques qui présentent vos métriques ActiveMQ.

Vérifier l'ingestion

Pour vérifier que les journaux sont ingérés, accédez à l'explorateur de journaux et exécutez la requête suivante pour afficher les journaux ActiveMQ en remplaçant activemq par le nom de votre unité système pour AciveMQ si nécessaire :

resource.type="gce_instance"
logName="projects/PROJECT_ID/logs/syslog"
activemq

Vous pouvez utiliser l'explorateur de métriques pour vérifier que vous avez correctement configuré le récepteur ActiveMQ. La collecte des métriques par l'agent Ops peut prendre une ou deux minutes.

Pour vérifier que les métriques sont ingérées, accédez à l'Explorateur de métriques et exécutez la requête suivante dans l'onglet MQL.

fetch gce_instance
| metric 'workload.googleapis.com/activemq.connection.count'
| align rate(1m)
| every 1m

Étape suivante

Pour accéder à un tutoriel pas à pas expliquant comment utiliser Ansible pour installer l'agent Ops, configurer une application tierce et installer un exemple de tableau de bord, consultez la vidéo Install the Ops Agent to troubleshoot third-party applications (Installer l'agent Ops pour résoudre les problèmes liés à des applications tierces).