Dynatrace Hub

Extend the platform,
empower your team.

Popular searches:

Home hero bg

IBM MQ (Local)

Monitor your IBM MQ queue managers. Collect queues, channels, topics, listener performance metrics.

Extension by Dynatrace

Health overview dashboard

Queue manager overview

Alias queues and channels overview

Topics overview

Queue manager properties

Queue performance

Queue properties

Channel performance

Channel properties

Topics performance

Host screen outlining queue managers on that host

Product information
Release notes

Overview

On this new version of this popular extension, collect performance metrics from your queue managers running locally on your OneAgent host. Capture metadata and new metrics on this version.

Metrics

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.
Uptime: Time in seconds since last time queue manager started
Connections: Number of active connections to queue manager
Queues count: Number of queues being monitored by the extension
DLQ depth: If DLQ is enabled, number of messages in dead letter queue
Active channels: Number of channels in an active state
Log utilization: Percentage estimate of how well the queue manager workload is contained within the primary log space
Log in use: Percentage of the primary log space in use for restart recovery
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.
Log reuse size: Amount of space occupied, in megabytes, by log extents available to be reused.

Queues

Depth: Number of messages in queue
Depth percentage: Percentage of messages filling up queue
Inhibit GET: Whether queue inhibits MQGET
Inhibit PUT: Whether queue inhibits MQPUT
Open input handles: Number of handles opened by applications for input
Open output handles: Number of handles opened by applications for output
Uncommitted messages: Number of handles opened by applications for output

In order to retrieve the following metrics, queue monitoring must be enabled on queues. Any monitoring resolution will start collecting these statistics.

Oldest message: Age in seconds of the oldest message on the queue.
Last GET: Time at which the last message was successfully read from the queue.
Last PUT: Time at which the last message was successfully put in queue.
Short time indicator: Amount of time that a message spent on the queue over a short period.
Long time indicator: Amount of time that a message spent on the queue over a long period.

In order to retrieve the following metrics, statistics on queues are reset. To reset them, CHG permission must be granted to queues

Enqueue count: Number of messages enqueued. This count includes messages that have been put to the queue, but have not yet been committed.
Dequeue count: 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.
Enqueue rate: Number of messages enqueued per second.
Dequeue rate: Number of messages dequeued per second.

Channels:

Messages: Number of messages sent or received, or number of MQI calls handled.
Bytes sent: Number of bytes sent
Bytes received: Number of bytes received
Buffers sent: Number of buffers sent.
Buffers received: Number of buffers received.
Last message sent: Time when last message was sent, or MQI call was handled
In-doubt: Whether the channel is currently in doubt. 0 = No. 1 = Yes
In-doubt messages: Number of messages in-doubt
Current shared conversations: Number of conversations currently active on this channel instance. This parameter is returned only for TCP/IP server-connection channels.
Channel instances: Number of instances of this channel. This metric is only available to server-connection channels.
Batches: Number of completed batches
Network time 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.
Network time 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.
XMIT queue time short: Time, in microseconds, that messages remained on the transmission queue before being retrieved over a short period.
XMIT queue time long: Time, in microseconds, that messages remained on the transmission queue before being retrieved over a longer period.
Channel status: Used to round up channel status counts for alerting and charting purposes
Long retries left: Number of long retry attempts remaining
Short retries left: Number of short retry attempts remaining

Listeners

Availability: Percentage this listener was running and available.

Topics

Publish count: The number of applications currently publishing to the topic.
Subcription count: The number of subscribers for this topic string, including durable subscribers who are not currently connected.
Inhibit publish: Whether publishes are not allowed
Inhibit subscription: Whether subscriptions are not allowed

Get started

Requirements

OneAgent for Windows or Linux only.
OneAgent must be running and monitoring queue manager processes.
Dynatrace version 1.261+
IBM MQ 9.x+
IBM MQ Command server must be running on queue managers
MQ Libraries must be in PATH on Windows or LD_LIBRARY_PATH on Linux. User running extension must be able to find these libraries.

Additional requirements for Linux systems:

User running the OneAgent (dtuser by default) must also have access to the queue manager directories (/var/mqm/log, /var/mqm/qmgrs/<queue_manager>) so that it can bind properly.
Ensure MQ libraries are accessible by dtuser or whichever user your OneAgent service is running under. Default location for these libraries is /opt/mqm/lib64
By default, IBM MQ installs an ldconfig file called /etc/ld.so.config.d/mqm.conf that adds /usr/lib64 to the LD_LIBRARY_PATH. Make sure IBM MQ library symbolic links to /opt/mqm/lib64 are found in that path. If there is no reference in /usr/lib64 to /opt/mqm/lib64 libraries, you may have to create your own .conf file and place it in /etc/ld.so.config.d/.

User permissions to MQ objects

IBM MQ extension permissions

Note:

Permissions above must be granted to all objects, not just those ones entered in extension filters.
CHG permission is only required if collecting Enqueue/Dequeue metrics.

Dynatrace configuration

Under Extensions on the left menu, select IBM MQ.

Add a monitoring configuration.

This OneAgent extension, also referred as "Local", can run on a specific host, host groups, hosts in a management zone or tagged hosts.

Select which hosts will run this extension
- Log level: Enable DEBUG only when troubleshooting or support makes that recommendation.
- Add a Queue Manager: Any queue managers matching its filter will use this configuration. You may create one separate configuration per queue manager on host, or one configuration for all queue managers on that host.
- Queue manager filter: A name matching this filter will be matched against running processes on this host. If a name matches this filter, all settings on this configuration endpoint will apply to it.
- User: Optional but recommended to add a user. Otherwise, if left blank, IBM MQ will try to authenticate user running process, dtuser by default.
- Password: Password to user above.
- Objects to monitor: Two methods of adding objects.
  - Using new wizard mode, just click buttons to enter rules. If there is an object you absolutely do not want to monitor then remove that rule.
  - Advanced mode, add filters in a comma-separated fashion under each tab. Hover your mouse over the (i) icon next to each object type for rules and examples.
- Send log event on Dead letter queue: Enable this if you would like any DLQ on any queue manager matching this configuration to trigger a log event indicating that the number of messages in DLQ exceeded threshold. You may create an alert based on that log event
- Send log event on high queue depth from queue manager: Enable this if you would like any matching queue on any queue manager in this configuration to trigger a log event when its configured depth threshold is exceeded. This threshold is configured on IBM MQ.
- Send log event on low queue depth from queue manager: Enable this if you would like any matching queue on any queue manager in this configuration to trigger a log event when its configured depth lower than threshold. This threshold is configured on IBM MQ.
- Retrieve topology for improved transaction tracing: Enabling this setting will collect mappings for alias queues, remote queues, and cluster queues. This mapping is then sent to Dynatrace to complement mapping information for improved transaction tracing. You may only need to collect this once unless your mappings on IBM MQ change frequently. When enabled, enter a Dynatrace token to communicate with the API with these permission: Read settings, Write settings.
- Lastly, select which feature sets (metric groups) you would like this configuration to collect. Selecting too few will not give you the proper visibility and you may miss out on important performance data, as well as key indicators that can be correlated between different objects.

IBM MQ monitoring configuration

Support

Built and supported by Dynatrace

Dynatrace support center

Subscribe to new releases

copy to clipboard

Extension content

Content typeNumber of items included

screen injections

2

screen layout

6

screen logs cards

1

screen chart groups

12

list screen layout

6

screen events cards

1

screen actions

12

screen metric tables

1

generic type

6

dashboards

1

screen properties

6

metric metadata

49

screen entities lists

23

generic relationship

12

alerts

8

screen message cards

12

metric query

2

Feature sets

Below is a complete list of the feature sets provided in this version. To ensure a good fit for your needs, individual metrics 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
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
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
Channel status	ibmmq.channel.status	Used to round up channel status counts for alerting and charting purposes	Unspecified

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

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
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

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

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
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
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
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
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
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
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
In-doubt	ibmmq.channel.in_doubt	Whether the channel is currently in doubt. 0 = No. 1 = Yes	Unspecified

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

Related to IBM MQ (Local)

OneAgent

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

Full version history

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

ReleaseDate

Fixed issue with Advanced Mode object collection

Release notes:

Developed in Dynatrace's Extension Framework 2.0
New metrics.
New configuration screen.
New dashboards.
New filters.
Supports Alias queues.
New topic metrics.
New entities. You can now tag entities too.
New relationships.
Ability to select feature sets of metrics to collect.

Dynatrace Hub

Build your own app

All (669)Log Management and Analytics Kubernetes Infrastructure Observability Automations Application Observability Application Security Digital Experience Business Analytics

Dynatrace Developer

Discover recent additions to Dynatrace

Site Reliability Guardian

Get automated change impact analysis for release and change validation.

DevSecOps Lifecycle Coverage with Snyk

Connect Snyk container scans and Dynatrace runtime insights for strong security.

Business Flow

Track, analyze, and optimize your critical business processes.

Salesforce Insights

Monitor Salesforce performance, user experience, adoption, and threats.

Carbon Impact

Track, analyze and reduce the carbon footprint of your hybrid cloud environment.

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 for Workflows

Create, query, comment on, and resolve Jira tickets within your workflows.

Slack for Workflows

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.

Third-party vulnerabilities

Detect vulnerabilities in real time, with context and automated risk assessment.

Code-level vulnerabilities

Detect vulnerabilities in your code in real time.

Attacks

Get a real-time overview of all the attacks on your environment.

Are you looking for something different?We have hundred 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.