IBM Cloud

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 one 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 Observability 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.

You can control, to some extent, which metrics you collect.

Queue metrics
Queue metrics are not collected if online collection is disabled. Collection is controlled by a queue's MONQ attribute, which can be set to one of the following values:
  • OFF
  • LOW
  • MEDIUM
  • HIGH
  • QMGR
Metrics are not collected if MONQ is set to OFF. If set to QMGR, metrics are collected according to the setting of the MONQ attribute for the queue manager.
Channel metrics
Channel metrics are not collected if online collection is disabled. Collection is controlled by a channel's MONCHL attribute, which can be set to one of the following values:
  • OFF
  • LOW
  • MEDIUM
  • HIGH
  • QMGR
Metrics are not collected if MONCHL is set to OFF. If set to QMGR, metrics are collected according to the setting of the MONCHL attribute for the queue manager.
Subscription metrics
You can control which subscription metrics are collected by enabling or disabling metrics collection for the destination queue of the subscription.

For more information on real-time monitoring of queues and channels, see Real-time monitoring in the main IBM MQ documentation.

Viewing metrics

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.

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 IBM MQ as a Service 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 managers
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

Log file system free space percentage

The percentage of log file system that is free
Metadata Description
Metric Name ibm_mq_qmgr_log_file_system_free_space_percentage
Metric Type gauge
Value Type percent
Value Scale 1 (percentage in range 0-100)
Segment By Service instance, The queue manager name

Log sequence number disk total

The total LSNs on disk for a queue manager
Metadata Description
Metric Name ibm_mq_qmgr_log_sequence_number_disk_total
Metric Type counter
Value Type none
Segment By Service instance, The queue manager name

Log sequence number quorum total

The total LSNs for a queue manager while quorum exists
Metadata Description
Metric Name ibm_mq_qmgr_log_sequence_number_quorum_total
Metric Type counter
Value Type none
Segment By Service instance, The queue manager name

Log slowest write since restart seconds

The slowest write since the last restart in seconds
Metadata Description
Metric Name ibm_mq_qmgr_log_slowest_write_since_restart_seconds
Metric Type gauge
Value Type second
Value Scale 1000000000 (seconds)
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

Replication acknowledged log sequence number total

The total LSNs acknowledged by replication target
Metadata Description
Metric Name ibm_mq_nha_replication_acknowledged_log_sequence_number_total
Metric Type count
Value Type none
Segment By Service instance, The queue manager name

Replication average network round trip time seconds

The average network round trip time for a replication in seconds
Metadata Description
Metric Name ibm_mq_nha_replication_average_network_round_trip_time_seconds
Metric Type gauge
Value Type second
Value Scale 1000000000 (seconds)
Segment By Service instance, The queue manager name

Replication backlog average bytes

Average size of replication backlog in bytes
Metadata Description
Metric Name ibm_mq_nha_replication_backlog_average_bytes
Metric Type gauge
Value Type byte
Segment By Service instance, The queue manager name

Replication backlog bytes

Size of replication backlog in bytes
Metadata Description
Metric Name ibm_mq_nha_replication_backlog_bytes
Metric Type gauge
Value Type byte
Segment By Service instance, The queue manager name

Replication catch up compressed log sent bytes

Size of replication compressed catch up in bytes
Metadata Description
Metric Name ibm_mq_nha_replication_catch_up_compressed_log_sent_bytes
Metric Type count
Value Type byte
Segment By Service instance, The queue manager name

Replication synchronous compressed log sent bytes

Size of synchronous compressed replication in bytes
Metadata Description
Metric Name ibm_mq_nha_replication_synchronous_uncompressed_log_sent_bytes
Metric Type count
Value Type byte
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
Value Scale 1 (percentage in range 0-100)
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
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   The queue manager name

Metrics dictionary for queues

Metrics are not available for SYSTEM queues, with the following exceptions:
  • SYSTEM.ADMIN.*
  • SYSTEM.CLUSTER.TRANSMIT.*
  • SYSTEM.DEAD.LETTER.QUEUE

Depth

Size of current queue depth in bytes
Metadata Description
Metric Name ibm_mq_queue_depth
Metric Type count
Value Type byte
Segment By
Service instance,
queue manager name,
queue name,
queue usage,
queue cluster,
queue description

Maximum queue depth percentage

Percentage of maximum queue depth that the queue currently uses
Metadata Description
Metric Name ibm_mq_queue_max_depth_percentage
Metric Type gauge
Value Type percentage
Value Scale 1 (percentage in range 0-100)
Segment By
Service instance,
queue manager name,
queue name,
queue usage,
queue cluster,
queue description

Time since last message get

The time since the last message get on the queue
Metadata Description
Metric Name ibm_mq_queue_time_since_get
Metric Type gauge
Value Type second
Value Scale 1000000000 (seconds)
Segment By
Service instance,
queue manager name,
queue name,
queue usage,
queue cluster,
queue description

Time since last message put

The time since the last message put on the queue
Metadata Description
Metric Name ibm_mq_queue_time_since_put
Metric Type gauge
Value Type second
Value Scale 1000000000 (seconds)
Segment By
Service instance,
queue manager name,
queue name,
queue usage,
queue cluster,
queue description

Input handles

The number of open handles to the queue for getting messages
Metadata Description
Metric Name ibm_mq_queue_input_handles
Metric Type gauge
Value Type none
Segment By
Service instance,
queue manager name,
queue name,
queue usage,
queue cluster,
queue description

Output handles

The number of open handles to the queue for putting messages
Metadata Description
Metric Name ibm_mq_queue_output_handles
Metric Type gauge
Value Type none
Segment By
Service instance,
queue manager name,
queue name,
queue usage,
queue cluster,
queue description

Oldest message age

The age of the oldest message on the queue
Metadata Description
Metric Name ibm_mq_queue_oldest_message_age
Metric Type gauge
Value Type second
Value Scale 1000000000 (seconds)
Segment By
Service instance,
queue manager name,
queue name,
queue usage,
queue cluster,
queue description

Queue time short

The short-term average time of messages on the queue
Metadata Description
Metric Name ibm_mq_queue_time_short
Metric Type gauge
Value Type second
Value Scale 1000 (microseconds)
Segment By
Service instance,
queue manager name,
queue name,
queue usage,
queue cluster,
queue description

Queue time long

The long-term average time of messages on the queue
Metadata Description
Metric Name ibm_mq_queue_time_long
Metric Type gauge
Value Type second
Value Scale 1000 (microseconds)
Segment By
Service instance,
queue manager name,
queue name,
queue usage,
queue cluster,
queue description

Additional Attributes

The following attributes are available for segmenting one or more attributes as described in the preceding reference. 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
The queue name ibm_mq_queue_name The queue name
The queue usage ibm_mq_queue_usage The queue usage
The queue cluster ibm_mq_queue_cluster The queue cluster
The queue description ibm_mq_queue_description The queue description

The queue usage label value is either XMITQ or NORMAL.

Metrics dictionary for channels

Channel status

The status of the channel
Metadata Description
Metric Name ibm_mq_channel_status
Metric Type gauge
Value Type none
Segment By
Service instance,
queue manager name,
channel type,
channel name,
remote queue manager name,
connection name,
job name,
CipherSpec

The values of the channel status metric correspond to the PCF constants used by IBM MQ for channel status:

Value Constant
0 MQCHS_INACTIVE
1 MQCHS_BINDING
2 MQCHS_STARTING
3 MQCHS_RUNNING
4 MQCHS_STOPPING
5 MQCHS_RETRYING
6 MQCHS_STOPPED
7 MQCHS_REQUESTING
8 MQCHS_PAUSED
9 MQCHS_DISCONNECTED
13 MQCHS_INITIALIZING
14 MQCHS_SWITCHING

Additional Attributes

The following attributes are available for segmenting one or more attributes as described in the preceding reference. 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
The channel type ibm_mq_channel_type The channel type
The channel name ibm_mq_channel_name The channel name
The remote queue manager name ibm_mq_channel_rqmname The remote queue manager name
The connection name ibm_mq_channel_conname The connection name
The job name ibm_mq_channel_jobname The job name
The CipherSpec ibm_mq_channel_sslciph The CipherSpec

The channel type is the name of the PCF channel type constant (MQCHT_xxx) without the MQCHT_ prefix. For example, a server connection channel has the PCF channel type constant of MQCHT_SVRCONN, so the value of the label is SVRCONN.

The PCF constants used by IBM MQ for channel type are as follows:

Value Constant
1 MQCHT_SENDER
2 MQCHT_SERVER
3 MQCHT_RECEIVER
4 MQCHT_REQUESTER
5 MQCHT_ALL
6 MQCHT_CLNTCONN
7 MQCHT_SVRCONN
8 MQCHT_CLUSRCVR
9 MQCHT_CLUSSDR
10 MQCHT_MQTT
11 MQCHT_AMQP

Metrics dictionary for subscriptions

Messages received

The number of messages put to the subscription's destination
Metadata Description
Metric Name ibm_mq_subscription_messages_received
Metric Type counter
Value Type none
Segment By
Service instance,
queue manager name,
subscription name,
subscription ID,
subscription Type,
topic string

Time since message published

The time since a published message was put to the subscription's destination
Metadata Description
Metric Name ibm_mq_subscription__time_since_message_published
Metric Type gauge
Value Type second
Value Scale 1000000000 (seconds)
Segment By
Service instance,
queue manager name,
subscription name,
subscription ID,
subscription Type,
topic string

The PCF constants used by IBM MQ for subscription type are as follows:

Value Constant
1 MQSUBTYPE_API
2 MQSUBTYPE_ADMIN
3 MQSUBTYPE_PROXY

Additional Attributes

The following attributes are available for segmenting one or more attributes as described in the preceding reference. 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
The subscription name ibm_mq_subscription_name The subscription name
The subscription ID ibm_mq_subscription_id The subscription ID
The subscription type ibm_mq_subscription_type The subscription type
The topic string ibm_mq_subscription_topic_string The topic string
The CipherSpec ibm_mq_channel_sslciph The CipherSpec