Sensu iLert Handler

Table of Contents

• Overview
• Usage examples
  • Help output
  • Deduplication key
• Configuration
  • Asset registration
  • Handler definition
  • Environment variables
• Installation from source
• Contributing

Overview

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

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
{{.Entity.Name}}-{{.Check.Name}}.

Configuration

Asset registration

Handler definition

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.

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
metadata:
  name: ilert_sensu_token
spec:
  provider: env
  id: ILERT_SENSU_TOKEN

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

Contributing

See https://github.com/sensu/sensu-go/blob/master/CONTRIBUTING.md