mirror/librenms-librenms
1
0
Fork 0
mirror of https://github.com/librenms/librenms.git synced 2024-10-07 16:52:45 +00:00
Code Issues Actions Packages Projects Releases Wiki Activity
librenms-librenms/doc/Extensions/SNMP-Trap-Handler.md
Neil Lathwood 1ee2e8e0e0 Updated to use new theme for docs site (#9320) 
* Updated to use new theme for docs site

* Updated theme location

* Removed librenms.css

* Updated index page + re-added librenms.css

* Use built in theme modification

* flexbox grid, dump bootstrap

* tidy up things

* Added path and updated deploy script + mkdocs config

* Removed db schmea changes

* Updated to install python/pip 3

* Removed pip3 install

* Pip3 install

* Updated deploy-docs

* Updated deploy-docs
2018-10-27 23:04:34 +01:00

1.1 KiB
Raw Blame History

source: Extensions/SNMP-Trap-Handler.md path: blob/master/doc/

SNMP trap handling

Currently, librenms only supports linkUp/linkDown (port up/down), bgpEstablished/bgpBackwardTransition (BGP Sessions Up/Down) and authenticationFailure SNMP traps. To add more see Adding new SNMP Trap handlers

Traps are handled via snmptrapd.

Configure snmptrapd

Install snmptrapd via your package manager.

Modify startup options to include -M /opt/librenms/mibs -m ALL

In /etc/snmp/snmptrapd.conf, add something like the following:

traphandle default /opt/librenms/snmptrap.php

Along with any necessary configuration to receive the traps from your devices (community, etc.)

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

$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)