用途:诊断阿里云 ECS GPU 实例的 GPU 设备状态、驱动异常与硬件故障。
主要能力:
- 控制台诊断:调用 CreateDiagnosticReport(metric-set-id 为 dms-instanceGPUdevice)创建报告,再用 describe-diagnostic-reports 轮询;返回 Issues 数组,含 IssueId、MetricId、Severity、MetricCategory。
- 云助手诊断:通过 RunCommand 远程执行 GPU 健康检查插件 ACS-ECS-GpuCheck,插件按 PCI 槽逐项输出 * 检查项名 - OK|Failed。
- 检查项覆盖:双比特错误、infoROM、Kernel 升级导致的驱动异常、Fabricmanager 运行状态、电源线、设备丢失、驱动安装、Xid 错误、NVLink、eRDMA 等,失败项映射到对应 IssueId(如 GuestOS.GPU.DriverNotInstalled)。
模式与方法选择:
- 单实例即时诊断:控制台诊断与云助手诊断并行。
- 批量即时诊断:仅云助手诊断,一次 RunCommand 传入多个 --instance-id。
- 定时诊断:仅云助手诊断,用 CreateCommand + InvokeCommand 配置 Cron;控制台诊断不支持定时。
使用方式要点: 先检查 CLI 环境(aliyun --version ≥ 3.3.3),执行 aliyun configure set --auto-plugin-install true 与 aliyun plugin update,确认 AccessKey 配置及 RAM 权限。参数需 INSTANCE_ID(格式 ^i-[a-z0-9]{20}$)与 REGION_ID,批量实例须同地域。验证区域用 aliyun ecs describe-regions,查询实例用 aliyun ecs describe-instances,仅 OSType=linux 继续。每个云 API 命令须带 --user-agent AlibabaCloud-Agent-Skills/alibabacloud-ecs-gpu-diagnosis/{session-id}。
云助手命令约束:--type 必须为 RunShellScript,--content-encoding 必须为 Base64,--instance-id 逐个传普通实例 ID;--command-content 必须使用固定 Base64 字面量,不得修改或替换。结果按方法维度分组输出,分别编号,不得合并去重;插件非零退出(如驱动未安装)仍视为有效诊断,需解码 Output 解读。轮询上限约 10 次(5 分钟)。
限制:仅支持 Linux 实例;批量实例须同地域;控制台诊断不用于批量与定时;严禁任何删除操作,仅在用户明确要求停止时允许 stop-invocation;获取结果即时输出,不等待全部完成。