diff --git a/config/_default/menus/main.en.yaml b/config/_default/menus/main.en.yaml index ccc8843201d..114909883cd 100644 --- a/config/_default/menus/main.en.yaml +++ b/config/_default/menus/main.en.yaml @@ -2133,32 +2133,27 @@ menu: url: error_tracking/regression_detection parent: error_tracking identifier: error_tracking_regression_detection - weight: 4 - - name: Default Grouping - url: error_tracking/default_grouping + weight: 3 + - name: Error Grouping + url: error_tracking/error_grouping parent: error_tracking - identifier: error_tracking_default_grouping - weight: 5 + identifier: error_tracking_error_grouping + weight: 4 - name: Monitors url: error_tracking/monitors parent: error_tracking identifier: error_tracking_monitors - weight: 6 - - name: Custom Grouping - url: error_tracking/custom_grouping - parent: error_tracking - identifier: error_tracking_custom_grouping - weight: 7 + weight: 5 - name: Identify Suspect Commits url: error_tracking/suspect_commits parent: error_tracking identifier: error_tracking_suspect_commits - weight: 8 + weight: 6 - name: Track Browser and Mobile Errors url: error_tracking/frontend parent: error_tracking identifier: error_tracking_frontend - weight: 9 + weight: 7 - name: Browser Error Tracking url: error_tracking/frontend/browser parent: error_tracking_frontend @@ -3801,16 +3796,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 @@ -5864,16 +5854,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 @@ -7544,17 +7529,12 @@ menu: url: real_user_monitoring/error_tracking/mobile/ parent: rum_error_tracking identifier: rum_error_tracking_mobile - weight: 904 - - name: Default Grouping - url: real_user_monitoring/error_tracking/default_grouping - parent: rum_error_tracking - identifier: rum_error_tracking_default_grouping - weight: 905 - - name: Custom Grouping - url: real_user_monitoring/error_tracking/custom_grouping + weight: 804 + - name: Error Grouping + url: real_user_monitoring/error_tracking/error_grouping parent: rum_error_tracking - identifier: rum_error_tracking_custom_grouping - weight: 906 + identifier: rum_error_tracking_error_grouping + weight: 805 - 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 4f412afeb99..c2006809f4e 100644 --- a/config/_default/menus/main.fr.yaml +++ b/config/_default/menus/main.fr.yaml @@ -1962,21 +1962,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 @@ -3334,16 +3329,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 @@ -5039,16 +5029,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 @@ -6166,16 +6151,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 84% rename from content/en/error_tracking/custom_grouping.md rename to content/en/error_tracking/error_grouping.md index 7781e54d659..d28b143c12f 100644 --- a/content/en/error_tracking/custom_grouping.md +++ b/content/en/error_tracking/error_grouping.md @@ -1,11 +1,34 @@ --- -title: Custom Grouping -description: Customize how error spans are grouped into issues. +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 --- -## 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 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. + +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 +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 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" >}} 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