Jira

Jira is an issue-tracking and agile project management tool from Atlassian. With the Vantage–Jira integration, you can create Jira issues for Cost Anomalies, Budget Alerts, and Resource Reports, including Resource Reports for Cost Recommendations, directly in Vantage. You can also view the progress of the associated Jira issues directly within Vantage.

note

This integration is specifically for users on Jira Cloud (hosted by Atlassian). Jira Server integrations (self-hosted Jira) are not currently supported.

How Vantage Connects with Jira

Vantage integrates with Jira via an OAuth workflow. To create an integration, you need to have the following Jira and Vantage roles:

• Jira: Jira users must have Admin access to install an application. See the Atlassian App Integration documentation for additional information.
• Vantage: Vantage users must have Owner or Integration Owner access to create Jira issues within Vantage. See the Role-Based Access Control documentation for information on user roles and permissions.

When you connect your Jira account with Vantage, the following required permissions are automatically requested during the OAuth workflow. No further action is needed on your part to set up these permissions.

Access Type	Permission	Description
View	jira-user, jira-work	View user information in Jira that the user has access to, including usernames, email addresses, and avatars. Read Jira project and issue data, search for issues, and objects associated with issues like attachments and worklogs.
Update	jira-work	Create and edit issues in Jira, post comments as the user, create worklogs, and delete issues.

note

At this time, you can integrate only a single Jira workspace into Vantage. In addition, you can integrate only a single Vantage subscription into a Jira workspace.

Connect to Jira

Follow the steps below to connect to Jira.

1. From the top navigation of Vantage, click Settings.
2. On the side navigation, click Integrations. Any provider integrations are listed on this screen, as well as any connected apps.
3. Under Apps, select Jira.
4. Click Connect Jira Account.
5. If you are not already logged in to Jira, you will be prompted to log in. Once you are logged in to your account, the App Authorization Jira screen is displayed. Review the requested app permissions, and click Accept.
   note

   If you have multiple Jira instances available, you will be sent back to the Vantage console to select which instance you want to integrate. Click Confirm to select an instance.

Your Jira account instance will be synced with Vantage. Note that this sync might take some time, and you can monitor the status on the Connection page:

• The connection’s status is displayed as either Connected, Syncing, or Unstable. An Unstable status indicates that one of your configurations is no longer valid. For example, you may have deleted an issue type in Jira that is connected to a Vantage anomaly alert, budget alert, or Resource Report.
  note

  If you see an Unstable connection, contact support@vantage.sh for help with triaging this issue.

• At the top of the screen, the Check for updates button is displayed. Click this button if you add new projects in Jira, or if you create new issue types in Jira, to ensure they are synced with Vantage. In addition, if you add new users to your Jira instance and need to resync your user list for fields like Reporter, click this button to import those new users.
• All your projects will be listed, along with the connected account name.

Remove Jira Integration

To remove a Jira integration, navigate to the Jira Settings screen and click the trashcan icon next to the connected account you want to remove.

When you remove your Jira integration from Vantage:

• All links to your Jira integration will be removed from the Vantage console.
• Any Cost Report annotations that were created from budget alerts will persist in Vantage.
• Any issues that were created will persist in your Jira workspace.

Create Jira Issues

You can create Jira issues based on Vantage budget alerts, cost anomalies, and Resource Reports. You can select which Jira project you want the issue sent to, as well as the issue type you want to create (e.g., Task, Bug).

note

At this time, the only way to have a Jira issue associated with an event in Vantage is if the ticket is created in or by Vantage. You cannot link to existing Jira issues.

info

For an explanation of Jira issue types, see the Jira documentation.

Budget Alerts

Budget alerts are automated alerts based on configurable budget thresholds. You can configure your budget alerts to create a corresponding Jira issue when the alert is triggered. When the set budget threshold is reached, Vantage creates a corresponding Jira issue.

info

Review the Vantage Budget Alerts documentation for more details on budget alerts.

1. Create a new budget alert. Enter all required budget alert criteria, such as Threshold.
2. Under Setup App Alerts, expand the Jira Alerts section.
3. Select the Jira Project where you want the issue to be created.
4. Select an Issue Type to indicate the type of Jira issue you want created. The Issue Type list is generated based on available issue types within your selected project and Jira instance. Additional required fields will also be displayed for the selected issue type (e.g., Reporter), based on your Jira setup. Any non-required Jira fields will not be displayed, and you can update these fields directly in Jira once the issue is created. Common examples are listed below:
   • Bug
     • Enter the corresponding bug Sprint ID: if required by your setup
   • Story
   • Epic
   • Subtask
     • Enter the Jira Parent task ID (e.g., SCRUM-39) for the subtask
   • Task
5. Click Save.

note

Due to a technical limitation at this time, if an issue type requires you to select a team, that issue type will not be available in Vantage.

When a budget alert is triggered, the corresponding issue is generated in Jira. In the below visual example:

• A story issue type was created in Jira based on a budget alert that was triggered in Vantage.
• The Description contains the date when the alert was triggered, the associated Cost Report, and the name of the budget.
• An annotation is added to the associated Vantage Cost Report for the date when the alert was triggered, and a link to the annotation is also provided in the Jira issue's description.

Cost Anomaly Alerts

Cost anomaly alerts notify teams of excess costs and are identified via Cost Reports. You can configure your cost anomaly alerts to create a corresponding Jira issue when the alert is triggered. When an alert is triggered for an individual service, Vantage creates a corresponding Jira issue.

info

Review the Vantage Cost Anomaly Alerts documentation for more details on cost anomaly alerts.

1. Create a new cost anomaly alert. Enter all anomaly alert criteria, such as Alert Threshold.
2. Under Setup App Alerts, expand the Jira Alerts section.
3. Select the Jira Project where you want the issue to be created.
4. Select an Issue Type to indicate the type of Jira issue you want created. The Issue Type list is generated based on available issue types within your selected project and Jira instance. Additional required fields will also be displayed for the selected issue type (e.g., Reporter), based on your Jira setup. Any non-required Jira fields will not be displayed, and you can update these fields directly in Jira once the issue is created. Common examples are listed below:
   • Bug
     • Enter the corresponding bug Sprint ID: if required by your setup
   • Story
   • Epic
   • Subtask
     • Enter the Jira Parent task ID (e.g., SCRUM-39) for the subtask
   • Task
5. Click Save.

note

Due to a technical limitation at this time, if an issue type requires you to select a team, that issue type will not be available in Vantage.

When a cost anomaly alert is triggered for a given service, the corresponding issue is generated in Jira. As shown in the image below, the Jira icon is also displayed to the right of the anomaly, with a link to the corresponding Jira issue.

In Jira, an issue is created, like the example below.

In this example:

• A story issue type was created based on an anomaly alert that was triggered for the Datadog Metrics service.
• The Description contains the date when the alert was triggered, the change in the dollar amount that caused this alert, and the associated Cost Report.
• A link to the anomaly is also provided.

Resource Reports and Cost Recommendations

You can create Jira issues for any Resource Report in Vantage. For example, if Cost Recommendations impact specific resources, you can generate a Resource Report to list the affected resources. From there, you can create a corresponding Jira issue in Vantage to assign to a stakeholder, which enables them to address tasks like rightsizing or reconfiguring the affected resources.

Unlike Jira issues related to cost anomalies or budget alerts, you will be creating one issue for the report.

info

Review the Vantage Resource Reports documentation for more details on Resource Reports.

1. From the top right of a saved Resource Report, click the Jira icon.
2. From the dropdown list, select a Project.
3. Select an Issue Type to indicate the type of Jira issue you want created. The Issue Type list is generated based on available issue types within your selected project and Jira instance. Additional required fields will also be displayed for the selected issue type (e.g., Reporter), based on your Jira setup. Any non-required Jira fields will not be displayed, and you can update these fields directly in Jira once the issue is created. Common examples are listed below:
   • Bug
     • Enter the corresponding bug Sprint ID: if required by your setup
   • Story
   • Epic
   • Subtask
     • Enter the Jira Parent task ID (e.g., SCRUM-39) for the subtask
   • Task

note

Due to a technical limitation at this time, if an issue type requires you to select a team, that issue type will not be available in Vantage.

4. Click Create Ticket.
5. A new issue will be created within the selected Jira project. The issue contains information on the person who created the issue in Vantage, the Resource Report name, and a link to the Resource Report. For Resource Reports generated from Cost Recommendations, additional information about the report is also provided, like total costs, number of affected resources, and potential monthly savings.

After the issue is created, to access the corresponding Jira issue from the Resource Report, click the Jira icon on the top right of the report.

Jira Issue Statuses in Vantage

You can see a Jira issue's status in Vantage. Issue statuses are updated once a day. Therefore, a change that is made today (e.g., changing an issue's status in Jira from "To Do" to "In Progress") might not be reflected in Vantage until tomorrow.

Next to the Jira icon, a badge is displayed.

Badge	Description
	The corresponding Jira issue is currently in the Jira "To Do" status.
	The corresponding Jira issue is currently in the Jira "In Progress" status.
	The corresponding Jira issue is currently in the Jira "Done" status.
	Vantage has not received a status update yet from Jira. It can take a day from the time when a corresponding Jira issue was created by Vantage to update this status.

These status badges are displayed next to the Jira icon in the following locations:

• Next to each cost anomaly with a corresponding Jira issue in the cost anomaly list
• On any Cost Report annotations for budget alerts
• At the top of a Resource Report with a corresponding Jira issue