# 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](https://sentry.io) pages:

* [Traces](https://docs.sentry.io/product/explore/traces.md) - 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.

## [Searchable Properties](https://docs.sentry.io/concepts/search/searchable-properties/spans.md#searchable-properties)

Below is a list of keys and tokens that can be used in the span search:

### [`action`](https://docs.sentry.io/concepts/search/searchable-properties/spans.md#action)

The type of span action, for example, `SELECT` for a SQL span or `POST` for an HTTP span.

* **Type:** string

### [`browser.name`](https://docs.sentry.io/concepts/search/searchable-properties/spans.md#browsername)

The name of the browser that generated the span.

* **Type:** string

### [`cache.hit`](https://docs.sentry.io/concepts/search/searchable-properties/spans.md#cachehit)

Whether a cache read has hit or missed the queried cache key. Values are `'true'` or `'false'`.

* **Type:** string

### [`description`](https://docs.sentry.io/concepts/search/searchable-properties/spans.md#description)

Parameterized and scrubbed description of the span.

* **Type:** string

### [`device.class`](https://docs.sentry.io/concepts/search/searchable-properties/spans.md#deviceclass)

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

### [`domain`](https://docs.sentry.io/concepts/search/searchable-properties/spans.md#domain)

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

### [`duration`](https://docs.sentry.io/concepts/search/searchable-properties/spans.md#duration)

The total time taken by the span.

* **Type:** duration

### [`environment`](https://docs.sentry.io/concepts/search/searchable-properties/spans.md#environment)

Refers to your code deployment naming convention. For example, `development`, `testing`, `staging` and so on. [Learn more](https://docs.sentry.io/product/sentry-basics/environments.md). In some pages of [Sentry](https://sentry.io/), you filter on environment using a dropdown.

* **Type:** string

### [`file_extension`](https://docs.sentry.io/concepts/search/searchable-properties/spans.md#file_extension)

The file extension of a resource span.

* **Type:** string

### [`group`](https://docs.sentry.io/concepts/search/searchable-properties/spans.md#group)

Unique hash of the span’s description.

* **Type:** string

### [`http.decoded_response_content_length`](https://docs.sentry.io/concepts/search/searchable-properties/spans.md#httpdecoded_response_content_length)

The [decoded body size](https://developer.mozilla.org/en-US/docs/Web/API/PerformanceResourceTiming/decodedBodySize) of the resource.

* **Type:** string

### [`http.response_content_length`](https://docs.sentry.io/concepts/search/searchable-properties/spans.md#httpresponse_content_length)

The [encoded body size](https://developer.mozilla.org/en-US/docs/Web/API/PerformanceResourceTiming/encodedBodySize) of the resource.

* **Type:** string

### [`http.response_transfer_size`](https://docs.sentry.io/concepts/search/searchable-properties/spans.md#httpresponse_transfer_size)

The [total transfer size](https://developer.mozilla.org/en-US/docs/Web/API/PerformanceResourceTiming/transferSize) of the resource.

* **Type:** string

### [`messaging.destination.name`](https://docs.sentry.io/concepts/search/searchable-properties/spans.md#messagingdestinationname)

The queue name or topic that the message is written or published to. The consumer also reads from this queue.

* **Type:** string

### [`messaging.message.id`](https://docs.sentry.io/concepts/search/searchable-properties/spans.md#messagingmessageid)

The unique ID of a message from the queue or messaging system.

* **Type:** string

### [`module`](https://docs.sentry.io/concepts/search/searchable-properties/spans.md#module)

The Insights module that the span is associated with, for example, `cache`, `db`, `http`, and so on.

* **Type:** string

### [`op`](https://docs.sentry.io/concepts/search/searchable-properties/spans.md#op)

The operation of the span, for example, `http.client`, `middleware`.

* **Type:** string

### [`os.name`](https://docs.sentry.io/concepts/search/searchable-properties/spans.md#osname)

Name of the operating system.

* **Type:** string

### [`platform`](https://docs.sentry.io/concepts/search/searchable-properties/spans.md#platform)

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

### [`release`](https://docs.sentry.io/concepts/search/searchable-properties/spans.md#release)

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](https://docs.sentry.io/product/releases/usage/sorting-filtering.md#latest-release).

* **Type:** string

### [`resource.render_blocking_status`](https://docs.sentry.io/concepts/search/searchable-properties/spans.md#resourcerender_blocking_status)

The [render blocking status](https://developer.mozilla.org/en-US/docs/Web/API/PerformanceResourceTiming/renderBlockingStatus) of the resource.

* **Type:** string

### [`sdk.name`](https://docs.sentry.io/concepts/search/searchable-properties/spans.md#sdkname)

Name of the Sentry SDK that sent the event.

* **Type:** string

### [`sdk.version`](https://docs.sentry.io/concepts/search/searchable-properties/spans.md#sdkversion)

Version of the Sentry SDK that sent the event.

* **Type:** string

### [`self_time`](https://docs.sentry.io/concepts/search/searchable-properties/spans.md#self_time)

The duration of the span excluding the duration of its child spans.

* **Type:** string

### [`status`](https://docs.sentry.io/concepts/search/searchable-properties/spans.md#status)

Status of the operation the span represents.

### [`status_code`](https://docs.sentry.io/concepts/search/searchable-properties/spans.md#status_code)

The HTTP response status code.

* **Type:** string

### [`system`](https://docs.sentry.io/concepts/search/searchable-properties/spans.md#system)

Database system (e.g., `postgresql` or `mysql`).

* **Type:** string

### [`trace.status`](https://docs.sentry.io/concepts/search/searchable-properties/spans.md#tracestatus)

The span trace's success or failure status.

* **Type:** string

### [`transaction`](https://docs.sentry.io/concepts/search/searchable-properties/spans.md#transaction)

Name of the containing transaction.

* **Type:** string

### [`transaction.method`](https://docs.sentry.io/concepts/search/searchable-properties/spans.md#transactionmethod)

HTTP method of the containing transaction.

* **Type:** string

### [`transaction.op`](https://docs.sentry.io/concepts/search/searchable-properties/spans.md#transactionop)

Operation of the containing transaction.

* **Type:** string

### [`user.email`](https://docs.sentry.io/concepts/search/searchable-properties/spans.md#useremail)

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`](https://docs.sentry.io/concepts/search/searchable-properties/spans.md#userid)

Application-specific internal identifier for the user.

* **Type:** string

### [`user.username`](https://docs.sentry.io/concepts/search/searchable-properties/spans.md#userusername)

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

* **Type:** string