Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

Navigation  Back up to About Overview 
  
[+] Expand All
[-] Collapse All

events.ini File

The events.ini configuration file configures dilution, suppression, and threshold settings for Steel-Belted Radius Carrier SNMP traps (except for Diameter-related traps) in the fnkradtr.mib and fnkradtr-v2.mib MIBs that communicate failures, warnings, and other information.

SNMP Traps and Statistics Overview summarizes common event values. Only some of these events support thresholds or dilution.

[EventDilutions] Section

The [EventDilutions] section (Table 10) of events.ini specifies how many events must occur before Steel-Belted Radius Carrier generates an event report. This feature lets you dilute the rate at which frequently occurring events are logged.

The syntax is:

[EventDilutions]
EventName=DilutionCount

Where EventName identifies a Steel-Belted Radius Carrier event and DilutionCount specifies how many times this event must occur before it is reported to the SNMP manager program.

Table 10: events.ini [EventDilutions] Syntax

OID

EventName

Function

5002

ConcurrencyServerFailure

Concurrency server returned failure indication. This event represents nnnn failures.

The default dilution count is 100.

5003

ConcurrencyServerTimeout

Timed out in proxy attempt to the concurrency server. This event represents nnnn requests timing out.

The default dilution count is 100.

5004

ConcurrencyProxyLocalFailure

Local failure encountered in an attempt to proxy to the concurrency server. This event represents nnnn requests timing out.

The default dilution count is 100.

5005

StaticAcctProxyTimeout

Timed out in static accounting proxy attempts. This event represents nnnn failures.

The default dilution count is 100.

5006

StaticAcctProxyFailure

Local failure encountered in an attempt to proxy for static accounting. This event represents nnnn requests timing out.

The default dilution count is 100.

5008

SQLConnectFailure

nnnn attempts to connect to the SQL server failed.

The default dilution count is 10.

5009

SQLDisconnect

nnnn disconnects from the SQL server because of an error.

The default dilution count is 100.

5010

SQLRequestTimeout

nnnn timeouts on SQL requests.

The default dilution count is 10.

5011

AcctDatabaseTimeout

Access to the accounting server database has timed out. This event represents nnnn timeouts.

The default dilution count is 100.

5012

AcctDatabaseFailure

Access to the accounting server database has failed. This event represents nnnn failures.

The default dilution count is 100.

5016

LDAPConnectFailure

nnnn attempts to connect to the LDAP server failed.

The default dilution count is 100.

5017

LDAPDisconnects

nnnn disconnects from the LDAP server because of an error.

The default dilution count is 100.

5018

LDAPRequestTimeout

nnnn timeouts on LDAP requests.

The default dilution count is 100.

5022

ProxySpoolerTimeout

nnnn proxy accounting spooler timeouts.

The default dilution count is 100.

5026

ACCTWriteFailure

nnnn failures to commit accounting data to a persistent store such as the file system, database, and so on.

The default dilution count is 100.

5030

FloodQueueOverflow

nnnn packets have been dropped due to the flood queue limit being exceeded.

10045

MemoryFailure

nnnn memory allocation failures have occurred.

The default dilution count is 1000.

Example

This example specifies that a Steel-Belted Radius Carrier server configured to authenticate against a SQL database reports every fifth SQLConnectFailure (trap OID 5008) error:

[EventDilutions]
; 5008 - nnnn attempts to connect to SQL server failed.
SQLConnectFailure=5

If an SQL error condition prevents the server from connecting to the database, Steel-Belted Radius Carrier retries the connection and reports these attempts in the server log file (yyyymmdd.log). Steel-Belted Radius Carrier does not trigger warning event 5008 until the fifth connection attempt fails.

[Suppress] Section

The [Suppress] section of events.ini lets you suppress Steel-Belted Radius Carrier events. An event whose trap number appears in this section is not reported when the applicable informational, warning, or error condition occurs.

Example

These settings suppress events relating to SQL database disconnections (5009) or LDAP server disconnections (5017).

[Suppress]

5009
5017

[Thresholds] Section

The [Thresholds] section (Table 11) of the events.ini file lets you specify thresholds that trigger an event report. Thresholds often come in pairs, where a warning event is generated when a resource becomes scarce (low threshold is crossed), and an information event is generated when the resource becomes available (high threshold is crossed).

The [Thresholds] section lets you tune Steel-Belted Radius Carrier event generation for items such as system memory, thread count, and file system space, and can differ for each computer depending on resources, configuration, and other applications.

Table 11: events.ini [Thresholds] Syntax

Parameter

Function

ThreadAvailWarningIssue

When the number of available accounting or authentication threads reaches the specified value, issue the warning event RADMSG_THREADS_LOW or funkSbrTrapLowThreads (5001).

Default value is 10.

ThreadAvailWarningClear

When the number of available accounting or authentication threads reaches the specified value, issue the informational event RADMSG_THREADS_NORMAL or funkSbrTrapThreadsNormal (102).

Default value is 20.

FileSystemFreeKBWarningIssue

When available system disk space falls to the specified value, issue the warning event RADMSG_FILE_SYSTEM_LOW or funkSbrTrapLowFSSpace (5007).

Default value is 4096 KB (4 MB).

FileSystemFreeKBWarningClear

When the number of kilobytes of available system disk space reaches the specified value, issue the informational event RADMSG_FILE_SYSTEM_NORMAL or funkSbrTrapFSNormal (103).

Default value is 8092 KB (8 MB).

ReserveMemoryKB

Reserve this amount of memory (in kilobytes) at system startup for cases of overload. If a memory allocation failure occurs, Steel-Belted Radius Carrier frees the reserved memory and reports the event.

Default value is 2048 KB (2 MB).

PoolPctAddressAvailWarningIssue

When the number of available addresses in any IP address pool drops below the specified percentage, issue a funkSbrTrapIPAddrPoolLow warning.

Default value is 20 percent.

PoolPctAddressAvailWarningClear

When the number of available addresses in any IP address pool rises above the specified percentage, issue an informational message.

Default value is 40 percent.

Example

This example produces a warning event (5001) when the number of available accounting or authentication threads falls below 10 percent, and an informational event (102) when it rises above 20 percent.

[Thresholds]
ThreadAvailWarningIssue=10
ThreadAvailWarningClear=20

Modified: 2017-09-27