Sensu Go Jira Handler

The Sensu Go Jira handler is a Sensu Event Handler that creates or updates a Jira issue.

Configuration

Example Sensu Go definition:

{
    "api_version": "core/v2",
    "type": "Handler",
    "metadata": {
        "namespace": "default",
        "name": "jira"
    },
    "spec": {
        "type": "pipe",
        "command": "sensu-jira-handler --jira-url 'https://example.atlassian.net' --jira-project-key SEN --jira-username 'sensu@example.com' --jira-password 'secret' --jira-issue-type 'Bug'",
        "timeout": 10,
        "filters": [
            "is_incident"
        ]
    }
}

Usage Examples

Help:

The Sensu Go Jira Handler

Usage:
  sensu-jira-handler [flags]

Flags:
      --event-json-file string     File containing the event JSON
  -h, --help                       help for sensu-jira-handler
  -P, --http-proxy string          The HTTP Proxy if necessary
  -T, --http-timeout string        The HTTP timeout
  -t, --jira-issue-type string     The type of Jira issue to create
  -p, --jira-password string       The Jira password
  -k, --jira-project-key string    The Jira project key
  -n, --jira-project-name string   The Jira project name
  -U, --jira-url string            The Jira URL
  -u, --jira-username string       The Jira usernane
  -v, --verbose                    Verbose mode

Authenticating Using Jira's Cloud Version

While the on-premise version of Jira uses basic HTTP authentication with only a simple username and password the cloud
version requires the use of an API token to authenticate. To create the API token perform the following steps:

1. Navigate to Atlassian's API Tokens Screen
2. Click on the Create API Token button
3. In the popup box enter Sensu Jira Handler or any label of your liking
4. Click on the Create button
5. Click on Copy to clipboard to copy your token

The token copied becomes the password you use to authenticate using the --jira-password or -p option.

Example:

sensu-jira-handler --jira-username your@email.com --jira-password xwBPFTG0s9zYgTfkFsK6505E ... 

or

sensu-jira-handler -u your@email.com -p xwBPFTG0s9zYgTfkFsK6505E ...