Surveillance d'ActiveMQ Artemis

Le capteur « ActiveMQ Artemis » s'installe automatiquement une fois que vous avez installé l'agent « Instana » sur l'hôte où s'exécute « ActiveMQ ».

Une fois le capteur configuré, vous pouvez consulter les hôtes surveillés et les métriques associés à ActiveMQ Artemis dans l'interface utilisateur d' Instana. Pour plus d'informations sur la configuration du capteur, voir Configuration.

Informations de support

Pour vous assurer que le capteur d' ActiveMQ Artemis s est compatible avec votre configuration actuelle, consultez les sections d'informations d'assistance suivantes :

Versions prises en charge et politique d'assistance

Le capteur « ActiveMQ Artemis » prend en charge les versions d' ActiveMQ Artemis allant de la version 2.0.0 à la version 2.36.x. Le capteur prend également en charge JBoss ActiveMQ 7 et les versions ultérieures.

Le tableau suivant présente la dernière version prise en charge et la politique d'assistance :

Technologie Politique de support Dernière version technologique Dernière version prise en charge
ActiveMQ Artemis A la demande 2.52.x 2.52.x

Pour plus d'informations sur la politique d'assistance, consultez la section « Stratégie d'assistance pour les capteurs ».

Prise en charge du traçage côté client

Instana prend en charge le traçage côté client pour l' Java.

Activer l' JMX

Si l'option « JMX » n'est pas activée, le message suivant s'affiche dans l'interface utilisateur d' Instana :

Jmx is not enabled.
You can enable it in activemq config by setting the broker property useJmx to true.

Vous pouvez activer l'accès à JMX en supprimant <authorisation> l'élément de /apache-artemis/bin/myinstance/etc/management.xml.

Configuration

Pour permettre une surveillance approfondie des métriques, ajoutez les files d'attente que vous souhaitez surveiller au fichier de configuration de <agent_install_dir>/etc/instana/configuration.yaml l'agent. Vous pouvez également définir une fréquence d'interrogation personnalisée en ajoutant poll_rate dans le même fichier, comme indiqué dans la configuration suivante :


com.instana.plugin.activemqartemis:
  poll_rate: 1 # Value is in seconds. Default value is 1 second.
  monitorQueues:
    - 'test-queue'
    - 'DLQ'
 
Remarque : le capteur « ActiveMQ Artemis » peut surveiller jusqu'à 100 files d'attente par broker. Assurez-vous que le nombre de files d'attente spécifié ne dépasse pas cette limite.

Configuration de la fréquence d'interrogation

Remarque : les capteurs Instana, ActiveMQ Artemis, 1.0.9 et les versions ultérieures permettent de configurer la fréquence d'interrogation afin de réduire le volume de données collectées. Cette fonctionnalité est prise en charge sur le backend Instana auto-hébergé à partir de la version 311.

Vous pouvez configurer la fréquence à laquelle l' Instana interroge ActiveMQ Artemis pour collecter des données et des métriques en utilisant le poll_rate paramètre dans le fichier de configuration.yaml l'agent, comme le montre l'exemple suivant :

com.instana.plugin.activemqartemis:
  poll_rate: 1 # values are in seconds. Default value is 1 second.

Affichage des mesures

Pour afficher les métriques, procédez comme suit :

  1. Dans le menu de navigation de l'interface utilisateur d' Instana, sélectionnez « Infrastructure ».
  2. Cliquez sur un hôte surveillé spécifique.

Vous pouvez voir un tableau de bord de l'hôte avec toutes les mesures collectées et les processus surveillés.

Données de configuration

  • Version
  • Nom du courtier
  • ID du noeud
  • Ports
  • Limite de mémoire
  • Adresses
  • Files d'attente
  • Accepteurs de transport

Métriques de performance

A l'échelle du courtier

Métrique Description Granularité
Messages ajoutés Nombre de messages ajoutés au courtier et collectés à partir de activemq.artemis:broker#TotalMessagesAdded. 1 seconde
Messages acceptés Nombre de messages qui sont reconnus (et supprimés) du courtier et qui sont collectés à partir de activemq.artemis:broker#TotalMessagesAcknowledged. 1 seconde
Messages ayant expiré Nombre de messages arrivés à expiration sur le courtier et collectés à partir de la somme de subcomponent=queues#MessagesExpired pour toutes les files d'attente. 1 seconde
Messages arrêtés Nombre de messages qui sont arrêtés sur le courtier pour dépasser le nombre maximal de tentatives de distribution et qui sont collectés à partir de la somme de subcomponent=queues#MessagesKilled pour toutes les files d'attente. 1 seconde
Nombre de messages Nombre de messages sur toutes les files d'attente et est collecté à partir de la somme de subcomponent=queues#MessageCount pour toutes les files d'attente. 1 seconde
Nombre total de connexions Nombre total de connexions sur le courtier, collecté à partir de activemq.artemis:broker#ConnectionCount. 1 seconde
Nombre total de consommateurs Nombre total de consommateurs sur le courtier, collecté à partir de activemq.artemis:broker#TotalConsumerCount. 1 seconde
Utilisation de la mémoire Pourcentage de la limite de mémoire utilisée par toutes les adresses du courtier et collectée à partir de activemq.artemis:broker#AddressMemoryUsagePercentage. 1 seconde

Files d'attente

Métrique Description Granularité
Nombre de messages Nombre de messages actuellement dans cette file d'attente (y compris les messages planifiés, paginés et en cours de distribution) et collectés à partir de subcomponent=queues#MessageCount. 1 seconde
Messages ajoutés Nombre de messages ajoutés à la file d'attente et collectés à partir de subcomponent=queues#MessagesAdded. 1 seconde
Messages acceptés Nombre de messages pris en compte (et supprimés) dans la file d'attente et collectés à partir de subcomponent=queues#MessagesAcknowledged. 1 seconde
Messages ayant expiré Nombre de messages arrivés à expiration dans cette file d'attente et collectés à partir de subcomponent=queues#MessagesExpired. 1 seconde
Messages arrêtés Nombre de messages arrêtés dans cette file d'attente en raison d'un dépassement du nombre maximal de tentatives de distribution et collectés à partir de subcomponent=queues#MessagesKilled. 1 seconde

Signatures d'intégrité

Chaque capteur dispose d'une base de connaissances de signatures de santé qui sont évaluées en permanence par rapport aux mesures reçues et sont utilisées pour soulever des problèmes ou des incidents qui dépendent de l'impact sur l'utilisateur.

Les événements intégrés déclenchent des problèmes ou des incidents en cas de non-conformité des signatures de santé des entités, tandis que les événements personnalisés déclenchent des problèmes ou des incidents en fonction des seuils d'une métrique spécifique de n'importe quelle entité.

Pour plus d'informations sur les événements intégrés du capteur « ActiveMQ Artemis », consultez la référence des événements intégrés.