From 31fd74246c975935928c49adaa96a6203226acf7 Mon Sep 17 00:00:00 2001 From: leomelki Date: Tue, 17 Jun 2025 18:54:10 +0200 Subject: [PATCH 1/6] create auto assign doc --- content/en/error_tracking/auto_assign.md | 38 ++++++++++++++++++++++++ 1 file changed, 38 insertions(+) create mode 100644 content/en/error_tracking/auto_assign.md diff --git a/content/en/error_tracking/auto_assign.md b/content/en/error_tracking/auto_assign.md new file mode 100644 index 0000000000000..b965de8e04022 --- /dev/null +++ b/content/en/error_tracking/auto_assign.md @@ -0,0 +1,38 @@ +--- +title: Auto Assign +description: Learn about Auto Assign in Error Tracking. +--- + +# Auto Assign + +## Overview +Auto Assign helps teams quickly resolve issues by automatically assigning them to the most likely responsible developers. This feature analyzes git commit history to identify suspect commits that may have introduced the issue, then assigns the issue directly to the developer who made those commits. This streamlines issue resolution by connecting errors to the developers most familiar with the relevant code changes. + +## Getting Started +To enable Auto Assign, follow these steps: + +1. **Set Up Source Code Integration** + - Ensure SCI is enabled and connected to a supported Git provider (e.g., GitHub). + +2. **Ensure Email Consistency** + - Developers must use the same email address in both Git and their Datadog account. + - This email matching is essential for Auto Assign to correctly identify and assign issues to the right users. + +Once configured, issues will automatically be assigned to developers based on suspect commit analysis, and the assigned developer will receive a notification about the issue. + +## Benefits +- **Faster Issue Resolution**: Issues are automatically assigned to developers who are most familiar with the relevant code. +- **Direct Accountability**: Individual developers receive clear ownership of issues related to their recent commits. +- **Proactive Notifications**: Assigned developers are immediately notified when issues are detected, enabling quick response times. +- **Reduced Triage Time**: Eliminates manual assignment processes by automatically identifying the most likely responsible developer. + +## Managing Auto Assignment + +### Configuration +Navigate to the Error Tracking configuration section in Datadog to manage Auto Assign settings. You can enable or disable Auto Assign globally for your entire organization, or configure it on a per-service basis for more granular control. + +### How It Works +Auto Assign uses [suspect commits](/error_tracking/suspect_commits/) to identify developers who may have introduced issues. When an issue is automatically assigned to a developer, they receive an immediate notification. + +### Assignment Management +You can view assigned developers directly within each issue in Datadog. If needed, manual reassignment is always possible to override the automatic assignment. \ No newline at end of file From a97bcd2310ab799893593d36dce5827afccbdfe0 Mon Sep 17 00:00:00 2001 From: leomelki Date: Tue, 17 Jun 2025 18:54:28 +0200 Subject: [PATCH 2/6] make it follow other articles flow --- content/en/error_tracking/auto_assign.md | 71 +++++++++++++++++------- 1 file changed, 50 insertions(+), 21 deletions(-) diff --git a/content/en/error_tracking/auto_assign.md b/content/en/error_tracking/auto_assign.md index b965de8e04022..fe60dbf581f9f 100644 --- a/content/en/error_tracking/auto_assign.md +++ b/content/en/error_tracking/auto_assign.md @@ -1,38 +1,67 @@ --- title: Auto Assign description: Learn about Auto Assign in Error Tracking. +further_reading: + - link: '/error_tracking/suspect_commits/' + tag: 'Documentation' + text: 'Suspect Commits' + - link: '/error_tracking/issue_states/' + tag: 'Documentation' + text: 'Issue States in Error Tracking' --- -# Auto Assign - ## Overview -Auto Assign helps teams quickly resolve issues by automatically assigning them to the most likely responsible developers. This feature analyzes git commit history to identify suspect commits that may have introduced the issue, then assigns the issue directly to the developer who made those commits. This streamlines issue resolution by connecting errors to the developers most familiar with the relevant code changes. -## Getting Started -To enable Auto Assign, follow these steps: +Auto Assign helps teams quickly resolve issues by automatically assigning them to the most likely responsible developers. This feature analyzes git commit history to identify suspect commits that may have introduced the issue, then assigns the issue directly to the developer who made those commits. -1. **Set Up Source Code Integration** - - Ensure SCI is enabled and connected to a supported Git provider (e.g., GitHub). +Auto Assign uses [suspect commits][1] to identify developers who may have introduced issues. When an issue is automatically assigned to a developer, they receive an immediate notification. -2. **Ensure Email Consistency** - - Developers must use the same email address in both Git and their Datadog account. - - This email matching is essential for Auto Assign to correctly identify and assign issues to the right users. +## Setup -Once configured, issues will automatically be assigned to developers based on suspect commit analysis, and the assigned developer will receive a notification about the issue. +Auto Assign is automatically enabled when the setup requirements are met. Once configured, issues are automatically assigned to developers based on suspect commit analysis. -## Benefits -- **Faster Issue Resolution**: Issues are automatically assigned to developers who are most familiar with the relevant code. -- **Direct Accountability**: Individual developers receive clear ownership of issues related to their recent commits. -- **Proactive Notifications**: Assigned developers are immediately notified when issues are detected, enabling quick response times. -- **Reduced Triage Time**: Eliminates manual assignment processes by automatically identifying the most likely responsible developer. +### Enable Source Code Integration + +Auto Assign requires [Source Code Integration][2]. To enable Source Code Integration: + +1. On the [**Integrations** page][4] in Datadog, choose **Link Source Code** in the top navbar. +2. Follow the steps to associate a commit with your telemetry and configure your GitHub repository. + +### Install the GitHub integration +Install [the GitHub integration][3], enabling read permissions for pull requests and contents. + +### Ensure email consistency +Developers must use the same email address in both Git and their Datadog account. This email matching is essential for Auto Assign to correctly identify and assign issues to the right users. + +## How it works -## Managing Auto Assignment +When an error occurs, Auto Assign: + +1. Analyzes the stack trace to identify suspect commits +2. Determines the developer responsible for the most recent suspect commit +3. Automatically assigns the issue to that developer +4. Sends a notification to the assigned developer + +## Managing assignments ### Configuration Navigate to the Error Tracking configuration section in Datadog to manage Auto Assign settings. You can enable or disable Auto Assign globally for your entire organization, or configure it on a per-service basis for more granular control. -### How It Works -Auto Assign uses [suspect commits](/error_tracking/suspect_commits/) to identify developers who may have introduced issues. When an issue is automatically assigned to a developer, they receive an immediate notification. +### Assignment management +You can view assigned developers directly within each issue in Datadog. If needed, manual reassignment is always possible to override the automatic assignment. + +## Benefits + +- **Faster issue resolution**: Issues are automatically assigned to developers who are most familiar with the relevant code +- **Direct accountability**: Individual developers receive clear ownership of issues related to their recent commits +- **Proactive notifications**: Assigned developers are immediately notified when issues are detected, enabling quick response times +- **Reduced triage time**: Eliminates manual assignment processes by automatically identifying the most likely responsible developer + +## Further Reading + +{{< partial name="whats-next/whats-next.html" >}} -### Assignment Management -You can view assigned developers directly within each issue in Datadog. If needed, manual reassignment is always possible to override the automatic assignment. \ No newline at end of file +[1]: /error_tracking/suspect_commits/ +[2]: /integrations/guide/source-code-integration +[3]: /integrations/github/ +[4]: https://app.datadoghq.com/integrations \ No newline at end of file From d70ac570f9ed11b22a4ce2e6f2c8dd05f8a51dbe Mon Sep 17 00:00:00 2001 From: leomelki Date: Fri, 20 Jun 2025 11:58:43 +0200 Subject: [PATCH 3/6] improve sci setup part --- content/en/error_tracking/auto_assign.md | 13 ++++--------- 1 file changed, 4 insertions(+), 9 deletions(-) diff --git a/content/en/error_tracking/auto_assign.md b/content/en/error_tracking/auto_assign.md index fe60dbf581f9f..6f3d0005c7a59 100644 --- a/content/en/error_tracking/auto_assign.md +++ b/content/en/error_tracking/auto_assign.md @@ -20,15 +20,10 @@ Auto Assign uses [suspect commits][1] to identify developers who may have introd Auto Assign is automatically enabled when the setup requirements are met. Once configured, issues are automatically assigned to developers based on suspect commit analysis. -### Enable Source Code Integration +### Configure Source Code Integration -Auto Assign requires [Source Code Integration][2]. To enable Source Code Integration: - -1. On the [**Integrations** page][4] in Datadog, choose **Link Source Code** in the top navbar. -2. Follow the steps to associate a commit with your telemetry and configure your GitHub repository. - -### Install the GitHub integration -Install [the GitHub integration][3], enabling read permissions for pull requests and contents. +- Ensure [Source Code Integration][2] is enabled and setup. +- Install [the GitHub integration][3]. Make sure all requested permission is granted for the GitHub integration. ### Ensure email consistency Developers must use the same email address in both Git and their Datadog account. This email matching is essential for Auto Assign to correctly identify and assign issues to the right users. @@ -62,6 +57,6 @@ You can view assigned developers directly within each issue in Datadog. If neede {{< partial name="whats-next/whats-next.html" >}} [1]: /error_tracking/suspect_commits/ -[2]: /integrations/guide/source-code-integration +[2]: /integrations/guide/source-code-integration/ [3]: /integrations/github/ [4]: https://app.datadoghq.com/integrations \ No newline at end of file From e21e7e2391ac7b165cc9acf45384a79e52b47c85 Mon Sep 17 00:00:00 2001 From: leomelki Date: Fri, 20 Jun 2025 16:18:27 +0200 Subject: [PATCH 4/6] auto assign is disabled by default --- content/en/error_tracking/auto_assign.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/en/error_tracking/auto_assign.md b/content/en/error_tracking/auto_assign.md index 6f3d0005c7a59..71ef75651e803 100644 --- a/content/en/error_tracking/auto_assign.md +++ b/content/en/error_tracking/auto_assign.md @@ -18,7 +18,7 @@ Auto Assign uses [suspect commits][1] to identify developers who may have introd ## Setup -Auto Assign is automatically enabled when the setup requirements are met. Once configured, issues are automatically assigned to developers based on suspect commit analysis. +Once configured and enabled, issues are automatically assigned to developers based on suspect commit analysis. ### Configure Source Code Integration From 2fbf35853b1068b0af760b3fc56dac2a3bd51c35 Mon Sep 17 00:00:00 2001 From: leomelki Date: Fri, 20 Jun 2025 16:31:45 +0200 Subject: [PATCH 5/6] remove repetitions --- content/en/error_tracking/auto_assign.md | 4 +--- 1 file changed, 1 insertion(+), 3 deletions(-) diff --git a/content/en/error_tracking/auto_assign.md b/content/en/error_tracking/auto_assign.md index 71ef75651e803..295d97799f578 100644 --- a/content/en/error_tracking/auto_assign.md +++ b/content/en/error_tracking/auto_assign.md @@ -12,9 +12,7 @@ further_reading: ## Overview -Auto Assign helps teams quickly resolve issues by automatically assigning them to the most likely responsible developers. This feature analyzes git commit history to identify suspect commits that may have introduced the issue, then assigns the issue directly to the developer who made those commits. - -Auto Assign uses [suspect commits][1] to identify developers who may have introduced issues. When an issue is automatically assigned to a developer, they receive an immediate notification. +Auto Assign helps teams quickly resolve issues by automatically assigning them to the most likely responsible developers. It uses [suspect commits][1] to identify developers who may have introduced issues, then assigns the issue directly to the developer who made those commits. When an issue is automatically assigned to a developer, they receive an immediate notification. ## Setup From a2a79d0d790d536fa86ee40c45ba7bfa347ceaa7 Mon Sep 17 00:00:00 2001 From: leomelki Date: Fri, 20 Jun 2025 17:14:08 +0200 Subject: [PATCH 6/6] simplify --- content/en/error_tracking/auto_assign.md | 22 +++++++--------------- 1 file changed, 7 insertions(+), 15 deletions(-) diff --git a/content/en/error_tracking/auto_assign.md b/content/en/error_tracking/auto_assign.md index 295d97799f578..d58e8a17b4f5a 100644 --- a/content/en/error_tracking/auto_assign.md +++ b/content/en/error_tracking/auto_assign.md @@ -12,7 +12,9 @@ further_reading: ## Overview -Auto Assign helps teams quickly resolve issues by automatically assigning them to the most likely responsible developers. It uses [suspect commits][1] to identify developers who may have introduced issues, then assigns the issue directly to the developer who made those commits. When an issue is automatically assigned to a developer, they receive an immediate notification. +Auto Assign automates triaging by assigning issues to the author of their [suspect commit][1]. + +This feature enables faster issue resolution by automatically assigning issues to developers most familiar with the relevant code, while reducing manual triage work. Developers are immediately notified when issues arise from their code. ## Setup @@ -22,18 +24,15 @@ Once configured and enabled, issues are automatically assigned to developers bas - Ensure [Source Code Integration][2] is enabled and setup. - Install [the GitHub integration][3]. Make sure all requested permission is granted for the GitHub integration. - -### Ensure email consistency -Developers must use the same email address in both Git and their Datadog account. This email matching is essential for Auto Assign to correctly identify and assign issues to the right users. +- Developers must use the same email address in both Git and their Datadog account. ## How it works When an error occurs, Auto Assign: -1. Analyzes the stack trace to identify suspect commits -2. Determines the developer responsible for the most recent suspect commit -3. Automatically assigns the issue to that developer -4. Sends a notification to the assigned developer +1. Analyzes the stack trace to identify a suspect commit +2. Finds the author of this commit +3. Assigns the issue to that developer and sends a notification. ## Managing assignments @@ -43,13 +42,6 @@ Navigate to the Error Tracking configuration section in Datadog to manage Auto A ### Assignment management You can view assigned developers directly within each issue in Datadog. If needed, manual reassignment is always possible to override the automatic assignment. -## Benefits - -- **Faster issue resolution**: Issues are automatically assigned to developers who are most familiar with the relevant code -- **Direct accountability**: Individual developers receive clear ownership of issues related to their recent commits -- **Proactive notifications**: Assigned developers are immediately notified when issues are detected, enabling quick response times -- **Reduced triage time**: Eliminates manual assignment processes by automatically identifying the most likely responsible developer - ## Further Reading {{< partial name="whats-next/whats-next.html" >}}