技能介绍

为什么分析健康值得单独监控

Cloudflare 区域通常承载着较高的请求量，团队习惯用缓存命中率和 WAF 事件来判断流量质量。但当请求速率异常飙升、缓存命中率骤降或 WAF 事件突然增多时，如果不主动查询 GraphQL Analytics 端点，往往很难第一时间察觉。等到用户投诉或工单涌入，影响已经发生。这里真正需要的不是报表汇总，而是一条能在指标越线时立刻触发告警的链路。

技能如何工作

@user_3c6cb52e/cloudflare-analytics-health-monitor 直接面向这个场景，核心流程如下：

数据采集：通过 Cloudflare API v4 的 GraphQL Analytics 端点拉取区域级指标，覆盖请求速率、缓存命中率与 WAF 事件数量。
阈值判定：在本地对照预设阈值，判断请求速率是否过载、缓存命中率是否跌破预期、WAF 事件是否出现峰值。
告警触发：当任一指标超过阈值，通过 PagerDuty Events API v2 推送事件，触发已配置的告警策略。

这样团队可以在页面出现异常之前介入，而不是事后翻日志。

适用边界与注意点

API 凭证要求：Cloudflare API token 需要具备 Analytics:Read 权限；PagerDuty 侧需要有效的 Events API v2 集成密钥。
GraphQL 数据依赖：技能依赖 Cloudflare GraphQL Analytics 端点返回的字段结构，若区域未开启相关分析数据，查询可能为空或延迟。
阈值需按业务校准：默认阈值并非通用答案，请求速率与缓存命中率的业务容忍度差异很大，建议按区域或业务线分别配置。
计费侧留意：来源文档提到示例涉及使用量计费，高频轮询时 GraphQL 查询次数可能产生额外成本，需要评估轮询频率。
PagerDuty 事件模型：Events API v2 使用 dedup_key 去重机制，同一问题的重复告警会被合并，需正确设置该键以便运维侧区分事件。