2016-08-24 08:12:20 +01:00
|
|
|
source: Extensions/SNMP-Trap-Handler.md
|
2018-10-27 23:04:34 +01:00
|
|
|
path: blob/master/doc/
|
2016-03-04 17:13:03 -07:00
|
|
|
# SNMP trap handling
|
|
|
|
|
|
2018-08-11 23:37:45 +02:00
|
|
|
Currently, librenms only supports linkUp/linkDown (port up/down), bgpEstablished/bgpBackwardTransition (BGP Sessions Up/Down) and authenticationFailure SNMP traps.
|
2018-08-14 01:56:16 -05:00
|
|
|
To add more see [Adding new SNMP Trap handlers](../Developing/SNMP-Traps.md)
|
2018-08-11 23:37:45 +02:00
|
|
|
|
|
|
|
|
Traps are handled via snmptrapd.
|
2016-03-04 17:13:03 -07:00
|
|
|
|
|
|
|
|
## Configure snmptrapd
|
|
|
|
|
|
|
|
|
|
Install snmptrapd via your package manager.
|
|
|
|
|
|
2018-08-11 23:37:45 +02:00
|
|
|
Modify startup options to include `-M /opt/librenms/mibs -m ALL`
|
|
|
|
|
|
2016-03-04 17:13:03 -07:00
|
|
|
In `/etc/snmp/snmptrapd.conf`, add something like the following:
|
|
|
|
|
|
|
|
|
|
```text
|
|
|
|
|
traphandle default /opt/librenms/snmptrap.php
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
Along with any necessary configuration to receive the traps from your devices (community, etc.)
|
2018-08-14 01:56:16 -05:00
|
|
|
|
|
|
|
|
### Event logging
|
|
|
|
|
|
|
|
|
|
You can configure generic event logging for snmp traps. This will log an event of the type trap for received traps.
|
|
|
|
|
These events can be utilized for alerting.
|
|
|
|
|
|
|
|
|
|
In config.php
|
|
|
|
|
```php
|
|
|
|
|
$config['snmptraps']['eventlog'] = 'unhandled';
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
Valid options are:
|
|
|
|
|
- `unhandled` only unhandled traps will be logged
|
|
|
|
|
- `all` log all traps
|
|
|
|
|
- `none` no traps will create a generic event log (handled traps may still log events)
|
