跳转到内容
搜索文档
↵选择
↑↓导航
ESC关闭

Span 与属性

最后更新 查看 MarkdownAgent 设置

Cloudflare Workers 提供开箱即用的自动追踪插桩——无需修改代码或 SDK。

当前支持的 span 与属性

所有 span 上可用的 attributes

  • cloud.provider - 始终设置为 cloudflare
  • cloud.platform - 始终设置为 cloudflare.workers
  • faas.name - Worker 的名称
  • faas.invocation_id - 此次 Worker 调用的唯一标识符
  • faas.version - Worker 的已部署版本标签
  • faas.invoked_region - Worker 被调用的区域
  • service.name - Worker 的名称
  • cloudflare.colo - 处理请求的 Cloudflare 数据中心的 IATA 三字机场代码（例如 SFO、LHR）
  • cloudflare.script_name - Worker 的名称
  • cloudflare.script_tags - 与 Worker 部署关联的标签
  • cloudflare.script_version.id - 已部署 Worker 的版本标识符
  • cloudflare.invocation.sequence.number - 添加到每个发出的 span 和日志的计数器，当时间戳相同时可用于区分哪个先发出
  • telemetry.sdk.language - 使用的编程语言，设置为 javascript
  • telemetry.sdk.name - 遥测 SDK 名称，设置为 cloudflare

所有根 span 上可用的 attributes

  • faas.trigger - 触发 Worker 调用的触发器（例如 http、cron、queue、email）
  • cloudflare.ray_id - 通过 Cloudflare 的每个请求的唯一标识符
  • cloudflare.handler_type - 处理请求的处理程序类型（例如 fetch、scheduled、queue、email、alarm）
  • cloudflare.entrypoint - Worker 中调用的入口点（例如 Durable Object 的名称）
  • cloudflare.execution_model - Worker 的执行模型（例如 Durable Objects 的 stateless、stateful）
  • cloudflare.outcome - Worker 调用的结果（例如 ok、exception、exceededCpu、exceededMemory）
  • cloudflare.cpu_time_ms - Worker 调用使用的 CPU 时间（毫秒）
  • cloudflare.wall_time_ms - Worker 调用使用的挂钟时间（毫秒）

Runtime API

fetch

  • network.protocol.name
  • network.protocol.version
  • url.full
  • url.scheme
  • url.path
  • url.query
  • server.port
  • server.address
  • user_agent.original
  • http.request.method
  • http.request.header.content-type
  • http.request.header.content-length
  • http.request.header.accept
  • http.request.header.accept-encoding
  • http.request.body.size
  • http.response.status_code
  • http.response.body.size

cache_put

  • cache.request.url
  • cache.request.method
  • cache.request.payload.status_code
  • cache.request.payload.header.cache_control
  • cache.request.payload.header.cache_tag
  • cache.request.payload.header.etag
  • cache.request.payload.header.expires
  • cache.request.payload.header.last_modified
  • cache.request.payload.size
  • cache.response.success

cache_match

  • cache.request.ignore_method
  • cache.request.url
  • cache.request.method
  • cache.request.header.range
  • cache.request.header.if_modified_since
  • cache.request.header.if_none_match
  • cache.response.status_code
  • cache.response.body.size
  • cache.response.cache_status
  • cache.response.success

cache_delete

  • cache.request.ignore_method
  • cache.request.url
  • cache.request.method
  • cache.response.status_code
  • cache.response.success

Handlers

Fetch Handler

  • cloudflare.verified_bot_category
  • cloudflare.asn
  • cloudflare.response.time_to_first_byte_ms
  • geo.timezone
  • geo.continent.code
  • geo.country.code
  • geo.locality.name
  • geo.locality.region
  • user_agent.original
  • user_agent.os.name
  • user_agent.os.version
  • user_agent.browser.name
  • user_agent.browser.major_version
  • user_agent.browser.version
  • user_agent.engine.name
  • user_agent.engine.version
  • user_agent.device.type
  • user_agent.device.vendor
  • user_agent.device.model
  • http.request.method
  • http.request.header.accept
  • http.request.header.accept-encoding
  • http.request.header.accept-language
  • url.full
  • url.path
  • network.protocol.name

Scheduled Handler

  • faas.cron
  • cloudflare.scheduled_time

QueueHandler

  • cloudflare.queue.name
  • cloudflare.queue.batch_size

RPC Handler

  • cloudflare.jsrpc.method

Email Handler

  • cloudflare.email.from
  • cloudflare.email.to
  • cloudflare.email.size

Tail Handler

  • cloudflare.trace.count

Alarm Handler

  • cloudflare.scheduled_time

D1

所有 D1 span 上可用的 attributes

  • db.system.name
  • db.operation.name
  • db.query.text
  • cloudflare.binding.type
  • cloudflare.d1.response.size_after
  • cloudflare.d1.response.rows_read
  • cloudflare.d1.response.rows_written
  • cloudflare.d1.response.last_row_id
  • cloudflare.d1.response.changed_db
  • cloudflare.d1.response.changes
  • cloudflare.d1.response.served_by_region
  • cloudflare.d1.response.served_by_primary
  • cloudflare.d1.response.sql_duration_ms
  • cloudflare.d1.response.total_attempts

d1_batch

  • db.operation.batch.size
  • cloudflare.d1.query.bookmark
  • cloudflare.d1.response.bookmark

d1_exec

d1_first

  • cloudflare.d1.query.bookmark
  • cloudflare.d1.response.bookmark

d1_run

  • cloudflare.d1.query.bookmark
  • cloudflare.d1.response.bookmark

d1_all

  • cloudflare.d1.query.bookmark
  • cloudflare.d1.response.bookmark

d1_raw

  • cloudflare.d1.query.bookmark
  • cloudflare.d1.response.bookmark

Browser Run

browser_rendering_fetch

Workers KV

所有 KV span 上可用的 attributes

  • db.system.name
  • db.operation.name
  • cloudflare.binding.name
  • cloudflare.binding.type

kv_get

  • cloudflare.kv.query.keys
  • cloudflare.kv.query.keys.count
  • cloudflare.kv.query.type
  • cloudflare.kv.query.cache_ttl
  • cloudflare.kv.response.size
  • cloudflare.kv.response.returned_rows
  • cloudflare.kv.response.metadata
  • cloudflare.kv.response.cache_status

kv_getWithMetadata

  • cloudflare.kv.query.keys
  • cloudflare.kv.query.keys.count
  • cloudflare.kv.query.type
  • cloudflare.kv.query.cache_ttl
  • cloudflare.kv.response.size
  • cloudflare.kv.response.returned_rows
  • cloudflare.kv.response.metadata
  • cloudflare.kv.response.cache_status

kv_put

  • cloudflare.kv.query.keys
  • cloudflare.kv.query.keys.count
  • cloudflare.kv.query.value_type
  • cloudflare.kv.query.expiration
  • cloudflare.kv.query.expiration_ttl
  • cloudflare.kv.query.metadata
  • cloudflare.kv.query.payload.size

kv_delete

  • cloudflare.kv.query.keys
  • cloudflare.kv.query.keys.colunt

kv_list

  • cloudflare.kv.query.prefix
  • cloudflare.kv.query.limit
  • cloudflare.kv.query.cursor
  • cloudflare.kv.response.size
  • cloudflare.kv.response.returned_rows
  • cloudflare.kv.response.list_complete
  • cloudflare.kv.response.cursor
  • cloudflare.kv.response.cache_status
  • cloudflare.kv.response.expiration

R2

所有 R2 span 上可用的 attributes

  • cloudflare.binding.type
  • cloudflare.binding.name
  • cloudflare.r2.bucket
  • cloudflare.r2.operation
  • cloudflare.r2.response.success
  • cloudflare.r2.error.message
  • cloudflare.r2.error.code

r2_head

  • cloudflare.r2.request.key
  • cloudflare.r2.response.etag
  • cloudflare.r2.response.size
  • cloudflare.r2.response.uploaded
  • cloudflare.r2.response.checksum.value
  • cloudflare.r2.response.checksum.type
  • cloudflare.r2.response.storage_class
  • cloudflare.r2.response.ssec_key
  • cloudflare.r2.response.content_type
  • cloudflare.r2.response.content_encoding
  • cloudflare.r2.response.content_disposition
  • cloudflare.r2.response.content_language
  • cloudflare.r2.response.cache_control
  • cloudflare.r2.response.cache_expiry
  • cloudflare.r2.response.custom_metadata

r2_get

  • cloudflare.r2.request.key
  • cloudflare.r2.request.range.offset
  • cloudflare.r2.request.range.length
  • cloudflare.r2.request.range.suffix
  • cloudflare.r2.request.range
  • cloudflare.r2.request.ssec_key
  • cloudflare.r2.request.only_if.etag_matches
  • cloudflare.r2.request.only_if.etag_does_not_match
  • cloudflare.r2.request.only_if.uploaded_before
  • cloudflare.r2.request.only_if.uploaded_after
  • cloudflare.r2.response.etag
  • cloudflare.r2.response.size
  • cloudflare.r2.response.uploaded
  • cloudflare.r2.response.checksum.value
  • cloudflare.r2.response.checksum.type
  • cloudflare.r2.response.storage_class
  • cloudflare.r2.response.ssec_key
  • cloudflare.r2.response.content_type
  • cloudflare.r2.response.content_encoding
  • cloudflare.r2.response.content_disposition
  • cloudflare.r2.response.content_language
  • cloudflare.r2.response.cache_control
  • cloudflare.r2.response.cache_expiry
  • cloudflare.r2.response.custom_metadata

r2_put

  • cloudflare.r2.request.key
  • cloudflare.r2.request.size
  • cloudflare.r2.request.checksum.type
  • cloudflare.r2.request.checksum.value
  • cloudflare.r2.request.custom_metadata
  • cloudflare.r2.request.http_metadata.content_type
  • cloudflare.r2.request.http_metadata.content_encoding
  • cloudflare.r2.request.http_metadata.content_disposition
  • cloudflare.r2.request.http_metadata.content_language
  • cloudflare.r2.request.http_metadata.cache_control
  • cloudflare.r2.request.http_metadata.cache_expiry
  • cloudflare.r2.request.storage_class
  • cloudflare.r2.request.ssec_key
  • cloudflare.r2.request.only_if.etag_matches
  • cloudflare.r2.request.only_if.etag_does_not_match
  • cloudflare.r2.request.only_if.uploaded_before
  • cloudflare.r2.request.only_if.uploaded_after
  • cloudflare.r2.response.etag
  • cloudflare.r2.response.size
  • cloudflare.r2.response.uploaded
  • cloudflare.r2.response.checksum.value
  • cloudflare.r2.response.checksum.type
  • cloudflare.r2.response.storage_class
  • cloudflare.r2.response.ssec_key
  • cloudflare.r2.response.content_type
  • cloudflare.r2.response.content_encoding
  • cloudflare.r2.response.content_disposition
  • cloudflare.r2.response.content_language
  • cloudflare.r2.response.cache_control
  • cloudflare.r2.response.cache_expiry
  • cloudflare.r2.response.custom_metadata

r2_list

  • cloudflare.r2.request.limit
  • cloudflare.r2.request.prefix
  • cloudflare.r2.request.cursor
  • cloudflare.r2.request.delimiter
  • cloudflare.r2.request.start_after
  • cloudflare.r2.request.include.http_metadata
  • cloudflare.r2.request.include.custom_metadata
  • cloudflare.r2.response.returned_objects
  • cloudflare.r2.response.delimited_prefixes
  • cloudflare.r2.response.truncated
  • cloudflare.r2.response.cursor

r2_delete

  • cloudflare.r2.request.keys

r2_createMultipartUpload

  • cloudflare.r2.request.key
  • cloudflare.r2.request.custom_metadata
  • cloudflare.r2.request.http_metadata.content_type
  • cloudflare.r2.request.http_metadata.content_encoding
  • cloudflare.r2.request.http_metadata.content_disposition
  • cloudflare.r2.request.http_metadata.content_language
  • cloudflare.r2.request.http_metadata.cache_control
  • cloudflare.r2.request.http_metadata.cache_expiry
  • cloudflare.r2.request.storage_class
  • cloudflare.r2.request.ssec_key
  • cloudflare.r2.response.upload_id

r2_uploadPart

  • cloudflare.r2.request.key
  • cloudflare.r2.request.upload_id
  • cloudflare.r2.request.part_number
  • cloudflare.r2.request.ssec_key
  • cloudflare.r2.request.size
  • cloudflare.r2.response.etag

r2_abortMultipartUpload

  • cloudflare.r2.request.key
  • cloudflare.r2.request.upload_id

r2_completeMultipartUpload

  • cloudflare.r2.request.key
  • cloudflare.r2.request.upload_id
  • cloudflare.r2.request.uploaded_parts
  • cloudflare.r2.response.etag
  • cloudflare.r2.response.size
  • cloudflare.r2.response.uploaded
  • cloudflare.r2.response.checksum.value
  • cloudflare.r2.response.checksum.type
  • cloudflare.r2.response.storage_class
  • cloudflare.r2.response.ssec_key
  • cloudflare.r2.response.content_type
  • cloudflare.r2.response.content_encoding
  • cloudflare.r2.response.content_disposition
  • cloudflare.r2.response.content_language
  • cloudflare.r2.response.cache_control
  • cloudflare.r2.response.cache_expiry
  • cloudflare.r2.response.custom_metadata

Durable Object API

durable_object_subrequest

Durable Object Storage SQL API

SQL API 允许您修改 Durable Object 内嵌的 SQLite 数据库。

durable_object_storage_exec

  • db.system.name
  • db.operation.name
  • db.query.text
  • cloudflare.durable_object.query.bindings
  • cloudflare.durable_object.response.rows_read
  • cloudflare.durable_object.response.rows_written

durable_object_storage_getDatabaseSize

  • db.operation.name
  • cloudflare.durable_object.response.db_size

durable_object_storage_kv_get

  • cloudflare.durable_object.kv.query.keys
  • cloudflare.durable_object.kv.query.keys.count

durable_object_storage_kv_put

  • cloudflare.durable_object.kv.query.keys
  • cloudflare.durable_object.kv.query.keys.count

durable_object_storage_kv_delete

  • cloudflare.durable_object.kv.query.keys
  • cloudflare.durable_object.kv.query.keys.count
  • cloudflare.durable_object.kv.response.deleted_count

durable_object_storage_kv_list

  • cloudflare.durable_object.kv.query.start
  • cloudflare.durable_object.kv.query.startAfter
  • cloudflare.durable_object.kv.query.end
  • cloudflare.durable_object.kv.query.prefix
  • cloudflare.durable_object.kv.query.reverse
  • cloudflare.durable_object.kv.query.limit

Durable Object Storage KV API

旧版 KV 支持的 API 允许您修改 Durable Object 内嵌存储。

durable_object_storage_get

durable_object_storage_put

durable_object_storage_delete

durable_object_storage_list

durable_object_storage_deleteAll

Durable Object Storage Alarms API

durable_object_alarms_getAlarm

durable_object_alarms_setAlarm

durable_object_alarms_deleteAlarm

Images

images_output

  • cloudflare.binding.type
  • cloudflare.images.options.format
  • cloudflare.images.options.quality
  • cloudflare.images.options.background
  • cloudflare.images.options.anim
  • cloudflare.images.options.transforms
  • cloudflare.images.error.code

images_info

  • cloudflare.binding.type
  • cloudflare.images.options.encoding
  • cloudflare.images.result.format
  • cloudflare.images.result.file_size
  • cloudflare.images.result.width
  • cloudflare.images.result.height
  • cloudflare.images.error.code

Email

reply_email

forward_email

send_email

Queues

queue_send

queue_sendBatch

Rate limiting

ratelimit_run

这篇文档对您有帮助吗？