Jira is the tracker for teams planning and building great products.
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".
In the "Product settings" screen look for the "Application links" under the "Integrations" section in the 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".
In the modal, only fill out the "Application Name".
After saving the integration, click the "Edit" icon for the newly created integration and go to the "Incoming Authentication" tab in the new modal.
In the "Incoming OAuth" tab, setup OAuth with the following values:
- Consumer Key:
- Consumer Name:
- Public Key:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 -----BEGIN CERTIFICATE----- MIICsDCCAhmgAwIBAgIJAJGEAsDfksoFMA0GCSqGSIb3DQEBBQUAMEUxCzAJBgNV BAYTAkFVMRMwEQYDVQQIEwpTb21lLVN0YXRlMSEwHwYDVQQKExhJbnRlcm5ldCBX aWRnaXRzIFB0eSBMdGQwHhcNMTUwNDAyMTIyMDEwWhcNMTUwNTAyMTIyMDEwWjBF MQswCQYDVQQGEwJBVTETMBEGA1UECBMKU29tZS1TdGF0ZTEhMB8GA1UEChMYSW50 ZXJuZXQgV2lkZ2l0cyBQdHkgTHRkMIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKB gQCoo3PzC3CIWEqXlLb7NDKRLqxp/M/88RevoOMAJq/UG/q4fJlhOkVoHK86IxV1 eZ+p6m1cqizWmnGp3KSqU1y+jhKj6+XqhPHfyXFOrRAGr//UGcIIXycPf5mKLftr 3PQ8F+Bloq7UGhkahtVP+u3CUcde6TCTGWYvAI47jVdyHwIDAQABo4GnMIGkMB0G A1UdDgQWBBQYN5ucG+T1xBsPHkDSKKMg8KP1YDB1BgNVHSMEbjBsgBQYN5ucG+T1 xBsPHkDSKKMg8KP1YKFJpEcwRTELMAkGA1UEBhMCQVUxEzARBgNVBAgTClNvbWUt U3RhdGUxITAfBgNVBAoTGEludGVybmV0IFdpZGdpdHMgUHR5IEx0ZIIJAJGEAsDf ksoFMAwGA1UdEwQFMAMBAf8wDQYJKoZIhvcNAQEFBQADgYEANgUypdXrA41lt2P1 atA+hxT1jtmYeIyUbVrsS2K9HYZpdijHVXZGHdaf2c56x2d9O8uOpwsbQT+09WNR KD4RHjXJPVCYaY1QFk0FHM+5yooD2H3XwNyzCWgSZZ1nc6ZuLXJKY8jtXH9cs0wZ utPOCXiudsot4u0pDWHLfsBQr+o= -----END CERTIFICATE-----
And finally, save the OAuth configuration.
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.
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.
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:
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.
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.
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 email@example.com if other errors occur.