IBM MQ Appliance extension
- Latest Dynatrace
- Extension
- Published Oct 27, 2025
Monitor your IBM MQ Appliances over SNMP
Get started
Overview
This extension collects metrics to monitor the health and performance of your IBM MQ Appliances. Metrics are collected via SNMP protocol.
Use cases
- Monitor relevant infrastructure metrics related to your IBM MQ Appliances, such as CPU, memory, and disk usage.
- Retrieve health information from your physical environmental sensors, ensuring their temperature or power supply status is correct.
Compatibility information
- SNMP v2c or SNMP v3
- Dynatrace version 1.310+
- ActiveGate version 1.310+
Activation and setup
- Find the extension in Dynatrace Hub and add it to your environment.
- Add a monitoring configuration.
For more information, see SNMP extension data source documentation.
Details
The extension package contains:
- SNMP Data Source configuration
- Overview dashboard (Classic & Gen3)
- Custom topology types extracted from metric dimensions:
- IBM MQ Appliance
- IBM MQ Appliance Queue Manager
- SNMP MIB files used for monitoring:
- IBM-MQ-APPLIANCE-STATUS-MIB
Licensing and cost
Calculations are based on the assumption that you monitor all metrics for every feature set every minute:
DDUs:
(37+ (5 * Queue Managers)) * 525.6 DDUs/year, per appliance
DPS (Metric data points):
(37 + (5 * Queue Managers)) * 525,600 metric data points/year, per appliance
Feature sets
When activating your extension using monitoring configuration, you can limit monitoring to one of the feature sets. To work properly the extension has to collect at least one metric after the activation.
In highly segmented networks, feature sets can reflect the segments of your environment. Then, when you create a monitoring configuration, you can select a feature set and a corresponding ActiveGate group that can connect to this particular segment.
All metrics that aren't categorized into any feature set are considered to be the default and are always reported.
A metric inherits the feature set of a subgroup, which in turn inherits the feature set of a group. Also, the feature set defined on the metric level overrides the feature set defined on the subgroup level, which in turn overrides the feature set defined on the group level.
Filesystem Status
| Metric name | Metric key | Description |
|---|---|---|
| Free encrypted storage space | ibm_mq.filesystemstatus.freeencrypted | Free, or unused and available, encrypted storage space on the device. All files placed in encrypted storage are automatically encrypted for security by the device. |
| Total encrypted storage space | ibm_mq.filesystemstatus.totalencrypted | Total encrypted storage space on the device (the maximum capacity). All files placed in encrypted storage are automatically encrypted for security by the device. |
| Free internal storage space | ibm_mq.filesystemstatus.freeinternal | Free, or unused and available, internal storage space on the device. The device uses internal storage for import, export, firmware upgrades and debug captures. |
| Total internal storage space | ibm_mq.filesystemstatus.totalinternal | Total internal storage space on the device. The device uses internal storage for import, export, firmware upgrades and debug captures. |
| Free temporary storage space | ibm_mq.filesystemstatus.freetemporary | Free, or unused and available, temporary storage space on the device. The device uses temporary storage for processing, logging and debugging. |
| Total temporary storage space | ibm_mq.filesystemstatus.totaltemporary | Total temporary storage space on the device. The device uses temporary storage for processing, logging and debugging. |
Environmental Sensors
| Metric name | Metric key | Description |
|---|---|---|
| Sensor case open - Status | ibm_mq.environmental_sensor.case_open | Yes: 1 No: 2 |
| Sensor intrusion - Status | ibm_mq.environmental_sensor.check_intrusion | Yes: 1 No: 2 |
| Sensor CPU 1 temp | ibm_mq.environmental_sensor.cpu.temp.1 | — |
| Sensor CPU 2 temp | ibm_mq.environmental_sensor.cpu.temp.2 | — |
| Sensor Power Supply | ibm_mq.environmental_sensor.power_supply | OK: 1, Power 1 Failure: 2, Power 2 Failure: 3, Power 1 AC Lost: 4, Power 2 AC Lost: 5 |
| Sensory System Temp | ibm_mq.environmental_sensor.system_temp | — |
Network
| Metric name | Metric key | Description |
|---|---|---|
| Total network bytes in | ibm_mq.network.bytes.in | The number of bytes received in the network interface of the device. |
| Total network bytes out | ibm_mq.network.bytes.out | The number of bytes sent by the network interface of the device. |
Disk
| Metric name | Metric key | Description |
|---|---|---|
| Disk used | ibm_mq.disk.used | The amount of MQ storage in use in megabytes. |
| Disk total | ibm_mq.disk.total | The total storage in megabytes available for MQ data. |
| Used error storage space | ibm_mq.errorstorage.used | Free, or unused and available, error storage space on the device. |
| Total error storage space | ibm_mq.errorstorage.total | Total error storage space on the device. |
| Used trace storage space | ibm_mq.tracestorage.used | Free, or unused and available, trace storage space on the device. |
| Total trace storage space | ibm_mq.tracestorage.total | Total trace storage space on the device. |
Queue Manager
| Metric name | Metric key | Description |
|---|---|---|
| Queue manager CPU usage % | ibm_mq.queue_manager.cpu.usage | The instantaneous CPU usage by the queue manager as a percentage of the CPU load. |
| Queue manager memory used | ibm_mq.queue_manager.memory.used | The amount of memory that is currently in use by the queue manager. |
| Queue manager filesystem used | ibm_mq.queue_manager.filesystem.used | The amount of filesystem space that is currently in use by the queue manager. |
| Queue manager filesystem total | ibm_mq.queue_manager.filesystem.total | The total amount of filesystem space that is available for the queue manager. |
default
| Metric name | Metric key | Description |
|---|---|---|
| — | ibm_mq.sys.uptime | — |
| Appliance Uptime (ms) | ibm_mq.status.uptime | The total amount of time the appliance has been up since the last reload or reboot. (hundredths of a second). |
| CPU usage % | ibm_mq.cpu.usage.percent | The instantaneous CPU usage as a percentage of the CPU load. |
| CPU average load 5 min | ibm_mq.cpu.load5min.percent | The average CPU load over the last 5 minutes. |
| Used memory percentage | ibm_mq.memory.used.percent | The instantaneous memory usage as a percentage of the total memory. |
Additional memory
| Metric name | Metric key | Description |
|---|---|---|
| Free memory | ibm_mq.memory.free | The amount of memory that is currently not in use and is therefore available. The free memory value includes any hold memory that is not currently in use. |
| Total memory | ibm_mq.memory.total | The total memory of the system in megabytes. The total memory equals the amount of installed memory minus the amount of reserved memory. |
| Used memory | ibm_mq.memory.used | The amount of memory that is currently in use. The used memory equals the amount of total memory minus the amount of free memory. The used memory does not include any hold memory. |
Related tags
ApplicationSNMPMessage queueIBMApplication Observability
Message Queues
Message Queues