From 03a2c3389f8a75764dd9e6f1ddf814904dbeb05f Mon Sep 17 00:00:00 2001 From: Charles Cote Date: Wed, 23 Oct 2024 15:54:54 +0200 Subject: [PATCH 1/4] [error-tracking] Merge Default Grouping and Custom grouping pages --- config/_default/menus/main.en.yaml | 46 ++++++------------- config/_default/menus/main.fr.yaml | 44 +++++------------- content/en/error_tracking/default_grouping.md | 19 -------- .../{custom_grouping.md => error_grouping.md} | 25 ++++++++-- .../en/logs/error_tracking/custom_grouping.md | 6 --- .../logs/error_tracking/default_grouping.md | 6 --- .../en/logs/error_tracking/error_grouping.md | 6 +++ .../error_tracking/custom_grouping.md | 6 --- .../error_tracking/default_grouping.md | 6 --- .../error_tracking/error_grouping.md} | 2 +- .../tracing/error_tracking/custom_grouping.md | 6 --- .../tracing/error_tracking/error_grouping.md | 6 +++ 12 files changed, 58 insertions(+), 120 deletions(-) delete mode 100644 content/en/error_tracking/default_grouping.md rename content/en/error_tracking/{custom_grouping.md => error_grouping.md} (86%) delete mode 100644 content/en/logs/error_tracking/custom_grouping.md delete mode 100644 content/en/logs/error_tracking/default_grouping.md create mode 100644 content/en/logs/error_tracking/error_grouping.md delete mode 100644 content/en/real_user_monitoring/error_tracking/custom_grouping.md delete mode 100644 content/en/real_user_monitoring/error_tracking/default_grouping.md rename content/en/{tracing/error_tracking/default_grouping.md => real_user_monitoring/error_tracking/error_grouping.md} (61%) delete mode 100644 content/en/tracing/error_tracking/custom_grouping.md create mode 100644 content/en/tracing/error_tracking/error_grouping.md diff --git a/config/_default/menus/main.en.yaml b/config/_default/menus/main.en.yaml index fa1a36c2100..2ed782b5733 100644 --- a/config/_default/menus/main.en.yaml +++ b/config/_default/menus/main.en.yaml @@ -1987,21 +1987,16 @@ menu: parent: error_tracking identifier: error_tracking_regression_detection weight: 3 - - name: Default Grouping - url: error_tracking/default_grouping + - name: Error Grouping + url: error_tracking/error_grouping parent: error_tracking - identifier: error_tracking_default_grouping + identifier: error_tracking_error_grouping weight: 4 - name: Monitors url: error_tracking/monitors parent: error_tracking identifier: error_tracking_monitors weight: 5 - - name: Custom Grouping - url: error_tracking/custom_grouping - parent: error_tracking - identifier: error_tracking_custom_grouping - weight: 6 - name: Identify Suspect Commits url: error_tracking/suspect_commits parent: error_tracking @@ -3464,16 +3459,11 @@ menu: parent: tracing_error_tracking identifier: tracing_error_tracking_states weight: 1002 - - name: Default Grouping - url: tracing/error_tracking/default_grouping + - name: Error Grouping + url: tracing/error_tracking/error_grouping parent: tracing_error_tracking - identifier: tracing_error_tracking_default_grouping + identifier: tracing_error_tracking_error_grouping weight: 1003 - - name: Custom Grouping - url: tracing/error_tracking/custom_grouping - parent: tracing_error_tracking - identifier: tracing_error_tracking_custom_grouping - weight: 1004 - name: Monitors url: tracing/error_tracking/monitors parent: tracing_error_tracking @@ -3958,7 +3948,7 @@ menu: url: llm_observability/configuration/ parent: llm_obs identifier: llm_obs_configuration - weight: 4 + weight: 4 - name: Submit Evaluations url: llm_observability/submit_evaluations/ parent: llm_obs @@ -5359,16 +5349,11 @@ menu: url: logs/error_tracking/backend parent: log_management_error_tracking weight: 704 - - name: Default Grouping - url: logs/error_tracking/default_grouping + - name: Error Grouping + url: logs/error_tracking/error_grouping parent: log_management_error_tracking - identifier: log_management_error_tracking_default_grouping + identifier: log_management_error_tracking_error_grouping weight: 705 - - name: Custom Grouping - url: logs/error_tracking/custom_grouping - parent: log_management_error_tracking - identifier: log_management_error_tracking_custom_grouping - weight: 706 - name: Manage Data Collection url: logs/error_tracking/manage_data_collection parent: log_management_error_tracking @@ -6511,16 +6496,11 @@ menu: parent: rum_error_tracking identifier: rum_error_tracking_mobile weight: 804 - - name: Default Grouping - url: real_user_monitoring/error_tracking/default_grouping + - name: Error Grouping + url: real_user_monitoring/error_tracking/error_grouping parent: rum_error_tracking - identifier: rum_error_tracking_default_grouping + identifier: rum_error_tracking_error_grouping weight: 805 - - name: Custom Grouping - url: real_user_monitoring/error_tracking/custom_grouping - parent: rum_error_tracking - identifier: rum_error_tracking_custom_grouping - weight: 806 - name: Monitors url: real_user_monitoring/error_tracking/monitors parent: rum_error_tracking diff --git a/config/_default/menus/main.fr.yaml b/config/_default/menus/main.fr.yaml index c390403829c..8dc3bea83b7 100644 --- a/config/_default/menus/main.fr.yaml +++ b/config/_default/menus/main.fr.yaml @@ -1941,21 +1941,16 @@ menu: parent: error_tracking identifier: error_tracking_regression_detection weight: 3 - - name: Default Grouping - url: error_tracking/default_grouping + - name: Error Grouping + url: error_tracking/error_grouping parent: error_tracking - identifier: error_tracking_default_grouping + identifier: error_tracking_error_grouping weight: 4 - name: Monitors url: error_tracking/monitors parent: error_tracking identifier: error_tracking_monitors weight: 5 - - name: Custom Grouping - url: error_tracking/custom_grouping - parent: error_tracking - identifier: error_tracking_custom_grouping - weight: 6 - name: Identify Suspect Commits url: error_tracking/suspect_commits parent: error_tracking @@ -3303,16 +3298,11 @@ menu: parent: tracing_error_tracking identifier: tracing_error_tracking_states weight: 1002 - - name: Default Grouping - url: tracing/error_tracking/default_grouping + - name: Error Grouping + url: tracing/error_tracking/error_grouping parent: tracing_error_tracking - identifier: tracing_error_tracking_default_grouping + identifier: tracing_error_tracking_error_grouping weight: 1003 - - name: Custom Grouping - url: tracing/error_tracking/custom_grouping - parent: tracing_error_tracking - identifier: tracing_error_tracking_custom_grouping - weight: 1004 - name: Monitors url: tracing/error_tracking/monitors parent: tracing_error_tracking @@ -5003,16 +4993,11 @@ menu: url: logs/error_tracking/backend parent: log_management_error_tracking weight: 704 - - name: Default Grouping - url: logs/error_tracking/default_grouping + - name: Error Grouping + url: logs/error_tracking/error_grouping parent: log_management_error_tracking - identifier: log_management_error_tracking_default_grouping + identifier: log_management_error_tracking_error_grouping weight: 705 - - name: Custom Grouping - url: logs/error_tracking/custom_grouping - parent: log_management_error_tracking - identifier: log_management_error_tracking_custom_grouping - weight: 706 - name: Manage Data Collection url: logs/error_tracking/manage_data_collection parent: log_management_error_tracking @@ -6135,16 +6120,11 @@ menu: parent: rum_error_tracking identifier: rum_error_tracking_mobile weight: 804 - - name: Default Grouping - url: real_user_monitoring/error_tracking/default_grouping + - name: Error Grouping + url: real_user_monitoring/error_tracking/error_grouping parent: rum_error_tracking - identifier: rum_error_tracking_default_grouping + identifier: rum_error_tracking_error_grouping weight: 805 - - name: Custom Grouping - url: real_user_monitoring/error_tracking/custom_grouping - parent: rum_error_tracking - identifier: rum_error_tracking_custom_grouping - weight: 806 - name: Monitors url: real_user_monitoring/error_tracking/monitors parent: rum_error_tracking diff --git a/content/en/error_tracking/default_grouping.md b/content/en/error_tracking/default_grouping.md deleted file mode 100644 index 32a24cdf194..00000000000 --- a/content/en/error_tracking/default_grouping.md +++ /dev/null @@ -1,19 +0,0 @@ ---- -title: Default Grouping -description: Understand how errors are grouped into issues. ---- - -## Overview - -Error Tracking intelligently groups similar errors into issues. This grouping is based on the following error properties: - -- `service`: the service where the error occurred. -- `error.type` or `error.kind`: the class of the error. -- `error.message`: a description of the error. -- `error.stack`: the file name and the function name of the top-most meaningful stack frame. - -The error stack trace is the code path followed by an error between being thrown and being captured by Datadog instrumentation. Error Tracking evaluates the topmost stack frame (the *location* of the error) and uses it to group the error. - -If any stack-frame properties differ for two given errors, the two errors are grouped under different issues. For example, Error Tracking does not group issues across services or error types. Error Tracking also ignores numbers, punctuation, and anything that is between quotes or parentheses: only word-like tokens are used. - -**Note**: To improve grouping accuracy, Error Tracking removes variable stack-frame properties such as versions, ids, dates, and so on. diff --git a/content/en/error_tracking/custom_grouping.md b/content/en/error_tracking/error_grouping.md similarity index 86% rename from content/en/error_tracking/custom_grouping.md rename to content/en/error_tracking/error_grouping.md index bb3592aae51..2326faf1cca 100644 --- a/content/en/error_tracking/custom_grouping.md +++ b/content/en/error_tracking/error_grouping.md @@ -1,11 +1,27 @@ --- -title: Custom Grouping -description: Customize how error spans are grouped into issues. +title: Error Grouping +description: Understand how errors are grouped into issues. --- -## Overview +## Default Grouping -Error Tracking intelligently groups similar errors into issues with a [default strategy][5]. By using _custom fingerprinting_, you can gain full control over the grouping decision and customize the grouping behavior for your error spans. +Error Tracking intelligently groups similar errors into issues. This grouping is based on the following error properties: + +- `service`: the service where the error occurred. +- `error.type` or `error.kind`: the class of the error. +- `error.message`: a description of the error. +- `error.stack`: the file name and the function name of the top-most meaningful stack frame. + +The error stack trace is the code path followed by an error between being thrown and being captured by Datadog instrumentation. Error Tracking evaluates the topmost stack frame (the *location* of the error) and uses it to group the error. + +If any stack-frame properties differ for two given errors, the two errors are grouped under different issues. For example, Error Tracking does not group issues across services or error types. Error Tracking also ignores numbers, punctuation, and anything that is between quotes or parentheses: only word-like tokens are used. + +**Note**: To improve grouping accuracy, Error Tracking removes variable stack-frame properties such as versions, ids, dates, and so on. + + +## Custom Grouping + +Error Tracking intelligently groups similar errors into issues with a default strategy. By using _custom fingerprinting_, you can gain full control over the grouping decision and customize the grouping behavior for your error spans. You can customize grouping by providing an `error.fingerprint` for the error. The fingerprint is provided in an attribute or tag, depending on the error source (see [Setup](#setup) for details). While the value of `error.fingerprint` does not have any particular format or requirement, the content must be a string. @@ -317,4 +333,3 @@ final configuration = DatadogConfiguration( [2]: /logs/log_collection/ [3]: /real_user_monitoring/browser/ [4]: /real_user_monitoring/mobile_and_tv_monitoring/setup -[5]: /error_tracking/default_grouping diff --git a/content/en/logs/error_tracking/custom_grouping.md b/content/en/logs/error_tracking/custom_grouping.md deleted file mode 100644 index ff1d5dc9a7c..00000000000 --- a/content/en/logs/error_tracking/custom_grouping.md +++ /dev/null @@ -1,6 +0,0 @@ ---- -title: Custom Grouping -description: Customize how error spans are grouped into issues. ---- - -{{< include-markdown "error_tracking/custom_grouping" >}} \ No newline at end of file diff --git a/content/en/logs/error_tracking/default_grouping.md b/content/en/logs/error_tracking/default_grouping.md deleted file mode 100644 index 9ceb31f1601..00000000000 --- a/content/en/logs/error_tracking/default_grouping.md +++ /dev/null @@ -1,6 +0,0 @@ ---- -title: Default Grouping -description: Understand how errors are grouped into issues. ---- - -{{< include-markdown "error_tracking/default_grouping" >}} \ No newline at end of file diff --git a/content/en/logs/error_tracking/error_grouping.md b/content/en/logs/error_tracking/error_grouping.md new file mode 100644 index 00000000000..659937749e5 --- /dev/null +++ b/content/en/logs/error_tracking/error_grouping.md @@ -0,0 +1,6 @@ +--- +title: Error Grouping +description: Understand how errors are grouped into issues. +--- + +{{< include-markdown "error_tracking/error_grouping" >}} diff --git a/content/en/real_user_monitoring/error_tracking/custom_grouping.md b/content/en/real_user_monitoring/error_tracking/custom_grouping.md deleted file mode 100644 index ff1d5dc9a7c..00000000000 --- a/content/en/real_user_monitoring/error_tracking/custom_grouping.md +++ /dev/null @@ -1,6 +0,0 @@ ---- -title: Custom Grouping -description: Customize how error spans are grouped into issues. ---- - -{{< include-markdown "error_tracking/custom_grouping" >}} \ No newline at end of file diff --git a/content/en/real_user_monitoring/error_tracking/default_grouping.md b/content/en/real_user_monitoring/error_tracking/default_grouping.md deleted file mode 100644 index 9ceb31f1601..00000000000 --- a/content/en/real_user_monitoring/error_tracking/default_grouping.md +++ /dev/null @@ -1,6 +0,0 @@ ---- -title: Default Grouping -description: Understand how errors are grouped into issues. ---- - -{{< include-markdown "error_tracking/default_grouping" >}} \ No newline at end of file diff --git a/content/en/tracing/error_tracking/default_grouping.md b/content/en/real_user_monitoring/error_tracking/error_grouping.md similarity index 61% rename from content/en/tracing/error_tracking/default_grouping.md rename to content/en/real_user_monitoring/error_tracking/error_grouping.md index 9ceb31f1601..9ad8fa76ac2 100644 --- a/content/en/tracing/error_tracking/default_grouping.md +++ b/content/en/real_user_monitoring/error_tracking/error_grouping.md @@ -3,4 +3,4 @@ title: Default Grouping description: Understand how errors are grouped into issues. --- -{{< include-markdown "error_tracking/default_grouping" >}} \ No newline at end of file +{{< include-markdown "error_tracking/error_grouping" >}} diff --git a/content/en/tracing/error_tracking/custom_grouping.md b/content/en/tracing/error_tracking/custom_grouping.md deleted file mode 100644 index ff1d5dc9a7c..00000000000 --- a/content/en/tracing/error_tracking/custom_grouping.md +++ /dev/null @@ -1,6 +0,0 @@ ---- -title: Custom Grouping -description: Customize how error spans are grouped into issues. ---- - -{{< include-markdown "error_tracking/custom_grouping" >}} \ No newline at end of file diff --git a/content/en/tracing/error_tracking/error_grouping.md b/content/en/tracing/error_tracking/error_grouping.md new file mode 100644 index 00000000000..659937749e5 --- /dev/null +++ b/content/en/tracing/error_tracking/error_grouping.md @@ -0,0 +1,6 @@ +--- +title: Error Grouping +description: Understand how errors are grouped into issues. +--- + +{{< include-markdown "error_tracking/error_grouping" >}} From 658343cb5735d30648cdcbaa0bb26442796f39a1 Mon Sep 17 00:00:00 2001 From: Charles Cote Date: Tue, 12 Nov 2024 12:54:32 +0100 Subject: [PATCH 2/4] Apply suggestions from code review Co-authored-by: Rosa Trieu <107086888+rtrieu@users.noreply.github.com> --- content/en/error_tracking/error_grouping.md | 17 ++++++++++++----- 1 file changed, 12 insertions(+), 5 deletions(-) diff --git a/content/en/error_tracking/error_grouping.md b/content/en/error_tracking/error_grouping.md index 2326faf1cca..d169e6a86d4 100644 --- a/content/en/error_tracking/error_grouping.md +++ b/content/en/error_tracking/error_grouping.md @@ -1,18 +1,25 @@ --- title: Error Grouping description: Understand how errors are grouped into issues. +aliases: + - /logs/error_tracking/custom_grouping + - /logs/error_tracking/default_grouping + - /tracing/error_tracking/custom_grouping + - /real_user_monitoring/error_tracking/custom_grouping + - /real_user_monitoring/error_tracking/default_grouping + - /error_tracking/default_grouping --- ## Default Grouping Error Tracking intelligently groups similar errors into issues. This grouping is based on the following error properties: -- `service`: the service where the error occurred. -- `error.type` or `error.kind`: the class of the error. -- `error.message`: a description of the error. -- `error.stack`: the file name and the function name of the top-most meaningful stack frame. +- `service`: The service where the error occurred. +- `error.type` or `error.kind`: The class of the error. +- `error.message`: A description of the error. +- `error.stack`: The filename and function name of the top-most meaningful stack frame. -The error stack trace is the code path followed by an error between being thrown and being captured by Datadog instrumentation. Error Tracking evaluates the topmost stack frame (the *location* of the error) and uses it to group the error. +The error stack trace is the code path followed by an error between being thrown and being captured by Datadog instrumentation. Error Tracking evaluates the topmost stack frame (the **location** of the error) and uses it to group the error. If any stack-frame properties differ for two given errors, the two errors are grouped under different issues. For example, Error Tracking does not group issues across services or error types. Error Tracking also ignores numbers, punctuation, and anything that is between quotes or parentheses: only word-like tokens are used. From aa02bd6d34d32ab28c1a68bb2fbcb973a85169f1 Mon Sep 17 00:00:00 2001 From: Rosa Trieu Date: Fri, 21 Feb 2025 13:05:40 -0800 Subject: [PATCH 3/4] remove unused link --- content/en/error_tracking/error_grouping.md | 1 - 1 file changed, 1 deletion(-) diff --git a/content/en/error_tracking/error_grouping.md b/content/en/error_tracking/error_grouping.md index da71b459345..d28b143c12f 100644 --- a/content/en/error_tracking/error_grouping.md +++ b/content/en/error_tracking/error_grouping.md @@ -340,4 +340,3 @@ final configuration = DatadogConfiguration( [2]: /logs/log_collection/ [3]: /real_user_monitoring/browser/ [4]: /real_user_monitoring/mobile_and_tv_monitoring/#get-started -[5]: /error_tracking/default_grouping From 111c6fa5acf940ead7785fd8c59f72ee002b1d79 Mon Sep 17 00:00:00 2001 From: Brian Deutsch Date: Thu, 27 Mar 2025 17:01:31 -0400 Subject: [PATCH 4/4] update translated include markdown shortcodes Signed-off-by: Brian Deutsch --- content/es/logs/error_tracking/default_grouping.md | 2 +- .../es/real_user_monitoring/error_tracking/custom_grouping.md | 2 +- .../es/real_user_monitoring/error_tracking/default_grouping.md | 2 +- content/es/tracing/error_tracking/custom_grouping.md | 2 +- content/es/tracing/error_tracking/default_grouping.md | 2 +- 5 files changed, 5 insertions(+), 5 deletions(-) diff --git a/content/es/logs/error_tracking/default_grouping.md b/content/es/logs/error_tracking/default_grouping.md index 989d77097b9..cd35cefe558 100644 --- a/content/es/logs/error_tracking/default_grouping.md +++ b/content/es/logs/error_tracking/default_grouping.md @@ -3,4 +3,4 @@ description: Comprender cómo se agrupan los errores en incidencias. title: Agrupación predeterminada --- -{{< include-markdown "error_tracking/default_grouping" >}} \ No newline at end of file +{{< include-markdown "error_tracking/error_grouping" >}} \ No newline at end of file diff --git a/content/es/real_user_monitoring/error_tracking/custom_grouping.md b/content/es/real_user_monitoring/error_tracking/custom_grouping.md index 30e9be885db..39152f054ac 100644 --- a/content/es/real_user_monitoring/error_tracking/custom_grouping.md +++ b/content/es/real_user_monitoring/error_tracking/custom_grouping.md @@ -3,4 +3,4 @@ description: Personaliza cómo se agrupan los tramos (spans) con errores en inci title: Agrupación personalizada --- -{{< include-markdown "error_tracking/custom_grouping" >}} \ No newline at end of file +{{< include-markdown "error_tracking/error_grouping" >}} \ No newline at end of file diff --git a/content/es/real_user_monitoring/error_tracking/default_grouping.md b/content/es/real_user_monitoring/error_tracking/default_grouping.md index 62a89f52544..b846b372cad 100644 --- a/content/es/real_user_monitoring/error_tracking/default_grouping.md +++ b/content/es/real_user_monitoring/error_tracking/default_grouping.md @@ -3,4 +3,4 @@ description: Entiende cómo se agrupan los errores en problemas. title: Agrupación por defecto --- -{{< include-markdown "error_tracking/default_grouping" >}} \ No newline at end of file +{{< include-markdown "error_tracking/error_grouping" >}} \ No newline at end of file diff --git a/content/es/tracing/error_tracking/custom_grouping.md b/content/es/tracing/error_tracking/custom_grouping.md index cfca7cf44c9..f5d630e2a31 100644 --- a/content/es/tracing/error_tracking/custom_grouping.md +++ b/content/es/tracing/error_tracking/custom_grouping.md @@ -3,4 +3,4 @@ description: Personaliza cómo se agrupan los tramos (spans) de errores en probl title: Agrupación personalizada --- -{{< include-markdown "error_tracking/custom_grouping" >}} \ No newline at end of file +{{< include-markdown "error_tracking/error_grouping" >}} \ No newline at end of file diff --git a/content/es/tracing/error_tracking/default_grouping.md b/content/es/tracing/error_tracking/default_grouping.md index 2e79d8b812e..01bd5db3154 100644 --- a/content/es/tracing/error_tracking/default_grouping.md +++ b/content/es/tracing/error_tracking/default_grouping.md @@ -3,4 +3,4 @@ description: Comprenda cómo se agrupan los errores en problemas. title: Agrupación por defecto --- -{{< include-markdown "error_tracking/default_grouping" >}} \ No newline at end of file +{{< include-markdown "error_tracking/error_grouping" >}} \ No newline at end of file