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
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").