SNMP Installation Instructions
How to Integrate SNMP with BigPanda
Create an App Key
First create an App Key. You'll need a separate App Key for each integrated system
Select an Install Method
RedHat
Install the BigPanda Agent on RedHat
-
Connect to the host where your SNMP trap server is installed, and install the BigPanda agent package.
$ sudo wget http://repos.bigpanda.io/config/bigpanda.repo -O /etc/yum.repos.d/bigpanda.repo $ sudo yum install bigpanda-agent
Note: If you run RHEL 5, you will need to install the EPEL repository. Please consult the FAQ for instructions.
-
Install the BigPanda SNMP daemon:
$ sudo yum install bigpanda-snmpd
Configure the BigPanda Agent
-
Configure the agent to work with the Raw Alerts Transfer plugin by running the following commands:
$ sudo bigpanda-config --init --token $TOKEN $ sudo bigpanda-config --add rawalertstransfer --app-key $YOUR_APP_KEY
Configure the BigPanda SNMP Agent
-
If any MIBs are not included by default, they need to be compiled and added manually:
$ cd /opt/bigpanda/bigpanda-snmpd/mib_compiler $ sudo ./compile_mib.sh --input-directory <path to MIBs> --output-directory /etc/bigpanda/snmpd/conf/
-
Modify Config Files
For MIBs that are to be monitored, their respective Event Configuration files must be added to the bigpanda-snmpd configuration file:
Edit
/etc/bigpanda/snmpd/snmp-daemon.json
, and add the paths to the event_config files to theprocessing.event-configs
array.For example:
$ sudo vi /etc/bigpanda/snmpd/snmp-daemon.json ... { <snip> "processing": { "mibs-dir": "/etc/bigpanda/snmpd/mibs", "event-configs": [ event_configs/example.json, <ADD EVENT CONFIGS HERE> ], "target-dir": "/var/lib/bigpanda/queue", "stress_test": false } </snip> }
Start the Services
-
Start the BigPanda agent and snmpd services by running the following commands:
-
For RHEL 5 and 7:
$ sudo service bigpanda start $ sudo service bigpanda-snmpd start
-
For RHEL 6:
$ sudo initctl start bigpanda $ sudo initctl start bigpanda-snmpd
-
Test the Integration
-
Install SNMP Utils:
$ sudo yum install net-snmp-utils
-
Send the test SNMP trap:
$ sudo snmptrap -v 2c -c public 127.0.0.1:5000 1 1.3.6.1.2.1.1 1.3.6.1.2.1.1.5 s "production-switch-1" 1.3.6.1.2.1.1.1 s "SNMP trap test"
Note: Since it is a test message, it won't be resolved automatically. Click Resolve incident in the BigPanda UI to manually resolve it.
CentOS
Install the BigPanda Agent on CentOS
-
Connect to the host where your SNMP trap server is installed, and install the BigPanda agent package.
$ sudo wget http://repos.bigpanda.io/config/bigpanda.repo -O /etc/yum.repos.d/bigpanda.repo $ sudo yum install bigpanda-agent
Note: If you run CentOS 5, you will need to install the EPEL repository. Please consult the FAQ for instructions.
-
Install the BigPanda SNMP daemon:
$ sudo yum install bigpanda-snmpd
Configure the BigPanda Agent
-
Configure the agent to work with the Raw Alerts Transfer plugin by running the following commands:
$ sudo bigpanda-config --init --token $TOKEN $ sudo bigpanda-config --add rawalertstransfer --app-key $YOUR_APP_KEY
Configure the BigPanda SNMP Agent
-
If any MIBs are not included by default, they need to be compiled and added manually:
$ cd /opt/bigpanda/bigpanda-snmpd/mib_compiler $ sudo ./compile_mib.sh --input-directory <path to MIBs> --output-directory /etc/bigpanda/snmpd/conf/
-
Modify Config Files
For MIBs that are to be monitored, their respective Event Configuration files must be added to the bigpanda-snmpd configuration file:
Edit
/etc/bigpanda/snmpd/snmp-daemon.json
, and add the paths to the event_config files to theprocessing.event-configs
array.For example:
$ sudo vi /etc/bigpanda/snmpd/snmp-daemon.json ... { <snip> "processing": { "mibs-dir": "/etc/bigpanda/snmpd/mibs", "event-configs": [ event_configs/example.json, <ADD EVENT CONFIGS HERE> ], "target-dir": "/var/lib/bigpanda/queue", "stress_test": false } </snip> }
Start the Services
-
Start the BigPanda agent and snmpd services by running the following commands:
-
For CentOS 5 and 7:
$ sudo service bigpanda start $ sudo service bigpanda-snmpd start
-
For CentOS 6:
$ sudo initctl start bigpanda $ sudo initctl start bigpanda-snmpd
-
Test the Integration
-
Install SNMP Utils:
$ sudo yum install net-snmp-utils
-
Send the test SNMP trap:
$ sudo snmptrap -v 2c -c public 127.0.0.1:5000 1 1.3.6.1.2.1.1 1.3.6.1.2.1.1.5 s "production-switch-1" 1.3.6.1.2.1.1.1 s "SNMP trap test"
Note: Since it is a test message, it won't be resolved automatically. Click Resolve incident in the BigPanda UI to manually resolve it.
Debian
Install the BigPanda Agent on Debian
-
Connect to the host where your SNMP trap server is installed, and install the BigPanda agent package.
$ echo deb http://repos.bigpanda.io/deb `lsb_release -c -s` main | sudo tee /etc/apt/sources.list.d/bigpanda.list $ curl https://repos.bigpanda.io/config/bigpanda.pub | sudo apt-key add - $ sudo apt-get update $ sudo apt-get install bigpanda-agent
-
Install the BigPanda SNMP daemon:
$ sudo apt-get install bigpanda-snmpd
Configure the BigPanda Agent
-
Configure the agent to work with the Raw Alerts Transfer plugin by running the following commands:
$ sudo bigpanda-config --init --token $TOKEN $ sudo bigpanda-config --add rawalertstransfer --app-key $YOUR_APP_KEY
Configure the BigPanda SNMP Agent
-
If any MIBs are not included by default, they need to be compiled and added manually:
$ cd /opt/bigpanda/bigpanda-snmpd/mib_compiler $ sudo ./compile_mib.sh --input-directory <path to MIBs> --output-directory /etc/bigpanda/snmpd/conf/
-
Modify Config Files
For MIBs that are to be monitored, their respective Event Configuration files must be added to the bigpanda-snmpd configuration file:
Edit
/etc/bigpanda/snmpd/snmp-daemon.json
, and add the paths to the event_config files to theprocessing.event-configs
array.For example:
$ sudo vi /etc/bigpanda/snmpd/snmp-daemon.json ... { <snip> "processing": { "mibs-dir": "/etc/bigpanda/snmpd/mibs", "event-configs": [ event_configs/example.json, <ADD EVENT CONFIGS HERE> ], "target-dir": "/var/lib/bigpanda/queue", "stress_test": false } </snip> }
Start the Services
-
Start the BigPanda agent and snmpd services by running the following commands:
$ sudo service bigpanda start $ sudo service bigpanda-snmpd start
Test the Integration
-
Install SNMP Utils:
$ sudo apt-get install snmp
-
Send the test SNMP trap:
$ sudo snmptrap -v 2c -c public 127.0.0.1:5000 1 1.3.6.1.2.1.1 1.3.6.1.2.1.1.5 s "production-switch-1" 1.3.6.1.2.1.1.1 s "SNMP trap test"
Note: Since it is a test message, it won't be resolved automatically. Click Resolve incident in the BigPanda UI to manually resolve it.
Ubuntu
Install the BigPanda Agent on Ubuntu
-
Connect to the host where your SNMP trap server is installed, and install the BigPanda agent package.
$ echo deb http://repos.bigpanda.io/deb `lsb_release -c -s` main | sudo tee /etc/apt/sources.list.d/bigpanda.list $ curl https://repos.bigpanda.io/config/bigpanda.pub | sudo apt-key add - $ sudo apt-get update $ sudo apt-get install bigpanda-agent
-
Install the BigPanda SNMP daemon:
$ sudo apt-get install bigpanda-snmpd
Configure the BigPanda Agent
-
Configure the agent to work with the Raw Alerts Transfer plugin by running the following commands:
$ sudo bigpanda-config --init --token $TOKEN $ sudo bigpanda-config --add rawalertstransfer --app-key $YOUR_APP_KEY
Configure the BigPanda SNMP Agent
-
If any MIBs are not included by default, they need to be compiled and added manually:
$ cd /opt/bigpanda/bigpanda-snmpd/mib_compiler $ sudo ./compile_mib.sh --input-directory <path to MIBs> --output-directory /etc/bigpanda/snmpd/conf/
-
Modify Config Files
For MIBs that are to be monitored, their respective Event Configuration files must be added to the bigpanda-snmpd configuration file:
Edit
/etc/bigpanda/snmpd/snmp-daemon.json
, and add the paths to the event_config files to theprocessing.event-configs
array.For example:
$ sudo vi /etc/bigpanda/snmpd/snmp-daemon.json ... { <snip> "processing": { "mibs-dir": "/etc/bigpanda/snmpd/mibs", "event-configs": [ event_configs/example.json, <ADD EVENT CONFIGS HERE> ], "target-dir": "/var/lib/bigpanda/queue", "stress_test": false } </snip> }
Start the Services
-
Start the BigPanda agent and snmpd services by running the following commands:
$ sudo service bigpanda start $ sudo service bigpanda-snmpd start
Test the Integration
-
Install SNMP Utils:
$ sudo apt-get install snmp
-
Send the test SNMP trap:
$ sudo snmptrap -v 2c -c public 127.0.0.1:5000 1 1.3.6.1.2.1.1 1.3.6.1.2.1.1.5 s "production-switch-1" 1.3.6.1.2.1.1.1 s "SNMP trap test"
Note: Since it is a test message, it won't be resolved automatically. Click Resolve incident in the BigPanda UI to manually resolve it.
Updated 7 months ago