0
0
Fork 0
mirror of https://github.com/alerta/alerta-contrib.git synced 2025-03-17 05:52:38 +00:00
alerta_alerta-contrib/integrations/snmptrap
2016-12-10 17:32:21 +00:00
..
handler.py fixed import name to alertaclient 2016-09-15 09:12:46 +00:00
README.md Update lots of READMEs 2016-12-10 17:32:21 +00:00
setup.py rename monitors to integrations 2015-01-26 11:55:20 +00:00

SNMP Trap Integration

SNMP trap listener sends alerts to Alerta.

For help, join Gitter chat

Prerequisites

  • Net-SNMP snmptrapd package - integration runs as a trap handler by Net-SNMP snmptrapd

To install net-snmp on RedHat/Centos Linux:

$ yum -y install net-snmp net-snmp-utils

Installation

Clone the GitHub repo and run:

$ python setup.py install

Or, to install remotely from GitHub run:

$ pip install git+https://github.com/alerta/alerta-contrib.git#subdirectory=integrations/snmptrap

Configuration

Configure snmptrapd to execute alerta-snmptrap when an SNMP trap is received:

$ vi /etc/snmp/snmptrapd.conf

authCommunity log,execute,net public
format execute $a %a\n$A %A\n$s %s\n$b %b\n$B %B\n$x %#y-%#02m-%#02l\n$X %#02.2h:%#02.2j:%#02.2k\n$N %N\n$q %q\n$P %P\n$t %t\n$T %T\n$w %w\n$W %W\n%V~\%~%v\n
traphandle default alerta-snmptrap

$ vi /etc/sysconfig/snmptrapd

export ALERTA_ENDPOINT="http://10.0.2.2:8080"

$ service snmptrapd start

Troubleshooting

  1. Stop snmptrapd and run it in the foreground:

    $ sudo service snmptrapd stop $ sudo ALERTA_ENDPOINT="http://10.0.2.2:8080" snmptrapd -Lsd -p /var/run/snmptrapd.pid -f

  2. Tail syslog file:

    $ tail -f /var/log/messages

  3. Send test trap:

    $ snmptrap -v2c -c public localhost "" .1.3.6.1.6.3.1.1.5.3.0 0 s "This is a test linkDown trap"

References

License

Copyright (c) 2014-2016 Nick Satterly. Available under the MIT License.