Skip to content

非公式本サイトは非公式の日本語ドキュメントであり、Cloudflare 公式サイトではありません。最新情報はdevelopers.cloudflare.comをご確認ください。

スパンと属性

最終更新 Markdown で表示Agent セットアップ

Cloudflare Workers は、コード変更や SDK なしで、すぐに使える自動トレーシング計測を提供します。

現在サポートされるスパンと属性

すべてのスパンで利用できる属性

  • 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 データセンターの 3 文字 IATA 空港コード（例: SFO、LHR）
  • cloudflare.script_name - Worker の名前
  • cloudflare.script_tags - Worker デプロイに関連するタグ
  • cloudflare.script_version.id - デプロイ済み Worker のバージョン識別子
  • cloudflare.durable_object.id - Durable Object インスタンス ID。Durable Object 呼び出しのルートスパンと子スパンに設定されます
  • cloudflare.invocation.sequence.number - 出力されるすべてのスパンとログに付くカウンター。タイムスタンプが同じときにどちらが先に出力されたかを区別できます
  • telemetry.sdk.language - 使用言語。javascript に設定されます
  • telemetry.sdk.name - テレメトリ SDK 名。cloudflare に設定されます

すべてのルートスパンで利用できる属性

  • 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

  • jsrpc.method

Email Handler

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

Tail Handler

  • cloudflare.trace.count

Alarm Handler

  • cloudflare.scheduled_time

RPC

Workers トレーシングは、Workers 間、および Workers から Durable Objects への RPC 呼び出しに対して、これらのスパンを出力します。

RPC セッション

RPC セッションの寿命をカバーする、呼び出し側のスパンです。セッションを再利用する呼び出しは、このスパンの下に現れます。

このスパンに追加の RPC 固有属性はありません。

RPC 呼び出し（受信側）

対象の Worker または Durable Object 内の RPC 呼び出しをカバーする、受信側のスパンです。

RPC コール

個別のメソッド呼び出しまたはプロパティアクセスに対する、呼び出し側または受信側のスパンです。

呼び出し側と受信側のスパンは、それらが動く Worker または Durable Object の実行カラーを使います。色の変化が実行境界を示します。

  • jsrpc.method - メソッド名またはプロパティパス
  • jsrpc.operation - 操作の種類: call または getProperty
  • jsrpc.target_kind - RPC ターゲットの種類
  • jsrpc.caller_span_id - 受信側スパンで、対応する呼び出し側の jsRpcCall スパン ID

D1

すべての D1 スパンで利用できる属性

  • 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 スパンで利用できる属性

  • 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 スパンで利用できる属性

  • 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

役に立ちましたか？