44 lines
1.6 KiB
Markdown
44 lines
1.6 KiB
Markdown
# SNMP Trap Input Plugin
|
|
|
|
The SNMP Trap plugin is a service input plugin that receives SNMP
|
|
notifications (traps and inform requests).
|
|
|
|
Notifications are received on plain UDP. The port to listen is
|
|
configurable.
|
|
|
|
OIDs can be resolved to strings using system MIB files. This is done
|
|
in same way as the SNMP input plugin. See the section "MIB Lookups" in
|
|
the SNMP [README.md](../snmp/README.md) for details.
|
|
|
|
### Configuration
|
|
```toml
|
|
# Snmp trap listener
|
|
[[inputs.snmp_trap]]
|
|
## Transport, local address, and port to listen on. Transport must
|
|
## be "udp://". Omit local address to listen on all interfaces.
|
|
## example: "udp://127.0.0.1:1234"
|
|
# service_address = udp://:162
|
|
## Timeout running snmptranslate command
|
|
# timeout = "5s"
|
|
```
|
|
|
|
### Metrics
|
|
|
|
- snmp_trap
|
|
- tags:
|
|
- source (string, IP address of trap source)
|
|
- name (string, value from SNMPv2-MIB::snmpTrapOID.0 PDU)
|
|
- mib (string, MIB from SNMPv2-MIB::snmpTrapOID.0 PDU)
|
|
- oid (string, OID string from SNMPv2-MIB::snmpTrapOID.0 PDU)
|
|
- version (string, "1" or "2c" or "3")
|
|
- fields:
|
|
- Fields are mapped from variables in the trap. Field names are
|
|
the trap variable names after MIB lookup. Field values are trap
|
|
variable values.
|
|
|
|
### Example Output
|
|
```
|
|
snmp_trap,mib=SNMPv2-MIB,name=coldStart,oid=.1.3.6.1.6.3.1.1.5.1,source=192.168.122.102,version=2c snmpTrapEnterprise.0="linux",sysUpTimeInstance=1i 1574109187723429814
|
|
snmp_trap,mib=NET-SNMP-AGENT-MIB,name=nsNotifyShutdown,oid=.1.3.6.1.4.1.8072.4.0.2,source=192.168.122.102,version=2c sysUpTimeInstance=5803i,snmpTrapEnterprise.0="netSnmpNotificationPrefix" 1574109186555115459
|
|
```
|