Resource statistics

Resource statistics are collected by an integration node to record performance and operating details of resources that are used by integration servers.

As a system administrator, you can use the resource statistics to ensure that your systems are using the available resources in the most efficient manner. By monitoring systems and analyzing statistical trends, you can keep system resource usage within boundaries that you consider acceptable, and help to pre-empt situations where system resources are overstretched and might become unavailable. Analysis of the data returned potentially requires specialist skills and knowledge of each resource type.

If you detect that system resources are under pressure, you can examine the statistics collected by the integration node to assess whether the cause of the concern is the use of those resources by processes in IBM® Integration Bus.

Before you can collect resource statistics, you must activate the collection feature, which is inactive by default. If you activate statistics collection, you might experience a minor degradation in operating performance of the integration node or integration nodes for which you are collecting data. You can collect data on one or more selected integration servers, or for all integration servers on an integration node, which enables you to limit the statistics gathering activity if appropriate.

Before resource statistics can be collected, you must ensure that the publication of events has been enabled. If you are subscribing to resource statistics data, you must also ensure that a pub/sub broker has been configured. For more information, see Configuring the publication of event messages and Configuring the built-in MQTT pub/sub broker.

To start, stop, or check the status of resource statistics collection, use one or more of the following options:
  • The mqsichangeresourcestats and mqsireportresourcestats commands
  • A custom integration application

To set and check the properties that control where resource statistics are reported, use the mqsichangeproperties and mqsireportproperties commands, and see the information in Parameter values for the ComIbmResourceStatsManager resource manager.

You can view the resource statistics data for your integration servers by using the IBM Integration Bus web user interface. For more information, see Viewing resource statistics data.

You can also specify that resource statistics data for the resource managers in your integration servers is written to files. For more information, see Reporting resource statistics to files.

View statistics data by using the publish/subscribe method

You can view the output that is generated by statistics collection by using an application that subscribes to a publication message, which is published by the integration node every 20 seconds. The message contains the data collected for each integration server for which you have activated statistics collection. The published message is available in XML format and in JSON format.

The topic for each message has the following structure:
  • For XML format:
    • For an MQ pub/sub broker:
      $SYS/Broker/integrationNodeName/ResourceStatistics/integration_server_name
    • For an MQTT pub/sub broker:
      IBM/IntegrationBus/integrationNodeName/ResourceStatistics/integration_server_name
  • For JSON format:
    • For an MQ pub/sub broker:
      $SYS/Broker/integrationNodeName/Statistics/JSON/Resource/integration_server_name
    • For an MQTT pub/sub broker:
      IBM/IntegrationBus/integrationNodeName/Statistics/JSON/Resource/integration_server_name
You can set up subscriptions for a specific integration server on a specific integration node. For example:
  • For XML format:
    • For an MQ pub/sub broker:
      $SYS/Broker/IBNODE/ResourceStatistics/default
    • For an MQTT pub/sub broker:
      IBM/IntegrationBus/IBNODE/ResourceStatistics/default
  • For JSON format:
    • For an MQ pub/sub broker:
      $SYS/Broker/IBNODE/Statistics/JSON/Resource/default
    • For an MQTT pub/sub broker:
      IBM/IntegrationBus/IBNODE/Statistics/JSON/Resource/default
You can also use wildcards in the subscriptions to broaden the scope of what is returned. For example, to subscribe to reports for all integration servers on all integration nodes, use the following values:
  • For XML format:
    • For an MQ pub/sub broker:
      $SYS/Broker/+/ResourceStatistics/#
    • For an MQTT pub/sub broker:
      IBM/IntegrationBus/+/ResourceStatistics/#
  • For JSON format:
    • For an MQ pub/sub broker:
      $SYS/Broker/+/Statistics/JSON/Resource/#
    • For an MQTT pub/sub broker:
      IBM/IntegrationBus/+/Statistics/JSON/Resource/#

For details of all the statistics that are reported for each resource manager, and the publication content, see Resource statistics data.