Managing resource statistics collection

Use the web user interface or commands to start, stop, or view the status of resource statistics collection for a specified integration server.

Before you begin

Create a message flow; see Creating a message flow.
Deploy a BAR file that contains the message flow; see Deploying integration solutions to a production environment.
Read the concept topic, Resource statistics.

About this task

Use resource statistics data to monitor the performance and resource usage of your integration servers. You can manage the collection of resource statistics data for active integration servers by using one of the following methods:

It is also possible to configure your integration servers to write resource statistics to files. For more information, see Reporting resource statistics to files.

Managing resource statistics collection by using the web user interface

Procedure

Start the web user interface for your integration node; see Accessing the web user interface.
The navigator is displayed on the left side of the pane, showing the servers (integration servers), message flows, and other resources that are owned by your integration node.
Expand the Servers section in the navigator.
Click the down arrow beside the integration server to display the menu.
If resource statistics collection is turned on for the integration server, data is displayed in the Resource Statistics tab.
- To start collecting resource statistics for this integration server, click Resource statistics on.
- To stop collecting resource statistics for this integration server, click Resource statistics off.

Managing resource statistics collection by using a command

Procedure

If your integration node is running on Linux®, UNIX, or Windows systems, set up the correct command environment.
For details of how to complete this task, see Setting up a command environment.
Run one of the following commands:
- To start or stop collecting resource statistics for a specific integration server, or for all integration servers, run the mqsichangeresourcestats command with the appropriate parameters.
  For example, to start collecting resource statistics for the default integration server for an integration node that is named IBNODE, enter the following command:
```
mqsichangeresourcestats IBNODE -c active -e default 
```
  For example, to stop collecting resource statistics for all integration servers on an integration node that is named IBNODE, enter the following command:
```
mqsichangeresourcestats IBNODE -c inactive
```
  For further examples, see mqsichangeresourcestats command.
- To check the status of resource collection, run the mqsireportresourcestats command with the appropriate parameters.
  For example, to view status for the default integration server on IBNODE, enter:
```
mqsireportresourcestats IBNODE -e default 
```
  For further examples, see the mqsireportresourcestats command.
- 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.

What to do next

You can view the resource statistics in the web user interface, as described in Viewing resource statistics data.

You can write a program that subscribes to a publication (single XML message) that returns the resource statistics data. For an example of the publication message, see Example XML output.