Install OpsView v2 with Debian or Ubuntu

Configure the BigPanda agent to send monitoring alerts from OpsView v2.

The BigPanda agent is a low-footprint utility installed on the master host of your monitoring tool. It consumes alerts from the tool in real-time and then transmits them to BigPanda via TLS-encrypted HTTP calls.

❗️

Python Compatibility

To use the Open Integration Manager for Agent-based integrations, Python version>= 3.8.0 and an Agent version >= 10.2 are required.

Prerequisites

python >= 3.8 and python-pip3 should be installed prior to installing the bigpanda-agent package.

  1. Ensure python3 is installed with the following command:

    $ sudo apt install -y python3
    
  2. Verify the install with the following commands:

    $ python3 --version
    $ pip3 --version
    

Note: If pip3 was not installed as a dependency, it can be installed with sudo apt install -y python3-pip.

Note: Access to JFrog, pypi, and yum repositories are required to install all dependencies.

Install the BigPanda Agent on Debian or Ubuntu

Connect to the host where your OpsView v2 server is installed, and install the BigPanda agent package.

  1. Ensure packages are installed prior to downloading the BigPanda agent package:

    $ sudo apt update && sudo apt install -y gnupg2 curl lsb-release
    
  2. Add the BigPanda repository and download the OpenPGP key:

        $ echo deb https://bigpandaio.jfrog.io/artifactory/int-deb `lsb_release -c -s` main | sudo tee /etc/apt/sources.list.d/bigpanda.list
        $ curl -sL https://bigpandaio.jfrog.io/artifactory/api/security/keypair/bigpanda/public | gpg --dearmor | sudo tee /etc/apt/trusted.gpg.d/bigpanda.gpg > /dev/null
    
    • The --dearmor option is for unpacking input from an OpenPGP ASCII armored key.
    • Since apt-key is marked to be deprecated on future releases of Debian or Ubuntu, it is preferred to manage keyring files in trusted.gpg.d instead.
    • Note: apt-key can still be used in place of OpenPGP, but it is less secure.
      $ curl -sL https://bigpandaio.jfrog.io/artifactory/api/security/keypair/bigpanda/public | sudo apt-key add -
      
  3. Update the repo list and install the BigPanda agent package.

    $ sudo apt update
    $ sudo apt install -y bigpanda-agent
    

    Note: For the OIM, bigpanda-agent v10.0.0+ is required.

Troubleshooting:

Error:

E: The method driver /usr/lib/apt/methods/https could not be found.
N: Is the package apt-transport-https installed?

Solution:

$ sudo ln -sf /usr/lib/apt/methods/http /usr/lib/apt/methods/https
$ sudo apt install -y apt-transport-https
$ sudo apt update

Opsview Permissions

Ensure the opsview user is added to the bigpanda group.

  • The default user, opsview, is added during the bigpanda agent installation. You can validate this with grep.
      $ cat /etc/group | grep -i bigpanda:
    
    
  • If additional users need to be added, run the following command:
      $ sudo usermod -aG bigpanda <user>
    

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 <Your Org Bearer Token>
            $ sudo bigpanda-config --add rawalertstransfer --app-key <Your App Key>
    

Usage

The notify_by_bigpanda notification script works in conjunction with the bigpanda-agent to send events to BigPanda. The following is a print out of the script's usage:

usage: notify_by_bigpanda [-h] [-d] [-v] [-n NAGIOS_VARS [NAGIOS_VARS ...]] [-t] [-l LOG] [-q QUEUE]

OpsView notifications script for bigpanda.io.

options:
-h, --help            show this help message and exit
-d, --debug           prints stderr to log file (default: False)
-v, --verbose         all logging modules print to log file (default: False)
-n NAGIOS_VARS [NAGIOS_VARS ...], --nagios-vars NAGIOS_VARS [NAGIOS_VARS ...]    List of Nagios ENV Variables to add to the payload in the format 'var=nagios_env_var' (default: None)
-t, --send-test       Sends a test payload to BigPanda (default: False)
-l LOG, --log LOG     Alternate log file location (default: /var/log/bigpanda/opsview.log)
-q QUEUE, --queue QUEUE     BigPanda alerts queue (default: /var/lib/bigpanda/queue)

Test the Notification Script

  1. To enable the script, log in to the Opsview console.

  2. At the top navigation bar, select CONFIGURATION.

  3. Under Users and Notifications, select NOTIFICATION METHODS.

  4. Click the + Add New button.

  5. Fill in the form as follows:

    Name: BigPanda
    Enable: checked
    Command: notify_by_bigpanda -d -t
    
    

    Note: -d turns on debug logging, -t sends a pre-configured test payload.

  6. Select Test at the top of the form and click the Send button.

Once the test payload has been generated, you can view both the log output in /var/log/bigpanda/opsview.log, and the payload in /var/lib/bigpanda/queue (given the agent is not running).

If you do not see a log entry or a payload, check that the opsview user has been added to the bigpanda group.

$ getent group | grep bigpanda:

You can also check that the permissions on the log and queue directories are set to 0775.

Configure the Notification Script

  1. After a successful test, configure the notification method with the desired command arguments. The default configuration has no arguments:

    ```
        notify_by_bigpanda
    
    ```
    
    **Note:** Additional <a href="https://docs.itrsgroup.com/docs/opsview/6.8.0/monitoring/notifications/customized-notification-methods/index.html#writing-your-own-notification-script" target="_blank" rel="noopener noreferrer">NAGIOS Variables</a> can be added to the default payload by passing the `-n` argument to the `notify_by_bigpanda` script. This should be a `key/value` pair separated by an equal sign (`=`).
    
    [block:image]
    

    {
    "images": [
    {
    "image": [
    "https://files.readme.io/a0d5796-opsview_v6_config_1.png",
    "OpsView Notification Configuration"
    ],
    "align": "center",
    "border": true,
    "caption": "OpsView Notification Configuration"
    }
    ]
    }
    [/block]

  2. Once the notification method is configured, click the Submit Changes button.

  3. At the top of the screen, click the number. This indicates the number of changes submitted.

    OpsView Changes Icon

    OpsView Changes Icon

  4. Click Apply Changes to add the new notification method.

Start the BigPanda Agent

$ sudo service bigpanda start

Success

You should be able to see all your active OpsView v2 alerts in the Incidents tab.