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
CentOS
Debian
Ubuntu

RedHat

Install the BigPanda Agent on RedHat

  1. 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.

  2. Install the BigPanda SNMP daemon:

    $ sudo yum install bigpanda-snmpd
    

Configure the BigPanda Agent

  1. 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

  1. 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/
    
  2. 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 the processing.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

  1. 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

  1. Install SNMP Utils:

    $ sudo yum install net-snmp-utils
    
  2. 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

  1. 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.

  2. Install the BigPanda SNMP daemon:

    $ sudo yum install bigpanda-snmpd
    

Configure the BigPanda Agent

  1. 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

  1. 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/
    
  2. 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 the processing.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

  1. 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

  1. Install SNMP Utils:

    $ sudo yum install net-snmp-utils
    
  2. 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

  1. 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
    
  2. Install the BigPanda SNMP daemon:

    $ sudo apt-get install bigpanda-snmpd
    

Configure the BigPanda Agent

  1. 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

  1. 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/
    
  2. 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 the processing.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

  1. Start the BigPanda agent and snmpd services by running the following commands:

    $ sudo service bigpanda start
    $ sudo service bigpanda-snmpd start
    

Test the Integration

  1. Install SNMP Utils:

    $ sudo apt-get install snmp
    
  2. 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

  1. 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
    
  2. Install the BigPanda SNMP daemon:

    $ sudo apt-get install bigpanda-snmpd
    

Configure the BigPanda Agent

  1. 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

  1. 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/
    
  2. 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 the processing.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

  1. Start the BigPanda agent and snmpd services by running the following commands:

    $ sudo service bigpanda start
    $ sudo service bigpanda-snmpd start
    

Test the Integration

  1. Install SNMP Utils:

    $ sudo apt-get install snmp
    
  2. 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.