Surveillance d'Amazon MQ
Le capteur Amazon MQ est automatiquement déployé et installé une fois que vous avez installé l'agent Instana.
Capteur (collecte de données)
La collecte de métriques est prise en charge pour les types de moteur ActiveMQ et RabbitMQ .
Configuration suivie
Les détails de courtier suivants sont disponibles quels que soient les moteurs utilisés.
| Détails du courtier |
|---|
| Nom |
| ARN |
| Etat |
| Créé à |
| Type de moteur |
| Version du moteur |
| Type d'instance |
| Déploiement |
| Accessibilité au public |
| Région AWS |
Métriques
ActiveMQ indicateurs
| Métriques du courtier | Description |
|---|---|
| CpuCreditBalance | Nombre de crédits d'UC acquis qu'une instance a accumulé depuis son démarrage ou son démarrage (y compris le nombre de crédits de lancement) |
| CpuUtilization | Pourcentage d'unités de traitement EC2 allouées que le courtier utilise actuellement. |
| CurrentConnectionsCount | Nombre actuel de connexions actives sur le courtier en cours. |
| JournalFilesForFastRecovery | Nombre de fichiers journaux relus après un arrêt correct. |
| JournalFilesForFullRecovery | Nombre de fichiers journaux qui seront relus après un arrêt incorrect. |
| HeapUsage | Pourcentage de la limite de mémoire de la machine virtuelle Java ActiveMQ actuellement utilisée par le courtier. |
| NetworkIn | Volume du trafic entrant pour le courtier. |
| NetworkOut | Volume du trafic sortant pour le courtier. |
| OpenTransactionsCount | Nombre total de transactions en cours. |
| StorePercentUsage | Pourcentage utilisé par la limite de stockage. S'il atteint 100, le courtier refuse les messages. |
| TotalConsumerCount | Nombre de destinataires de message abonnés aux destinations sur le courtier en cours. |
| TotalMessageCount | Nombre de messages stockés sur le courtier. |
| TotalProducerCount | Nombre de producteurs de messages actifs dans les destinations sur le courtier en cours. |
| Métriques de destination | Description |
|---|---|
| ConsumerCount | Nombre de destinataires abonnés à la destination. |
| EnqueueCount | Nombre de messages envoyés à la destination. |
| EnqueueTime | Temps nécessaire au courtier pour accepter un message du producteur et l'envoyer à la destination. |
| ExpiredCount | Nombre de messages qui n'ont pas pu être distribués car ils sont arrivés à expiration. |
| DispatchCount | Nombre de messages envoyés aux consommateurs. |
| DequeueCount | Nombre de messages dont les consommateurs ont accusé réception. |
| MemoryUsage | Pourcentage de la limite de mémoire utilisée par la destination. |
| ProducerCount | Nombre de producteurs pour la destination. |
| QueueSize | Nombre de messages dans la file d'attente. (Cette métrique s'applique uniquement aux files d'attente.) |
RabbitMQ indicateurs
| Métriques du courtier | Description |
|---|---|
| ConnectionCount | Nombre total de connexions établies sur le courtier. |
| ConsumerCount | Nombre total de consommateurs connectés au courtier. |
| MessageCount | Nombre total de messages dans les files d'attente. |
| MessagesRate | Nombre total de messages par seconde dans les files d'attente. |
| MessageReadyCount | Nombre total de messages prêts dans les files d'attente. |
| MessagesReadyRate | Nombre de messages par seconde prêts à être distribués aux clients. |
| MessageUnacknowledgedCount | Nombre total de messages sans accusé de réception dans les files d'attente. |
| MessageUnacknowledgedRate | Nombre de messages par seconde qui sont distribués aux clients mais qui n'ont pas encore fait l'objet d'un accusé de réception. |
| PublishRate | Fréquence à laquelle les messages sont publiés dans le courtier. |
| ConfirmRate | Fréquence à laquelle le serveur RabbitMQ confirme les messages publiés. |
| AckRate | Fréquence à laquelle les messages sont reconnus par les consommateurs. |
| Métriques de noeud | Description |
|---|---|
| SystemCpuUtilization | Pourcentage d'unités de calcul Amazon EC2 allouées que le courtier utilise actuellement. |
| MemoryLimit | Limite de mémoire RAM pour un noeud RabbitMQ . |
| MemoryUsed | Volume de mémoire RAM utilisé par un noeud RabbitMQ . |
| DiskFreeLimit | Limite de disque pour un noeud RabbitMQ . |
| DiskFree | Volume total d'espace disque disponible dans un noeud RabbitMQ . |
| FileDescriptorsUsed | Nombre de descripteurs de fichier utilisés. |
Si le type de déploiement du courtier d' RabbitMQ s est CLUSTER_MULTI_AZ, il peut arriver, dans de rares cas, que plus de trois nœuds apparaissent dans le tableau de bord d' RabbitMQ. Cela peut se produire lorsque le courtier CLUSTER_MULTI_AZ est supprimé, créé avec le même nom, puis reconnu par l'agent en l'espace de quelques heures. Ce problème est dû au fait que l' CloudWatch conserve les métriques même après la suppression de la ressource. Pour résoudre ce problème, vous pouvez redémarrer l'agent. {: note}
| Métriques de file d'attente | Description |
|---|---|
| ConsumerCount | Nombre de consommateurs abonnés à la file d'attente. |
| MessageReadyCount | Nombre de messages actuellement disponibles à distribuer. |
| MessageUnacknowledgedCount | Nombre de messages pour lesquels le serveur attend un accusé de réception. |
| MessageCount | Le nombre total d' MessageReadyCount s et d' MessageUnacknowledgedCount s (également appelé « profondeur de file d'attente »). |
Droits requis
cloudwatch:GetMetricDatacloudwatch:GetMetricStatisticsmq:ListBrokersmq:DescribeBroker
Configuration
Les métriques d'Amazon MQ sont extraites toutes les 5 minutes, qui peuvent être modifiées via la configuration d'agent (<agent_install_dir>/etc/instana/configuration.yaml):
com.instana.plugin.aws.mq:
cloudwatch_period: 300
Pour désactiver la surveillance des instances MQ , utilisez la configuration suivante:
com.instana.plugin.aws.mq:
enabled: false
ActiveMQ configuration
Pour activer la surveillance des métriques approfondie des courtiers ActiveMQ , vous devez informer l'agent hôte des files d'attente ou des rubriques à surveiller pour chaque courtier. Vous pouvez le configurer dans le fichier de configuration d'agent <agent_install_dir>/etc/instana/configuration.yaml comme suit:
com.instana.plugin.aws.mq:
PLACEHOLDER_ACTIVE_MQ_BROKER_NAME: # replace PLACEHOLDER_ACTIVE_MQ_BROKER_NAME with your ActiveMQ broker name
queues: # max 165 queues
- 'queue1'
- 'queue2'
topics: # max 165 topics
- 'topic1'
RabbitMQ configuration
Pour activer la surveillance de métrique approfondie des courtiers RabbitMQ , vous devez informer l'agent hôte des files d'attente que vous souhaitez surveiller pour chaque courtier (jusqu'à 700 files d'attente). Vous pouvez le configurer dans le fichier de configuration d'agent <agent_install_dir>/etc/instana/configuration.yaml comme suit:
com.instana.plugin.aws.mq:
PLACEHOLDER_RABBIT_MQ_BROKER_NAME: # replace PLACEHOLDER_RABBIT_MQ_BROKER_NAME with your RabbitMQ broker name
queuesRegex: '.*' # Regex pattern used for matching monitored queues
monitorQueues:
- queue: 'queue1' # name of the queue
vhost: '/' # name of the vhost, default is '/'
- queue: 'queue2' # name of the queue
vhost: '/' # name of the vhost, default is '/'
Configuration de proxy
Pour configurer le capteur AWS spécifique, afin d'utiliser la configuration du proxy, ajoutez les paramètres de configuration d'agent suivants :
com.instana.plugin.aws.mq:
proxy_host: 'example.com' # proxy host name or ip address
proxy_port: 3128 # proxy port
proxy_protocol: 'HTTP' # proxy protocol: HTTP or HTTPS
proxy_username: 'username' # OPTIONAL: proxy username
proxy_password: 'password' # OPTIONAL: proxy password
Surveillance de plusieurs comptes AWS
Reportez-vous à la documentation Surveillance de plusieurs comptes AWS pour configurer la surveillance de plusieurs comptes AWS avec un agent AWS dans la même région.
Approche des profils nommés AWS
Pour remplacer les profils utilisés pour surveiller MQ, utilisez la configuration suivante:
com.instana.plugin.aws.mq:
profile_names:
- 'profile2'
- 'profile3'
Approche AWS STS
Pour remplacer les rôles IAM utilisés pour surveiller MQ, utilisez la configuration suivante:
com.instana.plugin.aws.mq:
role_arns:
- 'arn:aws:iam::<account_1_id>:role/<role_1_name>'
- 'arn:aws:iam::<account_2_id>:role/<role_2_name>'
Filtrage
Plusieurs balises séparées par des virgules peuvent être définies. Les balises sont fournies sous la forme d'une paire clé-valeur séparée par: Pour faciliter la configuration, il est possible de définir les balises à inclure dans la reconnaissance ou à exclure de la reconnaissance. Si vous définissez une balise dans les deux listes (inclusion et exclusion), la liste d'exclusion a une priorité plus élevée. S'il n'est pas nécessaire de filtrer les services, la configuration ne doit pas être définie. Il n'est pas obligatoire de définir toutes les valeurs pour activer le filtrage.
Les utilisateurs peuvent spécifier la fréquence à laquelle les détecteurs interrogent les ressources balisées AWS qui utilisent la propriété de configuration tagged-services-poll-rate (valeur par défaut: 300 secondes).
Pour définir la fréquence à laquelle les détecteurs interrogent les ressources balisées, utilisez la configuration suivante:
com.instana.plugin.aws:
tagged-services-poll-rate: 60 #default 300
Pour inclure des services par balises dans la reconnaissance, utilisez la configuration suivante:
com.instana.plugin.aws.mq:
include_tags: # Comma separated list of tags in key:value format (e.g. env:prod,env:staging)
Pour exclure des services par balises de la reconnaissance, utilisez la configuration suivante :
com.instana.plugin.aws.mq:
exclude_tags: # Comma separated list of tags in key:value format (e.g. env:dev,env:test)
Les services AWS sans balises sont surveillés par défaut mais peuvent être exclus en définissant la zone include_untagged sur false:
com.instana.plugin.aws.mq:
include_untagged: false # True value by default