IBM Cloud Docs
Monitoring a queue manager with Sysdig

Monitoring a queue manager with Sysdig

IBM® MQ as a Service, paid plans, generate metrics from queue managers that are displayed in your IBM Cloud Monitoring instances. IBM Cloud Monitoring is operated by Sysdig in partnership with IBM.

Platform metrics overview

You can configure 1 instance only of the IBM Cloud Monitoring service per region to collect platform metrics.

  • To configure the Sysdig instance, you must turn on the platform metrics configuration setting.
  • If a Sysdig instance in a region is already enabled to collect platform metrics, metrics from Sysdig-enabled services are collected automatically and available for monitoring through this instance. For more information about Sysdig-enabled services, see Cloud services.

Important: To monitor platform metrics, check that the IBM Cloud Monitoring instance is provisioned in the same region where the IBM® MQ as a Service instance is provisioned.

Enabling platform metrics from the IBM® MQ as a Service dashboard

Complete the following steps to configure platform metrics:

  1. Log in to IBM Cloud.
  2. Click View resources.
  3. In the Services section, click the IBM® MQ as a Service instance that you plan to monitor.
  4. Click the overflow menu. Then, select Add monitoring to configure platform metrics in the region of your IBM® MQ as a Service instance. Note: If the menu choices include the option Monitoring, then your instance is already configured for platform metrics.
  5. Provision an instance of the IBM Cloud Monitoring service.

Note: After you provision the Sysdig instance, the Observabvility page opens. To continue working with IBM® MQ as a Service, go back to the IBM® MQ as a Service UI.

For more information about how to configure Sysdig instances to receive queue manager metrics, see Provisioning an instance.

Viewing metrics

Important: To monitor IBM® MQ as a Service metrics, you must launch the Sysdig web UI instance that is enabled for platform metrics in the region where your IBM® MQ as a Service instance is available.

There are different options to launch the Sysdig web UI and monitor metrics:

Launching Sysdig web UI from the IBM® MQ as a Service dashboard

Complete the following steps to launch the Sysdig web UI from the IBM® MQ as a Service dashboard:

  1. Log in to IBM Cloud.
  2. Click View resources.
  3. In the Services section, click the IBM® MQ as a Service instance that you plan to monitor.
  4. Click the overflow menu. Then, select Monitoring.

A new tab in your browser opens and displays the Default dashboard named Queue Managers within the context of your IBM® MQ as a Service instance.

Launching Sysdig web UI from the Observability page

Complete the following steps to launch the Sysdig web UI from the Observability page:

  1. Launch the Sysdig web UI.
  2. Select DASHBOARDS.
  3. In the Default Dashboards section, expand IBM.
  4. Choose the Queue managers dashboard from the list.

Next, change the scope or make a copy of the Default dashboard to monitor an IBM® MQ as a Service instance.

Where to look for IBM® MQ as a Service metrics

The region in which IBM® MQ as a Service metrics are available corresponds to the region of the queue manger that generated the metrics.

The following table shows the location of IBM® MQ as a Service metrics.

Location of IBM® MQ as a Service metrics
Region for your MQ SaaS instance Location of IBM® MQ as a Service metrics
us-south Dallas (us-south)
us-east Washington DC (us-east)
eu-de Frankfurt (eu-de)
eu-gb London (eu-gb)

Metrics dictionary for queue managers

Table 1: Metrics Available by Plan Names
Metric Name
Alter durable subscription count
Commit count
Create durable subscription count
Create non-durable subscription count
Delete durable subscription count
Delete non-durable subscription count
Expired message count
Failed MQCB count
Failed MQCLOSE count
Failed MQCONN/MQCONNX count
Failed MQGET count
Failed MQINQ count
Failed MQOPEN count
Failed MQPUT count
Failed MQPUT1 count
Failed MQSET count
Failed MQSUBRQ count
Failed browse count
Failed create/alter/resume subscription count
Failed topic MQPUT/MQPUT1 count
Got non-persistent messages - byte count
Got persistent messages - byte count
Interval total MQPUT/MQPUT1 byte count
Interval total MQPUT/MQPUT1 count
Interval total destructive get
Interval total destructive get - byte count
Interval total topic bytes put
MQCB count
MQCLOSE count
MQCONN/MQCONNX count
MQCTL count
MQDISC count
MQINQ count
MQOPEN count
MQSET count
MQSTAT count
MQSUBRQ count
Non-persistent - topic MQPUT/MQPUT1 count
Non-persistent message MQPUT count
Non-persistent message MQPUT1 count
Non-persistent message browse - byte count
Non-persistent message browse count
Non-persistent message get - byte count
Persistent - topic MQPUT/MQPUT1 count
Persistent message MQPUT count
Persistent message MQPUT1 count
Persistent message browse - byte count
Persistent message browse - count
Persistent message destructive get - count
Published to subscribers - byte count
Published to subscribers - message count
Purged queue count
Put non-persistent messages - byte count
Put persistent messages - byte count
Queue Manager file system - bytes in use
Queue Manager file system - free space
Resume durable subscription count
Rollback count
Subscription delete failure count
Topic MQPUT/MQPUT1 interval total

Alter durable subscription count

Count of alter durable subscriptions for a queue manager

Table 2: Alter durable subscription count metric metadata
Metadata Description
Metric Name ibm_mq_qmgr_durable_subscription_alter_total
Metric Type counter
Value Type none
Segment By Service instance, The queue manager name

Commit count

The total number of commits for a queue manager

Table 3: Commit count metric metadata
Metadata Description
Metric Name ibm_mq_qmgr_commit_total
Metric Type counter
Value Type none
Segment By Service instance, The queue manager name

Create durable subscription count

Count of create durable subscriptions for a queue manager

Table 4: Create durable subscription count metric metadata
Metadata Description
Metric Name ibm_mq_qmgr_durable_subscription_create_total
Metric Type counter
Value Type none
Segment By Service instance, The queue manager name

Create non-durable subscription count

Total non-durable subscription create count for a queue manager

Table 5: Create non-durable subscription count metric metadata
Metadata Description
Metric Name ibm_mq_qmgr_non_durable_subscription_create_total
Metric Type counter
Value Type none
Segment By Service instance, The queue manager name

Delete durable subscription count

Count of delete durable subscriptions for a queue manager

Table 6: Delete durable subscription count metric metadata
Metadata Description
Metric Name ibm_mq_qmgr_durable_subscription_delete_total
Metric Type counter
Value Type none
Segment By Service instance, The queue manager name

Delete non-durable subscription count

Total non-durable subscription delete count for a queue manager

Table 7: Delete non-durable subscription count metric metadata
Metadata Description
Metric Name ibm_mq_qmgr_non_durable_subscription_delete_total
Metric Type counter
Value Type none
Segment By Service instance, The queue manager name

Expired message count

Total number of expired messages for a queue manager

Table 8: Expired message count metric metadata
Metadata Description
Metric Name ibm_mq_qmgr_expired_message_total
Metric Type counter
Value Type none
Segment By Service instance, The queue manager name

Failed MQCB count

Total number of failed MQCB for a queue manager

Table 9: Failed MQCB count metric metadata
Metadata Description
Metric Name ibm_mq_qmgr_failed_mqcb_total
Metric Type counter
Value Type none
Segment By Service instance, The queue manager name

Failed MQCLOSE count

Total number of failed MQCLOSE for a queue manager

Table 10: Failed MQCLOSE count metric metadata
Metadata Description
Metric Name ibm_mq_qmgr_failed_mqclose_total
Metric Type counter
Value Type none
Segment By Service instance, The queue manager name

Failed MQCONN/MQCONNX count

Total number of failed MQCONN/MQCONNX for a queue manager

Table 11: Failed MQCONN/MQCONNX count metric metadata
Metadata Description
Metric Name ibm_mq_qmgr_failed_mqconn_mqconnx_total
Metric Type counter
Value Type none
Segment By Service instance, The queue manager name

Failed MQGET count

Total number of failed MQGET for a queue manager

Table 12: Failed MQGET count metric metadata
Metadata Description
Metric Name ibm_mq_qmgr_failed_mqget_total
Metric Type counter
Value Type none
Segment By Service instance, The queue manager name

Failed MQINQ count

Total number of failed MQINQ for a queue manager

Table 13: Failed MQINQ count metric metadata
Metadata Description
Metric Name ibm_mq_qmgr_failed_mqinq_total
Metric Type counter
Value Type none
Segment By Service instance, The queue manager name

Failed MQOPEN count

Total number of failed MQOPEN for a queue manager

Table 14: Failed MQOPEN count metric metadata
Metadata Description
Metric Name ibm_mq_qmgr_failed_mqopen_total
Metric Type counter
Value Type none
Segment By Service instance, The queue manager name

Failed MQPUT count

Total number of failed MQPUT for a queue manager

Table 15: Failed MQPUT count metric metadata
Metadata Description
Metric Name ibm_mq_qmgr_failed_mqput_total
Metric Type counter
Value Type none
Segment By Service instance, The queue manager name

Failed MQPUT1 count

Total number of failed MQPUT1 for a queue manager

Table 16: Failed MQPUT1 count metric metadata
Metadata Description
Metric Name ibm_mq_qmgr_failed_mqput1_total
Metric Type counter
Value Type none
Segment By Service instance, The queue manager name

Failed MQSET count

Total number of failed MQSET for a queue manager

Table 17: Failed MQSET count metric metadata
Metadata Description
Metric Name ibm_mq_qmgr_failed_mqset_total
Metric Type counter
Value Type none
Segment By Service instance, The queue manager name

Failed MQSUBRQ count

Total number of failed MQSUBRQ for a queue manager

Table 18: Failed MQSUBRQ count metric metadata
Metadata Description
Metric Name ibm_mq_qmgr_failed_mqsubrq_total
Metric Type counter
Value Type none
Segment By Service instance, The queue manager name

Failed browse count

Total number of failed browses for a queue manager

Table 19: Failed browse count metric metadata
Metadata Description
Metric Name ibm_mq_qmgr_failed_browse_total
Metric Type counter
Value Type none
Segment By Service instance, The queue manager name

Failed create/alter/resume subscription count

Total number of failed create/alter/resume subscriptions for a queue manager

Table 20: Failed create/alter/resume subscription count metric metadata
Metadata Description
Metric Name ibm_mq_qmgr_failed_subscription_create_alter_resume_total
Metric Type counter
Value Type none
Segment By Service instance, The queue manager name

Failed topic MQPUT/MQPUT1 count

Total number of failed topic MQPUT/MQPUT1 for a queue manager

Table 21: Failed topic MQPUT/MQPUT1 count metric metadata
Metadata Description
Metric Name ibm_mq_qmgr_failed_topic_mqput_mqput1_total
Metric Type counter
Value Type none
Segment By Service instance, The queue manager name

Got non-persistent messages - byte count

Total non-persistent message get count for a queue manager

Table 22: Got non-persistent messages - byte count metric metadata
Metadata Description
Metric Name ibm_mq_qmgr_non_persistent_message_destructive_get_total
Metric Type counter
Value Type byte
Segment By Service instance, The queue manager name

Got persistent messages - byte count

Total persistent messages get byte count for a queue manager

Table 23: Got persistent messages - byte count metric metadata
Metadata Description
Metric Name ibm_mq_qmgr_persistent_message_get_bytes_total
Metric Type counter
Value Type byte
Segment By Service instance, The queue manager name

Interval total MQPUT/MQPUT1 byte count

Total MQPUT/MQPUT1 byte count for a queue manager

Table 24: Interval total MQPUT/MQPUT1 byte count metric metadata
Metadata Description
Metric Name ibm_mq_qmgr_mqput_mqput1_bytes_total
Metric Type counter
Value Type byte
Segment By Service instance, The queue manager name

Interval total MQPUT/MQPUT1 count

Total MQPUT/MQPUT1 count for a queue manager

Table 25: Interval total MQPUT/MQPUT1 count metric metadata
Metadata Description
Metric Name ibm_mq_qmgr_mqput_mqput1_total
Metric Type counter
Value Type none
Segment By Service instance, The queue manager name

Interval total destructive get

Total number of call to destructive GET for a queue manager

Table 26: Interval total destructive get metric metadata
Metadata Description
Metric Name ibm_mq_qmgr_destructive_get_total
Metric Type counter
Value Type none
Segment By Service instance, The queue manager name

Interval total destructive get - byte count

Total number of bytes from destructive GET for a queue manager

Table 27: Interval total destructive get - byte count metric metadata
Metadata Description
Metric Name ibm_mq_qmgr_destructive_get_bytes_total
Metric Type counter
Value Type byte
Segment By Service instance, The queue manager name

Interval total topic bytes put

Total topic bytes put interval for a queue manager

Table 28: Interval total topic bytes put metric metadata
Metadata Description
Metric Name ibm_mq_qmgr_topic_put_bytes_total
Metric Type counter
Value Type none
Segment By Service instance, The queue manager name

MQCB count

Total MQCB count for a queue manager

Table 29: MQCB count metric metadata
Metadata Description
Metric Name ibm_mq_qmgr_mqcb_total
Metric Type counter
Value Type none
Segment By Service instance, The queue manager name

MQCLOSE count

Total MQCLOSE count for a queue manager

Table 30: MQCLOSE count metric metadata
Metadata Description
Metric Name ibm_mq_qmgr_mqclose_total
Metric Type counter
Value Type none
Segment By Service instance, The queue manager name

MQCONN/MQCONNX count

Total MQCONN/MQCONNX count for a queue manager

Table 31: MQCONN/MQCONNX count metric metadata
Metadata Description
Metric Name ibm_mq_qmgr_mqconn_mqconnx_total
Metric Type counter
Value Type none
Segment By Service instance, The queue manager name

MQCTL count

Total MQCTL count for a queue manager

Table 32: MQCTL count metric metadata
Metadata Description
Metric Name ibm_mq_qmgr_mqctl_total
Metric Type counter
Value Type none
Segment By Service instance, The queue manager name

MQDISC count

Total MQDISC count for a queue manager

Table 33: MQDISC count metric metadata
Metadata Description
Metric Name ibm_mq_qmgr_mqdisc_total
Metric Type counter
Value Type none
Segment By Service instance, The queue manager name

MQINQ count

Total MQINQ count for a queue manager

Table 34: MQINQ count metric metadata
Metadata Description
Metric Name ibm_mq_qmgr_mqinq_total
Metric Type counter
Value Type none
Segment By Service instance, The queue manager name

MQOPEN count

Total MQOPEN count for a queue manager

Table 35: MQOPEN count metric metadata
Metadata Description
Metric Name ibm_mq_qmgr_mqopen_total
Metric Type counter
Value Type none
Segment By Service instance, The queue manager name

MQSET count

Total MQSET count for a queue manager

Table 36: MQSET count metric metadata
Metadata Description
Metric Name ibm_mq_qmgr_mqset_total
Metric Type counter
Value Type none
Segment By Service instance, The queue manager name

MQSTAT count

Total MQSTAT count for a queue manager

Table 37: MQSTAT count metric metadata
Metadata Description
Metric Name ibm_mq_qmgr_mqstat_total
Metric Type counter
Value Type none
Segment By Service instance, The queue manager name

MQSUBRQ count

Total MQSUBRQ count for a queue manager

Table 38: MQSUBRQ count metric metadata
Metadata Description
Metric Name ibm_mq_qmgr_mqsubrq_total
Metric Type counter
Value Type none
Segment By Service instance, The queue manager name

Non-persistent - topic MQPUT/MQPUT1 count

Total non-persistent topic MQPUT/MQPUT1 count for a queue manager

Table 39: Non-persistent - topic MQPUT/MQPUT1 count metric metadata
Metadata Description
Metric Name ibm_mq_qmgr_non_persistent_topic_mqput_mqput1_total
Metric Type counter
Value Type none
Segment By Service instance, The queue manager name

Non-persistent message MQPUT count

Total non-persistent message MQPUT count for a queue manager

Table 40: Non-persistent message MQPUT count metric metadata
Metadata Description
Metric Name ibm_mq_qmgr_non_persistent_message_mqput_total
Metric Type counter
Value Type none
Segment By Service instance, The queue manager name

Non-persistent message MQPUT1 count

Total non-persistent message MQPUT1 count for a queue manager

Table 41: Non-persistent message MQPUT1 count metric metadata
Metadata Description
Metric Name ibm_mq_qmgr_non_persistent_message_mqput1_total
Metric Type counter
Value Type none
Segment By Service instance, The queue manager name

Non-persistent message browse - byte count

Total non-persistent message browse byte count for a queue manager

Table 42: Non-persistent message browse - byte count metric metadata
Metadata Description
Metric Name ibm_mq_qmgr_non_persistent_message_browse_bytes_total
Metric Type counter
Value Type byte
Segment By Service instance, The queue manager name

Non-persistent message browse count

Total non-persistent message browse count for a queue manager

Table 43: Non-persistent message browse count metric metadata
Metadata Description
Metric Name ibm_mq_qmgr_non_persistent_message_browse_total
Metric Type counter
Value Type none
Segment By Service instance, The queue manager name

Non-persistent message get - byte count

Total non-persistent message get byte count for a queue manager

Table 44: Non-persistent message get - byte count metric metadata
Metadata Description
Metric Name ibm_mq_qmgr_non_persistent_message_get_bytes_total
Metric Type counter
Value Type byte
Segment By Service instance, The queue manager name

Persistent - topic MQPUT/MQPUT1 count

Total persistent topic MQPUT/MQPUT1 count for a queue manager

Table 45: Persistent - topic MQPUT/MQPUT1 count metric metadata
Metadata Description
Metric Name ibm_mq_qmgr_persistent_topic_mqput_mqput1_total
Metric Type counter
Value Type none
Segment By Service instance, The queue manager name

Persistent message MQPUT count

Total persistent message MQPUT count for a queue manager

Table 46: Persistent message MQPUT count metric metadata
Metadata Description
Metric Name ibm_mq_qmgr_persistent_message_mqput_total
Metric Type counter
Value Type none
Segment By Service instance, The queue manager name

Persistent message MQPUT1 count

Total persistent message MQPUT1 count for a queue manager

Table 47: Persistent message MQPUT1 count metric metadata
Metadata Description
Metric Name ibm_mq_qmgr_persistent_message_mqput1_total
Metric Type counter
Value Type none
Segment By Service instance, The queue manager name

Persistent message browse - byte count

Total persistent message browse byte count for a queue manager

Table 48: Persistent message browse - byte count metric metadata
Metadata Description
Metric Name ibm_mq_qmgr_persistent_message_browse_bytes_total
Metric Type counter
Value Type byte
Segment By Service instance, The queue manager name

Persistent message browse - count

Total persistent message browse count for a queue manager

Table 49: Persistent message browse - count metric metadata
Metadata Description
Metric Name ibm_mq_qmgr_persistent_message_browse_total
Metric Type counter
Value Type none
Segment By Service instance, The queue manager name

Persistent message destructive get - count

Total persistent message destructive get count for a queue manager

Table 50: Persistent message destructive get - count metric metadata
Metadata Description
Metric Name ibm_mq_qmgr_persistent_message_destructive_get_total
Metric Type counter
Value Type none
Segment By Service instance, The queue manager name

Published to subscribers - byte count

Total published to subscribers byte count for a queue manager

Table 51: Published to subscribers - byte count metric metadata
Metadata Description
Metric Name ibm_mq_qmgr_published_to_subscribers_bytes_total
Metric Type counter
Value Type byte
Segment By Service instance, The queue manager name

Published to subscribers - message count

Total published to subscribers message count for a queue manager

Table 52: Published to subscribers - message count metric metadata
Metadata Description
Metric Name ibm_mq_qmgr_published_to_subscribers_message_total
Metric Type counter
Value Type none
Segment By Service instance, The queue manager name

Purged queue count

Total purged queue count for a queue manager

Table 53: Purged queue count metric metadata
Metadata Description
Metric Name ibm_mq_qmgr_purged_queue_total
Metric Type counter
Value Type none
Segment By Service instance, The queue manager name

Put non-persistent messages - byte count

Total non-persistent messages put byte count for a queue manager

Table 54: Put non-persistent messages - byte count metric metadata
Metadata Description
Metric Name ibm_mq_qmgr_non_persistent_message_put_bytes_total
Metric Type counter
Value Type byte
Segment By Service instance, The queue manager name

Put persistent messages - byte count

Total persistent messages put byte count for a queue manager

Table 55: Put persistent messages - byte count metric metadata
Metadata Description
Metric Name ibm_mq_qmgr_persistent_message_put_bytes_total
Metric Type counter
Value Type byte
Segment By Service instance, The queue manager name

Queue Manager file system - bytes in use

File system bytes in use for a queue manager

Table 56: Queue Manager file system - bytes in use metric metadata
Metadata Description
Metric Name ibm_mq_qmgr_queue_manager_file_system_in_use_bytes
Metric Type gauge
Value Type byte
Segment By Service instance, The queue manager name

Queue Manager file system - free space

File system free space for a queue manager

Table 57: Queue Manager file system - free space metric metadata
Metadata Description
Metric Name ibm_mq_qmgr_queue_manager_file_system_free_space_percentage
Metric Type gauge
Value Type percent
Segment By Service instance, The queue manager name

Resume durable subscription count

Count of resume durable subscriptions for a queue manager

Table 58: Resume durable subscription count metric metadata
Metadata Description
Metric Name ibm_mq_qmgr_durable_subscription_resume_total
Metric Type counter
Value Type none
Segment By Service instance, The queue manager name

Rollback count

Rollback count for a queue manager

Table 59: Rollback count metric metadata
Metadata Description
Metric Name ibm_mq_qmgr_rollback_total
Metric Type counter
Value Type none
Segment By Service instance, The queue manager name

Subscription delete failure count

Total number of failed subscription deletes for a queue manager

Table 60: Subscription delete failure count metric metadata
Metadata Description
Metric Name ibm_mq_qmgr_failed_subscription_delete_total
Metric Type counter
Value Type none
Segment By Service instance, The queue manager name

Topic MQPUT/MQPUT1 interval total

Total topic MQPUT/MQPUT1 interval for a queue manager

Table 61: Topic MQPUT/MQPUT1 interval total metric metadata
Metadata Description
Metric Name ibm_mq_qmgr_topic_mqput_mqput1_total
Metric Type counter
Value Type none
Segment By Service instance, The queue manager name

Attributes for Segmentation

Global Attributes

The following attributes are available for segmenting all of the metrics listed above

Attribute Attribute Name Attribute Description
Cloud Type ibm_ctype The cloud type is a value of public, dedicated or local
Location ibm_location The location of the monitored resource - this may be a region, data center or global
Resource ibm_resource The resource being measured by the service - typically a indentifying name or GUID
Resource Type ibm_resource_type The type of the resource being measured by the service
Resource group ibm_resource_group_name The resource group where the service instance was created
Scope ibm_scope The scope is the account, organization or space GUID associated with this metric
Service name ibm_service_name Name of the service generating this metric

Additional Attributes

The following attributes are available for segmenting one or more attributes as described in the reference above. Please see the individual metrics for segmentation options.

Attribute Attribute Name Attribute Description
Service instance ibm_service_instance The service instance segment identifies the instance the metric is associated with
The queue manager name ibm_mq_qmgr_name The queue manager name