← Workers / workers / observability / traces
Spans and attributes
Cloudflare Workers provides automatic tracing instrumentation out of the box - no code changes or SDK are required.
Currently supported spans and attributes
Attributes available on all spans
cloud.provider- Always set tocloudflarecloud.platform- Always set tocloudflare.workersfaas.name- The name of your Workerfaas.invocation_id- A unique identifier for this specific Worker invocationfaas.version- The deployed version tag of your Workerfaas.invoked_region- The region where the Worker was invokedservice.name- The name of your Workercloudflare.colo- The three-letter IATA airport code of the Cloudflare data center that processed the request (e.g.,SFO,LHR)cloudflare.script_name- The name of your Workercloudflare.script_tags- Tags associated with your Worker deploymentcloudflare.script_version.id- The version identifier of your deployed Workercloudflare.invocation.sequence.number- A counter added to every emitted span and log that can be used to distinguish which was emitted first when the timestamps are the sametelemetry.sdk.language- The programming language used, set tojavascripttelemetry.sdk.name- The telemetry SDK name, set tocloudflare
Attributes available on all root spans
faas.trigger- The trigger that your Worker was invoked by (e.g.,http,cron,queue,email)cloudflare.ray_id- A unique identifier for every request that goes through Cloudflarecloudflare.handler_type- The type of handler that processed the request (e.g.,fetch,scheduled,queue,email,alarm)cloudflare.entrypoint- The entrypoint that was invoked in your Worker (e.g. the name of your Durable Object)cloudflare.execution_model- The execution model of the Worker (e.g.,stateless,statefulfor Durable Objects)cloudflare.outcome- The outcome of the Worker invocation (e.g.,ok,exception,exceededCpu,exceededMemory)cloudflare.cpu_time_ms- The CPU time used by the Worker invocation, in millisecondscloudflare.wall_time_ms- The wall time used by the Worker invocation, in milliseconds
network.protocol.namenetwork.protocol.versionurl.fullurl.schemeurl.pathurl.queryserver.portserver.addressuser_agent.originalhttp.request.methodhttp.request.header.content-typehttp.request.header.content-lengthhttp.request.header.accepthttp.request.header.accept-encodinghttp.request.body.sizehttp.response.status_codehttp.response.body.size
cache.request.urlcache.request.methodcache.request.payload.status_codecache.request.payload.header.cache_controlcache.request.payload.header.cache_tagcache.request.payload.header.etagcache.request.payload.header.expirescache.request.payload.header.last_modifiedcache.request.payload.sizecache.response.success
cache.request.ignore_methodcache.request.urlcache.request.methodcache.request.header.rangecache.request.header.if_modified_sincecache.request.header.if_none_matchcache.response.status_codecache.response.body.sizecache.response.cache_statuscache.response.success
cache.request.ignore_methodcache.request.urlcache.request.methodcache.response.status_codecache.response.success
cloudflare.verified_bot_categorycloudflare.asncloudflare.response.time_to_first_byte_msgeo.timezonegeo.continent.codegeo.country.codegeo.locality.namegeo.locality.regionuser_agent.originaluser_agent.os.nameuser_agent.os.versionuser_agent.browser.nameuser_agent.browser.major_versionuser_agent.browser.versionuser_agent.engine.nameuser_agent.engine.versionuser_agent.device.typeuser_agent.device.vendoruser_agent.device.modelhttp.request.methodhttp.request.header.accepthttp.request.header.accept-encodinghttp.request.header.accept-languageurl.fullurl.pathnetwork.protocol.name
faas.croncloudflare.scheduled_time
cloudflare.queue.namecloudflare.queue.batch_size
cloudflare.jsrpc.method
cloudflare.email.fromcloudflare.email.tocloudflare.email.size
cloudflare.trace.count
cloudflare.scheduled_time
Attributes available on all D1 spans
db.system.namedb.operation.namedb.query.textcloudflare.binding.typecloudflare.d1.response.size_aftercloudflare.d1.response.rows_readcloudflare.d1.response.rows_writtencloudflare.d1.response.last_row_idcloudflare.d1.response.changed_dbcloudflare.d1.response.changescloudflare.d1.response.served_by_regioncloudflare.d1.response.served_by_primarycloudflare.d1.response.sql_duration_mscloudflare.d1.response.total_attempts
db.operation.batch.sizecloudflare.d1.query.bookmarkcloudflare.d1.response.bookmark
cloudflare.d1.query.bookmarkcloudflare.d1.response.bookmark
cloudflare.d1.query.bookmarkcloudflare.d1.response.bookmark
cloudflare.d1.query.bookmarkcloudflare.d1.response.bookmark
cloudflare.d1.query.bookmarkcloudflare.d1.response.bookmark
browser_rendering_fetch
Attributes available on all KV spans
db.system.namedb.operation.namecloudflare.binding.namecloudflare.binding.type
cloudflare.kv.query.keyscloudflare.kv.query.keys.countcloudflare.kv.query.typecloudflare.kv.query.cache_ttlcloudflare.kv.response.sizecloudflare.kv.response.returned_rowscloudflare.kv.response.metadatacloudflare.kv.response.cache_status
cloudflare.kv.query.keyscloudflare.kv.query.keys.countcloudflare.kv.query.typecloudflare.kv.query.cache_ttlcloudflare.kv.response.sizecloudflare.kv.response.returned_rowscloudflare.kv.response.metadatacloudflare.kv.response.cache_status
cloudflare.kv.query.keyscloudflare.kv.query.keys.countcloudflare.kv.query.value_typecloudflare.kv.query.expirationcloudflare.kv.query.expiration_ttlcloudflare.kv.query.metadatacloudflare.kv.query.payload.size
cloudflare.kv.query.keyscloudflare.kv.query.keys.colunt
cloudflare.kv.query.prefixcloudflare.kv.query.limitcloudflare.kv.query.cursorcloudflare.kv.response.sizecloudflare.kv.response.returned_rowscloudflare.kv.response.list_completecloudflare.kv.response.cursorcloudflare.kv.response.cache_statuscloudflare.kv.response.expiration
Attributes available on all R2 spans
cloudflare.binding.typecloudflare.binding.namecloudflare.r2.bucketcloudflare.r2.operationcloudflare.r2.response.successcloudflare.r2.error.messagecloudflare.r2.error.code
cloudflare.r2.request.keycloudflare.r2.response.etagcloudflare.r2.response.sizecloudflare.r2.response.uploadedcloudflare.r2.response.checksum.valuecloudflare.r2.response.checksum.typecloudflare.r2.response.storage_classcloudflare.r2.response.ssec_keycloudflare.r2.response.content_typecloudflare.r2.response.content_encodingcloudflare.r2.response.content_dispositioncloudflare.r2.response.content_languagecloudflare.r2.response.cache_controlcloudflare.r2.response.cache_expirycloudflare.r2.response.custom_metadata
cloudflare.r2.request.keycloudflare.r2.request.range.offsetcloudflare.r2.request.range.lengthcloudflare.r2.request.range.suffixcloudflare.r2.request.rangecloudflare.r2.request.ssec_keycloudflare.r2.request.only_if.etag_matchescloudflare.r2.request.only_if.etag_does_not_matchcloudflare.r2.request.only_if.uploaded_beforecloudflare.r2.request.only_if.uploaded_aftercloudflare.r2.response.etagcloudflare.r2.response.sizecloudflare.r2.response.uploadedcloudflare.r2.response.checksum.valuecloudflare.r2.response.checksum.typecloudflare.r2.response.storage_classcloudflare.r2.response.ssec_keycloudflare.r2.response.content_typecloudflare.r2.response.content_encodingcloudflare.r2.response.content_dispositioncloudflare.r2.response.content_languagecloudflare.r2.response.cache_controlcloudflare.r2.response.cache_expirycloudflare.r2.response.custom_metadata
cloudflare.r2.request.keycloudflare.r2.request.sizecloudflare.r2.request.checksum.typecloudflare.r2.request.checksum.valuecloudflare.r2.request.custom_metadatacloudflare.r2.request.http_metadata.content_typecloudflare.r2.request.http_metadata.content_encodingcloudflare.r2.request.http_metadata.content_dispositioncloudflare.r2.request.http_metadata.content_languagecloudflare.r2.request.http_metadata.cache_controlcloudflare.r2.request.http_metadata.cache_expirycloudflare.r2.request.storage_classcloudflare.r2.request.ssec_keycloudflare.r2.request.only_if.etag_matchescloudflare.r2.request.only_if.etag_does_not_matchcloudflare.r2.request.only_if.uploaded_beforecloudflare.r2.request.only_if.uploaded_aftercloudflare.r2.response.etagcloudflare.r2.response.sizecloudflare.r2.response.uploadedcloudflare.r2.response.checksum.valuecloudflare.r2.response.checksum.typecloudflare.r2.response.storage_classcloudflare.r2.response.ssec_keycloudflare.r2.response.content_typecloudflare.r2.response.content_encodingcloudflare.r2.response.content_dispositioncloudflare.r2.response.content_languagecloudflare.r2.response.cache_controlcloudflare.r2.response.cache_expirycloudflare.r2.response.custom_metadata
cloudflare.r2.request.limitcloudflare.r2.request.prefixcloudflare.r2.request.cursorcloudflare.r2.request.delimitercloudflare.r2.request.start_aftercloudflare.r2.request.include.http_metadatacloudflare.r2.request.include.custom_metadatacloudflare.r2.response.returned_objectscloudflare.r2.response.delimited_prefixescloudflare.r2.response.truncatedcloudflare.r2.response.cursor
cloudflare.r2.request.keys
cloudflare.r2.request.keycloudflare.r2.request.custom_metadatacloudflare.r2.request.http_metadata.content_typecloudflare.r2.request.http_metadata.content_encodingcloudflare.r2.request.http_metadata.content_dispositioncloudflare.r2.request.http_metadata.content_languagecloudflare.r2.request.http_metadata.cache_controlcloudflare.r2.request.http_metadata.cache_expirycloudflare.r2.request.storage_classcloudflare.r2.request.ssec_keycloudflare.r2.response.upload_id
cloudflare.r2.request.keycloudflare.r2.request.upload_idcloudflare.r2.request.part_numbercloudflare.r2.request.ssec_keycloudflare.r2.request.sizecloudflare.r2.response.etag
cloudflare.r2.request.keycloudflare.r2.request.upload_id
cloudflare.r2.request.keycloudflare.r2.request.upload_idcloudflare.r2.request.uploaded_partscloudflare.r2.response.etagcloudflare.r2.response.sizecloudflare.r2.response.uploadedcloudflare.r2.response.checksum.valuecloudflare.r2.response.checksum.typecloudflare.r2.response.storage_classcloudflare.r2.response.ssec_keycloudflare.r2.response.content_typecloudflare.r2.response.content_encodingcloudflare.r2.response.content_dispositioncloudflare.r2.response.content_languagecloudflare.r2.response.cache_controlcloudflare.r2.response.cache_expirycloudflare.r2.response.custom_metadata
durable_object_subrequest
The SQL API allow you to modify the SQLite database embedded within a Durable Object.
db.system.namedb.operation.namedb.query.textcloudflare.durable_object.query.bindingscloudflare.durable_object.response.rows_readcloudflare.durable_object.response.rows_written
db.operation.namecloudflare.durable_object.response.db_size
cloudflare.durable_object.kv.query.keyscloudflare.durable_object.kv.query.keys.count
cloudflare.durable_object.kv.query.keyscloudflare.durable_object.kv.query.keys.count
cloudflare.durable_object.kv.query.keyscloudflare.durable_object.kv.query.keys.countcloudflare.durable_object.kv.response.deleted_count
cloudflare.durable_object.kv.query.startcloudflare.durable_object.kv.query.startAftercloudflare.durable_object.kv.query.endcloudflare.durable_object.kv.query.prefixcloudflare.durable_object.kv.query.reversecloudflare.durable_object.kv.query.limit
The legacy KV-backed API allows you to modify embedded storage within a Durable Object.
cloudflare.binding.typecloudflare.images.options.formatcloudflare.images.options.qualitycloudflare.images.options.backgroundcloudflare.images.options.animcloudflare.images.options.transformscloudflare.images.error.code
cloudflare.binding.typecloudflare.images.options.encodingcloudflare.images.result.formatcloudflare.images.result.file_sizecloudflare.images.result.widthcloudflare.images.result.heightcloudflare.images.error.code