Skip to main content

Jira

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, our Jira integration updates Jira issues with Infracost cost estimates along with a direct link to our dashboard. Use this to dive into specific cloud costs impacted by engineering changes.

jira issue

You'll also be able to filter Jira issues by cost impacts using Jira's search feature. This allows you to track the most impactful tickets your team is working on as it relates to the cloud bill.

jira filter

We'll also add Jira metadata to any Infracost Cloud runs, meaning you can search, filter and analyse Infracost runs based on your team's Jira issues.

dashboard

Get started

1. Create Jira API token

First, you'll need to create a Jira API token so that Infracost Cloud can sync information across your Jira issues:

  1. Sign in to Atlassian using an account with write access to Jira projects.
  2. The link opens the API tokens page. Alternatively, to go to this page from your Atlassian profile, select Account Settings > Security > Create and manage API tokens.
  3. Select Create API token.
  4. In the dialog, enter a label for your token and select Create.
  5. To copy the API token, select Copy, then paste the token somewhere safe - you'll need this later.

2. Create Jira custom fields

You'll now need to create some custom fields in Jira so that Infracost can update your Jira issues to show the required information.

  1. Log in to your Atlassian account
  2. Select Settings > Issues.
  3. Under FIELDS in the left sidebar, select Custom fields.
  4. Click Create a custom field.
  5. Select the type of field you want to create and click Next. See the Supported custom fields table below for the suggested field types for each field.
  6. Add a name to your custom field - make it as descriptive as possible.
  7. When you have entered the field details, select Create.
  8. Add the new custom field to one or multiple screens. We recommend adding it to at least your project issue default screen.
  9. Repeat the following steps for the supported custom fields below. Note, only the Infracost Link field is required.

Supported custom fields

namedescriptionrequiredJira field type
Infracost LinkThe field where the link to Infracost Cloud will be posted to.trueURL field
Previous Monthly CostThe field where the previous monthly cost will be posted to.falseNumber field
New Monthly CostThe field where the new monthly cost will be posted to.falseNumber field
Cost DiffThe field where the cost diff will be posted to.falseNumber field
Cost Diff PercentageThe field where the cost diff percentage will be posted to.falseNumber field

3. Setup integration in Infracost Cloud

Now head over to the Infracost Cloud dashboard:

  1. Navigate to Integrations > Jira
  2. Enter the following information in the Jira Authentication section
    1. The URL of your organization's Atlassian account, this is normally: https://{YOUR_ORG}.atlassian.net
    2. The email of the user that you created an API Token for in Jira
    3. The API Token copied from the Create Jira API token step
  3. Click the Test Connection button. If your credentials are correct, you'll see a green tick displayed auth
  4. Add your custom fields mapping in the Infracost Configurations section.
  5. Hit save. If you've entered everything correctly, you'll see a green tick displayed by the Jira integration on the integrations page.

Requirements

Once you've set up the Jira integrations, 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 some pr title"
  2. A git commit message, e.g. "TEST-2 some commit message."
  3. A git branch name, e.g. "TEST-2-some-branch-name"