用途:对阿里云 PolarDB MySQL 实例做只读健康巡检,并输出可视化 HTML 报告(也支持 markdown、text)。
主要能力:巡检维度包括实例信息(数据库类型、版本、规格、存储)、资源使用(CPU/内存/IOPS/连接数,含集群、单节点与 Proxy)、空间分析(Top 20 表、自增主键使用)、慢查询日志统计、会话与告警(活跃连接、云监控告警历史)。支持单实例、多实例、全账号(--all)及指定地域巡检。
使用方式:这是 AI Agent 技能,用自然语言描述需求即可,无需手动运行脚本。核心命令为 python3 scripts/health-inspect.py <CLUSTER_ID> [options],常用参数:--all、--region/-r、--days/-d(默认 7)、--item(resource、space、slowlog、session、alert,可多次)、--profile/-p、--output/-o、--format/-f。多实例报告输出到同一目录并生成 index.html 汇总页。
前置条件:Python >= 3.7、aliyun CLI >= 3.3.3 并配置有效凭证;无需 mysql 客户端,全部通过 API 完成。需先运行 aliyun configure set --auto-plugin-install true 与 aliyun plugin update。
限制:仅使用只读 API,不执行任何写操作或 SQL,不直连数据库;巡检数据必须经脚本获取,不得绕过脚本直接调用 aliyun CLI 采集;API 失败时在报告中标记“retrieval failed”,不采用替代方式取数。所有可自定义参数需与用户确认。具体 RAM 权限、报告格式与验证方法见技能内参考文档。