Sensu

Supported Versions	Type	Authentication Type
<= 5.0.0	Webhook	Org Bearer Token

Sensu is a monitoring platform that you can build upon, enabling you to focus on what to monitor and measure, rather than how. Sensu monitors application and system services, detecting those in an unhealthy state.

Use the instructions below to install the integration and begin sending alerts from Sensu to BigPanda.

Install the Integration

Install the integration by following these steps:

Create an App Key

Create an app key in BigPanda.

Integration specific

You'll need a separate app key for each integrated system.

https://files.readme.io/9865f2f-Integrations_App_Key_Creation.jpg

App Key Configuration in BigPanda

Create a Sensu Handler

In order to send events to BigPanda we need to define a handler for Sensu (more about handlers):

Connect to the Sensu server via shell.
Make sure you have all the following libraries installed: ruby, ruby-dev, build-essential.
Make sure you have the sensu-plugin gem installed: sudo gem install sensu-plugin.

Download the BigPanda handler and its configuration by executing the following:

sudo curl -o /etc/sensu/handlers/bigpanda.rb https://a.bigpanda.io/resources/integrations/sensu/bigpanda.rb

sudo curl https://a.bigpanda.io/resources/integrations/sensu/handler_bigpanda.json | $SED | sudo tee /etc/sensu/conf.d/handler_bigpanda.json > /dev/null

Change the script’s permissions to allow Sensu to execute it (you might need to replace sensu with the appropriate user):
```
sudo chown sensu:sensu /etc/sensu/handlers/bigpanda.rb && sudo chmod 700 /etc/sensu/handlers/bigpanda.rb
```

Add BigPanda as a Handler

Still on the Sensu server, go to the checks configuration directory (default: /etc/sensu/conf.d):

For each check, add "bigpanda" to the handlers array. The outcome should look similar to this:

   {
     "checks": {
       "<check_name>": {
         "handlers": ["<handler_1_name>", "<handler_2_name>", ..., "bigpanda"],

For example, the cron_check from sensu documentation should look like this:

   {
     "checks": {
       "cron_check": {
         "handlers": ["default", "bigpanda"],
         "command": "/etc/sensu/plugins/check-procs.rb -p cron -C 1 ",
         "interval": 60,
         "subscribers": [ "webservers" ]
       }
     }
   }

Restart the sensu-server service:

sudo /etc/init.d/sensu-server restart

Uninstall the Integration

Deleting an integration requires that you remove the integration in both the integrated system and BigPanda. We recommend that you first uninstall the integration on the integrated system to prevent traffic from being sent and rejected by BigPanda, since the app key will not exist once you delete the integration in BigPanda.

Caution during replacement

When replacing an existing integration with a new tool or system, we recommend configuring the new integration first to ensure no data is lost.

Deactivate Inbound Integration

If you want to stop sending data to BigPanda but don’t want to delete your integration, you can temporarily deactivate it.

To deactivate an inbound integration:

In BigPanda, navigate to the Integrations tab and select the desired integration from the list. This will open integration details on the right side of the window.
At the top of the integration details, click the Active/Inactive toggle next to the application name to change the status of the integration.

In the integrations list, inactive integrations will be marked with a gray bar.

Alert Resolution for Inactive Integrations

Any active alerts belonging to an inactive integration must be manually resolved or they will stay in the system until the auto-resolve window is reached.

Stop Sending Data to BigPanda

On the Sensu server, go to the checks configuration directory. By default, the directory is located at: /etc/sensu/conf.d
For each check, delete the BigPanda handler. For example, you would remove the "bigpanda" handler from this check definition.
```
{
  "checks": {
  "<check_name>": {
  "handlers": ["<handler_1_name>", "<handler_2_name>", ..., "bigpanda"]
```
Remove the BigPanda Handler and configuration files, which are located at:
- /etc/sensu/handlers/bigpanda.rb
- /etc/sensu/conf.d/handler_bigpanda.json
Restart the Sensu server by running the following command: sudo /etc/init.d/sensu-server restart

Delete the Integration in BigPanda

Take the following steps to delete the integration from BigPanda:

In BigPanda, navigate to the Integrations tab and select the desired integration from the list.
In the integration details on the right of the page, click the trash icon, then confirm you want to delete the integration. The integration will be removed immediately.

️Automatic alert resolution for deleted integrations

All active alerts from the integration will be resolved after deletion.

Data removal

This procedure does not remove any data from the integrated system.

In this section: