跳转到内容
搜索文档

已知限制

最后更新 查看 MarkdownAgent 设置

Workers 追踪功能目前处于公开 Beta 测试阶段。本页面记录了当前的限制以及我们路线图上的即将推出的功能。

要提供更多反馈并发送功能需求,请前往 Workers 追踪 GitHub 讨论区 ↗。

非 I/O 操作可能报告 0 ms 的时间

由于为了防范 Spectre 攻击而实施的安全措施,Workers 运行时在发生 I/O 事件之前不会更新时间。这意味着某些跨度 (span) 即使操作花费了更长时间,也会返回 0 ms 的长度。

Cloudflare Workers 团队正在探索在这些情况下能够以毫秒级粒度公开时间长度的安全措施。

追踪上下文传播到外部服务

在将 Trace 导出到外部平台时,Trace ID 不会传播到 Cloudflare 外部的服务。这意味着来自你 Workers 的 Trace 将不会与可观测性工具中非 Cloudflare 服务的 Trace 关联链接。

我们正在研究使用 W3C Trace Context 标准 ↗ 进行自动 Trace 上下文传播,这将使跨你现有工具和服务的完整端到端可见性成为可能。

跨度属性不完整

我们计划为每个 Span 添加更详细的属性。你可以在此查阅已插桩内容的完整列表。

你对任何缺失信息的反馈将帮助我们优先安排添加和更改。如果特定属性有助于有效使用追踪,请在 Workers 追踪 GitHub 讨论区 ↗上发表评论。

跨度和属性名称可能会发生更改

由于 Workers 追踪目前处于 Beta 阶段,Span 名称和 Attribute 名称尚未最终确定。我们可能会在 Beta 期间精炼这些名称,以提高清晰度并与 OpenTelemetry 语义规范保持一致。我们建议定期审查 Span 和 Attribute 文档以获取更新。

已知 Bug 和其他注意事项

  • 目前有一些属性仅适用于某些 Span(例如 service.name、faas.name)。当跨 Trace 和 Log 按 Worker 名称进行过滤或分组时,请改用 $metadata.service,因为它将在所有事件类型中保持一致地应用。
  • 当 Trace 正在进行中时,事件将在根 Span 上显示 Trace in Progress。请稍等片刻以待完整的 Trace 变得可用。

这篇文档对您有帮助吗?