IBM App Connect Enterprise, Version 11.0.0.2 Operating Systems: Windows, Linux


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:

  1. 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    
  2. Set the following properties:
    1. Set the reportingOn property to true.
    2. 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.
  3. 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.


bj43390_.htm | Last updated 2018-11-02 14:46:27