Surveillance d'Amazon MQ

Le capteur Amazon MQ est automatiquement déployé et installé une fois que vous avez installé l'agent Instana.

Remarque : pour en savoir plus sur les autres services pris en charge par l' AWS, consultez la documentation d' AWS.

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:GetMetricData
  • cloudwatch:GetMetricStatistics
  • mq:ListBrokers
  • mq: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'
Remarque : la définition de profils au niveau du service remplace la configuration globale des profils d' AWS.

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>'
Remarque : la définition de rôles IAM au niveau du service remplace la configuration globale des rôles IAM sur AWS.

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

Remarque : les balises ne sont disponibles qu'avec l' agent « AWS ».

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

Balises de l'agent Instana

Veuillez noter que les balises ne sont disponibles qu'avec l 'agent « AWS ». Vous trouverez ici plus de détails sur l'utilisation des balises.