Issue Links

Issue links connect Sentry issues to BlameTrail incidents, creating a bi-directional reference between both platforms. Your team can navigate from a Sentry issue directly to the relevant BlameTrail incident, and vice versa.

Linking from Sentry

When the BlameTrail integration is installed in Sentry, a link component appears in the Sentry issue sidebar:

1. Open a Sentry issue.
2. In the sidebar, find the BlameTrail section.
3. Click Link Issue.
4. Search for a BlameTrail incident by title, service name, or incident ID.
5. Select the incident to link.
6. Click Save.

The link appears in the Sentry issue sidebar, providing a direct reference to the BlameTrail incident.

Viewing links in BlameTrail

When a Sentry issue is linked to a BlameTrail incident:

1. Open the incident detail page in BlameTrail.
2. In the Linked Issues section, linked Sentry issues appear with:
   • Sentry issue title
   • Sentry project name
   • A link to the issue in Sentry

Click the link to navigate directly to the Sentry issue for full error details, stacktraces, and event history.

Automatic linking

When BlameTrail creates an incident from a Sentry webhook (via project mappings), the link between the Sentry issue and the BlameTrail incident is established automatically. No manual linking is needed for webhook-driven incidents.

Manual linking is useful when:

• An incident was created by a monitor check (not a Sentry webhook) but is related to a Sentry issue.
• You want to link additional Sentry issues to an existing incident.
• You are correlating issues across different Sentry projects with a single BlameTrail incident.

Link verification

BlameTrail periodically verifies that linked Sentry issues still exist and are accessible:

• Active links — The Sentry issue exists and is accessible with the current token.
• Stale links — The Sentry issue was deleted, the project was removed, or the token no longer has access. Stale links are flagged but not automatically removed, so you can review and clean them up.

Unlinking

To remove a link between a Sentry issue and a BlameTrail incident:

• From Sentry — Open the issue, find the BlameTrail link in the sidebar, and click Unlink.
• From BlameTrail — Open the incident, find the linked issue in the Linked Issues section, and click Remove.

Unlinking from either side removes the association on both sides.