https://github.com/phpipam/php-snmptraps
php snmptrap handler + web UI
https://github.com/phpipam/php-snmptraps
Last synced: 4 months ago
JSON representation
php snmptrap handler + web UI
- Host: GitHub
- URL: https://github.com/phpipam/php-snmptraps
- Owner: phpipam
- Created: 2016-04-19T11:07:22.000Z (about 10 years ago)
- Default Branch: master
- Last Pushed: 2025-01-20T08:55:14.000Z (over 1 year ago)
- Last Synced: 2025-01-20T09:38:39.669Z (over 1 year ago)
- Language: PHP
- Size: 2.7 MB
- Stars: 73
- Watchers: 16
- Forks: 31
- Open Issues: 13
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
## php-snmptraps
###### php snmptrap handler and web UI for management
php-snmptraps is an php trpahandler that processes snmp traps, writes them to database and/or file and sends
notifications via sms/email/pushover to users, based on web settings.
It comes with nice HMTL5 UI:
* Dashboard that shows overview of last messages
* Displays messages sent by specific host
* Displays messages per severity
* Displays specific messages received
* Live update of received traps
and more.
You can set severity level for each received message, ignore specific message types, create maintenance periods
for hosts, set per-user quiet hours and more.
Notifications are set per-user/severity, by default aupported are:
* Email notification
* Pushover notification
* SMS notification
* Slack/Mattermost notification
The can be easily extended to any other custom notification type.
## screenshots
Some sample UI screenshots can be found below:
## setup
This guide assumes you have a working net-snmp, apache, php and mysql installation with default apache files stored
in /var/www/.
1.Set traphandler
First, edit file `/etc/snmp/snmptrapd.conf` and add traphandler for default files to traphandler.php:
```
# listen on
agentaddress my_ip_address:162
# set php-snmptraps as default trap handler
traphandle default /usr/bin/php /var/www/traphandler.php
```
2.Prepare and edit config file
Now go to /var/www/ directory and copy config.dist.php to config.php:
```
cp /var/www/config.dist.php /var/www/config.php
```
and edit the config file to match your settings.
3.Set mod_rewrite
mod_rewrite is required for snmptraps. Example here:
http://phpipam.net/documents/prettified-links-with-mod_rewrite/
4.Import database schema
Now you have to import chema for mysql database with following command:
```
mysql -u root -p
Enter password:
mysql> create database snmptraps;
Query OK, 1 row affected (0.00 sec)
mysql> GRANT ALL on snmptraps.* to snmptraps@localhost identified by "snmptraps";
Query OK, 0 rows affected (0.00 sec)
mysql> exit
Bye
# import SCHEMA.SQL file
mysql -u root -p snmptraps < db/SCHEMA.sql
```
That should be it, fire up browser and login. Default user/pass is Admin/snmptraps.
5.Send test message and debugging
To test snmptrap you can use the following command:
```snmptrap -v 2c -c public my_public_ip '' .1.3.6.1.4.1.2636.4.1.1 .1.3.6.1.4.1.2636.4.1.1 s "Power supply failure"```
Check also the file you set in config.php for possible errors:
```tail -f /tmp/trap.txt```