jira

edit

This is a community-maintained plugin! It does not ship with Logstash by default, but it is easy to install by running bin/logstash-plugin install logstash-output-jira.

Origin https://groups.google.com/forum/#!msg/logstash-users/exgrB4iQ-mw/R34apku5nXsJ and https://botbot.me/freenode/logstash/msg/4169496/ via https://gist.github.com/electrical/4660061e8fff11cdcf37#file-jira-rb

Uses jiralicious as the bridge to JIRA

By Martin Cleaver, Blended Perspectives with a lot of help from electrical in #logstash

This is most useful so you can use logstash to parse and structure your logs and ship structured, json events to JIRA

To use this, you’ll need to ensure your JIRA instance allows REST calls

 

Synopsis

edit

This plugin supports the following configuration options:

Required configuration options:

jira {
    issuetypeid => ...
    password => ...
    priority => ...
    projectid => ...
    summary => ...
    username => ...
}

Available configuration options:

Setting Input type Required Default value

assignee

string

No

codec

codec

No

"plain"

host

string

No

issuetypeid

string

Yes

password

string

Yes

priority

string

Yes

projectid

string

Yes

reporter

string

No

summary

string

Yes

username

string

Yes

workers

number

No

1

Details

edit

 

assignee

edit
  • Value type is string
  • There is no default value for this setting.

JIRA Reporter

codec

edit
  • Value type is codec
  • Default value is "plain"

The codec used for output data. Output codecs are a convenient method for encoding your data before it leaves the output, without needing a separate filter in your Logstash pipeline.

exclude_tags (DEPRECATED)

edit
  • DEPRECATED WARNING: This configuration item is deprecated and may not be available in future versions.
  • Value type is array
  • Default value is []

Only handle events without any of these tags. Optional.

host

edit
  • Value type is string
  • There is no default value for this setting.

The hostname to send logs to. This should target your JIRA server and has to have the REST interface enabled

issuetypeid

edit
  • This is a required setting.
  • Value type is string
  • There is no default value for this setting.

JIRA Issuetype number

password

edit
  • This is a required setting.
  • Value type is string
  • There is no default value for this setting.

priority

edit
  • This is a required setting.
  • Value type is string
  • There is no default value for this setting.

JIRA Priority

projectid

edit
  • This is a required setting.
  • Value type is string
  • There is no default value for this setting.

Javalicious has no proxy support JIRA Project number

reporter

edit
  • Value type is string
  • There is no default value for this setting.

JIRA Reporter

summary

edit
  • This is a required setting.
  • Value type is string
  • There is no default value for this setting.

JIRA Summary

tags (DEPRECATED)

edit
  • DEPRECATED WARNING: This configuration item is deprecated and may not be available in future versions.
  • Value type is array
  • Default value is []

Only handle events with all of these tags. Optional.

type (DEPRECATED)

edit
  • DEPRECATED WARNING: This configuration item is deprecated and may not be available in future versions.
  • Value type is string
  • Default value is ""

The type to act on. If a type is given, then this output will only act on messages with the same type. See any input plugin’s type attribute for more. Optional.

username

edit
  • This is a required setting.
  • Value type is string
  • There is no default value for this setting.

workers

edit
  • Value type is number
  • Default value is 1

The number of workers to use for this output. Note that this setting may not be useful for all outputs.