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