Skip to content

Tag Analysis GA docs #30329

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 3 commits into from
Jul 10, 2025
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
17 changes: 11 additions & 6 deletions config/_default/menus/main.en.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -3949,25 +3949,30 @@ menu:
parent: trace_explorer
identifier: span_query_syntax
weight: 602
- name: Trace Queries
url: tracing/trace_explorer/trace_queries/
parent: trace_explorer
weight: 603
- name: Span Tags and Attributes
url: tracing/trace_explorer/span_tags_attributes/
parent: trace_explorer
identifier: span_attributes
weight: 603
weight: 604
- name: Span Visualizations
url: tracing/trace_explorer/visualize/
parent: trace_explorer
identifier: visualize_spans
weight: 604
weight: 605
- name: Trace View
identifier: tracing_trace_explorer_trace_view
url: tracing/trace_explorer/trace_view/
parent: trace_explorer
weight: 605
- name: Trace Queries
url: tracing/trace_explorer/trace_queries/
parent: trace_explorer
weight: 606
- name: Tag Analysis
identifier: tracing_tag_analysis
url: tracing/trace_explorer/tag_analysis/
parent: trace_explorer
weight: 607
- name: Recommendations
url: tracing/recommendations/
parent: tracing
Expand Down
16 changes: 6 additions & 10 deletions content/en/tracing/trace_explorer/tag_analysis.md
Original file line number Diff line number Diff line change
Expand Up @@ -13,10 +13,6 @@ further_reading:
text: "Find what's driving errors and latency with Tag Analysis"
---

{{< callout url="https://www.datadoghq.com/product-preview/tag-analysis/" header="Request access to the Preview!" >}}
Tag Analysis is in Preview. To request access, fill out this form.
{{< /callout >}}

## Overview

Tag Analysis helps you identify tags and attributes that contribute most significantly to anomalies in your tracing data, such as error spikes or latency issues. It automatically highlights dimensions that distinguish problematic spans from normal ones.
Expand All @@ -38,6 +34,10 @@ Use Tag Analysis to answer questions such as:

You can initiate Tag Analysis from several locations:

- **Trace Explorer Point Plot Visualization**: Select a cluster of spans by brushing over the graph (spanning duration and time range) to define a subset of spans to compare against. The same visualization can be found in [service][3] and [resource][4] pages.

{{< img src="/tracing/trace_explorer/tag_analysis/point_plot_explorer.png" alt="Trace Explorer Point plot selection" style="width:80%;" >}}

- **Trace Explorer Top Metrics** (Requests, Errors and Latency): Click **Analyze** next to the Errors or Latency graphs to discover tags contributing to errors or latency.

{{< img src="/tracing/trace_explorer/tag_analysis/red_metrics_entrypoint.png" alt="Analyze RED metrics" style="width:90%;" >}}
Expand All @@ -46,12 +46,6 @@ You can initiate Tag Analysis from several locations:

{{< img src="/tracing/trace_explorer/tag_analysis/timeseries_entrypoint.png" alt="Analyze time range" style="width:80%;" >}}

- **Trace Explorer and Service Page Point plot Graph**: Select a cluster of spans by brushing over the graph (spanning duration and time range) to define a subset of spans to compare against.

{{< img src="/tracing/trace_explorer/tag_analysis/scatterplot_entrypoint.png" alt="Analyse point plot slice" style="width:80%;" >}}

Click **Analyze** to see the results in the Tag Analysis side panel.

## Exploring Tag Analysis results

Tag Analysis results appear in a side panel and include:
Expand Down Expand Up @@ -79,3 +73,5 @@ Tag Analysis results appear in a side panel and include:

[1]: app.datadoghq.com/apm/traces
[2]: /tracing/trace_explorer/trace_groups
[3]: /tracing/services/service_page
[4]: /tracing/services/resource_page
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading