Download This Guide
events.xml File
The events.xml configuration file is used to dilute and suppress Diameter traps that are defined in the jnx-diameter-base-protocol.mib MIB. Table 12 describes the mandatory Diameter trap attributes allowed in the events.xml file. If you want to dilute and suppress a Diameter trap, you need to define the corresponding attributes for the Diameter trap.
Table 12: Attributes Allowed in the events.xml File
Attribute Name | Description |
|---|---|
dilutionFactor | Specifies how many times a Diameter event must occur before it is reported to the SNMP manager program. The default dilution count is 1. |
enable | Specifies whether to suppress a Diameter trap.
Default value is false. |
dilutionFactorChangeable | Specifies whether to enable or disable changing the dilution count.
Default value is true. |
For more information about common event values, see SNMP Traps and Statistics Overview. Table 13 lists the Diameter traps that can be diluted using the events.xml file.
Table 13: Diameter Traps That Can Be Diluted
OID | Trap Name | Description |
|---|---|---|
1 | jnxDbpProtocolError | Diameter base protocol error has occurred. |
2 | jnxDbpTransientFailure | Diameter transient failure has occurred. |
3 | jnxDbpPermanentFailure | Diameter permanent failure has occurred. |
4 | jnxDbpPeerConnectionDown | Connection between the Diameter peer and SBR Carrier is down. |
5 | jnxDbpPeerConnectionUp | Connection is established between the Diameter peer and SBR Carrier. |
5000 | jnxAAATrapUnauthorizedAdminRequest | A request from the administrator interface is denied. |
10000 | jnxAAATrapInternalError | The Diameter Result-Code attribute value indicating internal error is set. |
10001 | jnxAAATrapLicenseCheckFailure | A disposition indicating license check failure is set. |
10002 | jnxAAATrapResourceFailure | A disposition indicating resource failure is set. |
10003 | jnxAAATrapLogFileFailure | Attempt to open, create, or write a log file encounters a failure. |
In the following example, the jnxDbpPermanentFailure trap (OID 3) is diluted to be sent once for every five occurrences of Diameter permanent failure.
<event id=".1.3.6.1.4.1.2636.8.1.2.1.0.0.3" description="diameter permanent failure"> <sinks> <sink name="trap" enable="true" dilutionFactor="5" dilutionFactorChangeable="true" /> </sinks> </events>
