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
- Type: string
project.id
The id of the
- Type: number
release
A release is a version of your code deployed to an environment. You can create a
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
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
- 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
- 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
Our documentation is open source and available on GitHub. Your contributions are welcome, whether fixing a typo (drat!) to suggesting an update ("yeah, this would be better").