火山引擎资源巡检与容量判断 Skill

能力定位

这个 Skill 用来把“资源清单 + 近 30/90 天监控 + 规则化判断 + 巡检建议 + 趋势判断”收成一条稳定流程。

当前 V1 已验证的范围：

ECS：资源清单、CPU、内存、磁盘使用率、磁盘写 IOPS
CLB：资源清单、监听器级 QPS / 并发连接 / 新建连接 / 带宽 摘要（默认先尝试拉取，失败时说明原因）
ALB：资源清单、监听器级 QPS / 并发连接 / 新建连接 / 带宽 / 丢连接 / HTTP 5xx 摘要
RDS MySQL：资源清单、当前 CPU/内存/磁盘快照、近 30 天 QPS / ConnUsage

当前 V1 的已知边界：

CLB 当前已默认尝试拉取监听器级带宽、连接数和 QPS 摘要，但仍缺少规格上限换算与更完整口径，因此先给事实摘要和待补建议，不给结论性扩缩容判断
ALB 当前已接入监听器级流量与异常摘要，但仍属于保守判断；如需更细粒度结论，还要继续补监听器/规则/服务器组维度口径
RDS MySQL 的历史 CPU / Mem / Disk 监控口径尚未完全映射，当前先使用实例快照 + QPS / ConnUsage 做第一版评估

如果任务是在补监控口径或排查“为什么拿不到指标”，读取 references/metric_gaps.md。

路由原则

这个 Skill 内部统一处理两类请求，不再拆成两个独立 skill：

巡检模式：用户想先看当前资源、水位、低利用率和风险点
趋势模式：用户已经拿到巡检结果，或者明确要看未来 7/15/30 天风险、预算方向、扩缩容时点

如果是趋势模式，读取 references/forecasting.md。

适用场景

想快速盘点当前账号在某个地域下的 ECS / CLB / ALB / RDS MySQL 资源
想看近 30 天资源水位，找低利用率资源
想输出第一版扩缩容建议或预算优化建议
想基于近 30/90 天数据做容量趋势判断
想基于巡检结果继续判断未来 7/15/30 天风险
想基于“明年客户数增长 10% / 业务量增长 20% / 某条链路请求上涨”来判断整条链路应该怎么扩容
想做月度巡检、容量回顾、资源健康检查

不适用场景

用户要求执行高风险资源变更，例如直接停机、删实例、调规格
用户要求精确的 CLB 容量预测，但当前还没补齐连接/带宽/QPS 监控口径
用户要求严格财务级预算预测，但没有价格口径、计费方式和历史账单

前置条件

当前工作空间有 .env
.env 至少包含：

VOLCENGINE_AK=...
VOLCENGINE_SK=...
VOLCENGINE_REGION=cn-beijing

本地 Python 环境已安装火山引擎 SDK

默认入口

优先使用内置脚本：

python3 <byted-volcengine-capacity-auditor-skill>/scripts/run_capacity_audit.py \
  --env-path ./.env \
  --project-name mysite \
  --region cn-beijing \
  --format markdown

如果用户没有给 project-name，默认输出整个地域下的结果。

如果是链路级趋势判断，使用：

python3 <byted-volcengine-capacity-auditor-skill>/scripts/run_capacity_audit.py \
  --env-path ./.env \
  --project-name mysite \
  --region cn-beijing \
  --mode forecast \
  --growth-factor 0.1 \
  --link-name payment-core \
  --format markdown

如果已经有拓扑产物，希望按拓扑链路范围评估链路内相关资源容量，优先使用：

python3 <byted-volcengine-capacity-auditor-skill>/scripts/run_capacity_audit.py \
  --env-path ./.env \
  --region cn-beijing \
  --mode forecast \
  --growth-factor 0.1 \
  --topology-file ./business_topologies/payment-core/topology.json \
  --link-name payment-core \
  --format markdown

说明：

传入 --topology-file 后，脚本会先从拓扑里提取链路内命中的资源，再按当前已支持的资源类型做容量评估
如果未传 --topology-file，但存在 business_topologies/<link-name>/topology.json，脚本会自动按该拓扑收敛评估范围
当前已支持按拓扑收敛并参与容量评估的资源类型是 CLB / ALB / ECS / RDS MySQL
这不是只针对某一条固定链路；只要拓扑里存在对应业务路径，脚本都会按该路径命中的已支持资源做整链评估
当前 CLB / ALB 若已位于拓扑链路内，也会被纳入整链评估；其中 ALB 已支持监听器级 QPS / 连接 / 带宽 / 丢连接 / HTTP 5xx 摘要，若关键指标仍缺失，报告会明确标记为数据缺口，而不是跳过入口层

输出产物

默认输出两种格式之一：

markdown：适合直接给用户看
json：适合继续给脚本、agent 或后续趋势判断流程消费

标准工作流

读取 .env 或环境变量里的 AK / SK / REGION
拉取 ECS / CLB / ALB / RDS MySQL 资源清单
对 ECS 拉取近 30 天 CPU、内存监控；补充近期磁盘和 IOPS 摘要
对 RDS MySQL 拉取当前实例快照和近 30 天 QPS / ConnUsage
对 CLB 默认尝试拉取监听器级流量摘要，拉取不到时说明计费方式、监听器协议或口径缺口；对 ALB 输出监听器级流量与异常摘要
基于阈值规则输出：
- 低利用率资源
- 容量风险资源
- 建议缩容/继续观察/补监控
如果用户要求趋势判断，再基于已有巡检结果继续给出：
- 未来 7/15/30 天风险
- 高/中/低置信度
- 预算方向建议
- 如果用户给的是业务增长目标（例如客户数、订单量、QPS、带宽或调用量增长），先做链路级场景建模，判断哪一层最可能先成为瓶颈，再给扩容顺序
用统一结构返回报告

当前脚本入口已经支持：

--mode audit：默认巡检
--mode forecast：链路级趋势判断
--growth-factor 0.1：表示场景增长 10%
--link-name xxx：指定链路名称；若存在同名业务拓扑目录，会自动读取其 topology.json
--topology-file xxx：显式指定拓扑文件，按拓扑链路筛选本次评估资源

阈值口径

读取 references/thresholds.md。

如果用户没有给明确阈值，默认使用这套口径，不要临时自创一套不同规则。

监控口径补齐

如果用户不是单纯要巡检，而是在问“某些监控项为什么拿不到、应该怎么补”，按下面顺序处理：

先确认该产品是否已经支持云监控 GetMetricData
再确认 Namespace / SubNamespace / MetricName / Dimensions
如果控制台可见但脚本拿不到，优先判断是不是口径写错、维度不对、粒度不匹配
如果产品文档明确说明该指标不上报，就不要继续假设可以自动补齐
在补不齐时，明确告诉用户哪些结论因此不能下

涉及具体排查路径时，读取 references/metric_gaps.md。

报告结构

默认按下面结构输出：

# 资源巡检报告
## 摘要
## ECS
## CLB
## RDS MySQL
## 建议清单
## 数据缺口

解释规则

先给整体结论，再给分资源类型明细
明确区分“已验证数据结论”和“尚未补齐的数据缺口”
对没有拉通的指标，不要装作已经评估完成
对缩容建议，优先用“建议进入候选池/建议验证后降配”这种保守措辞，不要直接断言必须缩容
对趋势结论，明确标注“高置信度/中置信度/低置信度”
如果只有 30 天数据，不要把预测说得过满

脚本资源

scripts/run_capacity_audit.py：主入口，输出 JSON 或 Markdown 报告

测试用例

参考 evals/evals.json。