Once the collector is running and data is flowing, you can view your IBM MQ metrics in New Relic, query them with NRQL, build dashboards, and set up alerts. Each queue manager appears as an IBMMQ_MANAGER entity (keyed as target.name:qmgr) with its queues as child IBMMQ_QUEUE entities.
View your IBM MQ data in New Relic
After a few minutes, IBM MQ metrics appear in New Relic. The pipeline preserves the raw Prometheus shape — underscore metric names (ibmmq_*) and the raw qmgr and queue labels — and stamps a target.name identity onto every metric, which New Relic uses to synthesize the entities.
To troubleshoot any data visibility issues, refer to Troubleshooting documentation.
Query your data with NRQL
팁
Query metrics by their underscore names and raw labels — ibmmq_qmgr_status, ibmmq_queue_depth, qmgr, queue. The metric names are not dotted and the qmgr label is not renamed, so NRQL written against ibmmq.* or ibmmq.queue_manager.name will not match.
Use case | Query |
|---|---|
To confirm data is flowing to every IBM MQ metric | |
To count the queue managers reporting (each becomes one | |
To view queue manager status ( | |
To view channel status ( | |
To view current depth of every monitored queue | |
To view dead-letter queue depth across the fleet as a common alert signal | |
To view queue throughput, puts and gets per minute. This requires MQI statistics enabled | |
To browse entities directly, go to All entities in the New Relic UI and filter for your IBMMQ_MANAGER and IBMMQ_QUEUE entities, or open a queue manager from any of the queries above.
Create custom dashboards
To build your own IBM MQ dashboard:
- Go to one.newrelic.com > Dashboards and click Create a dashboard.
- Add a widget, choose Add a chart, and paste any of the NRQL queries above.
- Group widgets by focus area for an at-a-glance view:
- Queue manager health —
ibmmq_qmgr_status,ibmmq_qmgr_connection_count,ibmmq_channel_status - Queue depth and backlog —
ibmmq_queue_depth,ibmmq_queue_oldest_message_age,ibmmq_queue_uncommitted_messages - Throughput —
ibmmq_queue_mqput_count,ibmmq_queue_mqget_count(charted as a rate) - Capacity —
ibmmq_qmgr_log_in_use_bytes,ibmmq_qmgr_queue_manager_file_system_in_use_bytes
- Queue manager health —
Set up alerts
Create NRQL alert conditions on the ibmmq_* metrics to catch problems before they affect the applications that depend on your messaging.
The following table shows recommended IBM MQ alert conditions:
Alert | NRQL query | Recommended threshold |
|---|---|---|
Queue manager not running | | Critical when the value is not equal to |
Channel not running | | Critical when the value is not equal to |
Queue filling toward its maximum | | Warning at |
Messages on the dead-letter queue | | Critical when the value is greater than |