You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
## DESCRIBE YOUR PR
Updating trace explorer doc for GA - adding arcades, new screenshots,
and a few text tweaks
Deleting old trace explorer docs.
closes#13539
## IS YOUR CHANGE URGENT?
Help us prioritize incoming PRs by letting us know when the change needs
to go live.
- [x] Urgent deadline (GA date, etc.): First week of May
- [ ] Other deadline: <!-- ENTER DATE HERE -->
- [ ] None: Not urgent, can wait up to 1 week+
## SLA
- Teamwork makes the dream work, so please add a reviewer to your PRs.
- Please give the docs team up to 1 week to review your PR unless you've
added an urgent due date to it.
Thanks in advance for your help!
## PRE-MERGE CHECKLIST
*Make sure you've checked the following before merging your changes:*
- [ x] Checked Vercel preview for correctness, including links
- [x ] PR was reviewed and approved by any necessary SMEs (subject matter
experts)
- [x ] PR was reviewed and approved by a member of the [Sentry docs
team](https://github.com/orgs/getsentry/teams/docs)
---------
Co-authored-by: Shannon Anahata <[email protected]>
Copy file name to clipboardExpand all lines: docs/product/explore/trace-explorer/index.mdx
+16-22
Original file line number
Diff line number
Diff line change
@@ -1,20 +1,12 @@
1
1
---
2
-
title: "New Trace Explorer With Span-Based Metrics"
2
+
title: "Trace Explorer With Span Metrics"
3
3
sidebar_order: 31
4
-
description: "Learn how to use the new Sentry Trace Explorer to search span data, find distributed traces, and debug performance issues across your entire application stack."
4
+
description: "Learn how to use Sentry's Trace Explorer to search span data, find distributed traces, and debug performance issues across your entire application stack."
5
5
---
6
6
7
-
<Alert>
8
-
The new Trace Explorer is currently an Early Adopter feature, to use it you
9
-
will need to [enable your Early Adopter
10
-
status](/organization/early-adopter-features/). If you are not an Early
11
-
Adopter, you will still see the [classic Trace
12
-
Explorer](/product/explore/traces/).
13
-
</Alert>
14
-
15
7
The [**Trace Explorer**](https://sentry.io/orgredirect/organizations/:orgslug/traces/) in Sentry is designed to make performance investigation easier and more intuitive. You can now explore span samples, visualize span attributes, and aggregate your data with flexible queries and filters. This guide will walk you through the key concepts and features of the Trace Explorer.
16
8
17
-

9
+

18
10
19
11
## Key Concepts
20
12
@@ -23,7 +15,7 @@ The [**Trace Explorer**](https://sentry.io/orgredirect/organizations/:orgslug/tr
23
15
- A trace represents a single transaction or request through your system. This includes things like user browser sessions, HTTP requests, DB queries, middleware, caches and more.
24
16
- It captures a series of operations (_spans_) that show how different parts of your application interacted during that transaction.
25
17
- Each trace is identified by a **Trace ID**, which you can use to follow a request across services or projects.
26
-
- A [distributed trace](/platforms/javascript/tracing/trace-propagation/#what-is-distributed-tracing) is composed of spans that traverse multiple servers, clients, edge workers, etc. and is assembled by passing the Trace ID through browser headers.
18
+
- A [distributed trace](/platforms/javascript/tracing/trace-propagation/#what-is-distributed-tracing) is made of spans that traverse multiple servers, clients, edge workers, etc. and is assembled by passing the Trace ID through browser headers.
27
19
28
20
### Spans
29
21
@@ -36,7 +28,6 @@ The [**Trace Explorer**](https://sentry.io/orgredirect/organizations/:orgslug/tr
36
28
37
29
- Span metrics are derived from applying a function to your span attributes (default or custom), like `p50(cart.value)` or `sum(ai.token_use)`, over a granular time frame. This calculation extrapolates metrics that then populate dashboards, alerts, etc. based on that rolling time window.
38
30
- These 'metrics' aren't stored separately from your span data. Rather, they're queried on the fly. This reduces your need to manage, ingest, and store custom metrics.
39
-
- The duration and granularity on which you can query your spans and extrapolate metrics depends on your plan - Developer: 7 days | Team: 14 days | Business: 30 days.
40
31
41
32
## Practical Examples
42
33
@@ -47,21 +38,25 @@ The [**Trace Explorer**](https://sentry.io/orgredirect/organizations/:orgslug/tr
47
38
48
39
With these tools, the new Trace Explorer gives you powerful ways to understand your application's performance, identify bottlenecks, and make informed optimizations.
49
40
41
+
<Alert>
42
+
You plan type determines your query window: Developer: 7 days | Team: 14 days | Business: 30 days.
43
+
</Alert>
44
+
50
45
## Browsing Span and Trace Samples
51
46
52
-
Trace Explorer allows you to browse span and trace samples effortlessly. Here's how:
47
+
Trace Explorer allows you to browse span and trace samples and inspect them. Here's how:
53
48
54
49
1.**Search for Samples**:
55
50
- Use the search bar to filter results based on default or custom attributes, tags, etc. like `http.request_method is "GET`
56
-
-**Edit and add** columns in teh span samples table to view any attribute
51
+
-**Edit and add** columns in the span samples table to view any attribute
57
52
-**Sort** by clicking the column header to toggle between ascending and descending
58
53
- Switch between **Span Samples** and **Trace Samples** tabs depending on your focus.
59
54
1.**Inspect Samples**:
60
55
61
56
- Clicking on a **Span ID** or **Trace ID** opens the **Trace Waterfall View**, showing the sequence of operations and their durations.
62
57
- You can explore individual spans in detail or see the trace's overall structure.
63
58
64
-

Dive deeper into your data with aggregation capabilities in Trace Explorer.
86
80
87
-
1.**Enable Aggregate Grouping** by clicking the **Aggregates**toggle.
81
+
1.Click into the **Aggregates**tab.
88
82
89
83
2.**Group By Attributes** to investigate patterns.
90
84
@@ -94,13 +88,13 @@ Dive deeper into your data with aggregation capabilities in Trace Explorer.
94
88
95
89
4.**View sample traces** that fit your aggregates by clicking the stack icon to the left side of the table rows. Use this to find outliers, debug issues, and find complex performance optimizations.
96
90
97
-

## Create Alerts and Dashboard Widgets From Queries
100
94
101
95
You can create Alerts and Dashboard widgets from your queries by clicking the "Save As" button:
102
96
103
-

97
+

104
98
105
99
## Practical Examples
106
100
@@ -203,7 +197,7 @@ Sentry treats this as a representation of the average across all 12 estimated sp
203
197
204
198
If your sampling rate is **too low** for an accurate extrapolation (for example, keeping less than 5% of an already low number of spans), Sentry may show a **low sampling rate warning**. This lets you know that extrapolation might be less reliable, especially for more restrictive queries.
205
199
206
-

200
+

207
201
208
202
Even if you sample your spans, **Trace Explorer's extrapolation gives you reasonably accurate answers** for counts, averages, and percentiles -- without you needing to do anything extra.
0 commit comments