Last updated Nov 29, 2023

Rate this page:

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.

  • An incident appears in Compass only if the person creating it, either through the service project or the customer portal, has access to view the associated incident issue in Jira Service Management.
  • Once it flows through, everyone in Compass can see the incident on the linked Compass component's activity feed, irrespective of their Jira Service Management permissions.

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.

You can link one Compass component to only one service in Jira Service Management at a time.

  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.

  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 More actions icon > Edit service.

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

Change the service linked to a component

You can link one Compass component to only one service in Jira Service Management at a time. Changing the links requires you to remove the previous link between the component and the service.

  1. Go to Compass and select your component.

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

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

  4. Select Save.

  1. Go to your service project and select Services.

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

  3. Select More actions (More actions icon) > Edit service.

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

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.

  1. Go to Compass and select your component.

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

  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 (More actions icon) > Edit service.

  4. Remove the linked component from the Compass field.

  5. Select Save.

Rate this page: