Select Supported Platforms

Select Supported Architectures

Select Tier

Github Name

v0.2.0 · public · Published over 2 years ago

Asset Definition
Release Notes
Release Assets

Sensu iLert Handler

Table of Contents


The Sensu iLert Handler is a Sensu Event Handler which manages
iLert incidents, for alerting operators. With this handler,
Sensu can trigger and resolve iLert incidents.

Usage examples

Help output

The Sensu Go Ilert handler for incident management

  sensu-ilert-handler [flags]
  sensu-ilert-handler [command]

Available Commands:
  help        Help about any command
  version     Print the version number of this plugin

  -k, --dedup-key-template string   The Ilert deduplication key template, can be set with ILERT_DEDUP_KEY_TEMPLATE (default "{{.Entity.Name}}-{{.Check.Name}}")
  -d, --details-template string     The template for the alert details, can be set with ILERT_DETAILS_TEMPLATE (default full event JSON)
  -h, --help                        help for sensu-ilert-handler
  -S, --summary-template string     The template for the alert summary, can be set with ILERT_SUMMARY_TEMPLATE (default "{{.Entity.Name}}/{{.Check.Name}} : {{.Check.Output}}")
  -t, --token string                The Ilert API authentication token, can be set with ILERT_SENSU_TOKEN

Use "sensu-ilert-handler [command] --help" for more information about a command.

Deduplication key

The deduplication key is determined via the --dedup-key-template argument. It
is a Golang template containing the event values and defaults to


Asset registration

The easiest way to get this handler added to your Sensu environment, is to add it as an asset from Bonsai:

sensuctl asset add ilert/sensu-ilert --rename sensu-ilert-handler

See sensuctl asset --help for details on how to specify version.

Handler definition

type: Handler
api_version: core/v2
  name: ilert
  namespace: default
  type: pipe
  command: sensu-ilert-handler
  timeout: 10
  - ilert/sensu-ilert
  - is_incident
    secret: ilert_sensu_token

Environment variables

Most arguments for this handler are available to be set via environment
variables. However, any arguments specified directly on the command line
override the corresponding environment variable.

Argument Environment Variable
--summary-template ILERT_SUMMARY_TEMPLATE
--dedup-key-template ILERT_DEDUP_KEY_TEMPLATE

Security Note: Care should be taken to not expose the auth token for this
handler by specifying it on the command line or by directly setting the
environment variable in the handler definition. It is suggested to make use of
secrets management to surface it as an environment variable. The handler
definition above references it as a secret. Below is an example secrets
definition that make use of the built-in env secrets provider.

type: Secret
api_version: secrets/v1
  name: ilert_sensu_token
  provider: env

Installation from source

Download the latest version of the sensu-ilert-handler from releases,
or create an executable from this source.

From the local path of the sensu-ilert-handler repository:

go build -o /usr/local/bin/sensu-ilert-handler



Are you sure you want to report this asset?

Please describe the reason for reporting this asset. Our moderators will be notified and will disable the asset if it is found to be inappropriate.


You must be signed in to report this asset.

Sign In with Github



Either download the source code:

Download Source

Or download the asset definition: