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 statistics per NAD client and per Called-Station-ID are not captured in the statlog file.
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.
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.
The [Settings] section of statlog.ini (Table 55) 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 55: statlog.ini [Settings] Syntax
Default value is 0.
Specifies the destination directory on the local host where statistics log files (yyyymmdd.statlog) are stored.
Default value is the directory where SBR Carrier is installed.
Specifies the owner and access permission setting for the *.statlog file.
Enter a value for the LogFilePermissions setting in owner:group permissions format, where:
Specifies the number of seconds that the SBR Carrier server waits before writing new statistics information to the statistics log.
You can enter a value ranging from 10 through 3600 seconds. On Solaris systems, this value ranges from 1 through 3600 seconds.
Default value is 600 seconds (10 minutes).
Note: The written statistics information may become garbled under extreme load when the interval is less than 60 seconds.
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.
[Settings] Enable = 1 ;LogfilePermissions = someuser:1007 rw-r- - - - - ;Interval-Seconds = 600 ;Days-To-Keep = 7 LogDir = /opt/JNPRsbr/
The [Statistics] section of statlog.ini (Table 56) 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 56: statlog.ini [Statistics] Syntax
Specifies the name of the LCI statistics container that holds the specified statistic.
Supported values for Source are:
Specifies the name of the statistic you want to record in the log.
Statistics for the Server are:
Authentication statistics are:
Accounting statistics are:
Proxy statistics are:
Statistics for the Rate are:
Statistics for the Rate are:
Key Performance Indicators (KPI) statistics are:
[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 KPI/Challenge-Objects KPI/Max-Challenge-Objects KPI/High-Challenge-Objects-Since-Reset