--- title: "Span Properties" description: "Learn more about searchable span properties." url: https://docs.sentry.io/concepts/search/searchable-properties/spans/ --- # 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/trace-explorer.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: ### [`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 ### [`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 ### [`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/concepts/key-terms/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 ### [`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 ### [`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 ### [`span.action`](https://docs.sentry.io/concepts/search/searchable-properties/spans.md#spanaction) The type of span action, for example, `SELECT` for a SQL span or `POST` for an HTTP span. * **Type:** string ### [`span.category`](https://docs.sentry.io/concepts/search/searchable-properties/spans.md#spancategory) The prefix of the span operation. For example, if `span.op` is `http.client`, then `span.category` is `http`. * **Type:** string ### [`span.description`](https://docs.sentry.io/concepts/search/searchable-properties/spans.md#spandescription) Parameterized and scrubbed description of the span. * **Type:** string ### [`span.domain`](https://docs.sentry.io/concepts/search/searchable-properties/spans.md#spandomain) 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 ### [`span.duration`](https://docs.sentry.io/concepts/search/searchable-properties/spans.md#spanduration) The total time taken by the span. * **Type:** duration ### [`span.group`](https://docs.sentry.io/concepts/search/searchable-properties/spans.md#spangroup) Unique hash of the span’s description. * **Type:** string ### [`span.kind`](https://docs.sentry.io/concepts/search/searchable-properties/spans.md#spankind) The kind of span. Indicates the type of span such as server, client, internal, producer, or consumer. * **Type:** string ### [`span.module`](https://docs.sentry.io/concepts/search/searchable-properties/spans.md#spanmodule) The dashboard module that the span is associated with, for example, `cache`, `db`, `http`, and so on. * **Type:** string ### [`span.name`](https://docs.sentry.io/concepts/search/searchable-properties/spans.md#spanname) The span name. A short, human-readable identifier for the operation being performed by the span. * **Type:** string ### [`span.op`](https://docs.sentry.io/concepts/search/searchable-properties/spans.md#spanop) The operation of the span, for example, `http.client`, `middleware`. * **Type:** string ### [`span.self_time`](https://docs.sentry.io/concepts/search/searchable-properties/spans.md#spanself_time) The duration of the span excluding the duration of its child spans. * **Type:** string ### [`span.status`](https://docs.sentry.io/concepts/search/searchable-properties/spans.md#spanstatus) Status of the operation the span represents. * **Type:** string ### [`span.status.message`](https://docs.sentry.io/concepts/search/searchable-properties/spans.md#spanstatusmessage) Span status message. If the span operation was not successful, this contains an error message. * **Type:** string ### [`span.status_code`](https://docs.sentry.io/concepts/search/searchable-properties/spans.md#spanstatus_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 ### [`trace_lifecycle`](https://docs.sentry.io/concepts/search/searchable-properties/spans.md#trace_lifecycle) Traces can be sent as transactions (legacy concept) or streamed as spans. * **Type:** string ### [`is_transaction`](https://docs.sentry.io/concepts/search/searchable-properties/spans.md#is_transaction) Indicates whether a span is also a transaction. * **Type:** boolean ### [`transaction`](https://docs.sentry.io/concepts/search/searchable-properties/spans.md#transaction) For [transactions](https://docs.sentry.io/product/dashboards/sentry-dashboards/transaction-summary.md#what-is-a-transaction), the name of the transaction. For errors, the name of the associated transaction. * **Type:** string ### [`transaction.event_id`](https://docs.sentry.io/concepts/search/searchable-properties/spans.md#transactionevent_id) The identifier of the transaction. * **Type:** UUID ### [`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) Short code identifying the [type of operation](https://develop.sentry.dev/sdk/performance/span-operations/) the span is measuring. * **Type:** string ### [`transaction.span_id`](https://docs.sentry.io/concepts/search/searchable-properties/spans.md#transactionspan_id) Span ID of the first span of the root transaction in the event. * **Type:** UUID ### [`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