用途
本技能面向 Cloudflare Workers 的生产级可观测性建设，覆盖日志（logging）、指标（metrics）、追踪（tracing）与告警（alerting）四个方面。适用于对 Workers 应用进行监控、调试、追踪，或在遇到日志缺失、日志截断、指标写入失败、告警缺口等问题时参考。
主要能力
技能围绕以下可观测性组件展开，并说明各自用途与使用时机：
console.log：基础日志，用于开发与调试。- Tail Workers：实时日志流，用于生产日志聚合。
- Analytics Engine：自定义指标与分析，用于业务指标与性能跟踪。
- Logpush：将日志导出到外部服务，用于长期存储与合规。
- Workers Trace Events：分布式追踪，用于请求链路调试。
技能还提供结构化日志模式（含日志级别、请求上下文、时间戳与自定义字段）、日志脱敏（对 password、token、secret、authorization、cookie 等敏感字段替换为 [REDACTED]）、Analytics Engine 数据点写入（blobs、doubles、indexes）、Tail Worker 事件处理与转发等代码示例。
使用方式
技能给出 wrangler.jsonc 配置示例，包含 observability（enabled、head_sampling_rate）、tail_consumers（service、environment）与 analytics_engine_datasets（binding、dataset）等字段。
按任务加载对应参考文档：
- 设置日志 → references/logging.md（结构化日志模式、日志级别、脱敏）
- 构建自定义指标 → references/analytics-engine.md（Analytics Engine SQL 查询、数据建模）
- 实现日志聚合 → references/tail-workers.md（Tail Worker 模式、外部服务集成）
- 创建仪表盘/跟踪 → references/custom-metrics.md（业务指标、性能跟踪）
- 设置告警 → references/alerting.md（错误率监控、PagerDuty/Slack 集成）
模板：templates/logging-setup.ts（生产日志类）、templates/analytics-worker.ts（Analytics Engine 集成）、templates/tail-worker.ts（完整 Tail Worker）。
脚本：scripts/setup-logging.sh（配置日志设置）、scripts/analyze-logs.sh（查询与分析日志，如 ./analyze-logs.sh --errors --last 1h）。
关键规则
- 始终使用结构化 JSON 日志，纯文本日志难以解析与聚合。
- 每条日志包含请求上下文（请求 ID、方法、路径）。
- 绝不记录敏感数据，需从日志中脱敏令牌、密码与 PII。
- 使用合适的日志级别：ERROR 用于失败，WARN 用于可恢复问题，INFO 用于操作记录。
- 对高频日志采样，生产环境请求日志可使用 1-10% 采样。
常见错误预防
技能列出 8 类常见错误及预防方式：日志不出现（在 wrangler.jsonc 启用 Standard 日志）、日志截断（大负载分块、采样）、Tail Worker 未接收（检查绑定名与 wrangler.jsonc 一致）、Analytics Engine 写入失败（验证 AE 绑定与 blobs 格式）、日志含 PII（实现脱敏中间件）、缺少请求上下文（为所有日志添加 requestId）、日志量爆炸（对高频事件采样）、告警缺口（为错误率阈值配置监控）。
适用场景与限制
适用于 Cloudflare Workers 的日志、指标、追踪与告警配置与排障。技能内容以代码示例、配置片段与参考文档为主，具体平台行为、计费与配额以 Cloudflare 官方文档为准；本资料未提供价格、收费与具体平台限制信息。相关资源链接：Workers Observability、Analytics Engine、Tail Workers、Logpush（见官方文档）。