Software AG Products 10.11 | Administering Integration Server | The Statistics Log | About the Statistics Log
 
About the Statistics Log
The statistics log contains information that you can use to monitor the activity on Integration Server. The log includes data about service requests, session usage, server resources and JVM thread usage. Integration Server captures and writes the statistics each time the statistics polling interval elapses. Some statistics, such as such as New Requests and Completed Requests, are per polling period while others, such as Max Running Service Threads, represent peak data. Most the data written to the statistics log is also displayed on the Server > Statistics page and on the Dashboard.
The frequency with which Integration Server gathers data for the statistics log is determined by the value of the watt.server.stats.pollTime server configuration parameter. By default, this parameter is set to poll for statistics every 60 seconds.
The service request information in the statistics log includes top-level service requests only. A top-level service request is a service invoked by a client request, a trigger, or a scheduled task. However, Integration Server omits statistical information about internal services invoked as top-level services from the statistics log. An internal service is a service that belongs to a package whose name begins with Wm. You can change the services excluded from statistics using the watt.server.stats.packages.exclude server configuration parameter.
Beginning with Integration Server 10.7, the default name and format of the statistics log is a comma-separated values (csv) file named stats.csv. The csv format allows Integration Server statistics to be easily imported into a spreadsheet program. Prior to Integration Server 10.7, the statistics log was written in hexadecimal values with ample use of white space to format the data clearly. You can change the format of the statistics log using the watt.server.stats.logfile.csv parameter.
Following is an example of the statistics log in csv format displayed in Microsoft Excel.
Following is an example of the statistics log in hexadecimal format.
Integration Server saves the statistics log in the following location: Integration Server_directory \instances\instanceName\logs\stats.csv. You can use the watt.server.stats.logfile server configuration parameter to change the location and name of the statistics log.
After startup, Integration Server creates the statistics log after the first polling interval. Integration Server then rotates the statistics log at the interval specified by the watt.server.statsLogRotateInterval server configuration parameter, which is measured in minutes. For example, if you set watt.server.statsLogRotateInterval to 60 minutes and Integration Server started at 1:30 pm, Integration Server rotates the stats.log at 2:30 pm, 3:30 pm, 4:30 pm, and so forth. An exception to this behavior is that when the log recycle time is greater than the time from Integration Server startup to midnight, Integration Server first rotates the statistics log at midnight. Thereafter, Integration Server rotates the log at the specified interval. For example, if the watt.server.statsLogRotateInterval is set to 300 minutes (5 hours) and Integration Server starts up at 9:30 pm, Integration Server rotates the statistics log file at midnight and thereafter rotates the stats.log every 5 hours. Integration Server always rotates the statistics log file at midnight.
You can also configure the statistics log to rotate based on size. Rotating the statistics log once it reaches a particular size can prevent the log files from becoming hard to use. Use the watt.server.stats.logRotateSize server configuration parameter to specify the file size at which Integration Server rolls over the statistics log. By default, Integration Server does not rotate the statistics log based on size.
If you configure the statistics log to rotate based on size, Integration Server will roll over the statistics log based on size and time - whichever occurs first.
When the statistics log rotates, Integration Server renames the previous statistics log to statsyyyymmdd_hhmmss.csv (or statsyyyymmdd_hhmmss.log if the statics log format is hexadecimal). By default, Integration Server keeps an unlimited number of archived statistics logs. You can use the watt.server.stats.logFilesToKeep server configuration parameter to limit the number of archived files retained by Integration Server.