Span Properties
Learn more about searchable span properties.
Spans are the underlying data element captured in Sentry SDKs that together make up a trace.
You can search by span properties in the following Sentry pages:
- Traces - when searching for a trace containing spans with matching properties
When you search for span properties within the Traces page, the search will return any trace that contains one or more spans that match your span properties filter.
Below is a list of keys and tokens that can be used in the span search:
The type of span action, for example, SELECT for a SQL span or POST for an HTTP span.
- Type: string
The name of the browser that generated the span.
- Type: string
Whether a cache read has hit or missed the queried cache key. Values are 'true' or 'false'.
- Type: string
Parameterized and scrubbed description of the span.
- Type: string
Device class is a synthesized field that's calculated by using device info found in context such as model (for iOS devices), and device specs like processor_frequency (for Android devices).
- Type: string
General scope of the span’s action, for example, the tables involved in a db span or the host name in an http span.
- Type: string
The total time taken by the span.
- Type: duration
Refers to your code deployment naming convention. For example, development, testing, staging and so on. Learn more. In some pages of Sentry, you filter on environment using a dropdown.
- Type: string
The file extension of a resource span.
- Type: string
Unique hash of the span’s description.
- Type: string
The decoded body size of the resource.
- Type: string
The encoded body size of the resource.
- Type: string
The total transfer size of the resource.
- Type: string
The queue name or topic that the message is written or published to. The consumer also reads from this queue.
- Type: string
The unique ID of a message from the queue or messaging system.
- Type: string
The Insights module that the span is associated with, for example, cache, db, http, and so on.
- Type: string
The operation of the span, for example, http.client, middleware.
- Type: string
Name of the operating system.
- Type: string
Name of the platform. This defaults to other and is only a property for platforms from this list: as3, c, cfml, cocoa, csharp, elixir, go, groovy, haskell, java, javascript, native, node, objc, other, perl, php, python, ruby
- Type: string
A release is a version of your code deployed to an environment. You can create a token that matches a release exactly, or pick the most recent release by using release:latest. Learn more.
- Type: string
The render blocking status of the resource.
- Type: string
Name of the Sentry SDK that sent the event.
- Type: string
Version of the Sentry SDK that sent the event.
- Type: string
The duration of the span excluding the duration of its child spans.
- Type: string
Status of the operation the span represents.
The HTTP response status code.
- Type: string
Database system (e.g., postgresql or mysql).
- Type: string
The span trace's success or failure status.
- Type: string
Name of the containing transaction.
- Type: string
HTTP method of the containing transaction.
- Type: string
Operation of the containing transaction.
- Type: string
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
Application-specific internal identifier for the user.
- Type: string
Username, which is typically a better label than user.id.
- Type: string
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").