Stats Configuration

Dynamic statistics configuration is activated using the -statscfg startup option.

Configuration Reference

[stats]

enabled	The value may be "0" to disable statistics collection or "1" to enable it. The default is "0".
file	The name of the statistics file. If not fully qualified then the value of the _DEFAULTS define is used to complete the file name.
time	Specifies the time format for the statistics file entries. Available formats are: GMT – Greenwich mean time (the default). LST – Local standard time (local time without DST adjustment). LCT – Local civil time (local time with DST adjustment).
flush-interval	Specifies how often statistics are written to the statistics file, specified in seconds, or as a CRON expression. The default value is 15 seconds. Valid values are 15 - 86400.
reset-interval	Specifies how often the process statistics counters are reset, specified in minutes, or as a CRON expression. The default value is 0, which indicates that the statistics are not automatically reset and continue to accumulate for the life of the process. Valid values are 0 - 10080.
on-reset	The action to take on the statistics file when a reset occurs. The available options are 'rollover', 'purgedata', and 'keep'. rollover - The current file is renamed according to the 'rollover-file' specification and a new file is opened. purgedata - The current file data is purged with a call to CONTROL 20 and the current file remains open. keep - No action is taken. Statistics continue to be written to the current file. The default action is 'keep'.

Example

TEXT

; Enable statistics collection.
[stats]
enabled=1
file=$data1.stats.zzstats
time=lct
flush-interval=60

Defining Intervals Using CRON Expressions

CRON is a job scheduling service available on a number of platforms. Interval values may be specified as CRON expressions which provide finer grain control on interval expiration. Documenation and tools for creating and interpreting CRON expressions may be found here:

CRON Expressions at Wikipedia

CRON Expression Generator and Explainer at FREEFORMATTER.COM

Example

TEXT

; Enable statistics collection.
[stats]
enabled=1
file=$data1.stats.zzstats
maxentents=200
time=lct
;Flush every 2 minutes
flush-interval=0 */2 * ? * *
; Reset every 4 hours
reset-interval=0 0 */4 ? * *