Issue Properties

Issues are an aggregate of one or more error events. Searchable issues properties include status, assignment, aggregate counts, and age. You can search by issue properties in the Issues page and in Dashboards in the widget builder, depending on your dataset selection.

Searchable Properties

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

age

Returns issues created since the time defined by the value. The syntax is similar to the Unix find command. Supported suffixes: m - minutes, h - hours, d - days, w - weeks. For example, age:-24h returns isssues that are new in the last 24 hours, while age:+12h returns ones that are older than 12 hours. Entering age:+12h age:-24h would return issues created between 12 and 24 hours ago.

  • Type: relative time

app.in_foreground

Indicates if the app is in the foreground or background. Values are 1/0 or true/false

  • Type: boolean

assigned

Returns issues assigned to the defined user(s) or team(s). Values can be a user ID (your email address), me for yourself, none for no assignee, my_teams or #team-name for teams you belong to.

  • Type: team or org user

assigned_or_suggested

Returns issues that are assigned to or suggested to be assigned to the defined user(s) or team(s). Suggested assignees are found by matching ownership rules and suspect commits. Values can be a user ID (your email address), me for yourself, none for no assignee/suggestion, my_teams or #team-name for teams you belong to.

  • Type: team or org user

bookmarks

Returns issues bookmarked by the defined user. Values can be your user ID (your email address) or me for yourself.

  • Type: team or org user

device.arch

CPU architecture

  • Type: string

device.brand

Brand of the device

  • Type: string

device.family

Family of the device. Typically, the common part of a model name across generations. For example, iPhone, Samsung Galaxy.

  • Type: string

device.locale

Deprecated

  • Type: string

device.model_id

Internal hardware revision to identify the device exactly.

  • Type: n/a

device.orientation

Describes the orientation of the device and can be either portrait or landscape.

  • Type: string

device.screen_density

Device screen density in pixels.

  • Type: string

device.screen_dpi

Number of dots per inch of the device screen.

  • Type: string

device.screen_height_pixels

Device screen height in pixels.

  • Type: string

device.screen_width_pixels

Device screen width in pixels.

  • Type: string

device.uuid

Deprecated

  • Type: UUID

dist

Distinguishes build or deployment variants of the same release of an application. For example, the dist can be the build number of an Xcode build or the version code of an Android build.

  • Type: string

error.handled

Indicates whether the user has handled the exception — for example, using try...catch. An error is considered handled if all stack traces handle the error. Values are 1/0 or true/false

  • Type: boolean

error.main_thread

Indicates if the error occurred on the main thread. Values are 1/0 or true/false

  • Type: boolean

error.mechanism

An object describing the mechanism that created this exception.

  • Type: array

error.type

The type of exception. For example, ValueError.

  • Type: array

error.unhandled

The inversion of error.handled.

  • Type: boolean

error.value

Original value of a field that causes or exhibits the error.

  • Type: array

event.timestamp

Returns issues with matching datetime.

  • Type: datetime

event.type

Type of the event (transaction, error, default, csp, and so on). The transaction type is unavailable in Issues.

  • Type: string

firstRelease

Returns issues first seen within the given release. Can be an exact match on the version of a release, or first-release:latest to pick the most recent release.

  • Type: datetime

firstSeen

Returns issues with a matching first time seen. Syntax is the same as age.

  • Type: datetime

geo.city

Full name of the city

  • Type: string

geo.country_code

ISO 3166-1 country code

  • Type: string

geo.region

Full name of the country

  • Type: string

has

Returns results with the defined tag or field, but not the value of that tag or field. For example, entering has:user would find events with the user tag.

  • Type: error

http.method

HTTP method of the request that created the event.

  • Type: string

http.referer

Identifies the web page from which the resource was requested.

  • Type: string

http.status_code

HTTP status code, which indicates whether a response was successful. For example, 200 or 404.

  • Type: string

http.url

Full URL of the request that caused the error, but without any parameters

  • Type: string

id

The event or replay id. In Issues, use only the ID value without the id key.

  • Type: UUID

is

The properties of an issue. Values can be: unresolved, resolved, archived, assigned, unassigned, linked, or unlinked. The linked and unlinked values return issues based on whether they are linked to an external issue tracker or not.

  • Type: status

issue

The short issue code, for example SENTRY-ABC.

  • Type: string

issue.category

The category of the issue (either error or performance).

  • Type: string

issue.type

The specific type of issue. For example issue.type:performance_n_plus_one_db_queries returns the n plus one db query performance issues.

  • Type: string

lastSeen

Datetime when the event was last seen. For example, lastSeen:+30d returns issues last seen 30 days ago or more; lastSeen:-2d returns issues last seen within the past two days. This is similar to age.

  • Type: datetime

level

Severity of the event (such as: fatal, error, warning). Always set to info for transactions.

  • Type: string

location

Location where the error happened.

  • Type: string

message

Returns errors with the matching message or transactions with matching transaction name. Also matches on any message containing the supplied value.Searching message:undefined will match an event with a message of undefined is not an object.Raw text searches (searches without the message key) are also checked against this field. For errors, the message can be a concatenatenation of elements, so searches might include unexpected results.

  • Type: string

os.build

The internal build revision of the operating system.

  • Type: string

os.kernel_version

The independent kernel version string. This is typically the entire output of the uname syscall.

  • Type: string

platform.name

Name of the platform

  • Type: string

project

The name of the project. In some pages of sentry.io, you can also filter on project using a dropdown.

  • Type: string

project.id

The id of the project.

  • Type: number

release

A release is a version of your code deployed to an environment. You can create a token with an exact match of the version of a release, or release:latest to pick the most recent release.

  • Type: string

release.build

The number that identifies an iteration of your app. For example, CFBundleVersion on iOS or versionCode on Android. Learn more.

  • Type: number

release.package

The unique identifier of the project/app. For example, CFBundleIdentifier on iOS or packageName on Android. Learn more.

  • Type: string

release.stage

The usage your release is seeing relative to other releases. Values can be adopted, low, or replaced. Learn more.

  • Type: string

release.version

A shorter version of the name; name without the package or short version of the hash. Learn more.

  • Type: string

sdk.name

Name of the Sentry SDK that sent the event.

  • Type: string

sdk.version

Version of the Sentry SDK that sent the event.

  • Type: string

stack.abs_path

The absolute path to the source file. In events, this is an array; in issues, this is a single value.

  • Type: array, single value

stack.filename

The path to the source file relative to the project root directory. In events, this is an array. In issues, this is a single value.

  • Type: array, single value

stack.function

Name of the function being called. In events, this is an array. In issues, this is a single value.

  • Type: array, single value

stack.module

Platform-specific module path. For example, sentry.interfaces.Stacktrace. In events, this is an array. In issues, this is a single value.

  • Type: array, single value

stack.package

The "package" the frame was contained in. Depending on the platform, this can be different things. For C#, it can be the name of the assembly. For native code, it can be the path of the dynamic library or something else. In events, this is an array. In issues, this is a single value.

  • Type: array, single value

timesSeen

Returns results with a matching count. (Same as count() in events.)

  • Type: number

timestamp

The finish timestamp of the transaction. Returns events with matching datetime.

  • Type: datetime

title

Title of the error or the transaction name.

  • Type: string

trace

A trace represents the record of the entire operation you want to measure or track — like page load, searched using the UUID generated by Sentry’s SDK.

  • Type: UUID

transaction

For transactions, the name of the transaction. For errors, the name of the associated transaction.

  • Type: string

unreal.crash_type

The Unreal Crash Context Type

  • Type: string

user.email

An alternative, or addition, to the username. Sentry is aware of email addresses and can therefore display things such as Gravatars and unlock messaging capabilities.

  • Type: string

user.id

Application-specific internal identifier for the user.

  • Type: string

user.ip

User's IP address. Sentry uses the IP address as a unique identifier for unauthenticated users.

  • Type: string

user.username

Username, which is typically a better label than the user.id.

  • Type: string
Help improve this content
Our documentation is open source and available on GitHub. Your contributions are welcome, whether fixing a typo (drat!) or suggesting an update ("yeah, this would be better").