isabella232 / sensu-victorops-handler

Sensu VictorOps Handler

Table of Contents

• Overview
• Configuration
  • Asset registration
  • Resource definition
• Usage examples
  • Help output
  • Templates
  • Environment variables
  • Argument annotations
• Installation from source

Overview

The Sensu VictorOps Handler is a Sensu Go Handler for sending events to the VictorOps incident response platform.

As of the initial version (0.1.x), this is meant to work in the same fashion as the prior Ruby based plugin, sensu-plugins-victorops, with the following changes:

• The environment variables for routing key and API URL are now SENSU_VICTOROPS_ROUTINGKEY and SENSU_VICTOROPS_APIURL, respectively
• Since Sensu Go events do not have an action, the RECOVERY message_type is based on event.check.status == 0

Configuration

Asset registration

Sensu Assets are the best way to make use of this plugin. If you're not using an asset, please consider doing so! If you're using sensuctl 5.13 with Sensu Backend 5.13 or later, you can use the following command to add the asset:

sensuctl asset add sensu/sensu-victorops-handler

If you're using an earlier version of sensuctl, you can find the asset on the Bonsai Asset Index.

Resource definition

---
type: Handler
api_version: core/v2
metadata:
  name: sensu-victorops-handler
  namespace: default
spec:
  command: sensu-victorops-handler
  filters:
  - is_incident
  - not_silenced
  type: pipe
  runtime_assets:
  - sensu/sensu-victorops-handler
  secrets:
  - name: SENSU_VICTOROPS_ROUTINGKEY
    secret: victorops_routingkey

Usage examples

Help output

Usage:
  sensu-victorops-handler [flags]
  sensu-victorops-handler [command]

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

Flags:
  -a, --api-url string              The URL for the VictorOps API (default "https://alert.victorops.com/integrations/generic/20131114/alert")
  -r, --routingkey string           The VictorOps Routing Key
  -e, --entity-id-template string   The template for the Entity ID sent to VictorOps (default "{{.Entity.Name}/{{.Check.Name}}")
  -m, --message-template string     The template for the message sent to VictorOps (default "{{.Entity.Name}:{{.Check.Name}}:{{.Check.Output}}")
  -h, --help                        help for sensu-victorops-handler

Templates

This handler provides options for using templates to populate the values provided by the event in the message sent via SNS. More information on template syntax and format can be found in the documentation.

Environment variables

Argument	Environment Variable
--routingkey	SENSU_VICTOROPS_ROUTINGKEY
--api-url	SENSU_VICTOROPS_APIURL

Security Note: Care should be taken to not expose the routing key 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: victorops_routingkey
spec:
  provider: env
  id: SENSU_VICTOROPS_ROUTINGKEY

Argument annotations

All arguments for this handler are tunable on a per entity or check basis based on annotations. The annotations keyspace for this handler is sensu.io/plugins/victorops/config.

NOTE: Due to check token substituion, supplying a template value such as for message-template as a check annotation requires that you place the desired template as a golang string literal (enlcosed in backticks) within another template definition. This does not apply to entity annotations.

Examples

To change the message template for a particular check, for that check's metadata add the following:

type: CheckConfig
api_version: core/v2
metadata:
  annotations:
    sensu.io/plugins/victorops/config/message-template: "{{`{{.Entity.Name}}/{{.Check.Name}}: {{.Check.State}}, {{.Check.Occurrences}}`}}"
[...]

Installation from source

The preferred way of installing and deploying this plugin is to use it as an Asset. If you would like to compile and install the plugin from source or contribute to it, download the latest version or create an executable from this source.

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

go build