Sensu Core Integration Guide

This integration guide explains how to configure Sensu to send monitoring alarms to AlertAgility.

In your AlertAgility account:

  1. Click on Services in the navbar and find ‘Sensu Integration’. Sensu Integration

  2. Create a new Sensu service and copy your service key. Sensu Integration

In your Sensu server:

Download the Sensu handler for AlertAgility’s API:

wget -O /etc/sensu/handlers/handler-alertagility.rb

Ensure the file is executable:

chmod 755 /etc/sensu/handlers/handler-alertagility.rb

Create an AlertAgility handler config.

cat /etc/sensu/conf.d/alertagility_handler.json

  "handlers": {
    "alertagility": {
      "type": "pipe",
      "command": "/etc/sensu/handlers/handler-alertagility.rb"
  "alertagility": {
    "api_url": "https://<YOUR SUBDOMAIN HERE>",
    "api_key": "<YOUR SENSU SERVICE KEY>"

You can now follow the usual Sensu handler configuration to either make AlertAgility the default handler for all your sensu alerts or to define which handler to use for each check.

If you make AlertAgility the default handler, any check for which no specific handler has been defined will use the AlertAgility handler.

  1. To make AlertAgility Sensu’s default handler: ``` cat /etc/sensu/conf.d/default_handler.json

{ “handlers”: { “default”: { “type”: “set”, “handlers”: [ “alertagility” ] } } }

2. You can define as many different handlers as you want for different checks: Here, for example, is how to use AlertAgility as the handler for a cron check:

cat /etc/sensu/conf.d/check_cron.json

{ “checks”: { “cron”: { “command”: “check-process.rb -p cron”, “subscribers”: [ “”, ], “interval”: 20, “handlers”: [“alertagility”] } } }