OpsGenie

ENTERPRISE: Built-in integrations are available for Sensu Enterprise users only.

Overview

Create and close OpsGenie alerts for events.

Configuration

Example(s)

The following is an example global configuration for the opsgenie enterprise event handler (integration).

{
  "opsgenie": {
    "api_key": "eed02a0d-85a4-427b-851a-18dd8fd80d93",
    "source": "Sensu Enterprise (AWS)",
    "teams": ["ops", "web"],
    "recipients": ["afterhours"],
    "tags": ["production"],
    "overwrites_quiet_hours": true,
    "timeout": 10
  }
}

Integration Specification

opsgenie attributes

The following attributes are configured within the {"opsgenie": {} } configuration scope.

api_key
description The OpsGenie Alert API key to use when creating/closing alerts.
required true
type String
example
"api_key": "eed02a0d-85a4-427b-851a-18dd8fd80d93"
source
description The source to use for OpsGenie alerts.
required false
type String
default Sensu Enterprise
example
"source": "Sensu (us-west-1)"
teams
description An array of OpsGenie team names to be used to calculate which users will be responsible for created alerts.
required false
type Array
default []
example
"teams": ["ops", "web"]
recipients
description An array of OpsGenie group, schedule, or escalation names to be used to calculate which users will be responsible for created alerts.
required false
type Array
default []
example
"recipients": ["web", "afterhours"]
tags
description An array of OpsGenie alert tags that will be added to created alerts.
required false
type Array
default []
example
"tags": ["production"]
overwrites_quiet_hours
description If events with a critical severity should be tagged with “OverwritesQuietHours”. This tag can be used to bypass quiet (or off) hour alert notification filtering.
required false
type Boolean
default false
example
"overwrites_quiet_hours": true
filters
description An array of Sensu event filters (names) to use when filtering events for the handler. Each array item must be a string. Specified filters are merged with default values.
required false
type Array
default
["handle_when", "check_dependencies"]
example
"filters": ["recurrence", "production"]
severities
description An array of check result severities the handler will handle. NOTE: event resolution bypasses this filtering.
required false
type Array
allowed values ok, warning, critical, unknown
example
 "severities": ["critical", "unknown"]
timeout
description The handler execution duration timeout in seconds (hard stop).
required false
type Integer
default 10
example
"timeout": 30