IBM MQ (Local)

Supported by Dynatrace

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

Overview
Get started
Metrics
Versions
Screenshots

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.

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

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

Metrics

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

Name	Metric key	Unit	Description
Availability	ibmmq.queue_manager.availability	Percent	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	ibmmq.queue_manager.uptime	Second	Time in seconds since last time queue manager started

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

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

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

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

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

Name	Metric key	Unit	Description
Last message sent	ibmmq.channel.last_msg	Second	Time when last message was sent, or MQI call was handled
Network time short	ibmmq.channel.nettime_short	MicroSecond	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	ibmmq.channel.nettime_long	MicroSecond	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	ibmmq.channel.xmitqtime_short	MicroSecond	Time, in microseconds, that messages remained on the transmission queue before being retrieved over a short period.
XMIT queue time long	ibmmq.channel.xmitqtime_long	MicroSecond	Time, in microseconds, that messages remained on the transmission queue before being retrieved over a longer period.

Name	Metric key	Unit	Description
Channel status	ibmmq.channel.status	Unspecified	Used to round up channel status counts for alerting and charting purposes

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

Name	Metric key	Unit	Description
Enqueue count	ibmmq.queue.enqueue_cnt	Count	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.
Dequeue count	ibmmq.queue.dequeue_cnt	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. Dequeue rate also comes with this metric.

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

Name	Metric key	Unit	Description
Log utilization	ibmmq.queue_manager.log_utilization	Percent	Percentage estimate of how well the queue manager workload is contained within the primary log space
Log in use	ibmmq.queue_manager.log_in_use	Percent	Percentage of the primary log space in use for restart recovery
Log archive size	ibmmq.queue_manager.log_archive_size	MegaByte	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	ibmmq.queue_manager.log_reuse_size	MegaByte	Amount of space occupied, in megabytes, by log extents available to be reused.

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

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

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

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

Name	Metric key	Unit	Description
Channel instances	ibmmq.channel.instances	Count	Number of instances of this channel. This metric is only available to server-connection channels.
Current shared conversations	ibmmq.channel.current_sharing_convs	Count	Number of conversations currently active on this channel instance. This parameter is returned only for TCP/IP server-connection channels.

Versions

Keep up-to-date with newest releases

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

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.

Screenshots

Keywords

extension
ibm-mq
message-queue
monitoring
mq

Related technologies

OneAgent

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

Dynatrace Hub

Extend the platform,
empower your team.

Popular searches:

Home hero bg

Dynatrace Hub

Hub homeBuild your own app

All (665)Log Management and Analytics Kubernetes Infrastructure Monitoring Automation Applications & Microservices Application Security Digital Experience Business Analytics

Dynatrace Developer

Discover recent additions to Dynatrace

Business Flow

Track, analyze, and optimize your critical business processes.

Carbon Impact

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

DevSecOps Lifecycle Coverage with Snyk

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

Salesforce Insights

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

Site Reliability Guardian

Get automated change impact analysis for release and change validation.

Analyze your data

Understand your data better with deep insights and clear visualizations.

Dashboards

Transform complex data into clear visualizations with custom dashboards.

Notebooks

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

Automate your processes

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

Jira for Workflows

Create Jira tickets, comment, and resolve tickets. Populate custom fields and query Jira for enriched workflow functionality.

Slack for Workflows

Send Slack messages, manage communication within threads, and more.

Workflows

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

Secure your cloud application

See vulnerabilities and attacks in your environment.

Attack Protection

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

Code-level vulnerabilities

Detect vulnerabilities in your code in real time.

Security overview

Get a comprehensive overview of the security of your applications.

Third-party vulnerabilities

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

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.