Skip to content

Commit a414879

Browse files
sfanahataShannon Anahatasentry-junior[bot]
authored
feat(Explore): New Dropped Data page, new Explore feature page, updates to search (#19870)
## DESCRIBE YOUR PR - New product page for Explore feature as a whole - New dropped data feature page - New searchable properties pages for Logs and Metrics - Updated explore-related pages to link to new explore page **Note:** Screenshots and arcades are pending EA-ready updates for dropped data. ## IS YOUR CHANGE URGENT? Help us prioritize incoming PRs by letting us know when the change needs to go live. Select exactly one option. For deadlines, replace `YYYY-MM-DD` with the due date. You can update this information later by editing the PR description. - [ ] Urgent deadline (GA date, etc.): YYYY-MM-DD - [x] Other deadline: 2026-10-16 - [ ] No deadline: 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 supplied a deadline. 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 <shannonanahata@gmail.com> Co-authored-by: sentry-junior[bot] <264270552+sentry-junior[bot]@users.noreply.github.com>
1 parent faf8b61 commit a414879

31 files changed

Lines changed: 2400 additions & 98 deletions

File tree

‎develop-docs/application-architecture/dynamic-sampling/the-big-picture.mdx‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -92,7 +92,7 @@ For more granular queries, **stored events are needed**. _The purpose of dynamic
9292

9393
If Sentry applies a 1% dynamic sample rate, you can still receive accurate events per minute (SPM or TPM, depending on event type) and web vital quantiles through total event data backed by metrics. There is also a listing of each of these numbers by the transaction.
9494

95-
When you go into Trace Explorer or Errors, you might want to now split the data by a custom tag you’ve added to your events. This granularity is not offered by metrics, so **these queries need to use stored events**.
95+
When you go into Explore → Traces or Errors, you might want to now split the data by a custom tag you’ve added to your events. This granularity is not offered by metrics, so **these queries need to use stored events**.
9696

9797
</Alert>
9898

‎develop-docs/sdk/telemetry/traces/index.mdx‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -161,7 +161,7 @@ In memory, spans build up a conceptual tree of timed operations. We call the who
161161

162162
Over the wire, transactions are serialized to JSON as an augmented `Event`, and sent as envelopes. The different envelope types are for optimizing ingestion (so we can route "transaction events" differently than other events, mostly "error events").
163163

164-
In the Sentry UI, you can use Errors and Trace Explorer to look at error and performance events, and the Issues section to dive into grouped errors. The [user-facing tracing documentation](https://docs.sentry.io/concepts/key-terms/tracing/distributed-tracing/) explains more of the concepts on the product level.
164+
In the Sentry UI, you can use Errors and Explore → Traces to look at error and performance events, and the Issues section to dive into grouped errors. The [user-facing tracing documentation](https://docs.sentry.io/concepts/key-terms/tracing/distributed-tracing/) explains more of the concepts on the product level.
165165

166166
The [Span](/sdk/foundations/transport/event-payloads/span/) class stores each individual span in a
167167
trace.

‎docs/concepts/key-terms/enrich-data/index.mdx‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -60,11 +60,11 @@ Learn more in [Search](/concepts/search/).
6060

6161
### Explore
6262

63-
Explore is a powerful query engine that builds upon your data, allowing you to reveal patterns, anomalies, and deeper insights in the health of your entire system. With this in mind, the more (custom) data you bring into Sentry, the more flexibility you'll gain in building queries that address your environments, releases, custom development, and business characteristics. Sentry supports telemetry data from a wide range of sources, like [errors](/product/errors/), [traces and spans](/product/trace-explorer/), [logs](/product/logs/), [session replays](/product/session-replay/web/), and [application metrics](/product/metrics/).
63+
[Explore](/product/explore/) queries your telemetry, including [errors](/product/errors/), [traces and spans](/product/trace-explorer/), [logs](/product/logs/), [session replays](/product/session-replay/web/), and [application metrics](/product/metrics/). The more custom data you send, the more specific those queries can be: environment, release, and your own tags.
6464

6565
For instance, a Traces query can display all the spans that occurred in the _production environment_, aggregated by the _customer-type custom tag_, and ordered by _p90(span.duration)_.
6666

67-
Learn more in [Traces and Spans](/product/trace-explorer/).
67+
Learn more in [Explore](/product/explore/).
6868

6969
### Ownership Rules
7070

‎docs/concepts/key-terms/extrapolation.mdx‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -74,11 +74,11 @@ Extreme values like `min` and `max` aren't extrapolated because they're less sta
7474

7575
While extrapolation is usually helpful, if you are exclusively looking to confirm your sampling usage or look exclusively at sampled data, you can turn off extrapolation.
7676

77-
You can disable extrapolation using the settings icon above charts in tools like Trace Explorer. Note that with extrapolation off, your metrics will only reflect the sampled data, not your full traffic.
77+
You can disable extrapolation using the settings icon above charts in [Explore → Traces](/product/trace-explorer/). Note that with extrapolation off, your metrics will only reflect the sampled data, not your full traffic.
7878

7979
<Alert>
8080
If Sentry displays a **low confidence warning**, it means there isn't enough sampled data for reliable extrapolation. Consider increasing your sample rate or widening your query filters.
8181
</Alert>
8282

83-
![Trace Explorer low samples warning =500x](./img/Trace_explorer_low_samples.png)
83+
![Low sampling rate warning in Traces =500x](./img/Trace_explorer_low_samples.png)
8484

‎docs/concepts/key-terms/key-terms.mdx‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -54,7 +54,7 @@ Each of these key features have their own page (or set of pages) in the [sentry.
5454

5555
- **Projects** - Lists the projects of which you're a member, by team, and provides you with a high-level overview of your projects. From here, you can go to the **Project Details** page of each project for a more granular view. Learn more in the full [Projects documentation](/product/projects/).
5656

57-
- **Explore** - Sentry offers multiple ways to search and investigate your application's data — including your app's [errors](/product/errors/), [traces](/product/trace-explorer/), [metrics](/product/metrics/), [profiles](/product/profiling/), [replays](/product/session-replay/), and [logs](/product/logs/) — to get the information you need to debug issues more quickly and easily.
57+
- **[Explore](/product/explore/)** - Sentry's home to search and investigate your application's data, including [errors](/product/errors/), [traces](/product/trace-explorer/), [metrics](/product/metrics/), [profiles](/product/profiling/), [replays](/product/session-replay/), and [logs](/product/logs/).
5858

5959
- **Pre-built Sentry Dashboards** - Sentry surfaces insights that can help you identify opportunities at the service-level to improve various parts of your app's performance, including requests, assets, caches, queues, and more. Pre-built Sentry Dashboards living under the Dashboards heading provide an overview of how your project is performing in various categories, as well as the ability to review sample events and their traces to help you diagnose potential problems. Learn more in the full [Sentry Dashboards documentation](/product/dashboards/sentry-dashboards/).
6060

‎docs/concepts/key-terms/tracing/distributed-tracing.mdx‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -240,6 +240,6 @@ Dynamic sampling ensures complete traces by retaining all transactions associate
240240

241241
## Viewing Trace Data
242242

243-
Use the [Trace Explorer](/product/trace-explorer/) to search for traces containing spans that meet your specific query conditions. This helps you find distributed traces that give you a connected view of your application and can help you debug and optimize your code.
243+
Use [Explore → Traces](/product/trace-explorer/) to search for traces containing spans that meet your specific query conditions. This helps you find distributed traces that give you a connected view of your application and can help you debug and optimize your code.
244244

245245
Through [Dashboards](/product/dashboards/sentry-dashboards/) and [Traces](/product/trace-explorer/), you can also view trace data in the [Trace View](/concepts/key-terms/tracing/trace-view/) page.

‎docs/concepts/search/searchable-properties/events.mdx‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -8,8 +8,8 @@ Events are the underlying event data captured using Sentry SDKs — that is, err
88

99
You can search by event properties in the following [sentry.io](https://sentry.io) pages:
1010

11-
- Errors - in the query builder
12-
- Trace Explorer - in the query builder
11+
- Explore → Errors - in the query builder
12+
- Explore → Traces - in the query builder
1313
- Dashboards - within the widget builder (depending on dataset selection)
1414
- Issues - as indicated in the list below
1515
- Alerts - when creating an alert

‎docs/concepts/search/searchable-properties/index.mdx‎

Lines changed: 21 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -4,22 +4,34 @@ description: "Learn more about searchable properties."
44
sidebar_order: 10
55
---
66

7-
Sentry's search provides you with reserved keywords, like `is`, `user`, `server`, and `browser`, that you can use to search on the properties of issues, events and replays (as well as the special case of releases). You can also create [custom tags](#custom-tags) on which to search. This page provides guidance for how to use these properties and links you to the respective searchable property lists.
7+
Search keys depend on the dataset. A key that works on Errors can be invalid on Logs. This page links each place you search to the property list for that dataset. You can also search [custom tags](#custom-tags) and any attribute you attach in the SDK.
88

99
## Search Properties
1010

11-
Sentry's searchable properties fall into one of five categories:
11+
### Explore
1212

13-
- [Issue properties](/concepts/search/searchable-properties/issues/)
14-
- [Event properties](/concepts/search/searchable-properties/events/)
15-
- [Span properties](/concepts/search/searchable-properties/spans/)
16-
- [Session Replay properties](/concepts/search/searchable-properties/session-replay/)
17-
- [User Feedback properties](/concepts/search/searchable-properties/user-feedback/)
18-
- [Release properties](/concepts/search/searchable-properties/releases/)
13+
[Explore](/product/explore/) uses one search syntax and a different property list per dataset.
14+
15+
- **Traces** use [span properties](/concepts/search/searchable-properties/spans/).
16+
- **Logs** use [log properties](/concepts/search/searchable-properties/logs/).
17+
- **Application Metrics** use [metric properties](/concepts/search/searchable-properties/metrics/).
18+
- **Errors** use [event properties](/concepts/search/searchable-properties/events/).
19+
- **Replays** use [session replay properties](/concepts/search/searchable-properties/session-replay/).
20+
- **Releases** use [release properties](/concepts/search/searchable-properties/releases/).
21+
- **Agents** use [span properties](/concepts/search/searchable-properties/spans/). Agent fields are attributes on spans.
22+
23+
Profiles is a browse page. It does not have its own property list.
24+
25+
### Issues and User Feedback
26+
27+
Issues and User Feedback each have their own keys.
28+
29+
- **Issues** uses [issue properties](/concepts/search/searchable-properties/issues/).
30+
- **User Feedback** uses [user feedback properties](/concepts/search/searchable-properties/user-feedback/).
1931

2032
## Search Tips
2133

22-
Search terms should auto-complete, and when they don't that means you have an invalid dataset. If you enter an invalid search term and tap Return or Enter, an error message is displayed. For example, in **Errors** or **Trace Explorer**, you cannot search using a grouping function (properties with a parentheses in the key, for example `epm()`) if you don't already have a grouping function included in the "Results" table columns.
34+
Search terms should auto-complete, and when they don't that means you have an invalid dataset. If you enter an invalid search term and tap Return or Enter, an error message is displayed. For example, in **Errors** or **Traces**, you cannot search using a grouping function (properties with a parentheses in the key, for example `epm()`) if you don't already have a grouping function included in the "Results" table columns.
2335

2436
When you search using a property that's a function, if the key includes a parameter, you still need to add a filter or value to have a complete search token. For example, the function `count_unique(field)` takes whichever field you choose as the parameter and then you add a number as your value to filter on. So a typical search might look like: `count_unique(user):>=20`.
2537

Lines changed: 209 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,209 @@
1+
---
2+
title: Log Properties
3+
description: "Learn more about searchable log properties."
4+
sidebar_order: 22
5+
---
6+
7+
Search logs in [Explore → Logs](/product/logs/). The keys below are common properties set by Sentry or the SDKs. Any custom attribute you attach on the log is searchable too, using the same attribute name you set in the SDK.
8+
9+
Raw text search matches `message` only. It does not search the rest of the log. Search is case sensitive by default. Use the **Ignore case** toggle in the search bar to match regardless of case. A regular expression uses `message://pattern//`. See [regular expressions](/concepts/search/#regular-expressions-logs-only).
10+
11+
## Searchable Properties
12+
13+
These keys can be used in a log search:
14+
15+
<DefinitionList>
16+
17+
### `message`
18+
19+
The log message body.
20+
21+
- **Type:** string
22+
23+
### `message.template`
24+
25+
The parameterized template, when the SDK recorded one. For example, `Adding item {item} for user {user}`.
26+
27+
- **Type:** string
28+
29+
### `message.parameter.<name>`
30+
31+
One parameter from a parameterized message. `<name>` is the parameter name or the positional index, such as `message.parameter.item` or `message.parameter.0`.
32+
33+
- **Type:** string or number, depending on the value the SDK sent
34+
35+
### `severity`
36+
37+
The severity text. One of `trace`, `debug`, `info`, `warn`, `error`, or `fatal`.
38+
39+
- **Type:** string
40+
41+
### `severity_number`
42+
43+
The numeric severity. Higher numbers are more severe. SDKs set the low end of each range: `trace` is 1, `debug` is 5, `info` is 9, `warn` is 13, `error` is 17, and `fatal` is 21.
44+
45+
- **Type:** number
46+
47+
### `timestamp`
48+
49+
When the log was recorded.
50+
51+
- **Type:** datetime
52+
53+
### `trace`
54+
55+
The trace ID for the active trace when the log was recorded.
56+
57+
- **Type:** string
58+
59+
### `span_id`
60+
61+
The span the log was emitted from. Empty when no span was active. Older SDKs send the same value as `trace.parent_span_id`.
62+
63+
- **Type:** string
64+
65+
### `id`
66+
67+
The log's unique ID.
68+
69+
- **Type:** string
70+
71+
### `project`
72+
73+
The project the log belongs to. You can also scope projects with the page filter.
74+
75+
- **Type:** string
76+
77+
### `environment`
78+
79+
The environment set in the SDK, such as `development`, `staging`, or `production`. [Learn more](/concepts/key-terms/environments/).
80+
81+
- **Type:** string
82+
83+
### `release`
84+
85+
The release set in the SDK. `release:latest` selects the most recent release. [Learn more](/product/releases/usage/sorting-filtering/#latest-release).
86+
87+
- **Type:** string
88+
89+
### `logger.name`
90+
91+
The name of the logger that emitted the log, when the SDK or logging integration set one.
92+
93+
- **Type:** string
94+
95+
### `origin`
96+
97+
Set when an SDK integration captured the log. For example, `auto.log.serilog` or `auto.db.prisma`. Direct calls to the Sentry logger API do not set this.
98+
99+
- **Type:** string
100+
101+
### `sdk.name`
102+
103+
Name of the Sentry SDK that sent the log.
104+
105+
- **Type:** string
106+
107+
### `sdk.version`
108+
109+
Version of the Sentry SDK that sent the log.
110+
111+
- **Type:** string
112+
113+
### `payload_size`
114+
115+
Size of the log payload, in bytes.
116+
117+
- **Type:** number
118+
119+
### `replay.id`
120+
121+
The ID of the active replay when the log was recorded.
122+
123+
- **Type:** string
124+
125+
### `browser.name`
126+
127+
Display name of the browser. Relay parses this from the user agent when the SDK does not set it.
128+
129+
- **Type:** string
130+
131+
### `browser.version`
132+
133+
Version of the browser.
134+
135+
- **Type:** string
136+
137+
### `user.id`
138+
139+
Application-specific identifier for the user. Sent when [send default PII](/platform-redirect/?next=/data-management/data-collected/) is enabled, or when you set it yourself.
140+
141+
- **Type:** string
142+
143+
### `user.email`
144+
145+
Email address of the user.
146+
147+
- **Type:** string
148+
149+
### `user.name`
150+
151+
Username of the user.
152+
153+
- **Type:** string
154+
155+
### `server.address`
156+
157+
Server address. Backend SDKs attach this.
158+
159+
- **Type:** string
160+
161+
### `os.name`
162+
163+
Operating system name. Mobile, desktop, and native SDKs attach this.
164+
165+
- **Type:** string
166+
167+
### `os.version`
168+
169+
Operating system version.
170+
171+
- **Type:** string
172+
173+
### `device.brand`
174+
175+
Device brand.
176+
177+
- **Type:** string
178+
179+
### `device.model`
180+
181+
Device model.
182+
183+
- **Type:** string
184+
185+
### `device.family`
186+
187+
Device family.
188+
189+
- **Type:** string
190+
191+
### `code.file.path`
192+
193+
File path captured with the log, when the SDK recorded a code location.
194+
195+
- **Type:** string
196+
197+
### `code.function.name`
198+
199+
Function name captured with the log.
200+
201+
- **Type:** string
202+
203+
### `code.line.number`
204+
205+
Line number captured with the log.
206+
207+
- **Type:** number
208+
209+
</DefinitionList>

0 commit comments

Comments
 (0)