Use traps
- Last UpdatedSep 03, 2024
- 2 minute read
About Traps
SNMP traps are alerts or events generated by agents on a managed device. Traps typically contain statistical or status information relating to a component of the device sending the trap.
SNMP managers - including the SNMP Communication Driver - listen for traps on port 162 by default.
Note: The SNMP OI Server supports traps received in SNMP v1 and v2 only. The traps received in SNMP v3 are not supported. The SNMP Communication Driver supports SNMP Trap data as polled read requests. It does not support unsolicited messaging for any other SNMP data type.
Trap Syntax
Specify the address of the trap with the following syntax:
TRAP:OID/Variable Binding
When using traps, the OID can be either the object identifier of a specific trap, including enterprise traps, or it can be referenced as one of the following generic traps:
|
COLDSTART |
The SNMP agent on the managed device reinitialized its configuration tables. |
|
WARMSTART |
|
|
LINKDOWN |
A network interface card (NIC) on the managed device either fails or reinitializes. |
|
LINKUP |
|
|
AUTHFAIL |
The SNMP agent on a managed device receives a request from an unrecognized community name. |
|
EGPLOSS |
The SNMP agent on a managed device cannot communicate with its EGP (Exterior Gateway Protocol) peer. |
An enterprise trap contains vendor-specific error conditions and error codes, specific to the managed device. This type of trap is usually received with a Trap OID.
Variable Binding
Variable Binding is the binding for the particular trap OID that is specified in the OID parameter. This parameter is optional, and is used only for traps.
If Variable Binding is specified, the item reference associated with the address will receive the value of the trap. If Variable Binding is not specified, the value of the associated item will be incremented each time a trap is received.
Trap Address Examples
Following are examples of valid addresses when using traps. Use addresses as illustrated here as item references when configuring device items. For more information, see Device item definitions.
-
TRAP:.1.3.6.1.6.3.1.1.5.4
-
TRAP:COLDSTART
-
TRAP:WARMSTART
-
TRAP:LINKDOWN/.1.3.6.1.2.1.2.2.1.1.19
-
TRAP:LINKUP/.1.3.6.1.2.1.2.2.1.1.11
-
TRAP:AUTHFAIL
-
TRAP:EGPLOSS
-
TRAP:LINKUP
-
TRAP:LINKDOWN