IBM Integration Bus, Version 10.0.0.0 Operating Systems: AIX, HP-Itanium, Linux, Solaris, Windows, z/OS


Subscribing to statistics reports

You can subscribe to topics that return statistics about the operation of your message flows and resource managers.

About this task

Message flow performance

If you enable message flow accounting and statistics collection for an integration node, you can subscribe to the messages that the integration node publishes on the following topics:
  • For JSON publications on an MQ pub/sub broker:
    $SYS/Broker/integrationNodeName/Statistics/JSON/record_type/integrationServerName/message_flow_name
  • For XML publications on an MQ pub/sub broker:
    $SYS/Broker/integrationNodeName/StatisticsAccounting/record_type/integrationServerName/message_flow_name
  • For JSON publications on an MQTT pub/sub broker:
    IBM/IntegrationBus/integrationNodeName/Statistics/JSON/record_type/integrationServerName/message_flow_name
  • For XML publications on an MQTT pub/sub broker:
    IBM/IntegrationBus/integrationNodeName/StatisticsAccounting/record_type/integrationServerName/message_flow_name

where integrationNodeName is the name of the integration node, record_type is the type of record (SnapShot or Archive), integrationServerName is the name of the integration server that you created on that integration node, and message_flow_name is the name of the message flow that you deployed to the integration server.

These messages contain statistics reports and are published at a regular interval, which you control by setting the statsInterval property of the integration node. Each MQ publication is a JMS TextMessage that contains the statistics report in XML format.

Note: If you need to revert to using a JMS BytesMessage format, this can be achieved by either of the following methods:
  • Set the environment variable MQSI_STATS_MQSTR=false.
  • Run the mqsichangeproperties command with the pubsub component to change the format. For example:
    mqsichangeproperties IBNODE -b pubsub -o OperationalEvents/MQ -n format -v none
    The pubsub component change overrides the use of environment variables. For more information, see Parameter values for the pubsub component.

Resource performance

If you enable resource statistics collection for one or more integration servers on an integration node, you can subscribe to the messages that the integration node publishes at 20-second intervals on the following topics:
  • For JSON publications on an MQ pub/sub broker:
    $SYS/Broker/integrationNodeName/Statistics/JSON/Resource/integrationServerName
  • For XML publications on an MQ pub/sub broker:
    $SYS/Broker/integrationNodeName/ResourceStatistics/integrationServerName
  • For JSON publications on an MQTT pub/sub broker:
    IBM/IntegrationBus/integrationNodeName/Statistics/JSON/Resource/integrationServerName
  • For XML publications on an MQTT pub/sub broker:
    IBM/IntegrationBus/integrationNodeName/ResourceStatistics/integrationServerName

For more information about how to interpret the resource statistics that are included in the publication, see Viewing resource statistics data in the web user interface.

Using wildcards in subscriptions

Procedure

You can use wild cards when you subscribe to statistics reports. For example, to receive message flow statistics reports for all integration nodes and all integration servers, subscribe to the following topics:

To receive integration server resource statistics reports for all integration nodes and all integration servers, subscribe to the following topics:

For further details about how you can use wildcards, see Special characters in topics.

Results

Subscribers receive statistics reports only from those integration nodes that are enabled to produce statistics.


aq20080_.htm | Last updated 2015-03-27 19:27:15