Skip to content

Commit 4262560

Browse files
sfanahataShannon Anahatacoolguyzone
authored andcommitted
Quick update to trace explorer doc (#13886)
## DESCRIBE YOUR PR Making these docs a bit clearer re: traces, transactions, spans ## IS YOUR CHANGE URGENT? Help us prioritize incoming PRs by letting us know when the change needs to go live. - [ ] Urgent deadline (GA date, etc.): <!-- ENTER DATE HERE --> - [ ] 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:* - [ ] Checked Vercel preview for correctness, including links - [ ] PR was reviewed and approved by any necessary SMEs (subject matter experts) - [ ] 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]> Co-authored-by: Alex Krawiec <[email protected]>
1 parent 8a87749 commit 4262560

File tree

1 file changed

+8
-6
lines changed

1 file changed

+8
-6
lines changed

docs/product/explore/trace-explorer/index.mdx

Lines changed: 8 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -12,10 +12,10 @@ The [**Trace Explorer**](https://sentry.io/orgredirect/organizations/:orgslug/tr
1212

1313
### Traces
1414

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.
16-
- It captures a series of operations (_spans_) that show how different parts of your application interacted during that transaction.
15+
- A trace represents a series of transactions or requests through a single system. This includes things like user browser sessions, HTTP requests, DB queries, middleware, caches and more.
16+
- It captures a series of operations (_spans_) that show how different parts of your application interacted during each transaction.
1717
- Each trace is identified by a **Trace ID**, which you can use to follow a request across services or projects.
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.
18+
- A [distributed trace](/platforms/javascript/tracing/trace-propagation/#what-is-distributed-tracing) is made of transactions and spans that traverse multiple servers, clients, edge workers, and other parts of your system. It is assembled by passing the Trace ID through browser headers.
1919

2020
### Spans
2121

@@ -26,7 +26,7 @@ The [**Trace Explorer**](https://sentry.io/orgredirect/organizations/:orgslug/tr
2626

2727
### Span Metrics
2828

29-
- [Span metrics](/concepts/key-terms/tracing/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.
29+
- [Span metrics](/concepts/key-terms/tracing/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 and alerts. based on that rolling time window.
3030
- 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.
3131

3232
## Practical Examples
@@ -47,7 +47,7 @@ With these tools, the new Trace Explorer gives you powerful ways to understand y
4747
Trace Explorer allows you to browse span and trace samples and inspect them. Here's how:
4848

4949
1. **Search for Samples**:
50-
- Use the search bar to filter results based on default or custom attributes, tags, etc. like `http.request_method is "GET`
50+
- Use the search bar to filter results based on default or custom attributes, tags, and strings like `http.request_method is "GET`
5151
- **Edit and add** columns in the span samples table to view any attribute
5252
- **Sort** by clicking the column header to toggle between ascending and descending
5353
- Switch between **Span Samples** and **Trace Samples** tabs depending on your focus.
@@ -90,12 +90,14 @@ Dive deeper into your data with aggregation capabilities in Trace Explorer.
9090

9191
<Arcade src="https://demo.arcade.software/rgVB85wJiopGNPO3KFJS?embed" />
9292

93-
## Create Alerts and Dashboard Widgets From Queries
93+
## Create Alerts and Dashboard Widgets From Queries or Compare Queries
9494

9595
You can create Alerts and Dashboard widgets from your queries by clicking the "Save As" button:
9696

9797
![Trace Explorer Screenshot](./img/trace_explorer_save.png)
9898

99+
You can also run side-by-side comparisons of different queries to analyze changes or differences in span data.
100+
99101
## Practical Examples
100102

101103
- **Diagnosing slow pages**:

0 commit comments

Comments
 (0)