Une fois le collecteur en cours d’exécution et que les données circulent, vous pouvez afficher vos métriques IBM MQ dans New Relic, effectuer des requêtes sur celles-ci avec NRQL, créer des dashboards et configurer des alertes. Chaque gestionnaire de files d’attente apparaît comme une entité IBMMQ_MANAGER (avec pour clé target.name:qmgr) avec ses files d’attente comme entités IBMMQ_QUEUE enfants.
Affichez vos données IBM MQ dans New Relic
Après quelques minutes, les métriques IBM MQ apparaissent dans New Relic. Le pipeline préserve la forme brute de Prometheus — les noms de métriques avec trait de soulignement (ibmmq_*) et les étiquettes brutes qmgr et queue — et attribue une identité target.name à chaque métrique, que New Relic utilise pour synthétiser les entités.
Pour dépanner tout problème de visibilité des données, consultez la documentation de Dépannage.
Interrogez vos données avec NRQL
Conseil
Interrogez les métriques par leurs noms avec tiret bas et leurs labels bruts — ibmmq_qmgr_status, ibmmq_queue_depth, qmgr, queue. Les noms de métriques ne sont pas séparés par des points et le label qmgr n’est pas renommé, donc le NRQL écrit pour ibmmq.* ou ibmmq.queue_manager.name ne correspondra pas.
Cas d'utilisation | Qequête |
|---|---|
Pour confirmer que les données circulent vers chaque métrique IBM MQ | |
Pour compter les gestionnaires de files d'attente qui remontent des données (chacun devient une entité
) | |
Pour afficher le statut du gestionnaire de files d'attente (
\= en cours d'exécution), une ligne par gestionnaire de files d'attente | |
Pour afficher le statut du canal (
\= en cours d'exécution) | |
Pour afficher la profondeur actuelle de chaque file d'attente monitorée | |
Pour afficher la profondeur de la file d'attente de lettres mortes sur l'ensemble du parc comme signal d'alerte commun | |
Pour afficher le débit de la file d'attente, les écritures et les lectures par minute. Cela nécessite que les statistiques MQI soient activées | |
Pour parcourir les entités directement, accédez à All entities dans l'UI de New Relic et filtrez pour vos entités IBMMQ_MANAGER et IBMMQ_QUEUE, ou ouvrez un gestionnaire de files d'attente à partir de l'une des requêtes ci-dessus.
Créer des dashboards personnalisés
Pour créer votre propre dashboard IBM MQ :
Allez à one.newrelic.com > Dashboards et cliquez sur Create a dashboard.
Ajoutez un widget, choisissez Add a chart et collez l'une des requêtes NRQL ci-dessus.
Regroupez les widgets par domaine d’intérêt pour une vue d’ensemble :
- Santé du gestionnaire de files d’attente —
ibmmq_qmgr_status,ibmmq_qmgr_connection_count,ibmmq_channel_status - Profondeur de la file d'attente et backlog —
ibmmq_queue_depth,ibmmq_queue_oldest_message_age,ibmmq_queue_uncommitted_messages - Débit —
ibmmq_queue_mqput_count,ibmmq_queue_mqget_count(représenté sous forme de taux) - Capacité —
ibmmq_qmgr_log_in_use_bytes,ibmmq_qmgr_queue_manager_file_system_in_use_bytes
- Santé du gestionnaire de files d’attente —
Configurer des alertes
Créez des conditions d'alerte NRQL sur les métriques ibmmq_* pour détecter les problèmes avant qu'ils n'affectent les applications qui dépendent de votre messagerie.
Le tableau suivant présente les conditions d'alerte IBM MQ recommandées :
Alerte | Requête NRQL | Seuil recommandé |
|---|---|---|
Gestionnaire de files d'attente non en cours d'exécution | | Critique lorsque la valeur n'est pas égale à
pendant au moins 2 minutes. |
Canal inactif | | Critique lorsque la valeur n'est pas égale à
pendant au moins 5 minutes. |
File d'attente se remplissant vers son maximum | | Avertissement à
, critique à
. |
Messages dans la file d'attente de rebut | | Critique lorsque la valeur est supérieure à
. |