/sentry-jira

A Plugin for sentry that lets you create JIRA issues

Primary LanguagePythonOtherNOASSERTION

sentry-jira

A flexible extension for Sentry which allows you to create issues in JIRA based on sentry events. It is capable of rendering and saving many custom fields, and will display the proper fields depending on which issue type you are trying to create.

Attention

I am developing this plugin against 2 different configurations of JIRA:

  • stock JIRA in development mode
  • live instance that has many specialized configurations / required custom fields

Since JIRA is so configurable, I'm looking for lots of feedback of the different ways that this breaks with specialized configurations. Provide your feedback here: https://github.com/thurloat/sentry-jira/issues

Visual Walkthrough

Per-Project configurations

http://sentry-jira.s3.amazonaws.com/ss4.png

When viewing a Sentry event, the Actions dropdown now contains a "Create JIRA Issue" button.

http://sentry-jira.s3.amazonaws.com/ss1.jpg

The Create JIRA Issue form is fully customized based on your JIRA Configuration and loads different fields depending on which issue type you choose.

http://sentry-jira.s3.amazonaws.com/ss2.png

You can now [0.5] use an auto-complete field to pull users from JIRA for any user field.

http://sentry-jira.s3.amazonaws.com/ss5.png

Once the Issue has been linked through JIRA there's a link that you can follow from Sentry to go directly to the issue on your configurated JIRA instance.

http://sentry-jira.s3.amazonaws.com/ss3.jpg

Installation

Install the package via pip:

pip install sentry-jira

Configuration

Go to your project's configuration page (Projects -> [Project]) and select the JIRA tab. Enter the JIRA credentials and Project configuration and save changes. Filling out the form is a two step process (one to fill in data, one to select project).

More Documentation

Have a look at the readthedocs page for more detailed configuration steps and a changelog: http://sentry-jira.readthedocs.org/en/latest/

License

sentry-jira is licensed under the terms of the 3-clause BSD license.

Contributing

All contributions are welcome, including but not limited to:

  • Documentation fixes / updates
  • New features (requests as well as implementations)
  • Bug fixes (see issues list)
  • Update supported JIRA types as you come across them