Resource statistics

Resource statistics are collected 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. You can also help to preempt situations where system resources are overstretched and might become unavailable. Analysis of the data that is 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 to assess whether the cause of the concern is the use of those resources by processes in IBM® App Connect Enterprise. You can collect data on one or more selected integration servers, or for all integration servers. When statistics collection is enabled, you might experience a minor degradation in operating performance of the integration servers for which you are collecting data.

When an integration node or server is created, the publication of resource statistics is enabled by default. The reportingOn property in the node.conf.yaml or server.conf.yaml file is explicitly set to true, which enables the publication of snapshot statistics to the web user interface. For integration nodes and servers that were created prior to IBM App Connect Enterprise Version 11.0.0.8, the publication of resource statistics was turned off by default. To enable the publication of statistics for your integration nodes or servers that were created prior to V11.0.0.8, edit the relevant .conf.yaml file and set the reportingOn property to true. For more information, see Managing resource statistics collection.

Before resource statistics can be collected, you must ensure that the publication of events is enabled. If you are subscribing to resource statistics data, you must also ensure that a pub/sub broker is 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, you can also use the mqsichangeresourcestats command and the mqsireportresourcestats command.

To set and check the properties that control where resource statistics are reported, use the mqsichangeproperties command and the mqsireportproperties command.

You can view the resource statistics data for your integration nodes and servers by using the IBM App Connect Enterprise web user interface.

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.