JIRA

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

Overview

Create and resolve Jira issues for Sensu events.

Configuration

Example

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

{
  "jira": {
    "host": "jira.example.com",
    "user": "admin",
    "password": "secret",
    "project": "Sensu",
    "timeout": 10
  }
}

Integration Specification

jira attributes

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

host
description The JIRA host address.
required true
type String
example
"host": "jira.example.com"
user
description The JIRA user used to authenticate.
required true
type String
example
"user": "admin"
password
description The JIRA user password.
required true
type String
example
"password": "secret"
project
description The JIRA project to use for issues.
required false
type String
default Sensu
example
"project": "Alerts"
project_key
description The JIRA project key to use for issues. This option allows the integration to work without querying JIRA for a projects key. Using this option is recommended.
required false
type String
example
"project_key": "SEN"
issue_type
description Specifies default issue type for projects. NOTE: The project used with this integration must include the issue_type defined here. For more info please see Atlassian’s documentation here.
required false
type String
default Incident
example
"issue_type": "Bug"
root_url
description The JIRA root URL. When set, this option overrides the host option, most commonly used when a service proxy is in use.
required false
type String
example
"root_url": "https://services.example.com/proxy/jira"
http_proxy
description The URL of a proxy to be used for HTTP requests.
required false
type String
example
"http_proxy": "http://192.168.250.11:3128"
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
default
["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