Link Pull Requests to Error Tracking Issues

Docs > Error Tracking > Link Pull Requests to Error Tracking Issues

Cette page n'est pas encore disponible en français, sa traduction est en cours.
Si vous avez des questions ou des retours sur notre projet de traduction actuel, n'hésitez pas à nous contacter.

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:

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

Datadog detects the issue URL and automatically creates the link.

Updating a pull request description to add or remove issue URLs automatically updates the link.

View linked pull requests

To view linked pull requests:

Navigate to Datadog Error Tracking.
Select the issue you want to link to open its side panel.
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:

Initial state	Action	Resulting state
Issue is `For Review`	A PR is linked to the issue	Issue moves to `Reviewed`
Issue is `Reviewed`	A linked PR is merged	Issue moves to `Resolved`
Issue is `Resolved`	A linked PR is reopened	Issue moves to `Reviewed`
Issue is `Resolved`	A new open PR is linked to the issue	Issue moves to `Reviewed`

If an issue is linked to multiple pull requests, the issue moves to Resolved only when the last open (non-closed, non-merged) PR is merged.

Closing a PR without merging does not resolve the issue.