为每个域名分别配置 Cloudflare Traces。选择要跟踪的请求数量、保存或发送跟踪的位置,以及是否将它们与其他系统的跟踪关联。
要通过 API 管理 trace 规则和设置,请创建具有 Zone Observability 权限且作用域限定为相关 zone 的 API token:
- Zone Observability Read — 读取 trace 规则和设置
- Zone Observability Edit — 更新或删除 trace 规则和设置
有关完整的 endpoint 文档,请参阅 API 参考。
Default sample rate (%)(默认采样率) 设置 Cloudflare 跟踪的请求比例。例如,10% 的采样率大约会跟踪每 100 个请求中的 10 个。跟踪规则可以对匹配规则的请求使用不同的采样率。
Cloudflare 在请求到达时做出采样决策。一旦请求被选中进行跟踪,Cloudflare 会捕获完整请求路径。启用跟踪不会带来开销。
跟踪规则会覆盖匹配请求的默认采样率。Cloudflare 使用第一条匹配的规则,因此规则顺序很重要。
选择 Custom filter expression(自定义过滤表达式) 以匹配选定请求,或选择 All incoming requests(所有传入请求) 将该规则应用于每个请求。可使用字段、运算符和值构建自定义过滤器,或选择 Edit expression(编辑表达式),用 Cloudflare Rules 语言 编写。
将 Sample rate (%)(采样率) 设置为要跟踪的匹配请求百分比。选择 Save as Draft(保存为草稿) 可让规则保持未启用,或选择 Deploy(部署) 开始使用。
开启 Persist to Cloudflare(持久化到 Cloudflare),即可在 Cloudflare 中保存跟踪并在仪表板中查看。
使用 Export destinations(导出目标) 将跟踪发送到已配置的账户级 OpenTelemetry 目标。要创建目标或配置提供商,请参阅 OpenTelemetry 导出。
你可以同时保存并导出相同的跟踪。如果只希望在外部工具中查看跟踪,请关闭 Persist to Cloudflare(持久化到 Cloudflare)。
跟踪上下文携带标识符,可将不同系统中的 span 连接到同一条跟踪。Cloudflare 使用 W3C Trace Context ↗,将其 span 连接到请求路径中 Cloudflare 之前或之后的服务。你可以分别配置传入和传出传播。
使用 Incoming trace context(传入跟踪上下文) 选择 Cloudflare 是否接受传入请求中包含的跟踪上下文。默认设置为 Reject,即忽略传入上下文,因此 Cloudflare 不会加入调用方的跟踪。
开启 Forward to origin(转发到源站),即可在 Cloudflare 发送到源站的请求中包含跟踪上下文。已插桩的源站可使用该上下文,将自己的 span 添加到同一条跟踪。转发上下文本身不会对源站进行插桩,也不会创建源站 span。
要在第三方可观测性工具中将 Cloudflare 和源站的 span 查看为同一条跟踪,请将两组 span 发送到同一个 OpenTelemetry 目标。