Observability 说明文档

# Cloudflare 可观测性技能参考 **目的**：为在 Cloudflare Workers 中实现可观测性提供全面指导，涵盖追踪、日志、指标和分析。 **范围**：仅限 Cloudflare 可观测性功能 —— Workers 日志、追踪、分析引擎、Logpush、指标与分析以及 OpenTelemetry 导出。 --- ## 决策树：加载哪个文件？ 使用此树状图路由到正确的文件，无需加载全部内容： ├─ "如何启用/配置 X?" → configuration.md ├─ "X 的 API/方法/绑定是什么?" → api.md ├─ "如何实现 X 模式?" → patterns.md │ ├─ 使用量跟踪/计费 → patterns.md │ ├─ 错误跟踪 → patterns.md │ ├─ 性能监控 → patterns.md │ ├─ 多租户跟踪 → patterns.md │ ├─ Tail Worker 过滤 → patterns.md │ └─ OpenTelemetry 导出 → patterns.md └─ "为什么 X 不工作?" / "限制?" → gotchas.md ## 阅读顺序 根据任务按以下顺序加载文件： | 任务类型 | 加载顺序 | 原因 | |-----------|------------|--------| | **初始设置** | configuration.md → gotchas.md | 先设置，避免陷阱 | | **实现功能** | patterns.md → api.md → gotchas.md | 模式 → API 详情 → 边缘情况 | | **调试问题** | gotchas.md → configuration.md | 先排查常见问题 | | **查询数据** | api.md → patterns.md | API 语法 → 查询示例 | ## 产品概览 ### Workers 日志 - **内容：** 来自 Workers 的控制台输出 (console.log/warn/error) - **访问：** 仪表板（实时日志）、Logpush、Tail Workers - **成本：** 免费（包含在所有 Workers 中） - **保留期：** 仅实时（仪表板中无历史存储） ### Workers 追踪 - **内容：** 包含时间、CPU 使用率、结果的执行追踪 - **访问：** 仪表板（Workers Analytics → Traces）、Logpush - **成本：** $0.10/100万个 span（GA 定价于 2026 年 3 月 1 日生效），每月 1000 万个免费 - **保留期：** 包含 14 天 ### 分析引擎 - **内容：** 高基数事件存储和 SQL 查询 - **访问：** SQL API、仪表板（Analytics → Analytics Engine） - **成本：** 每月 1000 万次免费后，$0.25/100万次写入 - **保留期：** 90 天（可配置最长 1 年） ### Tail Workers - **内容：** 从其他 Workers 接收日志/追踪的 Workers - **用例：** 日志过滤、转换、外部导出 - **成本：** 标准 Workers 定价 ### Logpush - **内容：** 将日志流式传输到...