用途:对已加入阿里云 SASE(CSAS)的终端设备进行只读健康与风险监控,可诊断单台设备或扫描设备群,关注 CPU、内存压力等指标。技能仅执行只读 CSAS API 调用;设备群扫描可能写入本地续跑文件,但不会改动 CSAS 设备。
主要能力:list-devices 发现候选设备;device-report 生成单设备时点报告及 CPU、内存趋势;workload-trend 分析单个工作负载;health-scan 执行有界同步设备群扫描。所有命令在 stdout 输出单个 JSON 结果,进度与错误输出到 stderr。设备报告同时展示 device_status(CSAS 终端状态)与 collection_status(快照上报新鲜度),两者不可互相替代。设备群扫描仅将 warning 与 critical 放入 flagged,observation 不算群告警。CSAS 工作负载点约为十分钟采样,不声称精确时长。Android、iOS、Harmony、过期或不完整遥测记为 insufficient_data,而非健康。最终健康摘要须保留 Disk (磁盘)、Battery (电池)、CPU、Memory (内存)、Collection status (上报状态) 五个维度标签。
使用方式:需 Aliyun CLI 3.3.3 及以上与 jq 1.6 及以上,可用 aliyun version 和 jq --version 检查。首次安装或大版本升级使用 /bin/bash -c "$(curl -fsSL --connect-timeout 10 --max-time 120 https://aliyuncli.alicdn.com/setup.sh)";CLI 3.3.5 及以上例行更新使用 aliyun upgrade。首次 CSAS 调用前脚本检查 aliyun-cli-csas,必要时以 aliyun plugin install --name aliyun-cli-csas < /dev/null 非交互安装。仅用 aliyun configure list 验证凭据状态,不读取、打印或嵌入凭据值。运行前须阅读 references/ram-policies.md,权限失败时用 ram-permission-diagnose 申请所列权限并等待用户确认。云调用前与用户确认设备选择器、区域/配置上下文、回溯窗口、阈值、扫描上限及本地续跑路径。首次云 API 调用前读取 references/manifest.json 并使用其非空版本,缺失或无效则停止;生成本技能专用的 32 位小写十六进制会话 ID,切换技能后重新生成。每条实际云 API 命令须追加 --user-agent "AlibabaCloud-Agent-Skills/alibabacloud-csas-device-health-monitor/{session-id} skill-version/{skill-version}"。示例:scripts/device-health.sh --profile <profile> --region <region> list-devices --limit 20 --sort-by UpdateTime;device-report --device <DeviceTag-or-hostname> --days 7;workload-trend --device <selector> --metric cpu --days 7(可用 --from/--to 指定精确 epoch 窗口,--max-gap-seconds 控制采样连续性);health-scan --days 7 --limit 100 --resume-file .device-health-state/scan.json。
适用场景:需要只读排查 CSAS 终端设备健康与风险、分析 CPU/内存压力趋势或对设备群做有界扫描时。
限制:仅只读,不修改 CSAS 设备;设备群扫描为有界同步,更大规模需调用方拆分多次运行;不完整遥测记为 insufficient_data;零电量值在缺少有效采集时间与容量证据时记为 insufficient_data,同时保留静态快照证据。其他细节暂未提供。