Span Operation Documentation
This page lists known span operations. The operation is a low-cardinality string that describes
the category of work a span represents, and is stored in the sentry.op attribute.
Choosing an Operation
Operations are grouped by category (for example database or browser).
Within a category, more specific operations use a dotted hierarchy such as
ui.react.render, where each segment narrows down the kind of work being measured.
Use the most specific operation that accurately describes the span. When no specific operation fits, fall back to the closest broader operation in the same category.
Example
A span measuring a database query sets:
sentry.op = "db.query"
general
2 operations| Operation | Description |
|---|---|
mark | A general point-in-time span indicating an event |
function | The time it took for a set of instructions to execute |
browser
27 operations| Operation | Description |
|---|---|
pageload | A full page load of a web application. |
navigation | Client-side browser history change in a web application. |
resource | Resource as per Performance Resource Timing. Defaults to resource.other if resource cannot be indentified. |
resource.script | — |
resource.link | — |
resource.img | — |
resource.css | — |
resource.audio | — |
resource.video | — |
resource.iframe | — |
resource.other | — |
browser | Usage of browser APIs or functionality |
browser.paint | — |
ui | Operations related to browser UI |
ui.task | A task that is taken on the main UI thread. Typically used to indicate to users about things like the Long Tasks API. |
ui.render | — |
ui.action | — |
ui.action.click | — |
ui.react | — |
ui.react.mount | — |
ui.react.render | — |
ui.react.update | — |
ui.vue | — |
ui.svelte | — |
ui.angular | — |
ui.ember | — |
ui.livewire | — |
database
6 operationsDatabase related spans are expected to follow OpenTelemetry's Database semantic conventions when possible.
| Operation | Description |
|---|---|
db | — |
db.query | — |
cache | — |
cache.get | — |
cache.put | — |
cache.remove | — |
faas
5 operationsServerless (FAAS)
| Operation | Description |
|---|---|
http | — |
grpc | — |
function.gcp | — |
function.aws | — |
function.azure | — |
gen_ai
4 operationsOperations related to Generative AI interactions
| Operation | Description |
|---|---|
chat | A chat interaction with a generative AI model |
execute_tool | Execution of a tool or function by a generative AI model |
handoff | Handoff of control between different AI agents or components |
invoke_agent | Invocation of an AI agent to perform a task |
messaging
14 operationsMessaging related spans represent operations on topics in streaming data systems and queues, such as producing and consuming messages in Kafka, RabbitMQ.
| Operation | Description |
|---|---|
queue | A general queue operation. |
queue.publish | Publishing a message to a queue. |
queue.create | Creating a queue or a message for later publishing. |
queue.receive | Receiving a message from a queue. |
queue.process | Processing a message from a queue. |
queue.settle | Settling a message, e.g. acknowledging or rejecting it. |
queue.submit.arq | Publishing a message to an arq queue. |
queue.task.arq | Processing a message from an arq queue. |
queue.submit.celery | Publishing a message to a Celery broker. |
queue.task.celery | Processing a message from a Celery queue. |
queue.task.dramatiq | Processing a message from a Dramatiq queue. |
queue.submit.huey | Publishing a message to a Huey instance. |
queue.task.huey | Processing a message from a Huey instance. |
queue.task.rq | Processing a message from an RQ queue. |
mobile
6 operations| Operation | Description |
|---|---|
app | — |
ui | — |
navigation | — |
file | — |
serialize | — |
http | — |
web_server
18 operations| Operation | Description |
|---|---|
http | A general point-in-time span indicating an event |
http.client | — |
http.server | — |
websocket | — |
rpc | — |
grpc | — |
graphql | — |
subprocess | — |
middleware | — |
view | — |
template | — |
function | — |
function.remix | — |
function.nextjs | — |
serialize | — |
console | — |
file | — |
app | — |