| 1 | name: mq |
| 2 | display_name: IBM MQ |
| 3 | description: | |
| 4 | Monitors IBM MQ queue managers, queues, channels, and topics |
| 5 | using the PCF (Programmable Command Format) protocol. |
| 6 | |
| 7 | By default the collector tracks the critical system queues `SYSTEM.DEAD.LETTER.QUEUE`, |
| 8 | `SYSTEM.ADMIN.COMMAND.QUEUE`, and `SYSTEM.ADMIN.STATISTICS.QUEUE`. All other queues are |
| 9 | opt-in via the `include_queues` list, with `exclude_queues` removing noisy patterns such as |
| 10 | `SYSTEM.*` or `AMQ.*`. Include patterns take precedence over excludes so you can safely |
| 11 | monitor individual system queues while dropping the broader wildcard. |
| 12 | |
| 13 | Per-queue charts are bounded by `max_queues` (default 50). When more queues are discovered, |
| 14 | the collector exports the busiest ones individually, rolls the remainder into an |
| 15 | aggregated `__other__` dimension, and logs a throttled warning listing the overflowed |
| 16 | groups. Parallel queue-group charts summarise depth, traffic, and backlog per naming |
| 17 | prefix (first two dot-separated segments, collapsing all `SYSTEM.*` queues together), so |
| 18 | high-level visibility is never lost even when detailed charts are trimmed. |
| 19 | icon: ibm-mq.png |
| 20 | categories: |
| 21 | - data-collection.applications |
| 22 | link: https://www.ibm.com/products/mq |
| 23 | keywords: |
| 24 | - message queue |
| 25 | - middleware |
| 26 | - enterprise messaging |
| 27 | - pcf |
| 28 | - ibm mq |