Cette traduction automatique est fournie pour votre commodité.
En cas d'incohérence entre la version anglaise et la version traduite, la version anglaise prévaudra. Veuillez visiter cette page pour plus d'informations.
Cette référence couvre les métriques et attributs IBM MQ collectés via OpenTelemetry : les métriques que l’exportateur mq-metric-samples publie et que le collecteur transfère à New Relic. Il s’applique à la fois aux déploiements d’ hôte Linux et Kubernetes ; la forme de la métrique est identique.
Collecte des métriques
Toutes les métriques conservent la forme brute de Prometheus que l'exportateur émet : les noms avec trait de soulignement (ibmmq_*) et les étiquettes brutes qmgr, queue et channel, plus l'attribut d'identité target.name et le tag cluster.name facultatif que le collecteur attache. La synthèse d'entité IBM MQ de New Relic dépend de cette forme, le collecteur transfère donc les noms et les étiquettes sans modification.
Important
Activez les statistiques MQI sur chaque gestionnaire de files d’attente, sinon les métriques de débit et de temps resteront vides. La santé du gestionnaire de files d’attente, la profondeur de la file d’attente et le statut du canal sont disponibles d’emblée, mais les métriques d’activité MQI (les tables de débit de la file d’attente et d’ activité MQI du gestionnaire de files d’attente — ibmmq_queue_mqput_count, ibmmq_queue_average_queue_time_seconds, etc.) nécessitent que la collecte des statistiques soit activée, ce qui est désactivé par défaut. Activez-la une fois par gestionnaire de files d’attente avec MQSC — par exemple ALTER QMGR STATMQI(ON) STATQ(ON), puis ALTER QLOCAL(...) STATQ(ON) pour toute file d’attente sur laquelle vous souhaitez des statistiques par file d’attente (ou fiez-vous à la valeur par défaut STATQ du gestionnaire de files d’attente). Sans cela, l’exportateur est sain et l’entité apparaît, mais ces panneaux s’affichent vides. Consultez la documentation de mq-metric-samples pour connaître les statistiques exactes dont dépend chaque métrique.
Conseil
Les métriques de statut renvoient des valeurs enum numériques, et non 1/0 — consultez la référence des codes de statut ci-dessous avant de configurer des alertes à leur sujet. Les compteurs sont convertis en temporalité delta par le collecteur, utilisez donc sum() / rate() sur une fenêtre plutôt que latest() pour les représenter graphiquement.
Les tableaux ci-dessous regroupent les métriques OpenTelemetry par domaine. Pour lister chaque métrique remontant actuellement dans votre compte, exécutez :
FROM Metric SELECT uniques(metricName,2000)WHERE metricName LIKE'ibmmq_%' SINCE 1day ago
Métriques
métrique
Description
ibmmq_qmgr_status
État d’exécution du gestionnaire de files d’attente (2 = en cours d’exécution).
ibmmq_qmgr_command_server_status
État d'exécution du serveur de commandes (2 = en cours d'exécution).
ibmmq_qmgr_channel_initiator_status
État d'exécution de l'initiateur de canal (le processus du gestionnaire de files d'attente qui démarre et gère les canaux MQ) (2 = en cours d'exécution).
ibmmq_qmgr_connection_count
Nombre actuel de connexions au gestionnaire de files d'attente.
ibmmq_qmgr_uptime
Temps de disponibilité du gestionnaire de files d'attente, en secondes.
ibmmq_qmgr_active_listeners
Nombre d'écouteurs actifs.
ibmmq_qmgr_active_services
Nombre de services actifs.
ibmmq_qmgr_concurrent_connections_high_water_mark
Pic de connexions simultanées.
métrique
Description
ibmmq_qmgr_cpu_load_one_minute_average_percentage
Moyenne de charge CPU sur 1 minute pour le gestionnaire de files d’attente (également _five_ et _fifteen_minute_).
ibmmq_qmgr_user_cpu_time_percentage
Temps CPU en espace utilisateur consommé par le gestionnaire de files d'attente.
ibmmq_qmgr_system_cpu_time_percentage
Temps CPU système (noyau) consommé par le gestionnaire de files d'attente.
Espace libre sur le système de fichiers du gestionnaire de files d'attente.
ibmmq_qmgr_mq_fdc_file_count
Nombre de fichiers de vidage de diagnostic IBM MQ (FFST/FDC — écrits lorsque le gestionnaire de files d'attente enregistre une erreur interne). Un nombre croissant signale des problèmes qui méritent d'être examinés.
métrique
Description
ibmmq_queue_depth
Nombre actuel de messages dans la file d'attente.
ibmmq_queue_attribute_max_depth
Profondeur maximale configurée de la file d'attente.
ibmmq_queue_oldest_message_age
Âge du message le plus ancien dans la file d’attente, en secondes.
ibmmq_queue_uncommitted_messages
Nombre de messages non validés.
ibmmq_queue_time_since_put
Secondes depuis le dernier MQPUT vers la file d’attente.
ibmmq_queue_time_since_get
Secondes écoulées depuis le dernier MQGET de la file d’attente.
ibmmq_queue_input_handles
Descripteurs d'entrée ouverts (consommateurs) sur la file d'attente.
ibmmq_queue_output_handles
Descripteurs de sortie ouverts (producteurs) sur la file d'attente.
ibmmq_queue_browse_handles
Descripteurs de navigation ouverts sur la file d'attente.
ibmmq_queue_publish_handles
Descripteurs de publication ouverts sur la file d'attente.
ibmmq_queue_qfile_current_size
Taille actuelle du fichier de file d'attente sur le disque.
ibmmq_queue_qfile_max_size
Taille maximale du fichier de file d'attente sur le disque.
Ces compteurs suivent les appels d'API de messages principaux d'IBM MQ par file d'attente : MQPUT / MQPUT1 (placer un message dans une file d'attente) et MQGET (obtenir un message d'une file d'attente). Ils nécessitent que les statistiques MQI soient activées sur le gestionnaire de files d'attente (voir Collecte de métriques).
métrique
Description
ibmmq_queue_mqput_count
MQPUTOpérations /MQPUT1 sur la file d'attente.
ibmmq_queue_mqget_count
MQGET opérations sur la file d'attente.
ibmmq_queue_mqput_bytes / ibmmq_queue_mqget_bytes
Octets placés dans/récupérés de la file d’attente.
État d'exécution du canal (3 = en cours d'exécution).
ibmmq_channel_status_squash
Statut de canal simplifié avec moins de valeurs d'énumération (informatif ; pour les alertes, utilisez ibmmq_channel_status et la référence des codes de statut).
Secondes écoulées depuis le dernier message sur le canal.
ibmmq_channel_type / ibmmq_channel_instance_type
Type de canal/type d'instance.
ibmmq_channel_substate
Sous-état du canal.
Ces compteurs à l'échelle du gestionnaire de files d'attente résument l'activité de l'API et les échecs sur tous les objets — utiles pour repérer les erreurs d'application et le roulement des transactions. Ils nécessitent que les statistiques MQI soient activées (voir Collecte de métriques).
métrique
Description
ibmmq_qmgr_interval_mqput_mqput1_total_count
Total des appels MQPUT + MQPUT1 dans l'intervalle.
ibmmq_qmgr_interval_destructive_get_total_count
Nombre total d'appels MQGET destructifs dans l'intervalle.
ibmmq_qmgr_published_to_subscribers_message_count
Messages publiés aux abonnés (débit de publication/abonnement).
Messages expirés dans l'ensemble du gestionnaire de files d'attente.
ibmmq_qmgr_purged_queue_count
Files d'attente purgées.
Les métriques d'état IBM MQ signalent des valeurs d'énumération numériques, et non1/0 — et la valeur saine (« running ») diffère selon la métrique (2 pour l'état au niveau du gestionnaire de files d'attente, 3 pour l'état du canal). Alertez sur l'inégalité par rapport à la valeur d'exécution (par exemple, ibmmq_qmgr_status != 2) :
métrique
Valeur saine
Signification
ibmmq_qmgr_status
2
Le gestionnaire de files d'attente est en cours d'exécution
ibmmq_qmgr_command_server_status
2
Le serveur de commandes est en cours d'exécution
ibmmq_qmgr_channel_initiator_status
2
L'initiateur de canal est en cours d'exécution
ibmmq_channel_status
3
Le canal est en cours d'exécution
Toute autre valeur (ou un point de données manquant) signifie que le composant n'est pas dans son état d'exécution.
Attributs de ressource
Le collecteur attache des attributs d'identité et de contexte à chaque métrique IBM MQ. Certains sont communs à tous les déploiements ; d'autres dépendent du fait que le collecteur s'exécute sur un hôte Linux ou dans Kubernetes.
Attribut
Description
Exemple
target.name
Attribut d'identité stable — le premier segment de chaque GUID d'entité IBM MQ. Injecté en tant qu'étiquette de scraping targetName, puis renommé en target.name par le collecteur.
prod-mq-01, prod-mq-cluster
qmgr
Nom du gestionnaire de files d'attente (étiquette brute de l'exportateur ; la synthèse d'entité se base dessus).
QM1
queue
Nom de la file d'attente (sur les métriques à l'échelle de la file d'attente).
APP.ORDERS.IN
channel
Nom du canal (sur les métriques à l'échelle du canal).
APP.SVRCONN
cluster.name
Tag de regroupement facultatif pour les gestionnaires de files d’attente dans le même cluster MQ. Ne fait pas partie du GUID de l’entité ; il est sûr de le laisser non défini ou de le modifier ultérieurement.
prod-mq
instrumentation.provider
Toujours opentelemetry pour cette intégration ; utilisez-le pour restreindre les requêtes au chemin OpenTelemetry.
opentelemetry
Attribut
Description
Exemple
host.id
Identifiant de l’hôte exécutant le collecteur, à partir du processeur resourcedetection (détecteurs system / ec2). Relie le gestionnaire de files d’attente à son entité d’hôte sous-jacente.
i-1234567890abcdef0
Attribut
Description
Exemple
k8s_namespace
Espace de nommage du pod de l'exportateur découvert, estampillé par les règles de réétiquetage du collecteur.
ibmmq
k8s_pod
Nom du pod de l'exportateur découvert.
qm1-0
host.id
Identifiant du nœud exécutant le pod, à partir de resourcedetection.
ip-10-0-1-23
Détails de la collecte des métriques
Fréquence de collecte
Intervalle par défaut: 60 secondes (le scrape_interval du collecteur). Il doit être supérieur ou égal au pollInterval propre à l'exportateur mq-metric-samples.
Configurable: ajustez IBMMQ_SCRAPE_INTERVAL (Linux) ou scrape_interval dans le values.yaml Helm (Kubernetes).
Source des données
Toutes les métriques proviennent de l'exportateur mq-metric-samples, qui interroge chaque gestionnaire de files d'attente via PCF et republie les statistiques sous forme de métriques Prometheus sur un point de terminaison HTTP /metrics. Le récepteur prometheus du collecteur scrape ce point de terminaison.
types métriques
Jauges — valeurs ponctuelles telles que ibmmq_qmgr_status, ibmmq_queue_depth et ibmmq_channel_status. Graphique avec latest().
Compteurs — totaux cumulés tels que ibmmq_queue_mqput_count. Le Processeur cumulativetodelta du collecteur les convertit en temporalité delta, donc créez des graphiques avec sum() ou rate() plutôt qu'avec latest().