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

* [Traces](/product/explore/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.

## [Searchable Properties](#searchable-properties)

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

### [`action`](#action)

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

* **Type:** string

### [`browser.name`](#browsername)

The name of the browser that generated the span.

* **Type:** string

### [`cache.hit`](#cachehit)

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

* **Type:** string

### [`description`](#description)

Parameterized and scrubbed description of the span.

* **Type:** string

### [`device.class`](#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`](#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`](#duration)

The total time taken by the span.

* **Type:** duration

### [`environment`](#environment)

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

* **Type:** string

### [`file_extension`](#file_extension)

The file extension of a resource span.

* **Type:** string

### [`group`](#group)

Unique hash of the span’s description.

* **Type:** string

### [`http.decoded_response_content_length`](#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`](#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`](#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`](#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`](#messagingmessageid)

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

* **Type:** string

### [`module`](#module)

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

* **Type:** string

### [`op`](#op)

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

* **Type:** string

### [`os.name`](#osname)

Name of the operating system.

* **Type:** string

### [`platform`](#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`](#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](/product/releases/usage/sorting-filtering/#latest-release).

* **Type:** string

### [`resource.render_blocking_status`](#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`](#sdkname)

Name of the Sentry SDK that sent the event.

* **Type:** string

### [`sdk.version`](#sdkversion)

Version of the Sentry SDK that sent the event.

* **Type:** string

### [`self_time`](#self_time)

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

* **Type:** string

### [`status`](#status)

Status of the operation the span represents.

### [`status_code`](#status_code)

The HTTP response status code.

* **Type:** string

### [`system`](#system)

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

* **Type:** string

### [`trace.status`](#tracestatus)

The span trace's success or failure status.

* **Type:** string

### [`transaction`](#transaction)

Name of the containing transaction.

* **Type:** string

### [`transaction.method`](#transactionmethod)

HTTP method of the containing transaction.

* **Type:** string

### [`transaction.op`](#transactionop)

Operation of the containing transaction.

* **Type:** string

### [`user.email`](#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`](#userid)

Application-specific internal identifier for the user.

* **Type:** string

### [`user.username`](#userusername)

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

* **Type:** string
