+

Search Tips | Advanced Search

Monitor system resource usage

We use the Charts widget in the IBM MQ Console to view monitoring data for queue managers.


About this task

You add a Charts widget to your dashboard and then configure it to monitor a particular aspect of resource usage. We can create many instances of the Charts widget to display different data. The data is displayed in a chart format.

Data is collected at 10-second intervals. The X-axis of the chart displays a timeline. The Y-axis displays units appropriate to the resource that you are viewing. The Y-axis is dynamically resized to accommodate the data that is returned.

You must have at least one running queue manager before we can configure a chart widget.

We cannot monitor system resource usage on z/OS®.


Procedure

  1. Add a Charts widget to your dashboard:
    1. Click the Add widget icon .
    2. Select Charts.
  2. Configure the Charts widget to show data:
    1. Click the configure icon in the title bar of the Charts widget.
    2. Optional: Enter a Widget title. This title is shown in the title bar of the widget.
    3. Select the Resource class to monitor:

        Platform central processing units
        Monitor the usage of the CPUs.

        Platform persistent data stores
        Monitor the use of disk resource.

        API usage statistics
        Monitor API calls.

        API per-queue usage statistics
        Monitor API calls by individual queues. When you choose this class, you specify the queue name to monitor in the Object field.

    4. Select the Resource type to monitor. The resource types that are available to select depend on the resource class that is selected. The following table shows the resource types:
      Table 1. Resource types
      Class Type Description
      Platform central processing units

      CPU performance - platform wide

      		 Select this type to view performance data for the CPUs and memory.
       

      CPU performance - running queue manager

      		 Select this type to view performance data for the CPUs and memory that is related to the queue managers that you are monitoring. A queue manager must be running for you to monitor it. If you are monitoring results from more than one queue manager, different colors are used to distinguish the performance data in the chart.

      Platform persistent data stores

      Disk usage - platform wide

      		 Select this type to view performance data for global disk usage.
       

      Disk usage - running queue managers

      		 Select this type to view performance data for the disk usage that is related to the queue managers that you are monitoring. A queue manager must be running for you to monitor it. If you are monitoring results from more than one queue manager, different colors are used to distinguish the performance data in the chart.
       

      Disk usage - queue manager recovery log

      		 Select this type to view data on how disk storage is being used for the recovery log of each queue manager that you are monitoring.

      API usage statistics

      MQCONN and MQDISC

      		Select this type to view data on MQCONN and MQDISC calls.
       

      MQOPEN and MQCLOSE

      		 Select this type to view data on MQOPEN and MQCLOSE calls.
       

      MQINQ and MQSET

      		 Select this type to view data on MQINQ and MQSET calls.
       

      MQPUT

      		 Select this type to view data on MQPUT-related calls.
       

      MQGET

      		 Select this type to view data on MQGET-related calls.
       

      Commit and rollback

      		 Select this type to view information about the use of sync points by the queue manager.
       

      Subscribe

      		 Select this type to view data that is related to MQSUB calls.
       

      Publish

      		 Select this type to view data about published messages.
      API per-queue usage statistics

      MQOPEN and MQCLOSE

      		 Select this type to view data on MQOPEN and MQCLOSE calls for the specified queue.
       

      MQINQ and MQSET

      		 Select this type to view data on MQINQ and MQSET calls for the specified queue.
       

      MQPUT and MQPUT1

      		 Select this type to view data on MQPUT-related and MQPUT1-related calls for the specified queue.
       

      MQGET

      		 Select this type to view data on MQGET-related calls for the specified queue.
    5. Select the Resource element to monitor: The resource elements that are available to select depend on the resource class and resource type that are selected. The following tables show the resource elements:
      Table 2. Elements for Platform central processing units resources
      Type Element Description
      CPU performance - platform wide

      User CPU time percentage

      		 Shows the percentage of CPU busy in user state.
       

      System CPU time percentage

      		 Shows the percentage of CPU busy in system state.
       

      CPU load - one-minute average

      		 Shows the load average over 1 minute.
       

      CPU load - five-minute average

      		 Shows the load average over 5 minutes.
       

      CPU load - fifteen-minute average

      		 Shows the load average over fifteen minutes.
       

      RAM free percentage

      		 Shows the percentage of free RAM memory.
       

      RAM total bytes

      		 Shows the total bytes of RAM configured.
      CPU performance - running queue manager

      User CPU time - percentage estimate for queue manager

      		 Estimates the percentage of CPU use in user state for processes that are related to the queue managers that are being monitored.
       

      System CPU time - percentage estimate for queue manager

      		 Estimates the percentage of CPU use in system state for processes that are related to the queue managers that are being monitored.
       

      RAM total bytes - estimate for queue managers

      		 Estimates the total bytes of RAM in use by the queue managers that are being monitored.
      Table 3. Elements for Platform persistent data stores resources
      Type Element Description

      Disk usage - platform wide

      MQ trace file system - bytes in use

      		 Shows the number of bytes of disk storage that are being used by the trace file system.
       

      MQ trace file system - free space

      		 Shows the disk storage that is reserved for the trace file system that is free.
       

      MQ errors file system - bytes in use

      		 Shows the number of bytes of disk storage that is being used by error data.
       

      MQ errors file system - free space

      		 Shows the disk storage that is reserved for error data that is free.
       

      MQ FDC file count

      		 Shows the current number of FDC files.
      Disk usage - running queue managers

      Queue Manager file system - bytes in use

      		 Shows the number of bytes of disk storage that is used by queue manager files for the queue managers that you are monitoring.
       

      Queue Manager file system - free space

      		 Shows the disk storage that is reserved for queue manager files that is free.
      Disk usage - queue manager recovery log

      Log - bytes in use

      		 Shows the number of bytes of disk storage that is used for the recovery logs of the queue managers that you are monitoring.
       

      Log - bytes max

      		 Shows the maximum bytes of disk storage that is configured to be used for queue manager recovery logs.
       

      Log file system - bytes in use

      		 Shows the total number of disk bytes in use for the log file system.
       

      Log file system - bytes max

      		 Shows the number of disk bytes that are configured for the log file system.
       

      Log - physical bytes written

      		 Shows the number of bytes being written to the recovery logs.
       

      Log - logical bytes written

      		 Shows the logical number of bytes written to the recovery logs.
       

      Log - write latency

      		 Shows a measure of the latency when writing synchronously to the queue manager recovery log.
      Table 4. Elements for API usage statistics resources
      Type Element Description

      MQCONN and MQDISC

      MQCONN/MQCONNX count

      		 Shows the number of calls to MQCONN and MQCONNX.
       

      Failed MQCONN/MQCONNX count

      		 Shows the number of failed calls to MQCONN and MQCONNX.
       

      Concurrent connections - high water mark

      		 Shows the maximum number of concurrent connections in the current statistics interval.
       

      MQDISC count

      		 Shows the number of calls to MQDISC.

      MQOPEN and MQCLOSE

      MQOPEN count

      		 Shows the number of calls to MQOPEN.
       

      Failed MQOPEN count

      		 Shows the number of failed calls to MQOPEN.
       

      MQCLOSE count

      		 Shows the number of calls to MQCLOSE.
       

      Failed MQCLOSE count

      		 Shows the number of failed calls to MQCLOSE.
      MQINQ and MQSET MQINQ count Shows the number of calls to MQINQ.
        Failed MQINQ count Shows the number of failed calls to MQINQ.
        MQSET count Shows the number of calls to MQSET.
        Failed MQSET count Shows the number of failed calls to MQSET.
      MQPUT

      Interval total MQPUT/MQPUT1 count

      		 Shows the number of calls to MQPUT and MQPUT1.
       

      Interval total MQPUT/MQPUT1 byte count

      		 Shows the total bytes of data that is put by calls to MQPUT and MQPUT1.
       

      Non-persistent message MQPUT count

      		 Shows the number of non-persistent messages that are put by MQPUT.
       

      Persistent message MQPUT count

      		 Shows the number of persistent messages that are put by MQPUT.
       

      Failed MQPUT count

      		 Shows the number of failed calls to MQPUT.
       

      Non-persistent message MQPUT1 count

      		 Shows the number of non-persistent messages that are put by MQPUT1.
       

      Persistent message MQPUT1 count

      		 Shows the number of persistent messages that are put by MQPUT1.
       

      Failed MQPUT1 count

      		 Shows the number of failed calls to MQPUT1.
       

      Put non-persistent message - byte count

      		 Shows the number of bytes put in non-persistent messages.
       

      Put persistent message - byte count

      		 Shows the number of bytes put in persistent messages.
       

      MQSTAT count

      		 Shows the number of calls to MQSTAT.
       

      Failed MQSTAT count

      		 Shows the number of failed calls to MQSTAT.
      MQGET

      Interval total destructive get - count

      		 Number of messages that are removed from queues by MQGET.
        Interval total destructive get - byte count Bytes of data that is removed from queues by MQGET.
       

      Non-persistent message destructive get - count

      		 Number of non-persistent messages that are removed from queues by MQGET.
       

      Persistent message destructive get - count

      		 Number of persistent messages that are removed from queues by MQGET.
       

      Failed MQGET - count

      		 Shows the number of failed calls to MQGET.
       

      Got non-persistent messages - byte count

      		 Shows a count of bytes of non-persistent messages that are returned to MQGET.
       

      Got persistent messages - byte count

      		 Shows a count of bytes of persistent messages that are returned to MQGET.
       

      Non-persistent message browse - count

      		 Shows a count of non-persistent messages that have been browsed.
       

      Persistent message browse - count

      		 Shows a count of persistent messages that have been browsed.
       

      Failed browse count

      		 Shows a count of failed message browses.
       

      Non-persistent message browse - byte count

      		 Shows the number of bytes of non-persistent messages that have been browsed.
       

      Persistent message browse - byte count

      		 Shows the number of bytes of persistent messages that have been browsed.
       

      Expired message count

      		 Shows a count of expired messages.
       

      Purged queue count

      		 Shows a count of queues that have been purged.
       

      MQCB count

      		 Shows the number of calls to MQCB.
       

      Failed MQCB count

      		 Shows the number of failed calls to MQCB.
       

      MQCTL count

      		 Shows the number of calls to MQCTL.
       

      Failed MQCTL count

      		 Shows the number of failed calls to MQCTL.
      Commit and rollback

      Commit count

      		 Shows the number of calls to MQCMIT.
       

      Failed commit count

      		 Shows the number of failed calls to MQCMIT.
       

      Rollback count

      		 Shows the number of calls to MQBACK.
      Subscribe

      Create durable subscription count

      		 Shows the number of calls to MQSUB to create durable subscriptions.
        Alter durable subscription count Shows the number of calls to MQSUB to alter durable subscriptions.
       

      Resume durable subscription count

      		 Shows the number of calls to MQSUB to resume durable subscriptions.
       

      Create non-durable subscription count

      		 Shows the number of calls to MQSUB to create non-durable subscriptions.
       

      Alter non-durable subscription count

      		 Shows the number of calls to MQSUB to alter non-durable subscriptions.
       

      Resume non-durable subscription count

      		 Shows the number of calls to MQSUB to resume non-durable subscriptions.
       

      Failed create/alter/resume subscription count

      		 Shows the number of failed calls to MQSUBRQ to create, alter, or resume subscriptions.
       

      Delete durable subscription count

      		 Shows the number of calls to MQSUB to delete durable subscriptions.
       

      Delete non-durable subscription count

      		 Shows the number of calls to MQSUB to delete non-durable subscriptions.
        Subscription delete failure count Shows the number of calls to MQSUB to delete subscriptions.
        MQSUBRQ count Shows the number of calls to MQSUBRQ
        Failed MQSUBRQ count Shows the number of failed calls to MQSUBRQ
        Durable subscriber - high water mark Shows the maximum number of durable subscriptions in the current statistics interval.
        Durable subscriber - low water mark Shows the minimum number of durable subscriptions in the current statistics interval.
        Non-durable subscriber - high water mark Shows the maximum number of non-durable subscriptions in the current statistics interval.
        Non-durable subscriber - low water mark Shows the minimum number of non-durable subscriptions in the current statistics interval.
      Publish

      Topic MQPUT/MQPUT1 interval total

      		 The number of messages that are put to topics.
       

      Interval total topic bytes put

      		 The number of message bytes put to topics.
       

      Published to subscribers - message count

      		 Shows the number of messages that are published to subscribers.
        Published to subscribers - byte count Shows the byte count of messages that are published to subscribers.
       

      Non-persistent - topic MQPUT/MQPUT1 count

      		 Shows the number of non-persistent messages that are put to topics.
       

      Persistent - topic MQPUT/MQPUT1 count

      		 Shows the number of persistent messages that are put to topics.
       

      Failed topic MQPUT/MQPUT1 count

      		 Shows the number of failed attempts to put to a topic.
      Table 5. Elements for API per-queue usage statistics resources
      Type Element Description

      MQOPEN and MQCLOSE

      MQOPEN count

      		 Shows the number of calls to MQOPEN.
       

      MQCLOSE count

      		 Shows the number of calls to MQCLOSE.
      MQINQ and MQSET MQINQ count Shows the number of calls to MQINQ.
        MQSET count Shows the number of calls to MQSET.
      MQPUT and MQPUT1

      MQPUT/MQPUT1 count

      		 Shows the number of calls to MQPUT and MQPUT1.
       

      MQPUT byte count

      		 Shows the total bytes of data that is put by calls to MQPUT and MQPUT1.
       

      MQPUT non-persistent message count

      		 Shows the number of non-persistent messages that are put by MQPUT.
       

      MQPUT persistent message count

      		 Shows the number of persistent messages that are put by MQPUT.
       

      MQPUT1 non-persistent message count

      		 Shows the number of non-persistent messages that are put by MQPUT1.
       

      MQPUT1 persistent message count

      		 Shows the number of persistent messages that are put by MQPUT1.
       

      Non-persistent byte count

      		 Shows the number of bytes put in non-persistent messages.
       

      Persistent byte count

      		 Shows the number of bytes put in persistent messages.
       

      Queue avoided puts

      		  
        Queue avoided bytes  
        Lock contention  
      MQGET MQGET count  
        MQGET byte count  
        Destructive MQGET non-persistent message count Number of non-persistent messages that are removed from the queue by MQGET.
        Destructive MQGET persistent message count Number of persistent messages that are removed from the queue by MQGET.
        Destructive MQGET non-persistent byte count Shows a count of bytes of non-persistent messages that are returned to MQGET.
        Destructive MQGET persistent byte count Shows a count of bytes of persistent messages that are returned to MQGET.
        MQGET browse non-persistent message count Shows a count of non-persistent messages that have been browsed.
        MQGET browse persistent message count Shows a count of persistent messages that have been browsed.
        MQGET browse non-persistent byte count Shows the number of bytes of non-persistent messages that have been browsed.
        MQGET browse persistent byte count Shows the number of bytes of persistent messages that have been browsed.
        Messages expired Shows a count of expired messages.
        Queue purged count Shows a count of queues that have been purged.
        Average queue time  
        Queue time  
    6. Select a queue manager to monitor, and specify the color to display information in for that queue manager. Click Add to add more queue managers. We can specify up to five queue managers.
    7. Click Save.


Results

After you configure the widget, there is a short delay before data is displayed in the chart. Data is displayed along a time axis. Each data point represents the end of the 10-second period over which the data is collected. We can hover over data points in the chart to see detailed information as shown in the following example: