Overview |
||
This section covers the properties that can be used to print tables of performance statistics for the system, Wrapper process and JVM. These statistics were added in version 3.5.52 to help understand issues in situations such as when the JVM is detected hung. The data are subject to change in future versions of the Wrapper, but currently include memory and CPU usage. They are collected at regular intervals by the Wrapper and then printed retrospectively when certain events occur. This allows analysis of what happened during a given period before a problem occurred and, when included in the logs, are a useful information for technical support. Triggering the printing of statistics: The 'STATS' keyword can be used in the value of any action property to configure when statistics should be printed.
It is also possible to use the 'STATS' keyword in the command file to trigger the printing of statistics at any time. The following properties can be used to configure how the statistics should be printed:
NOTEThis feature is currently only available for Windows, but can be added to other platforms upon request. |
wrapper.stats.system.enable |
||||||||
This property can be used to enable or disable the ability to print performance statistics for the System. Currently, the Physical memory, Committed memory, and Cache are included in the system statistics. The property is ignored if wrapper.stats.enable is set to FALSE. The default value is TRUE.
|
wrapper.stats.wrapper.enable |
||||||||
This property can be used to enable or disable the ability to print performance statistics for the Wrapper process. The property is ignored if wrapper.stats.enable is set to FALSE. The following data will be printed:
The default value is TRUE.
|
wrapper.stats.java.enable |
||||||||
This property can be used to enable or disable the ability to print performance statistics for the JVM (java process). The property is ignored if wrapper.stats.enable is set to FALSE. The following data will be printed:
The default value is TRUE.
|
wrapper.stats.lines |
||||||||
This property specifies the maximum number of lines to be printed per statistics table. Be aware that increasing the value of this property will result in more log output. The value can be balanced with wrapper.stats.interval to observe performance over a period of time that is right for you, while keeping a reasonable number of rows per table. Valid values are in the range of "1" to "60". The default value is 10.
|
wrapper.stats.interval |
||||||||||
This property specifies the interval, in seconds, at which statistics are collected. The starting time and ending time of each interval can be visualized in the first column of the tables. Valid values are in the range of "1-86400" (1 second - 1 day). The default value is one third of the value of wrapper.shutdown.timeout (so 10 seconds by default). NOTEThe CPU usage is calculated based on an average over the entire interval. The Page Faults count (for the Java process) is the total number of page faults during an interval. Examples:
|
wrapper.stats_on_failed_jvm_exit |
||||||
This property controls whether statistics should be printed when the Wrapper detects that the JVM is hung. It is similar to wrapper.request_thread_dump_on_failed_jvm_exit, which causes a thread dumps in the same situation of a hung JVM. When this property is set to TRUE, the statistics will be printed before the thread dumps (if requested), which itself happens before the JVM process is being terminated. The default value is TRUE. |