Reporting resource statistics to files
You can configure an integration server to send resource
statistics directly to files in the file system, by modifying the server.conf.yaml configuration
file for the integration server and setting the resource statistics
properties. Alternatively, you can configure the collection of resource
statistics for the integration node by modifying the properties in
the node.conf.yaml file.
About this task
If you enable this option, each resource manager writes
a separate file that contains its resource statistics. Limits apply
to the size of each file and if the limit for a file is reached, a
new file is created. Limits also apply to the number of files that
can be written for each resource manager, and if the limit for the
number of files for the resource manager is reached, the resource
manager then writes to a previous file in a circular fashion.
Procedure
Configure an integration server to write resource statistics
to files, by completing the following steps:
- Open the configuration file for your integration server
(server.conf.yaml) by using a YAML editor.
If you do not have access to a YAML editor, you can edit
the file by using a plain text editor; however, you must ensure that
you do not include any tab characters, because they are invalid in
YAML and would cause your configuration to fail. If you are using
a plain text editor, ensure that you use a YAML validation tool to
validate the content of your file.
The properties that you need
to set are in the
Statistics section of the
.yaml configuration
file:
Statistics:
# Application message flows will by default inherit Snapshot and Archive values set here
...
Resource:
#reportingOn: true # choose 1 of : true|false, default false
#outputFormat: 'file' # comma separated list of : file,bluemix
- Set the following properties:
- Set the reportingOn property to true.
- Set the outputFormat property to file.
The integration server writes the data to files at
the following location:
serverWorkDirectory/config/common/resourceStats/ResourceStats_integration_server_serverName_resource.txt.n
where:
- serverWorkDirectory is the value of the --work-dir parameter.
- serverName is the value of the --name parameter.
- resource is the name of the reported resource,
such as JVM or JDBCConnectionPools.
- Restart the integration server for the changes to take
effect. For information about how to start an integration
server, see Starting an integration server.
Results
You can view the resource statistics by accessing the files
that each resource manager has written. The files are in
.csv format.
Use
the links in Resource statistics data for information about
the resource statistics data that is collected.