用途:对阿里云 Redis(ApsaraDB for Redis / Tair)实例做只读健康巡检,自动采集数据并生成标准化报告。默认时间范围为 7 天,报告维度共 7 项:实例基础信息、当前会话、资源使用(含 ECharts 图表)、大Key/热Key、慢日志统计、告警历史、巡检结论与建议。
主要能力:支持单实例、多实例(多个 ID)与账号全量(--all)巡检;支持指定 Region、自定义天数、单项或组合巡检项(resource/session/bigkey/slowlog/alert);输出格式可选 html(默认)、markdown、text,多实例报告汇总到同一目录并生成 index.html 索引页。资源指标覆盖 CPU、内存、连接、出入带宽,集群/读写分离还含 Proxy 指标,Tair 另有持久内存与磁盘指标。架构覆盖标准版(单节点、主从)、集群版、读写分离;实例类型覆盖 Redis 社区版与 Tair(DRAM、持久内存 tair.scm.、ESSD tair.essd.)。
使用方式:所有巡检必须通过 python3 scripts/health-inspect.py <INSTANCE_ID> [options] 执行,AI 不应绕过脚本直接调用 aliyun r-kvstore 采集数据。常用参数:--all、--region/-r、--days/-d、--item(可多次)、--profile/-p、--output/-o、--format/-f。示例:python3 scripts/health-inspect.py r-bp1xxxxxxxxxxxx;python3 scripts/health-inspect.py --all --item resource --item slowlog。也支持自然语言触发,由 AI 映射为对应参数。
前置条件:Python >= 3.7,aliyun CLI >= 3.3.3,已配置有效凭证(仅用 aliyun configure list 检查,不得读取或索要 AK/SK),无需 redis-cli,仅使用 Python 标准库。业务 API 命令需携带 --user-agent,系统/工具命令不得携带。需只读 RAM 权限;权限失败时按 references/ram-policies.md 处理并等待用户确认授权。
限制:不得使用 CloudMonitor(cms)API 替代取数;不得直连 Redis 或执行 Redis 命令;不得执行任何写操作;脚本失败时在报告中标记“retrieval failed”,不得改用其他方式取数,也不应在报告输出后追加追问。