Apache ActiveMQ

L'intégration Apache ActiveMQ écrit les journaux et collecte les métriques de stockage et d'utilisation du stockage. 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 documentation Apache ActiveMQ.

Prérequis

Pour collecter les données de télémétrie ActiveMQ, vous devez installer l'agent Ops :

Pour les métriques, installez la version 2.11.0 ou ultérieure.
Pour les journaux, installez la version 2.15.0 ou ultérieure.

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

Cette intégration est compatible avec les versions ActiveMQ suivantes :

Versions 5.8.x à 5.16.x classiques
Artemis 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 la télémétrie des instances ActiveMQ, puis redémarrez l'agent.

Exemple de configuration

La commande suivante crée la configuration permettant de collecter et d'ingérer la télémétrie pour ActiveMQ, et redémarre l'agent Ops.

# Configures Ops Agent to collect telemetry from the app and restart Ops Agent.

set -e

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

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.

Configurer la collecte de métriques

Pour ingérer des métriques à partir d'ActiveMQ, vous devez créer des récepteurs pour les métriques produites par ActiveMQ, puis créer un pipeline pour les nouveaux récepteurs.

Pour configurer un récepteur pour vos métriques activemq, spécifiez les champs suivants :

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

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`

Exemple de tableau de bord

Pour afficher vos métriques ActiveMQ, vous devez configurer un graphique ou un tableau de bord. Cloud Monitoring fournit une bibliothèque d'exemples de tableaux de bord pour les intégrations, contenant des graphiques préconfigurés. Pour en savoir plus sur l'installation de ces tableaux de bord, consultez la page Installer des exemples de tableaux de bord.

Vérifier la configuration

Cette section explique comment vérifier que vous avez bien configuré le récepteur ActiveMQ. La collecte de la télémétrie par l'agent Ops peut prendre une ou deux minutes.

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 :

resource.type="gce_instance"
log_id("syslog")
jsonPayload.message~='(activemq\[[0-9]+\]|activemq):'

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.consumer.count'
| 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).