SuperAPI AI 工具集

fastly-stats

通用与其它

查看项目

更新于 10-15 21:41

技能介绍

用途:查询 Fastly 的流量与用量数据,包括缓存命中率、带宽、请求数、状态码与错误率、边缘与源站流量、实时每秒请求数,以及源站和域名维度的指标。

主要能力:优先使用 fastly CLI,覆盖单服务历史窗口、单字段、全服务汇总、账户用量(按区域或按服务)、区域代码、POP 与 shield 名称、产品启用状态、源站 Inspector、域名 Inspector 和实时数据。CLI 无法完成的七类查询改用原始 API,例如按 POP 的历史数据、一次调用拆分所有服务、单字段跨服务、当月计费用量、POP 区域字段、实时按源站或域名数据、120 秒按 POP 快照。

使用方式:需要 fastly CLI、jq 和网络访问,原始 API 还需 curl,并使用本地已配置的认证;缺少认证时引导用户本地登录或配置 FASTLY_API_TOKEN,不要在对话中粘贴密钥。日历窗口需传显式 UTC 边界,如 --from 2026-07-01T00:00:00Z --to 2026-08-01T00:00:00Z。字节转 GB 用十进制 SI(/1e9),TB 用 /1e12。hit_ratio 等是仪表值,不可跨桶求和或平均,应基于计数器重算。fastly stats ... --json 输出 NDJSON,需用 jq -s 聚合。Compute 服务的流量计入 compute_requests,requests 为 0,需同时统计。状态码用 all_status_*。实时数据只覆盖最近 120 秒且只返回有流量的秒,需按实际观察窗口计算速率。

适用场景:流量报表、缓存效果评估、错误率排查、账户用量核算、按 POP 或源站定位问题。

限制:创建或配置服务、后端、VCL、WAF 不属于本技能;原始请求日志和 NGWAF 安全事件也不属于本技能。Origin 与 Domain Inspector 为付费附加功能,未启用时返回空数据。region 与 datacenter 不可同时发送,否则 POP 过滤会被静默丢弃。部分字段、参数与错误处理细节需参考随附的 api.md、fields.md、debugging.md。