Overview

Link GitHub pull requests to Error Tracking issues and track the full life cycle of an error, from detection to resolution. This link enables Datadog to automatically resolve the Error Tracking issue when the associated PR is merged.

With linked pull requests, you can:

• Track issue resolution: See which pull requests are addressing an Error Tracking issue directly from the issue panel.
• Automatically resolve issues: When a linked pull request is merged, Datadog automatically moves the issue to Resolved status.

Prerequisites

• Install the GitHub integration with read permissions for pull requests.
• Enable Source Code Integration so that Datadog can process GitHub webhooks and link pull requests to Error Tracking issues.
• Verify that you have the Error Tracking Issue Write permission. This is required to link your PRs to Error Tracking issues.

Link and manage pull requests

Link a pull request to an issue

To link a pull request to an Error Tracking issue:

1. Navigate to Datadog Error Tracking.
2. Select the issue you want to link to open its side panel.
3. In the top right corner, click the Actions dropdown, then select Link a Pull Request to copy the issue URL.
4. Open your GitHub pull request and paste the issue URL into the description.

Datadog detects the issue URL and automatically creates the link.

View linked pull requests

To view linked pull requests:

1. Navigate to Datadog Error Tracking.
2. Select the issue you want to link to open its side panel.
3. In the top right corner, click the Actions dropdown to see the linked PR under PULL REQUESTS.

Unlink a pull request

To unlink a pull request from an issue, open the GitHub pull request and remove the Error Tracking issue URL from the description.

Automatic state changes

Linked pull requests trigger automatic issue state transitions:

Further reading

Additional helpful documentation, links, and articles:

Issue States in Error TrackingDOCUMENTATION Suspect CommitsDOCUMENTATION Source Code IntegrationDOCUMENTATION