Apache ActiveMQ

Restez organisé à l'aide des collections Enregistrez et classez les contenus selon vos préférences.

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
GAUGEINT64
gce_instance
 
workload.googleapis.com/activemq.consumer.count
GAUGEINT64
gce_instance
broker
destination
workload.googleapis.com/activemq.disk.store_usage
GAUGEDOUBLE
gce_instance
 
workload.googleapis.com/activemq.disk.temp_usage
GAUGEDOUBLE
gce_instance
 
workload.googleapis.com/activemq.memory.usage
GAUGEDOUBLE
gce_instance
broker
destination
workload.googleapis.com/activemq.message.current
GAUGEINT64
gce_instance
broker
destination
workload.googleapis.com/activemq.message.dequeued
CUMULATIVEINT64
gce_instance
broker
destination
workload.googleapis.com/activemq.message.enqueued
CUMULATIVEINT64
gce_instance
broker
destination
workload.googleapis.com/activemq.message.expired
CUMULATIVEINT64
gce_instance
broker
destination
workload.googleapis.com/activemq.message.wait_time.avg
GAUGEDOUBLE
gce_instance
broker
destination
workload.googleapis.com/activemq.producer.count
GAUGEINT64
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).