TrapUdp

This connector creates a UDP server to receive SNMP v.1 Trap notifications.

This is a specialized version of the "server-udp" protocol that converts SNMP version 1 traps into multi-line text, presented in an XML-like format. Traps are defined in RFC 1157: http://www.faqs.org/rfcs/rfc1157.html

All attributes of the "trap:v1" tag are defined by SNMP, except the "duration" attribute of the "trap:v1" tag which is added as a convenience. The duration represents the "ticks" attribute (hundredths of seconds since some element-specific reset) converted into a human-readable time duration, in the format:

  [days] [hours]:[minutes]:[seconds].[hundredths]

The "type" attribute of the "varbind" tag represents the data type for the "value" attribute. The text is non-standard, but maps directly to value types defined by SNMP.

Below is an example trap, translated as it would appear to a listener. A blank line is appended after each trap for easier human viewing. (The first line is split here to avoid scrolling; the line is not split in live events.)

<trap:v1 agent="192.12.12.12" community="public" enterprise="1.3.6.1.1" 
generic="2" specific="4" ticks="11100" duration="129 1:06:51.88">
  <varbind name="1.3.6.1.1.0" value="one thing" type="SNMPOctetString"/>
  <varbind name="1.3.6.1.1.1" value="987" type="SNMPInteger"/>
</trap:v1>

This protocol accepts the optional "udp.forward" setting to forward received traps to additional servers.