IBM MQ

Monitor performance of your IBM MQ queue manager objects.

Extension

Free trial Documentation

Product information
Release notes

Overview

With the Extensions Framework 2.0 release of the IBM MQ extension, collect performance metrics from your queue managers running locally on your OneAgent host or remotely from your ActiveGates.

New metadata and metrics are included in this version.

Use cases

Monitor IBM MQ infrastructure, including Queue Managers, Queues, Channels, Topics, and listeners.
Get alerted if a Queue Manager recently has started, is not available, has retrying channels, and more.
Monitor your IBM MQ by deploying locally on a OneAgent monitored-host, or remotely using an ActiveGate.

Compatibility information

Reference the Get Started section for more details on compatibility information.

Subscribe to new releases

Copy to clipboard

Extension content

Content typeNumber of items included

screen injections

2

screen entities lists

29

screen logs cards

2

list screen layout

9

generic relationship

17

document dashboard

1

screen dql table

16

metric metadata

63

screen message cards

28

screen events cards

2

screen actions

10

generic type

9

screen chart groups

34

screen layout

18

dashboards

1

screen properties

9

metric query

4

alerts

8

Feature sets

Below is a complete list of the feature sets provided in this version. To ensure a good fit for your needs, individual feature sets can be activated and deactivated by your administrator during configuration.

Feature setsNumber of metrics included

Metric name	Metric key	Description	Unit
Inhibit publish	ibmmq.topic.inhibit_pub	Whether publishes are not allowed	Unspecified
Inhibit subscription	ibmmq.topic.inhibit_sub	Whether subscriptions are not allowed	Unspecified

Metric name	Metric key	Description	Unit
Connections	ibmmq.queue_manager.connections	Number of active connections to queue manager	Count
Queues count	ibmmq.queue_manager.monitored_queues	Number of monitored queues	Count
DLQ depth	ibmmq.queue_manager.dlq_depth	Number of messages in dead letter queue	Count
Active channels	ibmmq.queue_manager.active_channels	Number of channels in an active current status	Count

Metric name	Metric key	Description	Unit
Channel instances	ibmmq.channel.instances	Number of instances of this channel. This metric is only available to server-connection channels.	Count
Total channel instances used	ibmmq.channel.total_instances_pct	Percentage of instances of this channel over its max intances. This metric is only available to server-connection channels.	Percent
Current shared conversations	ibmmq.channel.current_sharing_convs	Number of conversations currently active on this channel instance. This parameter is returned only for TCP/IP server-connection channels.	Count

Metric name	Metric key	Description	Unit
Total pages	ibmmq.queue_manager.usage.pageset.total_pages	The total number of 4 KB pages in the page set. Available only on z/OS IBM MQ	Count
Expand count	ibmmq.queue_manager.usage.pageset.expand_cnt	The number of times the page set has been dynamically expanded since restart. Available only on z/OS IBM MQ	Count
Unused pages	ibmmq.queue_manager.usage.pageset.unused_pages	The number of pages that are not used (that is, available page sets). Available only on z/OS IBM MQ	Count
Persistent pages	ibmmq.queue_manager.usage.pageset.persistent_data_pages	The number of pages holding persistent data. Available only on z/OS IBM MQ	Count
Non-persistent pages	ibmmq.queue_manager.usage.pageset.nonpersistent_data_pages	The number of pages holding nonpersistent data. Available only on z/OS IBM MQ	Count
Free buffers	ibmmq.queue_manager.usage.buffer_pool.free_buffers	Number of free buffers in buffer pool. Available only on z/OS IBM MQ	Count
Percent of free buffers	ibmmq.queue_manager.usage.buffer_pool.percent_free_buffers	Number of free buffers as a percentage of all buffers in the buffer pool. Available only on z/OS IBM MQ	Percent
Total buffers	ibmmq.queue_manager.usage.buffer_pool.total_buffers	The number of buffers defined for specified buffer pool. Available only on z/OS IBM MQ	Count

Metric name	Metric key	Description	Unit
Bytes sent	ibmmq.channel.bytes_sent	Number of bytes sent	Byte
Bytes received	ibmmq.channel.bytes_rcvd	Number of bytes received	Byte
Buffers sent	ibmmq.channel.buffers_sent	Number of buffers sent.	Count
Buffers received	ibmmq.channel.buffers_rcvd	Number of buffers received.	Count

Metric name	Metric key	Description	Unit
Last message sent	ibmmq.channel.last_msg	Time when last message was sent, or MQI call was handled	Second
Network time short	ibmmq.channel.nettime_short	Amount of time, in microseconds, to send an end of batch request to the remote end of the channel and receive a response over a short period.	MicroSecond
Network time long	ibmmq.channel.nettime_long	Amount of time, in microseconds, to send an end of batch request to the remote end of the channel and receive a response over a longer period.	MicroSecond
XMIT queue time short	ibmmq.channel.xmitqtime_short	Time, in microseconds, that messages remained on the transmission queue before being retrieved over a short period.	MicroSecond
XMIT queue time long	ibmmq.channel.xmitqtime_long	Time, in microseconds, that messages remained on the transmission queue before being retrieved over a longer period.	MicroSecond

Metric name	Metric key	Description	Unit
Availability	ibmmq.listener.availability	Percentage this listener was running and available.	Percent

Metric name	Metric key	Description	Unit
Oldest message	ibmmq.queue.oldest_message	Age in seconds of the oldest message on the queue.	Second
Uncommitted messages	ibmmq.queue.uncommitted_messages	Number of handles opened by applications for output	Count
Last GET	ibmmq.queue.last_get	Time at which the last message was successfully read from the queue.	MilliSecond
Last PUT	ibmmq.queue.last_put	Time at which the last message was successfully put in queue.	MilliSecond
Short time indicator	ibmmq.queue.time_indicator_short	Amount of time that a message spent on the queue over a short period.	MicroSecond
Long time indicator	ibmmq.queue.time_indicator_long	Amount of time that a message spent on the queue over a long period.	MicroSecond

Metric name	Metric key	Description	Unit
Inhibit GET	ibmmq.queue.inhibit_get	Whether queue inhibits MQGET	Unspecified
Inhibit PUT	ibmmq.queue.inhibit_put	Whether queue inhibits MQPUT	Unspecified

Metric name	Metric key	Description	Unit
In-doubt	ibmmq.channel.in_doubt	Whether the channel is currently in doubt. 0 = No. 1 = Yes	Unspecified

Metric name	Metric key	Description	Unit
Enqueue count	ibmmq.queue.enqueue_cnt	Number of messages enqueued. This count includes messages that have been put to the queue, but have not yet been committed. Enqueue rate also comes with this metric.	Count
Dequeue count	ibmmq.queue.dequeue_cnt	Number of messages dequeued. This count includes messages that have been successfully retrieved (with a nonbrowse MQGET) from the queue, even though the MQGET has not yet been committed. Dequeue rate also comes with this metric.	Count

Metric name	Metric key	Description	Unit
Open input handles	ibmmq.queue.open_input_handles	Number of handles opened by applications for input	Count
Open output handles	ibmmq.queue.open_output_handles	Number of handles opened by applications for output	Count

Metric name	Metric key	Description	Unit
Publish count	ibmmq.topic.pub_cnt	The number of applications currently publishing to the topic.	Count
Subcription count	ibmmq.topic.sub_cnt	The number of subscribers for this topic string, including durable subscribers who are not currently connected.	Count

Metric name	Metric key	Description	Unit
Depth	ibmmq.queue.depth	Number of messages in queue	Count
Depth percentage	ibmmq.queue.depth_percent	Percentage of messages filling up queue	Percent

Metric name	Metric key	Description	Unit
Channel status	ibmmq.channel.status	Used to round up channel status counts for alerting and charting purposes	Unspecified
Last started time	ibmmq.channel.last_started	Time when this channel was last started	Second

Metric name	Metric key	Description	Unit
Log utilization	ibmmq.queue_manager.log_utilization	Percentage estimate of how well the queue manager workload is contained within the primary log space	Percent
Log in use	ibmmq.queue_manager.log_in_use	Percentage of the primary log space in use for restart recovery	Percent
Log archive size	ibmmq.queue_manager.log_archive_size	Amount of space occupied, in megabytes, by log extents no longer required for restart or media recovery, but waiting to be archived.	MegaByte
Log reuse size	ibmmq.queue_manager.log_reuse_size	Amount of space occupied, in megabytes, by log extents available to be reused.	MegaByte
z/OS Total log data sets	ibmmq.queue_manager.total_log_data_sets	The total number of active log data sets.	Count
z/OS Full log data sets	ibmmq.queue_manager.full_log_data_sets	The total number of full active log data sets that have not yet been archived.	Count

Metric name	Metric key	Description	Unit
Availability	ibmmq.queue_manager.availability	Percentage of time queue manager was reachable and available to this extension. While a queue manager sometimes may be up and running, availability is within the context of this extension.	Percent
Uptime	ibmmq.queue_manager.uptime	Time in seconds since last time queue manager started	Second

Metric name	Metric key	Description	Unit
Long retries left	ibmmq.channel.long_retries_left	Number of long retry attempts remaining	Count
Short retries left	ibmmq.channel.short_retries_left	Number of short retry attempts remaining	Count

Metric name	Metric key	Description	Unit
Messages	ibmmq.channel.messages	Number of messages sent or received, or number of MQI calls handled.	Count
Batches	ibmmq.channel.batches	Number of completed batches	Count
In-doubt messages	ibmmq.channel.current_messages	Number of messages in-doubt	Count

Related to IBM MQ

OneAgent

The simplest way to capture all observation signals automatically and in context

ActiveGate

Route traffic, monitor clouds and remote technologies & run Synthetic monitors

IBM MQ

Monitor performance of your IBM MQ queue manager objects.

Full version history

To have more information on how to install the downloaded package, please follow the instructions on this page.

ReleaseDate

Full version history

⚠️ Important Change:

Minimum EEC version requirement was increased to 1.313.0

What's new:

Added support to auto-defined cluster sender channels
Added Endpoint status roll up to monitoring configuration.

Fixed in this version:

Resolved an issue where channel instances metric was incorrect.
Resolved an issue where Dead Letter Queue access was too broad on z/OS.

Full version history

Fixed in this version:

Fixed issue when channel auto-definition was enabled and extension would stop monitoring.

Full version history

⚠️ IMPORTANT ⚠️

Minimum EEC version and Dynatrace version were increased to 1.313

New in this version:

Added enablePCFResponseExpiry JVM parameter to work around IBM MQ (APAR IT11161) issue that could leave messages orphaned in Reply queues.
Added auto-defined channel support.
Added support for OpenShift routing using Outbound SNI
Added Last start time metric to channels.
Added error codes to facilitate troubleshooting.
Added more situations that could indicate Queue Manager is not reachable from extension.

Fixed in this version:

Resolved issue where logs were not showing for local deployment
Resolved performance issue when collecting channels using bulk mode.

Full version history

Issues resolved in this version:

An issue where ActiveChannels and Channels would not display or show any data.
An issue where Total Channels Percentage metric was not correct.
An issue where extension would not start on custom installations where there would be a mix of config folders across multiple locations.

Features in this version:

New generation dashboard has been added.

Full version history

⚠️IMPORTANT CHANGE⚠️

This extension version requires minimum Dynatrace cluster version 1.310.

In this version:

New dashboard compatible with new Dynatrace look & feel.

Full version history

Issues resolved in this version:

Resolved issue where Active Channels metric was not showing on Remote version.
Resolved issue where Channel metrics could spike up when going into Retrying mode on certain MQ use cases.
Resolved issue where Topology could not be sent to Dynatrace API on newer ActiveGate versions.

Full version history

Fixed in this version:

Issue where broken connections would not auto-reconnect.
Issue with reading local configuration on OneAgent (Local) deployment.
High/Low Queue Depth Limit dimension is sent every minute to allow for metric events to work properly.

New metric:

Total Channel Instances Percent

Full version history

Release notes:

⚠️ When migrating from any version below 3.5.x, please read 3.5.2 Release Notes

Changes in this version:

Short/Long retries channel metric adjustment.
Disable auto-alerting feature was added.
Task bucket size feature was added to optimize resource utilization across ActiveGates.
Fixed issue with a gap occurring once an hour for certain dimensions on channels.

Full version history

⚠️ When migrating from any version below 3.5.x, please read 3.5.2 Release Notes

Changes in this version:

Minor filters fix

Full version history

⚠️IMPORTANT CHANGE⚠️

This version takes filtering rules and evaluates them in sequential order. This allows you to enter more complex filtering rules based on results from the previous step.

For example:

Monitor all queues
Do not monitor queues that start with SYSTEM.
Monitor queues that start with SYSTEM.CLUSTER.
Do not monitor queues that start with SYSTEM.CLUSTER.TRANSMIT.

will evaluate them in that specific order.

Same as: *, -SYSTEM*, SYSTEM.CLUSTER*, -SYSTEM.CLUSTER.TRANSMIT.*

Make sure you review your rules when upgrading to this version to ensure they are ordered in the sequence you want to evaluate them
In case you need to change the order, there is no need to recreate rules. You can drag & drop them using your mouse over the dots next to each rule.

Other changes:

actual_qm_name property is in all entities.
Resolved "No KeepAlive from datasource Python" message in some specific instances that was causing restarts.
Resolved issue with channel metrics on z/OS that were not aggregating properly.

Full version history

Resolved java error on ConcurrentModification exception

Full version history

Resolved issue with channels showing incremental values.
Some large numbers display as negative.

Full version history

Note: All patches are cumulative. For a list of fixes and enhancements, please look at Release notes in previous releases.

In this release:

Resolved an issue on Windows Local deployments only where it could not find MQ libraries.

Full version history

Fixed an issue on z/OS and channel metrics coming in once an hour.
Fixed an issue where some dimensions regarding QSG were missing.
Fixed an issue where topology was not being sent.
Minor bug fixes

Full version history

Fixed issue that caused gaps in metrics.
Modified data collection to no longer require permissions to all objects but still optional when collecting data in bulk.
Added functionality to send a log event when multi-instanced queue manager switch hosts (failover). This allows the creation of alerting when failover occurs.
Minor improvements and bug fixes

Full version history

Resolves a java error dependency on java.time.Instant#seconds

Full version history

Credential Vault support was added.
Ability to Rename/Prefix queue managers allowing you to have same queue manager names from different environments or datacenters.
Minor fixes.

Full version history

Improved memory consumption.
Added Connection name list and Connected host properties to MQ objects (Remote deployment only).
Fixed non-ascii characters in description fields causing rejection.
Fixed issue causing extension initialization problems on some rare use cases.
Fixed an issue with filters no picking up new channels.

Full version history

Solved an issue with connections that gave a MQRC_QMGR_NAME_ERROR error

Full version history

Solved a communication error with cluster when sending Topology data.
Added Management zone support to metrics.
Added type of activation, configuration labels and description to Queue manager metadata for rapid configuration lookup.
Various UI fixes

Full version history

⚠️ For customers upgrading from versions 3.0.x, new entities will be created for all objects (queue managers, queues, channels, topics, listeners). You will see double entities temporarily, and it will fix itself over time. Your old entities will eventually fall off. Please update any references to any existing entities in any custom alert rules or any custom dashboards you may have created. This change does not affect customers coming from 1.x.x or 2.x.x versions. Please disregard this warning if you are not upgrading from 3.0.x.

Added support to Remote (ActiveGate) deployment, therefore consolidating activations.
Added Remote queues
Made adjustments to Unified Analysis screens to reflect new metrics and deployment.
Support for z/OS and AIX on Remote deployment only.
Fixed issue with circular dependencies in libraries.

Discover recent additions to Dynatrace

Problems

Analyze abnormal system behavior and performance problems detected by Davis AI.

Logs

Explore all your logs without writing a single query.

Security Investigator

Fast and precise forensics for security and logs on Grail data with DQL queries.

Business Flow

Track, analyze, and optimize your critical business processes.

Cost & Carbon Optimization

Track, analyze, and optimize your IT carbon footprint and public cloud costs.

Davis Anomaly Detection

Detect anomalies in timeseries using the Davis AI

Analyze your data

Understand your data better with deep insights and clear visualizations.

Notebooks

Create powerful, data-driven documents for custom analytics and collaboration.

Dashboards

Transform complex data into clear visualizations with custom dashboards.

Automate your processes

Turn data and answers into actions, securely, and at scale.

Workflows

Automate tasks in your IT landscape, remediate problems, and visualize processes

Jira

Create, query, comment, transition, and resolve Jira tickets within workflows.

Slack

Automate Slack messaging for security incidents, attacks, remediation, and more.

Secure your cloud application

See vulnerabilities and attacks in your environment.

Security Overview

Get a comprehensive overview of the security of your applications.

Code-Level Vulnerabilities

Detect vulnerabilities in your code in real time.

Security Posture Management

Detect, prioritize, and remediate security and compliance findings with SPM.

Threats & Exploits

Understand, triage, and investigate detection findings and alerts.

Are you looking for something different?

We have hundreds of apps, extensions, and other technologies to customize your environment

Leverage our newest innovations of Dynatrace Saas

Kick-start your app creation

Kick-start your app creation

Whether you’re a beginner or a pro, Dynatrace Developer has the tools and support you need to create incredible apps with minimal effort.

Go to Dynatrace Developer

Upgrading from Dynatrace Managed to SaaS

Upgrading from Dynatrace Managed to SaaS

Drive innovation, speed, and agility in your organization by seamlessly and securely upgrading.

Log Management and Analytics

Log Management and Analytics

Innovate faster and more efficiently with unified log management and log analytics for actionable insights and automation.