用途:对指定的阿里云 MSE Nacos 实例集合执行使用率巡检,覆盖配置数使用率、连接数使用率、QPS 使用率、TPS 使用率,并按阈值输出告警建议。
两种巡检模式:模式 A 指定实例 ID 列表;模式 B 按地域自动发现并巡检该地域内全部 Nacos 实例。
前置条件:需 Aliyun CLI >= 3.3.3(用 aliyun version 校验);启用插件自动安装并更新插件: aliyun configure set --auto-plugin-install true aliyun plugin update 需配置阿里云凭证(仅用 aliyun configure list 检查,禁止读取、回显或让用户在会话中输入 AK/SK),并具备 mse:QueryClusterDetail、mse:ListClusters、arms:ListPrometheusInstances、arms:GetPrometheusInstance 等只读权限;还需 curl 执行 Prometheus 查询。
每次调用云 API 的命令须带 --user-agent AlibabaCloud-Agent-Skills/alibabacloud-mse-nacos-inspection/{session-id},会话内生成一次 32 位小写十六进制 session id。
主要流程:确认巡检模式、实例 ID 或地域、时间范围(默认最近 1 小时);模式 B 用 aliyun mse list-clusters 分页获取实例;模式 A 用 aliyun mse query-cluster-detail 获取 ClusterName 与 MseVersion;用 arms list-prometheus-instances / get-prometheus-instance 获取 Prometheus HTTP API 地址并替换 ClusterId 为 cloud-product-regcenter,再用 curl 对 query_range 查询指标(PromQL 需 URL 编码),step 建议 <=1 小时用 15s、1 天内用 60s。
版本差异:专业版 mse_pro、企业版 mse_platinum 查询全部四项;Serverless mse_serverless 仅查配置数使用率;开发版 mse_dev、基础版 mse_basic 跳过查询,标记 N/A。
告警阈值:配置数使用率 > 0.8(80%)告警;连接数、QPS、TPS 使用率 > 1(100%)告警。结果以 Markdown 表格在会话输出并生成 .md 报告。
限制:仅只读操作,不创建、修改或删除资源,无需清理;批量实例较多时需注意执行效率;查询无数据标记“No data”并建议确认实例运行状态;权限不足、Prometheus 实例不存在或地址为空、PromQL 语法错误、查询超时等均有对应处理提示。