Documentation navigation

Jira

Jira is the tracker for teams planning and building great products.

Configuring Jira

Before we can link AppSignal to Jira we need to configure Jira to accept our OAuth request.

Sign in to Jira and open the "Settings" (Cogwheel) menu on the bottom of the sidebar. Then select "Products".

Administration navigation

In the "Product settings" screen look for the "Application links" under the "Integrations" section in the navigation.

Application links navigation

You'll be presented with a small form for a URL. Enter: https://appsignal.com in the field for a new Application Link.

If you receive a "No response was received from the URL you entered" error. Don't be alarmed, this is actually OK. Now click "continue".

Application details

In the modal, only fill out the "Application Name".

Application setup

After saving the integration, click the "Edit" icon for the newly created integration and go to the "Incoming Authentication" tab in the new modal.

OAuth navigation

OAuth setup

In the "Incoming OAuth" tab, setup OAuth with the following values:

  • Consumer Key: ce2jejafmni3qmnzrfergg9fLpzxmppl
  • Consumer Name: AppSignal
  • Public Key:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
-----BEGIN CERTIFICATE-----
MIIDaDCCAlACCQCmEw1Ty8uuRTANBgkqhkiG9w0BAQsFADB2MQswCQYDVQQGEwJO
TDEWMBQGA1UECAwNTm9vcmQtQnJhYmFudDESMBAGA1UEBwwJRGVuIEJvc2NoMRUw
EwYDVQQKDAxBcHBTaWduYWwgQlYxJDAiBgkqhkiG9w0BCQEWFWNvbnRhY3RAYXBw
c2lnbmFsLmNvbTAeFw0yMjA0MjExMDQ1MjBaFw0yMjA1MjExMDQ1MjBaMHYxCzAJ
BgNVBAYTAk5MMRYwFAYDVQQIDA1Ob29yZC1CcmFiYW50MRIwEAYDVQQHDAlEZW4g
Qm9zY2gxFTATBgNVBAoMDEFwcFNpZ25hbCBCVjEkMCIGCSqGSIb3DQEJARYVY29u
dGFjdEBhcHBzaWduYWwuY29tMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKC
AQEAtts1uBJnpIP89PDrlz7EjmEOBBE9RRjpfEEcPctwyYwgLwlP1rK75Qsi/f/T
4T8jD1Q5uVoaAx03m+OBnAJu016qZI2yaCBDVw4+eZwhD9O4kj9ZvwsOFv+ewme8
Bi4MSh+PpXcZuf+FAtAWEPS0aZlA3tq1DokxiJsu1UjfDGBjpVGRf4vwPhQg9Qaq
SPOpFODHX6m2fQvglRUxU6y9pJgXhBUxhkiyAosJOnvVLVVdOJ/cnEM6XRfXMb1I
aa7on+2dMjryZktYCZRwWMKBfTP3v4qyWB/keyob9K/BvHi8uDTSbJV62vQ+WJza
b3STEtFvLl6o2l8GzSkHVlX8/QIDAQABMA0GCSqGSIb3DQEBCwUAA4IBAQAXnutJ
HHFo3s+b1pnbRs0uKQ/D8bMUlGQocOh2+7189puEdy161Z6qXbv7QL2Z5uAhd67j
I/8h3Fchtiy+PbXAn5L+cTQ8ixPllBq4+WFCnL+lWhV4Pnv+qc6KohBHOfgYL9U0
aKGYe5/eFBdewXE1VT+qfncXOxRSjGr4L5UqqS3672ncl1mEWwX6VN/SiGQ8eQ2h
FnBIhGCok9w2GLRmx7bfdQVo0b5ROq1FgWyWJWT+eFRmAJ4ei2YrjmfgAfgVEco3
LfAzOw42KKEkcFLiPLZarCGh15fh7QSdBIVI1aF15vceLONC4EEvxMpFLYljmqIF
aXqiZ0iKf9gfCvtP
-----END CERTIFICATE-----

And finally, save the OAuth configuration.

Configuring AppSignal

Now that the Jira-end is setup up we can link it to AppSignal. (Open the application in AppSignal you want to link Jira to and go to "Integrations" (left-hand side navigation bar, "Configure" section).)

Enter in the "Jira installation location" the root path of your Jira app, e.g. https://appsignal-test-1.atlassian.net. Press "Link AppSignal to Jira".

You'll be presented with an authentication confirmation screen.

Jira OAuth confirmation

Upon pressing "Allow" you'll be returned to AppSignal. Here you need to select which project and issue type you want to use for AppSignal issues.

If, upon selecting a issue type, you get an error, please read the "Errors" section for what to do.

Errors

AppSignal requires a number of fields to be present when the integration is activated. If fields are missing, we will show an error message during the setup.

Required fields are:

  • Labels
  • Environment
  • Summary
  • Description

In order to fix these messages, you have to add the fields to the Jira screens by going to the "Issues" tab in the "Settings" menu. First check which "screen" your issue type is using on the "Issue types" page, in the "Related Schemes" column for the issue type you selected in AppSignal.

Then navigate to the "Screens" page in the "Screens" section.

Issues screens page

Click on "Configure" in the "Actions" column for the relevant "Screen".

On this "Configure" page you'll be presented with a list of fields that are configured in this Jira screen. Go to the bottom of the page where the new field dropdown is located and select the required fields, as listed in the "Errors" section, from the dropdown. Go back to AppSignal and relink the Jira issue type.

Issue fields

Getting Jira working can be a bit of a hassle, but it should work if you follow the above steps with care. If you run into any issues, don't hesitate to contact us at support@appsignal.com if other errors occur.


Other integrations

We'd like to set cookies, read why.