librenms-librenms/doc/Extensions/SNMP-Trap-Handler.md

source: Extensions/SNMP-Trap-Handler.md
# SNMP trap handling

Currently, librenms only supports linkUp/linkDown (port up/down), bgpEstablished/bgpBackwardTransition (BGP Sessions Up/Down) and authenticationFailure SNMP traps.

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:

```text
traphandle default /opt/librenms/snmptrap.php
```

Along with any necessary configuration to receive the traps from your devices (community, etc.)
Updated docs to have source to use for edit github (#4185) * Added source link for edit on github * Updated formatting issues * Updated formatting issues * Updated formatting issues 2016-08-24 08:12:20 +01:00			`source: Extensions/SNMP-Trap-Handler.md`
Add doc stub for SNMP trap handling 2016-03-04 17:13:03 -07:00			`# SNMP trap handling`

Fixed snmptraps. (#8898) * Fixed snmptraps. * Fixed space * Added bgp down/up and authentication failure * Fixed typo * Fixed some typos, arrays, astext and format_hostname * Updated documentation * Moved code to a function * Some refactor * Minor fixes * Minor fixes 2 * More minor fixes * Changes requested by Tony * Minor fixes * Moved include to snmptrap.php * Refactor traps to use object oriented code. Should trigger events too/instead, but we'll leave that. Testing todo * Add tests and fix things so they actually work Not checking events yet. * Fixed typo and severity level * Update composer deps, I think the lock file wasn't right. add json and mbstring extension deps while I'm at it. * Fix several issues with phpunit fixtures 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.`

			`Traps are handled via snmptrapd.`
Add doc stub for SNMP trap handling 2016-03-04 17:13:03 -07:00
			`## Configure snmptrapd`

			`Install snmptrapd via your package manager.`

Fixed snmptraps. (#8898) * Fixed snmptraps. * Fixed space * Added bgp down/up and authentication failure * Fixed typo * Fixed some typos, arrays, astext and format_hostname * Updated documentation * Moved code to a function * Some refactor * Minor fixes * Minor fixes 2 * More minor fixes * Changes requested by Tony * Minor fixes * Moved include to snmptrap.php * Refactor traps to use object oriented code. Should trigger events too/instead, but we'll leave that. Testing todo * Add tests and fix things so they actually work Not checking events yet. * Fixed typo and severity level * Update composer deps, I think the lock file wasn't right. add json and mbstring extension deps while I'm at it. * Fix several issues with phpunit fixtures 2018-08-11 23:37:45 +02:00			Modify startup options to include `-M /opt/librenms/mibs -m ALL`

Add doc stub for SNMP trap handling 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.)`