Skip to content

Commit

Permalink
Make updates to search concepts section (#11248)
Browse files Browse the repository at this point in the history
  • Loading branch information
lizokm committed Sep 19, 2024
1 parent 2778f0d commit 63ca5a7
Show file tree
Hide file tree
Showing 3 changed files with 10 additions and 9 deletions.
4 changes: 4 additions & 0 deletions docs/concepts/search/index.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -8,6 +8,10 @@ Search is available on several features throughout [sentry.io](https://sentry.io

## Query Syntax

<Note>
You'll only need to use query syntax if you're using a Sentry [API](/api/). You'll get pre-populated suggestions once you start typing in your search terms when using the search bar anywhere in [Sentry.io](https://sentry.sentry.io/).
</Note>

Search queries are constructed using a `key:value` pattern, with an optional raw search at the end. Each `key:value` pair is a `token` and the optional raw search is itself a single `token`. The `key:value` pair `tokens` are treated as issue or event properties. The optional raw search is treated as a single `token` and searches event titles/messages.

For example:
Expand Down
4 changes: 4 additions & 0 deletions docs/concepts/search/searchable-properties/issues.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -10,6 +10,10 @@ sidebar_order: 10

Below is a list of keys and tokens that can be used in the issues search.

<Note>
You'll only need to use query syntax for **datetime** and **relative time** searchable property types if you're using the Sentry [API](/api/).
</Note>

<DefinitionList>

### `age`
Expand Down
11 changes: 2 additions & 9 deletions docs/product/explore/traces/index.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -80,13 +80,6 @@ All events have built-in key fields or custom tags, this includes our span data.

### Syntax

The Query Builder syntax is identical to [Sentry's Search syntax](/concepts/search/). After you enter a key field from above or a custom tag, you can use any of the referenced syntax. For example, `count()` gives you the number of times an event occurs. This can be written in the following ways:
The Query Builder syntax is identical to [Sentry's Search syntax](/concepts/search/). After you enter a key field from above or a custom tag, you can use any of the referenced syntax. For example, `count()` gives you the number of times an event occurs.

- Exact match (is equal to): `span.duration:99`
- Upper bounds (is less than or equal to): `span.duration:<99` or `span.duration:<=99`
- Lower bounds (is more than or equal to): `span.duration:>99` or `span.duration:>=99`
- Multiple bounds (is more and less than): `span.duration:>10 span.duration:<20`

Use `OR` and `AND` search conditions between filters. However `OR` cannot be used between aggregate and non-aggregate filters. For more details about these conditions, see [Using `OR` and `AND`](/concepts/search/#using-or-and-and).

You can also search multiple values for the same key by putting the values in a list. For example, "x:[value1, value2]" will find the same results as "x:value1 `OR` x:value2". You can learn more in our content covering [Multiple Values on the Same Key](/concepts/search/#multiple-values-on-the-same-key).
Use `OR` and `AND` to search conditions between filters. However `OR` cannot be used between aggregate and non-aggregate filters. For more details about these conditions, see [Using `OR` and `AND`](/concepts/search/#using-or-and-and).

0 comments on commit 63ca5a7

Please sign in to comment.