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.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.

  • false—Suppresses the Diameter trap.
  • true—Does not suppress the Diameter trap.

Default value is false.

dilutionFactorChangeable

Specifies whether to enable or disable changing the dilution count.

  • true—Enables changing the dilution count.
  • false—Disables changing the dilution count and enables SBR carrier to use only the default 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>

Modified: 2018-01-11