SNMP Input Module [snmpd_in]

Description

Listens for SNMP v1 or v2c traps and returns trap information and a raw trap packet. Also parses MIB files and resolves OIDs to their string names.

Configuration Tokens:

debugmode: Debug Level (0 - 4)
debugmessages: Path to file to log debug messages

Additional Configuration Tokens for MIB parsing:

parsemibs: Set to '1' to enable MIB parsing. If enabled, the module will attempt to resolve the OIDs.
mibpath: Colon separated list of directories to check for MIB files.
mibrepository: Directory to store pre-compiled MIBS (speeds up execution time on repeated runs).
enabledmibs: Comma separated names of MIBs to enable. Dependencies are automatically resolved. Eg. 'SNMPv2-SMI, RFC-1215, BRIDGE-MIB'.

Generated Tokens:

community: Trap community string
enterprise: Enterprise OID
agentaddr: Source IP address
generic-trap: Generic trap number
specific-trap: Specific trap number
uptime: Uptime
rawtrap: Base64 encoded raw trap data, useful for trap forwarding. (v0.6 and higher)
enterprisename: Resolved MIB Enterprise name. (If 'parsemibs' is enabled)
trapname: Resolved name of trap. (If 'parsemibs' is enabled)
trapdesc: Trap description. (If 'parsemibs' is enabled)

Varbinds are tokenized as so:

The OID numbers are in tokens varbindOID0, varbindOID1, varbindOID2 etc. And values are
in varbind0, varbind1, varbind2 etc. Also varbindTag1, varbindTag2 etc. contains the
numeric ASN tag header values. If 'parsemibs' is enabled, then varbindResolved0.._varbindResolved__x_ returns
the resolved OID names as well.

Back to Module Reference