Span Operations

Span operations are a short code identifying the type of operation the span is measuring. Span operations are low cardinality attributes - they should be as general as possible while still being human readable and useful.

Operations are expected to follow OpenTelemetry's semantic conventions as much as possible.

Below is a table containing a list of span operations that are recommended to be used.

Operations are expected to generally take the form: CATEGORY.ACTION, where the categories and actions can have optional identifiers. For example, a redis database operation takes the form db.sql.query, where db is the category, sql is the category identifier, and query is the action. Another example is a mobile app rendering it's screen. It would have the operation ui.load.hot, where ui is the category, load is the action, and hot is the action identifier.

It's important to keep categories consistent between sdks and integrations as they are used by Sentry in the Operations Breakdown feature. For example, both db.init and db.query will be categorized as database operations. The default operations breakdown config can be seen here.

Having both a category and action is recommended. Operations should be lowercased.

List of Operations

Browser

OpUsageDescription
pageloadA full page load of a web application
navigationClient-side browser history change in a web application
resourceResource as per Performance Resource Timing
resource.script
resource.link
resource.css
resource.img
browserUsage of browser APIs or functionality
browser.paint
markUsage of performance.mark() API
measureUsage of performance.measure() API
user
animate

JS Frameworks

OpUsageDescription
reactSpans related to React
react.mount
react.render
vue
vue.mount
vue.update
angular
ember

Web Server

OpUsageDescription
http
http.client
http.server
rpc
grpc
template
template.init
template.parse
template.render
view
view.render
serialize

Web Frameworks

OpUsageDescription
django
django.middleware
django.view
express
rails
rack
console

Database

OpUsageDescription
dbAn operation on a database
db.connection
db.transaction
db.sql.query
db.query
db.query.compile

Serverless (FAAS)

OpUsageDescription
aws
aws.lambda
aws.request
gcp

Mobile

OpUsageDescription
appData about the mobile app
app.start
uiAn operation on a mobile/desktop UI
ui.load
ui.action
navigationNavigating to another screen
fileOperations on the file system
file.read
file.write

Messages/Queues

OpUsageDescription
topic
topic.send
topic.recieve
topic.process
queue
queue.process
job
job.exec
celery
You can edit this page on GitHub.