Skip to content

Receiving SNMP v3 traps

Zenoss Cloud can receive SNMP v3 traps from your devices, but there are some prerequisites:

  • The device sending the traps must be added as a monitored device
  • The zSnmpEngineId configuration property must be set to match the value from the device

To receive SNMP v3 traps for a device, follow these steps:

  1. If you are not already monitoring the device, add it to an appropriate device class.
  2. Set the zSnmpEngineId property for the device.
    1. Add the zenoss.snmp.SnmpV3EngineIdMap modeler plugin to the device and remodeling, or
    2. Set the value manually. To get the engine ID from the device, see the manufacturer's documentation.

The zenoss.snmp.SnmpV3EngineIdMap modeler plugin only works for devices configured for SNMP v3 monitoring and that have no Engine ID already set.

Each device with a configured zSnmpEngineId must have a unique value for this property. For virtual machine devices that are cloned from a template machine image, you might have to change the engineIDType value in the snmpd.conf configuration file. See the Net-SNMP documentation for more details.

SNMP v3 zProperties

Devices sending SNMP v3 traps must adhere to the same configuration property rules as when monitoring through SNMP v3.

  1. zSnmpVer must be set to v3.
  2. zSnmpAuthType and zSnmpAuthPassword must be specified together. If either is missing, then both are ignored.
  3. zSnmpPrivType and zSnmpPrivPassword must be specified together. If either is missing, then both are ignored.
  4. If zSnmpAuthType and zSnmpAuthPassword are not both specified, then zSnmpPrivType and zSnmpPrivPassword are ignored.
  5. If zSnmpSecurityName is blank, then zSnmpAuthType, zSnmpAuthPassword, zSnmpPrivType, and zSnmpPrivPassword are ignored.

Testing SNMP v3 traps

To confirm that your collector is capable of receiving SNMP v3 traps, you may want to send a test trap and confirm its receipt and conversion into an event on your Event Console. You will need:

  • A Linux host, configured for monitoring via SNMP v3
  • Access to the command line of that host
  • To install the net-snmp and net-snmp-utils packages, if not already installed

The syntax for the snmptrap command takes the form of:

snmptrap -v3 -e {dev/zSnmpEngineId} -u {dev/zSnmpSecurityName} -l authPriv -a SHA -A {dev/zSnmpAuthPassword} -x AES -X {dev/zSnmpPrivPassword} $COLLECTOR_IP '' SNMPv2-MIB::sysORUpTime.1

After substituting the {dev/*} variables and the $COLLECTOR_IP, a test command might look like the following:

snmptrap -v3 -e 80001f88806f6c4959a3cc0c5f00000000 -u zenmonitor -l authPriv -a SHA -A authPass -x AES -X privPass 192.0.2.100 '' SNMPv2-MIB::sysORUpTime.1