SuperAPI AI 工具集

huawei-cloud-cdn-abnormal-status-code-analysis

部署与运维

查看项目

更新于 10-15 22:14

技能介绍

用途:对华为云 CDN 加速域名的异常 HTTP 状态码(4xx/5xx)做只读诊断,回答“是否存在异常及规模、具体是哪个码在何时、边缘还是回源、涉及哪些 IP/路径/UA、根因与取证”等问题。全程仅执行查询操作,不修改任何配置。

主要能力:通过 ShowDomainStats/v2 的 summary 与 detail 量化 4xx/5xx 数量与占比并定位具体状态码和时间桶;用 bs_status_code_* 区分边缘生成与回源生成(bs_status_code_* 为空即边缘产生,非空为回源产生);覆盖 400/401/403/404/429/499/500/502/503/504/530 等常见码;借助 Top-N 系列与 ListDomainClientStats 分析可疑 IP、路径、UA、referer 及客户端 IP 数;结合 ShowDomainFullConfig 等边缘配置与 ShowOriginHost 等回源配置排查根因;最后用 ShowLogs/v2 与 Python 脚本 scripts/fetch_cdn_log.py 拉取并解压日志、提取异常请求行(JSON 输出),并用 ShowIpInfo/v2 做 IP 归属。

使用方式:需先安装 hcloud(KooCLI)>= 3.2.0、Python >= 3.8 与 requests >= 2.25,凭据通过环境变量或已有 CLI profile 读取,禁止在对话中粘贴 AK/SK。命令格式为 hcloud CDN <Operation> --cli-region=<region> [--key=value ...],参数必须用等号,建议 cn-north-1。时间参数为毫秒时间戳、左闭右开,interval=300(≤2 天)/3600(≤7 天)/86400(≤31 天)。status_code_(边缘)与 bs_status_code_(回源)不能在同一查询混用。日志脚本示例:python scripts/fetch_cdn_log.py --url <link> [--status 403,502] [--timeout 30] [--max-lines 200]。诊断流程为发现量化、定位分叉、分布分析、根因排查、逐请求取证、生成报告六步。

适用场景:CDN 域名 403 突增、502/503/504 爆发、边缘还是回源判断、业务异常码排查、限流与封禁排查、巡检中的状态码异常分析。

限制:仅做只读诊断,禁止创建/删除域名、修改配置、刷新预热、启停域名等 55 项非 GET 操作;ShowLogs/v2 仅限单域名且跨度不超过 30 天;Top-N 的 stat_type 只支持 flux/req_num,无状态码维度;ListDomainClientStats 的 ip_num 仅支持 1 天粒度;ListBanUrl/ListAccessControlTask 需工单白名单,否则返回 CDN.0004;CDN 仅支持 cn-north-1 与 ap-southeast-1;日志脚本解析的是官方 14 字段格式。需先提供目标域名,否则应先询问用户。