SuperAPI AI 工具集

alibabacloud-pts-reporter

测试与质量

查看项目

更新于 10-15 19:55

技能介绍

用途:该技能用于解读阿里云 PTS 压测报告,针对已运行的压测结果做报告层面的问题诊断,输出排序后的发现列表。它只分析报告数据,不做 ECS/CloudMonitor 的实例级诊断(CPU、内存、磁盘 IO、网络),也不创建、启动、停止或删除 PTS 场景(后者属于 alibabacloud-pts-task)。

主要能力:读取 PTS 报告数据,包括 QPS/TPS 曲线、响应时间分位数(P50/P90/P99)、错误率、采样器明细、并发曲线;可选通过 SceneId 与 GetPtsSceneBaseLine 拉取场景基线做对比。诊断类别限于报告可观测范围:PTS 客户端配置(并发爬坡形态、压测源地域、keep-alive/HTTPS 握手、客户端超时与退避信号)、应用层(5xx 错误聚集、采样器级错误集中、连接错误、状态码分布)、吞吐模式(QPS/TPS 平台期、阶梯式上限、饱和拐点、并发与吞吐背离)、延迟模式(RT 分位数分布形态、P99 尖峰、长尾背离、RT 与并发相关性)。输出 findings[],每项含 area、severity、evidence、suggestion,按严重程度排序,默认最多 5 条(TopN)。

使用方式:需 Aliyun CLI >= 3.3.3,先运行 aliyun version 校验,再执行 aliyun plugin install pts 与 aliyun plugin update。工作流开始时启用 AI-Mode:aliyun configure ai-mode enable 与 aliyun configure ai-mode set-user-agent --user-agent "AlibabaCloud-Agent-Skills/alibabacloud-pts-reporter",每个退出点(成功、失败、错误、取消、会话结束)必须执行 aliyun configure ai-mode disable。凭据通过 aliyun configure list 检查,禁止读取、回显或让用户直接输入 AK/SK。必填参数为 RegionId 与 HistoryReportId,CLI 还需 SceneId 与 PlanId;先执行 aliyun pts list-pts-scene 做环境发现,再按报告类型调用 aliyun pts get-pts-report-details 或 aliyun pts get-jmeter-report-details,可选调用 get-pts-scene-base-line、get-pts-scene-running-data、get-pts-scene。

适用场景:已跑完 PTS 压测、需要解读报告或定位报告可见性能问题的用户。

限制:无报告数据不得生成任何发现或严重度评级;参数解析失败时不得循环重试或猜测 SceneId/PlanId;每条 evidence 必须引用实际 API 返回数据;权限失败需参考 references/ram-policies.md 并借助 ram-permission-diagnose 处理。该技能为只读分析,不创建资源,无需清理。