Steel Belted Radius Carrier 7.0 Reference Guide > Authentication Configuration Files > statlog.ini File

statlog.ini File

The statlog.ini initialization file configures the Steel-Belted Radius Carrier statistics log file (yyyymmdd.statlog), which periodically records server statistics to a comma-delimited ASCII file. The statistics log provides a mechanism for creating snapshots of user-selected server statistics.

• The first line in a *.statlog file lists all column headings in double quotes ("Date", "Time", ...).
• The first column in a *.statlog file identifies the current date in yyyy-mm-dd format in double-quotes ("2006-02-13"). The *.statlog file uses the local date, not the date in the UTC time zone, when it records date information.
• The second column in a *.statlog file identifies the current time in hh:mm:ss format in double-quotes ("14:13:22"). The *.statlog file uses the local time, not the time in the UTC time zone, when it records time information.
• If statistics logging is enabled, a new statistics logging file is created the first time the server is started each day. At midnight, the server closes the old statistics log file and starts a new one with a file name that reflects the new date.
• If you restart the Steel-Belted Radius Carrier server and a *.statlog file exists for the current day, the server appends new information to the existing *.statlog file. When the server is restarted, the timer for capturing statistics snapshots is restarted; for example, a server configured to record statistics every 10 minutes captures statistics at 14:10:00. If the server is restarted at 14:15:00, it captures system statistics immediately (14:15:00) and 10 minutes thereafter (14:25:00); it does not try to capture statistics at 14:20:00 (10 minutes after the capture before the restart).
• If you change the order or contents of the list of statistics to be recorded and restart the server, Steel-Belted Radius Carrier detects the change and writes an entry with the new column headers to the current *.statlog file before writing new data records into the file.
  

  NOTE: When you change the order or contents of the list of statistics recorded in the *.statlog file, Steel-Belted Radius Carrier creates the statloghdr.dat checkpoint file in the radiusdir directory. Do not modify or delete the statloghdr.dat file.

  
  

[Settings] Section

The [Settings] section of statlog.ini (Table 49) specifies whether the statistics log file is enabled, who can access the statistics log file, how frequently the server writes information to the statistics log file, and the number of days statistics log files are retained.

Table 49: statlog.ini.ini [Settings] Syntax  

Parameter	Function
Enable	If set to 1, the Steel-Belted Radius Carrier server periodically writes statistics information to the yyyymmdd.statlog file. If set to 0, the Steel-Belted Radius Carrier server does not update the yyyymmdd.statlog file. Default value is 0.
LogFilePermissions	Specifies the owner and access permission setting for the *.statlog file. Enter a value for the LogFilePermissions setting in owner:group permissions format, where: owner specifies the owner of the file in text or numeric format. group specifies the group setting for the file in text or numeric format. permissions specifies what privileges can be exercised by Owner/Group/Other with respect to the file in text or numeric format. For example, ralphw:1007 rw-r- - - - - specifies that the file owner (ralphw) can read and edit the log file, members of group 1007 can read (but not edit) the log file, and other users cannot access the log file.
Interval-Seconds	Specifies the number of seconds (in the range 1-3600) that the Steel-Belted Radius Carrier server waits before writing new statistics information to the statistics log. Default value is 600 seconds (10 minutes).
Days-To-Keep	Specifies the number of days (in the range 1-365) the statistics log is retained by the Steel-Belted Radius Carrier server. When the specified number of days has elapsed, the statistics log is automatically purged. Default value is 7 days.

For example:

[Settings]

Enable              = 0

;LogfilePermissions = ralphw:1007 rw-r- - - - -

;Interval-Seconds   = 600

;Days-To-Keep       = 7

[Statistics] Section

The [Statistics] section of statlog.ini (Table 50) identifies the statistics you want included in the snapshot. Each entry in this section takes the format Source/Statistic, where Source identifies the LCI statistics container that holds the statistic counter you want and Statistic identifies the statistic by name.

Statistics are written to the log file in the order in which they are listed in the [Statistics] section.

Table 50: statlog.ini [Statistics] Syntax  

Parameter	Function
Source	Specifies is the name of the LCI statistics container that holds the specified statistic. Supported values for Source are: Server Authentication Accounting Proxy Rate
Statistic	Specifies the name of the statistic you want to record in the log. Statistics in the Server LCI container are: Accounting-Threads Authentication-Threads High-Acct-Threads High-Acct-Threads-Since-Reset High-Auth-Threads High-Auth-Threads-Since-Reset High-Total-Threads High-Total-Threads-Since-Reset Max-Acct-Threads Max-Auth-Threads Max-Total-Threads Total-Threads
	Statistics in the Authentication LCI container are: Accept Dropped-Packet Failed-Authentication Failed-On-Check-List Insufficient-Resources Invalid-Request Proxy-Failure Reject Rejected-By-Proxy Silent-Discard Total-Retry-Packets Total-Transactions Transactions-Retried
	Statistics in the Accounting LCI container are: Dropped-Packet Insufficient-Resources Interim Invalid-Client Invalid-Request Invalid-Shared-Secret Off On Proxy-Failure Start Stop Total-Retry-Packets Total-Transactions Transactions-Retried
	Statistics in the Proxy LCI container are: Accounting Authentication Insufficient-Resources Invalid-Response Invalid-Shared-Secret Timed-Out Total-Retry-Packets Total-Transactions Transactions-Retried
	Statistics in the Rate LCI container are: Acct-Start-Average-Rate Acct-Start-Current-Rate Acct-Start-Peak-Rate Acct-Stop-Average-Rate Acct-Stop-Current-Rate Acct-Stop-Peak-Rate
	Auth-Accept-Average-Rate Auth-Accept-Current-Rate Auth-Accept-Peak-Rate Auth-Reject-Average-Rate Auth-Reject-Current-Rate Auth-Reject-Peak-Rate Auth-Request-Average-Rate Auth-Request-Current-Rate Auth-Request-Peak-Rate
	Statistics in the Rate LCI container are: Proxy-Acct-Fail-Proxy-Average-Rate Proxy-Acct-Fail-Proxy-Current-Rate Proxy-Acct-Fail-Proxy-Peak-Rate Proxy-Acct-Request-Average-Rate Proxy-Acct-Request-Current-Rate Proxy-Acct-Request-Peak-Rate Proxy-Auth-Rej-Proxy-Average-Rate Proxy-Auth-Rej-Proxy-Current-Rate Proxy-Auth-Rej-Proxy-Error-Average-Rate
	Proxy-Auth-Rej-Proxy-Error-Current-Rate Proxy-Auth-Rej-Proxy-Error-Peak-Rate Proxy-Auth-Rej-Proxy-Peak-Rate Proxy-Auth-Request-Average-Rate Proxy-Auth-Request-Current-Rate Proxy-Auth-Request-Peak-Rate Proxy-Fail-Badresp-Average-Rate Proxy-Fail-Badresp-Current-Rate Proxy-Fail-Badresp-Peak-Rate Proxy-Fail-Badsecret-Average-Rate Proxy-Fail-Badsecret-Current-Rate Proxy-Fail-Badsecret-Peak-Rate
	Proxy-Fail-Missingresr-Average-Rate Proxy-Fail-Missingresr-Current-Rate Proxy-Fail-Missingresr-Peak-Rate Proxy-Fail-Timeout-Average-Rate Proxy-Fail-Timeout-Current-Rate Proxy-Fail-Timeout-Peak-Rate Proxy-Retries-Average-Rate Proxy-Retries-Current-Rate Proxy-Retries-Peak-Rate

For example:

[Statistics]    

Server/Authentication-Threads

Server/Accounting-Threads

Server/Total-Threads

Server/Max-Acct-Threads

Server/Max-Auth-Threads

Server/Max-Total-Threads

Server/High-Auth-Threads

Server/High-Acct-Threads

Server/High-Total-Threads

Server/High-Acct-Threads-Since-Reset

Server/High-Auth-Threads-Since-Reset

Server/High-Total-Threads-Since-Reset

Authentication/Accept

Authentication/Reject

Authentication/Silent-Discard

Authentication/Total-Transactions

Authentication/Dropped-Packet

Authentication/Invalid-Request

Authentication/Failed-Authentication

Authentication/Failed-On-Check-List

Authentication/Insufficient-Resources

Authentication/Proxy-Failure

Authentication/Rejected-By-Proxy

Authentication/Transactions-Retried

Authentication/Total-Retry-Packets

Accounting/Start

Accounting/Stop

Accounting/Interim

Accounting/On

Accounting/Off

Accounting/Total-Transactions

Accounting/Dropped-Packet

Accounting/Invalid-Request

Accounting/Invalid-Client

Accounting/Invalid-Shared-Secret

Accounting/Insufficient-Resources

Accounting/Proxy-Failure

Accounting/Transactions-Retried

Accounting/Total-Retry-Packets

Proxy/Authentication

Proxy/Accounting

Proxy/Total-Transactions

Proxy/Timed-Out

Proxy/Invalid-Response

Proxy/Invalid-Shared-Secret

Proxy/Insufficient-Resources

Proxy/Transactions-Retried

Proxy/Total-Retry-Packets

Rate/Auth-Request-Current-Rate

Rate/Auth-Request-Average-Rate

Rate/Auth-Request-Peak-Rate

Rate/Auth-Accept-Current-Rate

Rate/Auth-Accept-Average-Rate

Rate/Auth-Accept-Peak-Rate

Rate/Auth-Reject-Current-Rate

Rate/Auth-Reject-Average-Rate

Rate/Auth-Reject-Peak-Rate

Rate/Acct-Start-Current-Rate

Rate/Acct-Start-Average-Rate

Rate/Acct-Start-Peak-Rate

Rate/Acct-Stop-Current-Rate

Rate/Acct-Stop-Average-Rate

Rate/Acct-Stop-Peak-Rate

Rate/Proxy-Auth-Request-Current-Rate

Rate/Proxy-Auth-Request-Average-Rate

Rate/Proxy-Auth-Request-Peak-Rate

Rate/Proxy-Acct-Request-Current-Rate

Rate/Proxy-Acct-Request-Average-Rate

Rate/Proxy-Acct-Request-Peak-Rate

Rate/Proxy-Fail-Timeout-Current-Rate

Rate/Proxy-Fail-Timeout-Average-Rate

Rate/Proxy-Fail-Timeout-Peak-Rate

Rate/Proxy-Fail-Badresp-Current-Rate

Rate/Proxy-Fail-Badresp-Average-Rate

Rate/Proxy-Fail-Badresp-Peak-Rate

Rate/Proxy-Fail-Badsecret-Current-Rate

Rate/Proxy-Fail-Badsecret-Average-Rate

Rate/Proxy-Fail-Badsecret-Peak-Rate

Rate/Proxy-Fail-Missingresr-Current-Rate

Rate/Proxy-Fail-Missingresr-Average-Rate

Rate/Proxy-Fail-Missingresr-Peak-Rate

Rate/Proxy-Retries-Current-Rate

Rate/Proxy-Retries-Average-Rate

Rate/Proxy-Retries-Peak-Rate

Rate/Proxy-Auth-Rej-Proxy-Current-Rate

Rate/Proxy-Auth-Rej-Proxy-Average-Rate

Rate/Proxy-Auth-Rej-Proxy-Peak-Rate

Rate/Proxy-Acct-Fail-Proxy-Current-Rate

Rate/Proxy-Acct-Fail-Proxy-Average-Rate

Rate/Proxy-Acct-Fail-Proxy-Peak-Rate

Rate/Proxy-Auth-Rej-Proxy-Error-Current-Rate

Rate/Proxy-Auth-Rej-Proxy-Error-Average-Rate

Rate/Proxy-Auth-Rej-Proxy-Error-Peak-Rate