告别复杂接入流程：用 AI Agent Skill 驱动云监控可观测接入

一、背景

随着云原生架构的普及和 AI 应用的快速增长，企业需要管理的应用类型日益丰富——从传统 Java 微服务到 AI Agent，从 Golang 后端到各类 AI 网关组件。与此同时，可观测平台的接入配置涉及大量参数和步骤，对运维效率提出了更高要求。

阿里云云监控 CMS（CloudMonitor Service）2.0 作为阿里云统一的可观测管理平台，整合了应用监控（APM）、前端监控（RUM）、Prometheus 服务、告警管理等核心能力。为了让用户在终端环境下也能高效完成可观测接入，CMS 团队推出了 aliyun cms2 CLI 工具。更进一步，通过将 CLI 能力封装为 alibabacloud-cms-manage Skill，我们实现了基于 AI Agent 的智能化可观测接入——用户只需用自然语言描述需求，AI Agent 即可自动编排 CLI 命令完成全流程。

本文将介绍 CMS CLI 的应用接入能力，并重点演示如何通过 AI Agent Skill 实现 K8s 场景下的自动化接入。

二、CMS CLI 概览

aliyun cms2 是阿里云 CLI 的子命令插件，覆盖 CMS 2.0 各模块的命令行操作：

使用前需确保环境就绪：

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

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

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

三、应用接入能力

APM 与 AI 可观测

CMS CLI 的 APM 模块支持多种语言的应用接入，同时提供ack-onepilot（K8s 容器）、手动自研探针和原生 OpenTelemetry 三种接入方式：

在 AI 可观测方面，CMS 2.0 为主流 AI 框架提供了开箱即用的接入体验：

四、CLI 接入流程

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

图2：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

返回示例：

{
  "success": true,
  "data": {
    "entryPointInfo": {
      "authToken": "a]***@***************4b70",
      "privateDomain": "proj-xtrace-***-cn-hangzhou.cn-hangzhou-intranet.log.aliyuncs.com",
      "project": "proj-xtrace-***-cn-hangzhou",
      "publicDomain": "proj-xtrace-***-cn-hangzhou.cn-hangzhou.log.aliyuncs.com"
    },
    "status": "Running",
    "workspace": "default-cms-1108xxxxxxxxxxxx-cn-hangzhou"
  }
}

# Step 4: 注册应用服务
$ aliyun cms2 apm service create \
    --workspace default-cms-1108xxxxxxxxxxxx-cn-hangzhou \
    --region cn-hangzhou \
    --body '{"serviceName":"my-app","serviceType":"TRACE","attributes":"{\"language\":\"java\"}"}' \
    < /dev/null
# → serviceId: a]***@*********************7f1

# Step 5: 获取接入配置模板（以 Java OTel 为例）
$ aliyun cms2 integration addon get --addon-name apm-java-batch --env-type Client -o json

# Step 6: 验证接入
$ aliyun cms2 apm service list \
    --workspace default-cms-1108xxxxxxxxxxxx-cn-hangzhou \
    --service-name my-app --region cn-hangzhou

上述流程虽然清晰，但 6 步操作、多个参数传递，对非高频使用 CLI 的运维人员来说仍有一定门槛。接下来介绍如何通过 AI Agent Skill 将这一过程简化为一句自然语言。

图3：基于 Skill 一句话轻松搞定接入

五、通过 AI Agent Skill 实现智能化接入

alibabacloud-cms-manage Skill

CMS 团队将完整的 CLI 操作知识封装为开箱即用的 Skill —— alibabacloud-cms-manage，其核心思路是将 CLI 操作流程转化为 AI Agent 可执行的结构化工作流。用户无需记忆命令和参数，只需用自然语言描述需求即可完成接入。

Skill 覆盖以下模块：

Skill 安装与使用详见：https://skills.aliyun.com/skills/alibabacloud-cms-manage

六、工作机制

当用户在 Claude Code 中描述需求时，AI Agent 按以下流程工作：

图4：Skill 智能接入工作流程图

七、安全机制：两阶段确认协议

对于可能影响用户集群的操作（如安装组件、Patch Deployment），Skill 严格执行两阶段确认：

只读命令（get、list）和 CMS 后端资源创建（apm configuration create）无需确认，Agent 可直接执行。

图5：两阶段确认协议

八、使用效果演示：K8s 容器自动接入

以下是通过 Skill 完成 ACK 集群中 LangChain 应用自动接入的完整交互过程。ack-onepilot 通过 DaemonSet 在集群节点运行 Agent Pod，当 Deployment 标注指定 Label 后自动注入探针，无需修改应用代码或 Dockerfile。

用户：

帮我把 ACK 集群里的 LangChain 应用 customer-support-agent 接入 CMS 监控

AI Agent：

检测到容器接入场景，正在获取集群信息...

$ aliyun sts get-caller-identity --force -o json
# → AccountId: 1108xxxxxxxxxxxx

$ aliyun cs describe-clusters
# → clusterId: c8d3f***********, region_id: cn-hangzhou

正在初始化 APM 基础设施并获取凭证...

$ aliyun cms2 apm configuration create \
    --workspace default-cms-1108xxxxxxxxxxxx-cn-hangzhou --region cn-hangzhou
# → 成功

$ aliyun cms2 apm configuration get \
    --workspace default-cms-1108xxxxxxxxxxxx-cn-hangzhou --region cn-hangzhou -o json
# → LicenseKey: a]***@***************4b70

$ aliyun cms2 apm service create \
    --workspace default-cms-1108xxxxxxxxxxxx-cn-hangzhou --region cn-hangzhou \
    --body '{"serviceName":"customer-support-agent","serviceType":"TRACE","attributes":"{\"language\":\"python\"}"}' \
    < /dev/null
# → serviceId: a]***@*********************7f1

正在检查 ack-onepilot 组件状态...

$ kubectl get pods -n ack-onepilot
# NAME                      READY   STATUS    RESTARTS   AGE
# ack-onepilot-7d8f9        1/1     Running   0          5d

ack-onepilot 已安装且正常运行。正在查找目标 Deployment...

$ kubectl get deployment --all-namespaces | grep customer-support
# default   customer-support-agent   3/3     3    3    12d

找到目标 Deployment default/customer-support-agent（3 副本）。执行计划 — Patch K8s Deployment请确认执行（yes / no）。

用户：

yes

AI Agent：

正在执行 Patch...

$ kubectl patch deployment customer-support-agent -n default \
    --type=strategic -p '{
      "spec":{"template":{"metadata":{"labels":{
        "aliyun.com/app-language":"python",
        "armsPilotAutoEnable":"on",
        "armsPilotCreateAppName":"customer-support-agent",
        "armsPilotAppWorkspace":"default-cms-1108xxxxxxxxxxxx-cn-hangzhou"
      }}}}}'
# deployment.apps/customer-support-agent patched

正在验证滚动更新...

$ kubectl rollout status deployment/customer-support-agent -n default --timeout=120s
# deployment "customer-support-agent" successfully rolled out

接入完成！应用已通过 ack-onepilot 自动注入 Python 探针，2-3 分钟后即可在 CMS 控制台 看到 LLM 调用耗时、Token 使用量、Agent 链路等监控数据。

整个过程中，用户只提供了一句自然语言描述。AI Agent 自动完成了：账号获取、集群信息派生（无需手动提供 regionId）、基础设施初始化、凭证获取、服务注册、组件状态检查、Deployment 查找，并通过两阶段确认让用户审核 Patch 内容后再执行。对比手动操作需要执行的 8+ 条命令，Skill 将接入体验从"记命令、查参数、拼 JSON"简化为一句话。

图6：K8s ack-onepilot 自动接入

如果您对 CMS CLI 或 AI Agent 驱动的可观测接入感兴趣，欢迎访问以下资源：

• alibabacloud-cms-manage Skill
• CMS 2.0 控制台
• APM 应用监控文档
• 阿里云 CLI 安装指南