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:
- Log in to IBM Cloud.
- Click View resources.
- In the Services section, click the IBM® MQ as a Service instance that you plan to monitor.
- 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.
- 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:
- Log in to IBM Cloud.
- Click View resources.
- In the Services section, click the IBM® MQ as a Service instance that you plan to monitor.
- 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:
- Launch the Sysdig web UI.
- Select DASHBOARDS.
- In the Default Dashboards section, expand IBM.
- 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.
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
Alter durable subscription count
Count of alter durable subscriptions for a queue manager
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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 |