Search is available on several major Sentry views: Issues, Events, and Releases.


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 token. The Sentry SDKs treat the key:value pair token as a search on an issue or event property. The SDKs treat the optional raw search token as a message separated by whitespace, which is used to search on event titles/messages.

For example:

is:resolved user.username:"Jane Doe" server:web-8 example error

In the example above, there are three keys (is:, user.username:, server:), but four tokens:

  • is:resolved
  • user.username:"Jane Doe"
  • server:web-8
  • example error

The tokens is:resolved and user.username:"Jane Doe" are standard search tokens because both use reserved keywords. See Issue Properties and Event Properties for appropriate keyword usage. The token server:web-8 is pointing to a custom tag sent by the Sentry SDK. See Custom Tags for more information on how to set tags.

The token example error is utilizing the optional raw search and is passed as part of the issue search query (which uses a CONTAINS match similar to SQL). When using the optional raw search, you can provide one string, and the query uses that entire string.



By default, search terms are AND-ed together; they return the intersection of issues/events that match all search terms.

To change this, you can use the negation operator ! to exclude a search parameter.

is:unresolved !

In the example above, the search query returns all Issues that are unresolved and have not affected the user with the email address


Search supports the wildcard operator * as a placeholder for specific characters and strings.

browser:"Safari 11*"

In the example above, the search query will match on browser values like "Safari 11.0.2", "Safari 11.0.3", etc.

Search Properties

In the examples above, we’ve highlighted a couple of example properties you can search on: is, user, server, browser, etc. Below is a canonical list of all available search terms.

Issue Properties

Issues are an aggregate of one or more events. Searchable properties include workflow status, assignment, aggregate counts, and age.

Below is a list of Issue-level tokens reserved and known to Sentry:


Filter on the status of an issue.

Values are resolved, unresolved, ignored, assigned, and unassigned.


Filter on the user which the issue is assigned to.

Values can be your user ID (your email address), me for yourself, or #team-name.


Filter on the user which the issue is bookmarked by.

Values can be your user ID (your email address) or me for yourself.


Restrict results to issues which have any value for a tag.



Restrict results to issues first seen within the given release.

Exact match on the version of a release.


Restrict results to issues created since age. The syntax is similar to the Unix find command:

Issues new in the last 24 hours:


Issues older than 12 hours:


Issues created between 12 and 24 hours ago:

age:+12h age:-24h

Supported suffixes:

m -> minutes h -> hours d -> days w -> weeks


Restrict results to issues that have been seen exactly, at least, or at most some number of times.

Exact match:


Upper or lower bounds:

  • timesSeen:>10
  • timesSeen:>=10
  • timesSeen:<10
  • timesSeen:<=10

Restrict results that were last seen since or until a given point in time. Usage is similar to the age token (see above).

Issues last seen 30 days ago or more:


Issues last seen within the last two days:


Event Properties

Events are the underlying event data captured using Sentry SDKs (read: errors and exceptions).

When searching on Event properties within the Issues search, Issue Search will return any Issue that has one or more events matching the supplied event filters.

Below is a list of Event-level tokens reserved and known to Sentry:


Restrict results to events triggered by a geographic area.


Restrict results to events tagged with the given release.

Exact match on the version of a release.

Restrict results to events affecting the given user.


Restrict results to events that occurred at the given timestamp. This filter can be passed twice to provide a range.

Events occurred on January 2, 2016:


Events between 01:00 and 02:00 (UTC):

event.timestamp:>=2016-01-02T01:00:00 event.timestamp:<2016-01-02T02:00:00

The following comparative operators are available:

  • greater than (>)
  • greater than or equal (>=)
  • less than (<)
  • less than or equal (<=)

Restrict results to events tagged with a specific device attribute.

Restrict results to events tagged with a specific operating system property.


Restrict results to events with a matching stack property.

Custom Tags

Additionally, you can use any tag you’ve specified as a token. Tags are various key/value pairs that get assigned to an event, and you can use them later as a breakdown or quick access to finding related events.

Most SDKs generally support configuring tags by configuring the scope:

from sentry_sdk import configure_scope

with configure_scope() as scope:
    scope.set_tag("page_locale", "de-at")
Sentry.configureScope((scope) => {
  scope.setTag("page_locale", "de-at");
using Sentry;

SentrySdk.ConfigureScope(scope => 
    scope.SetTag("page_locale", "de-at");
Sentry\configureScope(function (Sentry\State\Scope $scope): void {
  $scope->setTag('page_locale', 'de-at');
sentry::configure_scope(|scope| {
    scope.set_tag("page_locale", "de-at");

Several common uses for tags include:

  • The hostname of the server
  • The version of your platform (for example, iOS 5.0)
  • The user’s language

For more information, see full documentation on Tagging Events.

Saving Searches

You can save a search by performing the search, clicking the dropdown arrow next to the Current Search, and then “Save Current Search”.