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.
-
Ensure python3 is installed with the following command:
$ sudo apt install -y python3
-
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.
-
Ensure packages are installed prior to downloading the BigPanda agent package:
$ sudo apt update && sudo apt install -y gnupg2 curl lsb-release
-
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 -
- The
-
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
-
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
-
To enable the script, log in to the Opsview console.
-
At the top navigation bar, select CONFIGURATION.
-
Under Users and Notifications, select NOTIFICATION METHODS.
-
Click the + Add New button.
-
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. -
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
-
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] -
Once the notification method is configured, click the Submit Changes button.
-
At the top of the screen, click the number. This indicates the number of changes submitted.
-
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.
Updated 1 day ago