SuperAPI AI 工具集
合作ENAI 行业资讯收藏
Skill 广场alibabacloud-cms-manage

alibabacloud-cms-manage

部署与运维

查看项目

更新于 10-15 13:27

技能介绍

阿里云云监控（CloudMonitor，CMS）CLI 入口技能，对应命令行工具为 aliyun cms2。该技能用于在 AI 代理会话中通过 aliyun CLI 调用云监控能力，由模块路由决定具体执行的命令集。

用途 该技能面向云监控（CMS）的日常管理操作，包括接入（onboarding）、接入策略（policy / Integration Policy）、组件与接入配置（Addon / AddonRelease）、实体查询（entity query）、Kubernetes 资源查看、Prometheus 相关查询、告警规则与模板、告警历史、通知渠道、联系人、事件中心、指标元数据（Metric Meta）等，并根据用户意图将其路由到对应模块（如 integration、integration entity query 等）。

前置检查 会话首次调用该技能时执行一次前置检查：

  1. 检查 aliyun 是否存在（macOS/Linux 用 which aliyun，Windows 用 where aliyun）；未找到则提示用户先安装 aliyun CLI（https://help.aliyun.com/document_detail/121541.html）并停止等待。
  2. 检查 CLI 版本，运行 aliyun version，最低要求 3.3.15；版本比较需按 semver 以整数逐段比较（例如 3.3.4 < 3.3.15）。可用 shell 校验：printf '%s\n' "3.3.15" "$(aliyun version)" | sort -V | head -1。版本过低时先尝试 aliyun upgrade --help 检测 upgrade 子命令是否存在，可用则执行 aliyun upgrade -y 自动升级后重新检查，不可用或升级失败则按官方指引手动升级（https://help.aliyun.com/zh/cli/update-cli）并等待用户确认。
  3. 检查 cms2 插件，运行 aliyun cms2 --help；若报 unknown command 或缺失，立即停止并输出错误报告（附 CLI 版本、操作系统与错误信息），不再发起任何 CLI 调用。

凭据与标识 该技能复用 aliyun CLI 的凭据体系（aliyun configure），可用 --profile <name> 切换配置。加载技能时每次会话生成一个随机会话 ID（32 位小写十六进制字符串），并为每条 aliyun cms2 命令追加 --user-agent "AlibabaCloud-Agent-Skills/alibabacloud-cms-manage/{session-id}"；本地工具类命令（version、configure、plugin、--help 等）不支持该参数，需排除。

使用方式与全局约定 硬性约束：禁止回退到 aliyun cms、其他 API 版本或任何变通方式。首次使用某子命令前应先运行 aliyun cms2 <command> [subcommand] --help 获取完整参数列表与示例；同一会话内已读取且命令形态未变时可复用。子命令的 --help / --show-schema / --show-example-body 是该命令参数、请求体、响应字段与环境行为的权威来源。为节省 token，列表/获取类查询优先使用 -o text（默认），仅在需要逐字段解析时用 -o json。变更类与详情类命令必须携带 --region 参数（模块另有规则除外），否则可能导致路由失败或操作到非预期区域。写操作与高影响创建操作在执行前需向用户展示确认摘要与具体命令，并获得明确肯定答复（如 yes、confirm、proceed、确认）。未知或无法可靠确定的参数（区域、工作空间、策略、资源组、标签、资源范围、组件等）必须由用户明确回答，不得臆测或使用默认值。

区域确认门（硬性要求） 适用于所有接受 --region 或区域字段的模块与命令，并应先于工作空间确认（工作空间校验是区域范围的）。列表/查询命令仅在模块规则声明为全区域时才可省略 --region；省略标志不等于全区域，CLI 会使用 profile 默认值。区域值仅有三种合法来源：用户在当前请求中说明；用户从候选列表中选定且等待其回答；宿主作为运行时上下文注入（如控制台会话当前区域）。其他来源（CLI profile / aliyun configure / 环境默认、省略必需参数、文档示例中的 cn-hangzhou、从工作空间名或 controlRegionId 推断等）均属违规。候选可用 aliyun cms2 meta regions 收集，需展示每个 regionId（不展示 showName 或 controlRegionId）。controlRegionId 为控制面区域，绝不可作为 --region 传入。

工作空间确认门（硬性要求） 适用于所有接受 --workspace 或工作空间字段的模块与命令。工作空间值同样只有三种合法来源：用户在当前对话中说明（并按 workspaceName 精确校验其在目标区域存在，无精确匹配则报告并询问，不得替换近似值）；用户从候选列表中选定并等待回答；环境作为运行时上下文提供且区域与目标区域一致。采用 aliyun cms2 workspace list 返回的单行、因形似账号默认而选用 default-cms-{userId}-{regionId}、由 sts 身份加区域拼装、或复用同一会话早前无关请求的工作空间，均属违规。workspace list 仍用于收集候选，但必须在选项中标注推荐项后停下等待。

分页与查询失败处理 支持 --next-token 的列表命令需分页至结束（无 nextToken 或累计数量 ≥ totalCount）。支持 --max-results 的命令传入 100 再分页（不依赖省略时的默认值，如 policy list 默认 30、prometheus instance list 默认 30）。累计数量 ≥ totalCount 时停止；空页但已满足 totalCount 时停止；出现重复 token 停止并报告为部分结果；默认页数上限 20 页，达到则报告为部分结果。不得依据不完整结果断定某项不存在，应使用过滤条件或完整分页。暂时性服务端错误（DEADLINE_EXCEEDED、超时）重试一次，仍失败则标记为 Unknown/QueryFailed，不得视为健康或不健康。

错误处理 错误码与处理动作见 aliyun cms2 --help。常见情况：InvalidJSON 通常表示 --body 格式错误，可先用 jq . <<<'<value>' 校验；--body 与 stdin 互斥，只能保留一个输入源，在 stdin 可能为管道的环境中可追加 < /dev/null 确保 stdin 为空。

输出语言与术语 面向用户的解释、分析、建议、摘要与结论应使用用户语言，语言不明确或混杂时默认简体中文，并遵循会话中途的语言切换与显式语言指令。问题提示、选项标签、表格表头与报告同样使用回答语言。CLI 命令名、参数、API 路径、JSON 字段名、枚举值、资源 ID、指标名与日志/错误信息必须保持英文/代码原样。中文回答时应使用术语表中文术语，首次出现且有助于消歧时可写“中文（English）”，随后仅用中文；发送前应扫描并替换已映射的英文术语（代码、命令、JSON 字段、ID 或引用的 CLI 输出除外）。

术语表示例 Cloud Monitor / CMS 云监控；Workspace 工作空间；Application Monitoring / APM 应用监控；RUM 用户体验监控；Synthetic Monitoring / Synthetic 云拨测；CloudResource 云资源；EntityStore 实体仓库；Entity 实体；Integration Policy / policy 接入策略；Addon / addon 组件；Addon Catalog 组件目录；AddonRelease / addon release / release 接入配置；Collector 采集器；Prometheus View Prometheus 聚合视图；AggTaskGroup 聚合任务；Delivery Task 数据投递任务；Alert Rule 告警规则；Alert Template 告警模板；Alert History 告警历史；Notification Channel 通知渠道；Contact 联系人；Event Hub 事件中心；Metric Meta 指标元数据；ClusterCollector 集群采集器；NodeCollector 节点采集器；Cluster probe 集群探针；Metric drop 指标废弃；CMS resource tag CMS 资源标签；Grafana workspace Grafana工作区。

元数据查询映射 指标业务元数据（命名空间与产品码经 meta namespaces；指标名、类型、单位、维度经 meta metrics）使用 meta namespaces / meta metrics；Prometheus 标签、取值与序列检查使用 metric promql labels / label-values / series。接入模块的查询（资源元数据、接入状态、策略范围内的 Kubernetes 资源、按策略定位 Prometheus 实例）见 references/integration-common.md。

模块路由 按用户意图关键词路由：涉及 onboarding、monitoring addon、policy、integration、addon release、integration resource、策略下 Namespace 资源、策略管理的资源、teardown、offboarding 等通用规则时加载 references/integration-common.md；容器接入、ACK/ACS/ASI 集群接入、集群机队审计、哪些集群未接入走 integration entity query 与 references/cs-onboarding.md（叠加 integration-common.md）；ECS 主机接入、ECS 机队审计、NodeCollector 走 references/ecs-onboarding.md（叠加 integration-common.md）。

限制与未提供内容 本资料未提供该技能的具体收费方式、价格、平台支持范围、实际效果数据或完整使用步骤示例；部分模块细节依赖各模块参考文件（如 references/integration-common.md、references/cs-onboarding.md、references/ecs-onboarding.md），其具体内容在本次资料中未完整给出。