Link components to services in Jira Service Management

Get a holistic view of your service by linking its record in Jira Service Management and the corresponding Compass component, and quickly navigating between the two.

You can link one Compass component to only one service in Jira Service Management at a time. You can add the link either in Compass or in Jira Service Management, and a bidirectional link is automatically added from the other side.

The linking has the following effect:

• In Compass, the link appears in the Jira Service Management field on the component's Overview page. Any incident events from Jira Service Management appear on Compass's component's activity feed.

• In Jira Service Management, the link appears in the Compass field on the service's page and under the Affected services section on the service's associated incidents.

The bidirectional linking helps you make informed and meaningful investigations of your service when incidents occur by looking at additional data in Compass. In Compass, you can assess the incident:

• across the activity timeline

• in accordance with other events, such as commits and failed deployments

• in the context of the component's dependencies

You can take your investigation further by:

• finding who the owner team is and how to reach them

• looking at metrics and scorecards to see if something is unusual

• find links to the component's resources like run books and dashboards

Before you begin

In Jira Service Management ensure:

• you have access to at least one service project

• the Services feature is enabled in Project settings > Features > Operations for your service project

This is required so you can access the services in Jira Service Management that you want to link to Compass components.

Link a component to a service in Jira Service Management

Link from Compass

1. In Jira Service Management:

   1. Go to your service project and select Services.

   2. Select the service you want to link.

   3. Copy its URL from the browser's address bar.

2. In Compass:

   1. Select the component you want to link.

   2. On the component's Overview page, select Add service link under the Jira Service Management field.

   3. Paste the service link you copied earlier.

   4. Select Save.

Link from Jira Service Management

1. Go to your service project and select Services.

2. Select the service you want to link to a Compass component.

3. Select More actions > Edit service.

4. Search and select a component in the Compass field, then select Save.

Change the service linked to a component

Change the link in Compass

1. Go to Compass and select your component.

2. Under the Jira Service Management field, select Remove to remove the previously added link.

3. Copy and paste the URL of the new service from Jira Service Management.

4. Select Save.

Change the link in Jira Service Management

1. Go to your service project and select Services.

2. Select a service to edit the Compass component link.

3. Select More actions () > Edit service.

4. Search and select a different component in the Compass field, then select Save.

Unlink a component from a service in Jira Service Management

When you unlink a component from the service in Jira Service Management, any incidents related to the previously linked service will longer appear on the component’s activity feed.

Unlink from Compass

1. Go to Compass and select your component.

2. In the Jira Service Management field, select Remove and confirm your action.

Unlink from Jira Service Management

1. Go to your service project and select Services.

2. Select the service for which you want to remove the Compass component link.

3. Select More actions () > Edit service.

4. Remove the linked component from the Compass field.

5. Select Save.