Jira integration

Connect Infracost Cloud to Jira to enrich your team's cost estimates with powerful contextual information. Our Jira integration provides an automated two-way connection that helps you better understand why your teams' cloud costs have changed.

Once enabled, the Jira integration:

• Updates Jira issues with cost estimates along with a direct link to your Infracost Cloud dashboard. Use this to dive into specific cloud costs impacted by engineering changes.
• You'll also be able to review and unblock pull requests that triggered guardrails.
• We'll also add Jira metadata to any Infracost Cloud estimate, meaning you can search, filter and analyze costs based on your team's Jira issues.

Usage

1. In Infracost Cloud, go to the Org Settings page and click on the Integrations tab.
2. You'll need to create a Infracost Cloud service account token. This will authenticate your Jira instance with Infracost Cloud, enabling it to fetch cost estimates for pull requests.
3. Click the Generate service token button and copy your token. Make sure to save this to a safe place as service account tokens are only shown once. If you lose your token you'll need to generate a new one, which will invalidate any prior tokens.
4. Once you generate the token, a status banner appears. This highlights if Jira has successfully connected to Infracost Cloud. We'll check back here later to make sure everything looks good.
5. Click the install app button, this takes you over to Atlassian Jira to complete the setup.
6. This will take you an approval screen where you'll be able to select which server you want to install the Infracost Jira app into.
7. Go ahead and install the app onto the server you want to link to your Infracost Cloud organization.
8. Once installed you'll need to provide the Jira app your Infracost service account token, so that it can communicate with Infracost Cloud. Head over to the Manage Apps section of your Jira instance.
   note

   Configuring the Infracost App in Jira requires Admin access.

   
9. Then select Infracost from the sidebar.
10. Add your Infracost service account token into the input.
11. Once you've saved your service account token, let's head back to Infracost Cloud > Org Settings > Integrations > Jira. On the Jira integration page you should see a success banner.
12. All pull requests moving forward will have a two-way link with Jira and Infracost Cloud. Pull requests in Infracost cloud will display a link to the Jira issue the pull request references.
13. Click the Jira issue button to navigate directly to the issue, which should now display an Infracost sidebar item.
    note

    The first time that you view the sidebar in Jira, you'll be prompted to accept access before you can see pull requests. Each user in Jira only needs to do this once.

    
14. This Infracost sidebar will list any pull requests that reference the Jira issue, and their associated costs and guardrails.

Requirements

The Jira integration should work with Jira Cloud, Jira Data Center, and Jira Server. Contact us if you have any issues.

Once you've set up the Jira integration, all future pull requests will be synced with Jira from Infracost Cloud. Infracost detects Jira issues from VCS systems exactly the same way the official Jira GitHub connection does. It checks if a Jira issue key prefixes either:

1. A pull request title, e.g. "TEST-2 my pull request title"
2. A git commit message, e.g. "TEST-2 my commit message."
3. A git branch name, e.g. "TEST-2-my-branch-name"

Migration from legacy Infracost Jira integration

Users of our legacy Jira integrations (if you connected Infracost cloud to Jira before 2 June 2023) will not be able to upgrade automatically to Infracost's Jira app integration. Instead, users should contact us and we'll help you migrate to the new integration.

The new Jira integration does not currently have issue fields for costs so you cannot run manual queries or reports in Jira. We plan to add that in the future, please contact us if this is blocking your migration.