阿里云云监控官方 CLI 作为 阿里云 CLI 的 cms2 插件，通过 aliyun cms2 <resource> <action> 提供云监控 2.0 的查询与管控。面向终端、CI 与脚本：结构化输出、显式失败、凭证走 RAM / 阿里云配置链，不进入命令业务入参。
本文只描述官方 CLI。如需在 Cursor、Claude Code、通义灵码等 MCP Client 中接入，请使用 云监控 MCP，不要将本文的安装与认证步骤用于 MCP。
云监控 MCP Cloud 与开源可观测 MCP Server 不是同一套服务。
能力范围
覆盖云监控 2.0 的查询与管控，主要包括：
接入与工作空间：集成策略、Addon、采集预检；CMS Workspace、数据源纳管与实体包
Prometheus：实例、聚合视图、预聚合规则；PromQL 透传查询
Grafana：工作空间 CRUD；实例内数据源 / 大盘 / 目录（经 ARMS GrafanaWorkspaceHttpApiProxy）
应用可观测：APM / RUM 应用与配置、探针配置、日志关联、诊断任务、RUM 符号文件上传
云拨测：站点监控任务，以及公网 / 内网探测点与 VPC 元数据
告警与事件：告警规则与模板、告警历史、通知对象、事件查询与 Logstore 寻址
指标与实体：基础云监控指标、指标元数据、实体 / UModel 查询、链路搜索与调用树
报表与开通：资源水位报表、标签、资源组、云服务开通状态
下载与安装
官方 CLI 作为阿里云 CLI 的 cms2 插件使用，安装完成后通过 aliyun cms2 调用。
安装阿里云 CLI
请先安装/更新最新版阿里云 CLI，并确认 aliyun 已在 PATH 中：
aliyun version验证
aliyun cms2 --help
aliyun cms2 --version能输出版本信息即表示插件已安装成功。后续命令统一使用 aliyun cms2，例如：
aliyun cms2 workspace list
aliyun cms2 alert rule list --workspace <workspace>认证方式
CLI 不在命令业务入参中携带 AccessKey。调用是否成功取决于当前身份对应的 RAM 权限。
aliyun cms2 复用阿里云 CLI 的凭证。推荐使用 aliyun configure 管理。
# 交互式配置（推荐）
aliyun configure
# 非交互式配置
aliyun configure set \
--access-key-id <AccessKeyId> \
--access-key-secret <AccessKeySecret> \
--region cn-hangzhou详见配置与管理身份凭证。
凭证优先级从高到低：
命令行参数：
--access-key-id、--access-key-secret、--security-token环境变量：
ALIBABA_CLOUD_CMS_ACCESS_KEY_ID、ALIBABA_CLOUD_CMS_ACCESS_KEY_SECRET、ALIBABA_CLOUD_CMS_SECURITY_TOKEN、ALIBABA_CLOUD_CMS_REGION阿里云 CLI 配置：
~/.aliyun/config.json（aliyun configure写入）
注意
禁止使用主账号 AccessKey，请使用 RAM 用户并按最小权限授权。
各优先级层可部分覆盖（例如仅用 flag 提供 AccessKey ID，Secret 从配置文件补齐）。请确保最终凭证属于同一账号。
多 Profile 时使用
aliyun configure switch --profile <name>切换。可用aliyun sts GetCallerIdentity核对当前AccountId。工作空间名称通常形如
default-cms-<uid>-<region>，操作该工作空间时凭证须属于同一账号。
RAM 权限
只读调查可授予 AliyunCloudMonitorReadOnlyAccess；Grafana 工作空间需叠加 ARMS 权限；链路与事件查询还需 SLS log:GetLogStoreLogs。写操作请授予 AliyunCloudMonitorFullAccess 或按下表精确授权。
多数管控接口为 CMS 2024-03-30；基础监控指标与资源水位报表为 CMS 2019-01-01；Grafana 工作空间为 ARMS 2019-08-08；APM 探针配置为 SLS 2020-12-30。
系统策略说明见 云监控 2.0 RAM 权限策略参考。
命令参考
当前共 196 条叶子命令，按命令树第一段分组。命令数量可能随版本更新增加，以 aliyun cms2 --help 实际输出为准。
命令组 | 能力域 | 命令数 |
| 接入管理 | 22 |
| 工作空间 | 8 |
| 数据源纳管 | 7 |
| Prometheus | 17 |
| Grafana | 26 |
| APM | 32 |
| RUM | 9 |
| 云拨测 | 13 |
| 资源水位报表 | 8 |
| 告警 | 15 |
| 通知渠道 | 3 |
| 事件中心 | 4 |
| 指标查询 | 11 |
| 实体查询 | 5 |
| UModel | 4 |
| 元数据 | 3 |
| 链路追踪 | 3 |
| 云服务开通 | 2 |
| 标签 | 3 |
| 资源组 | 1 |
接入管理（integration）
CLI 命令 | 能力介绍 | API 权限需求 |
| 获取 Addon 元数据、Schema 与告警代码模板 |
|
| 列出可安装的 Addon 目录 |
|
| 在集成策略上创建 Addon Release |
|
| 删除 Addon Release |
|
| 获取 Addon Release 详情 |
|
| 列出集成策略下的 Addon Release |
|
| 更新 Addon Release |
|
| 预检采集目标连通性并分析指标 |
|
| 对已部署抓取配置做服务发现与 relabel dry-run |
|
| 列出集成策略下的采集器 |
|
| 列出集成策略下的自定义抓取任务 |
|
| 列出集成策略关联的仪表盘 |
|
| 列出采集 Job 或其抓取目标 |
|
| 列出集成策略下的 PodMonitor |
|
| 创建集成策略 |
|
| 删除集成策略 |
|
| 获取集成策略详情 |
|
| 列出集成策略 |
|
| 更新集成策略 |
|
| 列出集成策略关联的 Kubernetes 资源 |
|
| 列出集成策略下的 ServiceMonitor |
|
| 列出集成策略的存储需求 |
|
工作空间（workspace）
CLI 命令 | 能力介绍 | API 权限需求 |
| 删除 UModel 公共 Schema 引用 |
|
| 列出 UModel 公共 Schema 引用 |
|
| 创建或更新 UModel 公共 Schema 引用 |
|
| 创建 CMS 工作空间，并初始化 UModel 与 EntityStore |
|
| 删除 CMS 工作空间 |
|
| 获取 CMS 工作空间详情 |
|
| 列出 CMS 工作空间 |
|
| 更新 CMS 工作空间 |
|
数据源纳管（datasource）
CLI 命令 | 能力介绍 | API 权限需求 |
| 将 Prometheus / SLS Logstore / MetricStore 纳管为工作空间 UModel 数据源 |
|
| 取消纳管数据源，并卸载其上的实体包实例 |
|
| 向数据源安装一个或全部匹配的实体模型包 |
|
| 卸载数据源上的实体包安装记录 |
|
| 列出数据源上已安装的实体包实例 |
|
| 列出可用的实体包模板 |
|
| 列出工作空间已纳管的数据源 |
|
Prometheus（prometheus）
CLI 命令 | 能力介绍 | API 权限需求 |
| 创建 Prometheus 实例 |
|
| 删除 Prometheus 实例 |
|
| 获取 Prometheus 实例详情（含 HTTP API 地址） |
|
| 列出 Prometheus 实例 |
|
| 更新 Prometheus 实例 |
|
| 创建预聚合（Recording Rule / AggTaskGroup） |
|
| 删除预聚合规则 |
|
| 获取预聚合规则详情 |
|
| 列出预聚合规则 |
|
| 启动预聚合规则 |
|
| 停止预聚合规则 |
|
| 更新预聚合规则 |
|
| 创建 Prometheus 聚合视图 |
|
| 删除 Prometheus 聚合视图 |
|
| 获取 Prometheus 聚合视图 |
|
| 列出 Prometheus 聚合视图 |
|
| 更新 Prometheus 聚合视图 |
|
Grafana（grafana）
CLI 命令 | 能力介绍 | API 权限需求 |
| 向 Grafana 工作空间授权阿里云账号 |
|
| 删除 Grafana 工作空间账号 |
|
| 列出 Grafana 工作空间账号 |
|
| 删除 Grafana 工作空间账号的组织角色 |
|
| 新增或更新 Grafana 工作空间账号的组织角色 |
|
| 按 UID 删除 Grafana 大盘 |
|
| 按 UID 获取完整 Grafana 大盘 JSON |
|
| 提取大盘各 Panel 的查询语句 |
|
| 按 JSONPath 读取大盘指定属性 |
|
| 按关键词搜索 Grafana 大盘 |
|
| 获取大盘紧凑摘要（标题、变量、Panel 概览） |
|
| 创建或更新 Grafana 大盘（全量 JSON 或 patch） |
|
| 在 Grafana 工作空间内创建数据源 |
|
| 删除 Grafana 数据源 |
|
| 获取 Grafana 数据源详情 |
|
| 检查 Grafana 数据源健康状态 |
|
| 列出 Grafana 数据源 |
|
| 更新 Grafana 数据源 |
|
| 创建 Grafana 目录 |
|
| 删除 Grafana 目录 |
|
| 按关键词搜索 Grafana 目录 |
|
| 创建 Grafana 工作空间 |
|
| 删除 Grafana 工作空间 |
|
| 获取 Grafana 工作空间详情 |
|
| 列出 Grafana 工作空间 |
|
| 更新 Grafana 工作空间 |
|
APM（apm）
CLI 命令 | 能力介绍 | API 权限需求 |
| 初始化工作空间 APM 可观测性基础设施（LicenseKey / 接入点） |
|
| 获取工作空间 APM 可观测性配置 |
|
| 更新工作空间 APM 可观测性实例设置 |
|
| 为 APM 应用创建日志关联记录 |
|
| 删除 APM 应用的日志关联记录 |
|
| 获取 APM 应用的日志关联记录 |
|
| 列出工作空间内的日志关联记录 |
|
| 更新 APM 应用的日志关联记录 |
|
| 获取探针收敛配置（SLS apm_convergence） |
|
| 局部修改探针收敛规则 |
|
| 全量替换探针收敛配置 |
|
| 获取业务参数提取配置（SLS apm_custom_extract） |
|
| 局部修改业务参数提取规则 |
|
| 全量替换业务参数提取配置 |
|
| 获取探针主配置（采样 / Trace / Metrics / Profile） |
|
| 局部修改探针主配置字段 |
|
| 获取数据富化配置（SLS apm_tag） |
|
| 局部修改数据富化配置 |
|
| 全量替换数据富化配置 |
|
| 全量替换探针主配置 |
|
| 获取监控方法自定义配置（SLS apm_user_method） |
|
| 局部修改监控方法配置 |
|
| 全量替换监控方法配置 |
|
| 创建 APM 应用服务 |
|
| 删除 APM 应用服务 |
|
| 获取 APM 应用服务详情 |
|
| 列出工作空间内 APM 应用服务 |
|
| 创建诊断任务（如 HeapDump / LiveDebug） |
|
| 删除诊断任务 |
|
| 获取诊断任务详情 |
|
| 列出某应用的诊断任务 |
|
| 更新 APM 应用服务 |
|
RUM（rum）
CLI 命令 | 能力介绍 | API 权限需求 |
| 初始化工作空间 RUM 可观测性基础设施 |
|
| 获取工作空间 RUM 可观测性配置 |
|
| 更新工作空间 RUM 可观测性实例设置 |
|
| 创建 RUM 应用服务 |
|
| 删除 RUM 应用服务 |
|
| 获取 RUM 应用服务详情 |
|
| 列出工作空间内 RUM 应用服务 |
|
| 更新 RUM 应用服务 |
|
| 上传 RUM 符号文件（sourcemap / dSYM / ProGuard / native-symbol 等） |
|
云拨测（synthetics）
CLI 命令 | 能力介绍 | API 权限需求 |
| 初始化云拨测所需资源 |
|
| 列出内网拨测可用地域 |
|
| 列出内网拨测可用安全组 |
|
| 列出内网拨测可用 VPC |
|
| 列出内网拨测可用交换机 |
|
| 列出云拨测可用探测点地域 |
|
| 创建站点监控任务 |
|
| 删除站点监控任务 |
|
| 停用站点监控任务 |
|
| 启用站点监控任务 |
|
| 获取站点监控任务详情 |
|
| 列出站点监控任务 |
|
| 更新站点监控任务 |
|
资源水位报表（resource-watermark）
CLI 命令 | 能力介绍 | API 权限需求 |
| 下载已完成水位报表任务的文件 |
|
| 查询水位报表支持的云产品与指标配置 |
|
| 创建水位报表计划 |
|
| 删除水位报表计划 |
|
| 列出水位报表计划 |
|
| 修改水位报表计划 |
|
| 列出水位报表任务 |
|
| 触发一次性水位报表任务 |
|
告警（alert）
CLI 命令 | 能力介绍 | API 权限需求 |
| 查询 CMS 2.0 告警历史，可按工作空间、严重级别、状态和时间范围过滤 |
|
| 创建告警规则（ManageAlertRules action=CREATE） |
|
| 按 UUID 批量删除告警规则 |
|
| 批量停用告警规则 |
|
| 批量启用告警规则 |
|
| 按 UUID 获取单条告警规则详情 |
|
| 查询工作空间内告警规则列表 |
|
| 增量修改告警规则（未指定字段保留服务端原值） |
|
| 全量替换告警规则 |
|
| 将告警模板物化为一条或多条告警规则 |
|
| 创建自定义告警规则模板 |
|
| 按 ID 删除自定义告警规则模板 |
|
| 按 ID 或 UUID 获取告警规则模板 |
|
| 列出告警规则模板 |
|
| 按字段补丁更新自定义告警规则模板 |
|
通知渠道（notification-channel）
CLI 命令 | 能力介绍 | API 权限需求 |
| 列出告警联系人 |
|
| 列出告警机器人（钉钉 / 飞书 / 企业微信等） |
|
| 列出自定义告警 Webhook |
|
事件中心（event-hub）
CLI 命令 | 能力介绍 | API 权限需求 |
| 查询 CMS 2.0 工作空间四类事件 Logstore 寻址 |
|
| 按 Event ID 获取单条事件详情 |
|
| 解析当前账号 CMS 1.0 存量事件的 SLS 落点 |
|
| 从 SLS Event Store 查询事件列表 |
|
指标查询（metric）
CLI 命令 | 能力介绍 | API 权限需求 |
| 获取基础监控 BatchExport 所需的游标 |
|
| 按游标批量导出基础监控时序数据 |
|
| 查询每个时序的最新点（DescribeMetricLast） |
|
| 按时间窗口聚合查询基础监控时序（DescribeMetricList） |
|
| 跨序列聚合的基础监控区间查询（DescribeMetricData） |
|
| 按统计值排序的最新点排行（DescribeMetricTop） |
|
| 透传 Prometheus label-values API |
|
| 透传 Prometheus labels API |
|
| 对 Prometheus 实例执行 instant PromQL 查询 |
|
| 对 Prometheus 实例执行 range PromQL 查询 |
|
| 按 label matcher 查找时序 |
|
实体查询（entity）
CLI 命令 | 能力介绍 | API 权限需求 |
| 创建绑定到实体集的健康巡检规则组 |
|
| 删除实体健康巡检规则组 |
|
| 列出实体健康巡检规则组 |
|
| 更新实体健康巡检规则组 |
|
| 查询实体数据：EntityStore 或资源中心 CloudResource |
|
UModel（umodel）
CLI 命令 | 能力介绍 | API 权限需求 |
| 按 domain 获取工作空间内的 UModel 对象 |
|
| 列出工作空间内的 UModel 对象 |
|
| 用 EntityStore SPL 查询 UModel 对象 |
|
| 通过 YAML/JSON body 写入（Upsert）UModel 对象 |
|
元数据（meta）
CLI 命令 | 能力介绍 | API 权限需求 |
| 查询云监控指标元数据（指标名、单位、维度） |
|
| 列出可用的云监控 Namespace / 产品代码 |
|
| 列出当前账号可用的业务地域 |
|
链路追踪（trace）
CLI 命令 | 能力介绍 | API 权限需求 |
| 对 Trace Logstore 执行 SLS SQL 聚合查询 |
|
| 按 SLS 过滤表达式搜索 Span |
|
| 按 Trace ID 拉取全部 Span 并组装调用树 |
|
云服务开通（aliyun-service）
CLI 命令 | 能力介绍 | API 权限需求 |
| 返回指定云服务的开通 / 购买页 URL |
|
| 检查 Prometheus、企业云监控、Grafana、资源中心等服务开通状态 |
|
标签（tag）
CLI 命令 | 能力介绍 | API 权限需求 |
| 为云监控产品资源绑定标签 |
|
| 列出云监控产品资源上的标签 |
|
| 解绑云监控产品资源上的标签 |
|
资源组（resource-group）
CLI 命令 | 能力介绍 | API 权限需求 |
| 列出账号下的资源组 |
|