sensu-go-pushover-handler

The Senso Go Pushover Handler is a Sensu Event Handler for sending incident notifications to Pushover.

This handler reuses concepts found in the sensu-email-handler.

Installation

Create an executable script from this source, download the asset from bonsai, or download one of the existing releases.

From the local path of the sensu-go-pushover-handler repository:

go build -o /usr/local/bin/sensu-go-pushover-handler main.go

Sensu Configuration

Example Sensu Go definition:

{
    "api_version": "core/v2",
    "type": "Handler",
    "metadata": {
        "namespace": "default",
        "name": "pushover"
    },
    "spec": {
        "type": "pipe",
        "command": "sensu-go-pushover-handler",
        "timeout": 10,
        "env_vars": [
            "SENSU_PUSHOVER_TOKEN=a0b1c2d3e4f5g6h7i8j9k0l1m2n3o4",
            "SENSU_PUSHOVER_USERKEY=a0b1c2d3e4f5g6h7i8j9k0l1m"
        ],
        "filters": [
            "is_incident",
            "not_silenced"
        ],
        "runtime_assets": [
            "sensu-go-pushover-handler"
        ]
    }
}

Pushover Configuration

This handler makes use of Pushover's standard API mechanism. This means creating an application token, as well as a user API key.

Usage Examples

Help

The Sensu Go Pushover handler for sending notifications

Usage:
  sensu-go-pushover-handler [flags]

Flags:
  -C, --criticalPriority uint    The priority for Critical status messages (default 1)
  -h, --help                     help for sensu-go-pushover-handler
  -b, --messageBody string       The message body, in token substitution format (default "{{.Check.Output}}")
  -m, --messageTitle string      The message title, in token substitution format (default "{{.Entity.Name}}/{{.Check.Name}}")
  -O, --okPriority uint          The priority for OK status messages (default 0)
  -t, --pushoverToken string     The Pushover API token
  -u, --pushoverUserKey string   The Pushover API token
  -U, --unknownPriority uint     The priority for Unknown status messages (default 1)
  -W, --warningPriority uint     The priority for Warning status messages (default 0)

Use of tokens

For defining the message title and body, tokens from the events attributes are used.

Environment Variables and Annotations

Variable	Setting	Annotation
SENSU_PUSHOVER_TOKEN	same as -t / --pushoverToken	sensu.io/plugins/pushover/config/pushoverToken
SENSU_PUSHOVER_USERKEY	same as -u / --pushoverUserKey	sensu.io/plugins/pushover/config/pushoverUserKey
N/A	same as -b / --messageBody	sensu.io/plugins/pushover/config/messageBody
N/A	same as -m / --messageTitle	sensu.io/plugins/pushover/config/messageTitle

Note: The command line arguments take precedence over the environment variables above.

Note: Annotations take precedence over command line arguments above.

balor / sensu-go-pushover-handler