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.
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).