阿里云云监控对接使用完全指南：从入门到智能化运维

apphuang2026年07月10日 16:49:029

一、云监控2.0：一站式可观测平台的演进

阿里云云监控CloudMonitor 2.0是融合了日志服务SLS、云监控CMS和应用实时监控服务ARMS三大产品能力后全新升级的一站式可观测平台。它能够将指标、链路、日志、事件汇集于统一视图之中，基于UModel建模与观测图谱，实现从基础设施到应用层的全链路、端到端的统一观测。

与传统的监控工具相比，云监控2.0的最大特点在于"统一"二字。过去，运维团队可能需要分别使用SLS查看日志、使用ARMS追踪链路、使用CMS查看云产品指标，数据分散在不同的控制台，难以形成全局视角。云监控2.0打破了这种数据孤岛，让所有可观测数据在一个平台内完成汇聚、分析和告警。

更为重要的是，云监控2.0借助AI增强的跨域智能洞察能力，能够实时分析和预测系统性能，提前识别异常情况，并提供智能化的故障诊断和优化建议。新增的智能根因定位与Copilot辅助诊断功能，可以自动关联异常指标与日志，大幅提升故障排查效率。

在接入方式上，云监控不仅提供可视化操作控制台，还提供了OpenAPI在线调试、阿里云SDK、阿里云CLI等多种调用方式，满足不同场景下的集成需求。

需要先登录阿里云控制台，点击：阿里云控制台

二、准备工作：开通服务与创建工作空间

2.1 开通云监控2.0服务

使用云监控2.0的第一步是开通服务。用户可以直接登录阿里云官网，在云监控产品页面点击开通即可。开通本身不产生费用，费用根据实际使用的监控数据量、存储量和告警通知数量按量计费。

2.2 理解工作空间（Workspace）

工作空间是云监控2.0中最重要的资源隔离概念。通过使用工作空间，可以创建多个独立的资源环境，每个资源环境都可以拥有自己的对象集（如云服务、基础设施、服务端和前端应用、中间件等），每个组内的资源相互隔离，防止不同组之间的资源冲突，提高资源使用的安全性。

简单来说，工作空间类似于一个"监控项目"或"监控租户"。对于拥有多个业务线或多个环境（开发、测试、生产）的团队来说，为每个环境创建独立的工作空间是最佳实践。工作空间所选地域用于存储工作区接入的数据和配置信息。

2.3 创建工作空间

创建工作空间的操作非常简便：

登录云监控2.0控制台
在工作空间页面，单击"新建工作空间"
在新建工作空间对话框中设置以下参数：
- 工作空间名称：自定义名称，长度为3-63个字符，建议使用有业务含义的命名，如"prod-monitoring"或"dev-observability"
- 所属地域：选择监控对象所在地域，不支持跨地域接入监控对象资源
- 工作空间描述：选填，可补充说明该工作空间的用途
单击"保存"完成创建

需要注意的是，一个工作空间只能服务于一个地域。如果您的业务部署在多个地域，需要分别在每个地域创建对应的工作空间。

三、接入中心：全栈监控数据的统一入口

3.1 什么是接入中心

接入中心是云监控2.0构建统一监控体系的基石，通过集中化数据接入和管理，实现从基础设施到业务层的全栈可观测性。作为统一接入入口，支持多源数据接入，涵盖Java应用监控、链路追踪、中间件、人工智能、阿里云服务等观测接入能力。

云监控2.0是把接入的对象统称为实体（Entity），例如接入一个容器集群或者一台ECS实例，对应一个实体。

3.2 ECS实例接入实操

以下以接入ECS实例为例，演示如何通过接入中心将ECS实例接入云监控2.0平台：

登录云监控2.0控制台，选择目标工作空间，在左侧导航栏单击接入中心
在接入中心页面，选择云服务器ECS
在右侧滑出的云服务器ECS对话框中开始接入，选择接入方式：
- 全部实体：匹配和工作空间所属同一地域的所有实体
- 按资源组：匹配选择的目标资源组下全部ECS实例资源
- 按标签：按标签的条件匹配全部ECS实例资源
- 手动选择：自定义选择资源
在接入配置步骤中，勾选以下配置：
- 阿里云ECS监控：采集云服务ECS指标，安装插件Node-exporter和Process-exporter采集主机指标
- 阿里云ECS审计日志：安装插件LoongCollector采集主机系统审计日志
- 阿里云ECS事件：ECS系统事件接入
接入成功后，在接入管理中可以检查接入状态是否正常

3.3 其他接入场景

除了ECS实例，云监控2.0的接入中心还支持多种监控目标的接入：

Web与H5应用：通过接入中心创建应用，自动生成JavaScript SDK，以CDN方式引入即可完成前端监控接入
容器服务ACK：选择容器集群监控指标，一键接入Kubernetes集群的监控数据
Prometheus自定义指标采集：在接入中心搜索"Prometheus自定义指标采集"进行配置
跨账号接入：支持将其他阿里云账号下的资源接入当前工作空间
非阿里云主机：通过安装LoongCollector采集器，将非阿里云ECS主机接入云监控2.0

四、告警规则与通知策略配置

4.1 告警规则创建

告警规则是云监控触发通知的核心条件。创建告警规则的步骤如下：

登录云监控2.0控制台，选择目标工作空间
在左侧导航栏选择"告警中心" → "告警管理" → "告警规则"
单击"创建告警规则"
在创建告警规则面板中设置告警参数，包括：
- 告警规则名称
- 监控目标（选择已接入的实体）
- 告警条件（支持PromQL语句自定义）
- 告警等级（P0/P1/P2/P3/P4）
配置完成后单击确定

云监控2.0的告警规则支持多种类型，包括云产品监控、Prometheus监控、应用监控、AI Agent观察、用户体验监控等。告警事件默认会发送到ARMS告警管理中。

4.2 通知策略配置

通知策略是云监控2.0告警中心的核心调度单元，负责将告警规则与外部集成产生的可观测事件进行订阅、降噪、路由、生命周期管理与自动化行动。

通知策略支持以下功能：

定义告警事件的匹配规则，筛选需要处理的事件
配置事件分组规则，减少通知疲劳度
指定通知对象和通知时段
配置重复通知、升级策略和恢复方式
关联行动集成实现自动化处理

通知策略采用分步配置的向导模式，将通知流程拆分为四个阶段：

事件订阅：定义事件过滤条件，只有满足订阅条件的可观测事件才会进入后续通知流程。支持三种匹配模式——任意（OR逻辑）、所有（AND逻辑）、复合（自定义表达式）
通知配置：包含合并降噪、路由规则和通知模板三个子模块。合并降噪通过指定降噪字段将同维度事件聚合为一个告警；路由规则将事件分派到不同通知对象和渠道
重复/升级/恢复策略：控制告警的生命周期行为，包括恢复通知开关、自动恢复时限、重复通知频率以及升级策略
行动集成：告警触发或恢复时自动执行预设的自动化行动，如调用Webhook、触发函数计算或创建ITSM工单

通知策略与告警规则是多对多的关系：一条通知策略可被多条告警规则引用，一条告警规则也可配置多条通知策略。修改通知策略后，所有引用该策略的告警规则立即生效。

4.3 通知对象配置

在配置告警之前，需要先创建通知对象：

在云监控控制台左侧导航栏选择"报警服务" → "报警联系人"
录入运维手机号、邮箱、钉钉群机器人地址，完成短信、邮件、钉钉三类通知绑定
新建运维联系组，把所有对接人归入分组
后续告警规则直接绑定分组，批量推送消息

五、OpenAPI与SDK集成

5.1 OpenAPI概览

云监控提供可视化操作控制台，还提供OpenAPI在线调试、阿里云SDK、阿里云CLI等调用方式。阿里云OpenAPI通过版本号管控各时期云产品大版本的API列表，云监控目前支持2019-01-01版本的API列表。

云监控在OpenAPI门户提供API调试等功能。在调用前，需要了解云监控提供的版本、接入点说明、集成方式等信息。调试API入口为：https://next.api.alibabacloud.com/api/Cms/2019-01-01/ 。

根据相关资源所在地域，选择对应的服务接入点地址，以获得最低延迟。例如华北3（张家口）的云监控公网接入地址为metrics.cn-zhangjiakou.aliyuncs.com，VPC接入地址为metrics-vpc.cn-zhangjiakou.aliyuncs.com。VPC地址的优势在于高安全性、更快的响应速度和更低的成本。

5.2 使用Python SDK查询监控数据

以下以Python SDK为例，介绍如何通过OpenAPI调用DescribeMetricList接口查询云产品的监控数据：

# 安装依赖：pip install aliyun-python-sdk-cms

from aliyunsdkcore.client import AcsClient
from aliyunsdkcms.request.v20190101 import DescribeMetricListRequest
import json

# 初始化客户端
client = AcsClient(
    '<your-access-key-id>',
    '<your-access-key-secret>',
    'cn-hangzhou'
)

# 构建请求
request = DescribeMetricListRequest.DescribeMetricListRequest()
request.set_Namespace('acs_ecs_dashboard')  # 云产品命名空间
request.set_MetricName('CPUUtilization')    # 监控指标名称
request.set_Period('60')                    # 数据间隔（秒）
request.set_StartTime('2026-07-01 00:00:00')
request.set_EndTime('2026-07-10 23:59:59')

# 发起调用
response = client.do_action_with_exception(request)
data = json.loads(response)
print(json.dumps(data, indent=2, ensure_ascii=False))

DescribeMetricList和DescribeMetricLast接口支持批量获取用户下所有实例的某个指标的数据。如果想获取多个指标，可以多个线程获取多个指标，也可以单线程循环获取多个指标。

5.3 使用Java SDK上报自定义监控数据

云监控支持使用OpenAPI、Java SDK和阿里云CLI三种方式上报监控数据。以下以Java SDK为例演示上报监控数据：

首先在项目中引入Maven依赖：

<dependency>
    <groupId>com.aliyun</groupId>
    <artifactId>aliyun-java-sdk-core</artifactId>
    <version>3.2.6</version>
</dependency>
<dependency>
    <groupId>com.aliyun.openservices</groupId>
    <artifactId>aliyun-cms</artifactId>
    <version>0.2.4</version>
</dependency>

上报原始监控数据的示例：

import com.aliyun.openservices.cms.CMSClient;
import com.aliyun.openservices.cms.CMSClientInit;
import com.aliyun.openservices.cms.model.CustomMetric;
import com.aliyun.openservices.cms.model.CustomMetricUploadRequest;
import com.aliyun.openservices.cms.model.CustomMetricUploadResponse;
import com.aliyun.openservices.cms.model.MetricAttribute;

public class CustomMetricUploadDemo {
    public static void main(String[] args) {
        // 设置应用分组ID
        CMSClientInit.groupId = 101L;
        
        String endPoint = "https://metrichub-cms-cn-hangzhou.aliyuncs.com";
        CMSClient cmsClient = new CMSClient(endPoint, accKey, secret);
        
        CustomMetricUploadRequest request = CustomMetricUploadRequest.builder()
            .append(CustomMetric.builder()
                .setMetricName("myCustomMetric")
                .setGroupId(102L)
                .setTime(new Date())
                .setType(CustomMetric.TYPE_VALUE)
                .appendValue(MetricAttribute.VALUE, 1f)
                .appendDimension("key1", "value1")
                .appendDimension("key2", "value2")
                .build())
            .build();
        
        CustomMetricUploadResponse response = cmsClient.putCustomMetric(request);
        System.out.println(JSONObject.toJSONString(response));
    }
}

上报聚合数据的示例：

CustomMetricUploadRequest request = CustomMetricUploadRequest.builder()
    .append(CustomMetric.builder()
        .setMetricName("customTest")
        .setTime(new Date())
        .setType(CustomMetric.TYPE_AGG)
        .setPeriod(CustomMetric.PERIOD_1M)
        .appendDimension("test", "testValue")
        .appendValue(MetricAttribute.SUM, 100)
        .appendValue(MetricAttribute.MAX, 20)
        .appendValue(MetricAttribute.MIN, 0.1)
        .appendValue(MetricAttribute.COUNT, 20)
        .appendValue(MetricAttribute.AVG, 5)
        .appendValue(MetricAttribute.LAST, 10)
        .appendValue(MetricAttribute.P50, 10)
        .appendValue(MetricAttribute.P90, 17)
        .appendValue(MetricAttribute.P99, 19)
        .build())
    .build();

CustomMetricUploadResponse response = cmsClient.putCustomMetric(request);
System.out.println(JSONObject.toJSONString(response));

上报时必须指定groupId参数，即云监控应用分组ID，该分组ID可以是已在云监控中创建的应用分组，或者一个不存在的应用分组，系统会自动创建新的应用分组。

六、自定义监控数据上报

6.1 自定义监控概述

自定义监控为您提供了自定义监控项和报警规则的功能，您可以通过上报监控数据接口，将自己关心的业务指标上报至云监控，并在云监控上添加监控图表和设置报警规则。您可以针对自己关心的业务指标进行监控，将采集到监控数据上报至云监控，由云监控来进行数据的处理，并根据处理结果进行报警。

6.2 通过CLI上报自定义监控数据

使用阿里云CLI上报自定义监控数据的步骤如下：

在自定义监控数据所在服务器安装阿里云CLI
在自定义监控数据所在服务器配置阿里云账号或RAM用户的AccessKey
在云监控控制台上创建指标仓库
- 指标仓库：命名空间名称
- 数据存储方案：可选择"日志服务"或"云监控存储"
通过CLI命令上报数据

创建数据接入任务后，企业云监控将会在1分钟~2分钟内回溯监控指标若干个周期的历史数据。

七、CLI命令行运维与AI Agent Skill智能化接入

7.1 云监控CLI概述

阿里云云监控CLI（aliyun cms2）是阿里云CLI的子命令插件，覆盖CMS 2.0各模块的命令行操作。aliyun cms2将云监控2.0控制台全部能力收敛为标准化命令行，覆盖接入、Prometheus、APM、告警、指标查询全场景。

使用前需确保环境就绪：

# 确认CLI已安装且版本 >= 3.3.15
aliyun version

# 验证cms2插件可用
aliyun cms2 --help

# 配置凭证（如尚未配置）
aliyun configure

aliyun cms2命令按照业务域划分为五大模块：

接入管理域（integration）：管控接入策略、Addon组件、采集任务、存储与大盘绑定
应用监控（APM）：aliyun cms2 apm
前端监控（RUM）：aliyun cms2 rum
告警管理：告警规则与通知策略的配置
指标查询：监控数据的检索与展示

7.2 CLI接入6步流程

无论接入应用的语言和接入方式，CLI接入均遵循以下6步流程：

# Step 1: 获取账号ID
aliyun sts get-caller-identity --force -o json
# → AccountId: 1108xxxxxxxxxxxx

# Step 2: 初始化APM基础设施（幂等）
aliyun cms2 apm configuration create \
    --workspace default-cms-1108xxxxxxxxxxxx-cn-hangzhou \
    --region cn-hangzhou

# Step 3: 获取接入凭证（LicenseKey、Endpoint等）
aliyun cms2 apm configuration get \
    --workspace default-cms-1108xxxxxxxxxxxx-cn-hangzhou \
    --region cn-hangzhou -o json

# Step 4: 注册应用服务
aliyun cms2 apm service create \
    --service-name my-java-app \
    --language java \
    --workspace default-cms-1108xxxxxxxxxxxx-cn-hangzhou

7.3 AI Agent Skill智能化接入

阿里云可观测团队将接入接口CLI化，并提供开箱即用的Skill，支持主流的APM和AI应用高效接入，用户仅需自然语言描述即可完成自动化接入，显著降低运维门槛。CMS Agent Skill把这些命令组织成面向AI Agent的业务工作流，实现了基于AI Agent的智能化可观测接入——用户只需用自然语言描述需求，AI Agent即可自动编排CLI命令完成全流程。

AI Agent自动调用aliyun cms2对应查询命令，拉取资源列表、实例状态；后端同步调用云监控开放API完成资源创建、组件部署；执行结构化结果校验，检测采集任务、存储、大盘是否正常生效。这种智能化运维方式构建了可控、可审计、可复用的运维闭环，大幅降低SRE日常重复工作成本。

八、仪表盘可视化与数据探索

8.1 创建仪表盘

云监控2.0提供了丰富的可视化能力，用户可以通过仪表盘自定义监控数据的展示方式：

登录云监控2.0控制台，选择目标工作空间
在左侧导航栏选择"可视化" → "仪表盘"
单击"创建仪表盘"，设置仪表盘名称
在仪表盘详情页面，单击"添加可视化组件"
选择图表类型（折线图、柱状图、表格等），再选择云产品及其监控项

8.2 查看实体监控数据

在接入成功后，可以通过以下方式查看监控数据：

在左侧导航栏选择目标实体，查看接入实体的可视化大盘
使用快捷键Ctrl+K弹出搜索框，输入ECS实例名称或者实例ID
选择搜索结果目标实体，查看实体可视化大盘页面
可视化大盘包括Memory分析、CPU分析、Disk分析等图表

九、事件集成与第三方系统对接

云监控2.0事件中心可以通过事件集成功能接入第三方监控平台或自定义系统的告警事件，实现统一的事件管理和告警通知。事件集成支持将来自不同监控系统的告警事件统一接入云监控2.0平台，通过字段映射将外部事件格式转换为标准事件格式。

支持接入的第三方系统包括自建Prometheus、Grafana、Zabbix、Skywalking等。云监控1.0及SLS的告警事件也会自动写入至云监控2.0事件中心。

在配置好集成后，来自集成的事件可以被通知策略匹配到。通过"接入外部报警"功能，外部系统可以调用云监控提供的专用API地址，将告警事件发送至指定的阿里云报警联系组。

十、安全与权限管理

强烈建议创建并使用RAM用户进行API访问或日常运维。阿里云账号拥有所有API的访问权限，风险很高。请根据业务的实际情况按需分配权限后进行接口调用。

RAM用户需具备操作云监控资源的权限。用户身份支持情况如下：

阿里云账号：支持，但风险高，不推荐
RAM用户：支持（推荐）
RAM角色：支持（推荐）

十一、最佳实践与总结

11.1 按业务线划分工作空间

当企业对云上资源进行监控时，通常需要从业务角度集中管理业务线涉及到的云服务器、数据库、负载均衡和存储等资源。您可以使用资源组，按照业务线对资源进行分组管理，然后基于资源组在云监控中创建对应的应用分组，实现按业务线管理报警规则、查看监控数据等目的。

11.2 通知策略与告警规则解耦

当人员或团队发生变化时，只调整通知策略中的通知对象，不动告警规则。这是云监控2.0通知策略与告警规则多对多解耦设计的核心价值。

11.3 充分利用AI能力

云监控2.0的AI增强跨域智能洞察能力、智能根因定位与Copilot辅助诊断功能，可以自动关联异常指标与日志，大幅提升故障排查效率。建议运维团队积极采用这些智能化工具。

问答环节

问1：云监控2.0与旧版云监控有什么区别？
答：云监控2.0是融合了日志服务SLS、云监控CMS和应用实时监控服务ARMS三大产品能力后全新升级的一站式可观测平台。它将指标、链路、日志、事件汇集于统一视图之中，打破了传统监控工具的数据孤岛，并引入了AI增强的跨域智能洞察能力。

问2：如何将自建Prometheus的告警接入云监控2.0？
答：云监控2.0事件中心支持通过事件集成功能接入自建Prometheus的告警事件。您可以在云监控2.0控制台配置事件集成，通过字段映射将Prometheus事件格式转换为标准事件格式，配置完成后即可被通知策略匹配和处理。

问3：云监控2.0的计费方式是什么？
答：开通云监控2.0服务本身不产生费用，费用根据实际使用的监控数据量、存储量和告警通知数量按量计费。具体计费标准请参考阿里云官网的定价页面。

问4：一个工作空间可以跨地域接入监控对象吗？
答：不可以。一个工作空间只能服务于一个地域，不支持跨地域接入监控对象资源。如果您的业务部署在多个地域，需要分别在每个地域创建对应的工作空间。

问5：云监控CLI（aliyun cms2）需要什么版本要求？
答：使用aliyun cms2需要确保阿里云CLI版本大于等于3.3.15。可以通过`aliyun version`命令查看当前版本，通过`aliyun cms2 --help`验证cms2插件是否可用。

问6：如何将非阿里云主机接入云监控2.0？
答：非阿里云ECS主机可以通过安装LoongCollector采集器接入云监控2.0。在服务器上下载安装包并执行安装命令，配置完成后即可在云监控2.0控制台查看该主机的监控数据。