通过 AI Agent 接入 AgentLoop 应用监控

• 服务端应用：应用拓扑、接口调用、异常事务、慢事务等 APM 数据

• AI 应用：LLM 调用耗时、Token 使用量、Agent 链路、工具调用（Tool Call）等 AI 可观测指标

适用场景

根据应用类型，Agent 会自动选择对应的探针与接入路径：

AI Agent 接入说明

alibabacloud-agentloop-management Skill 将 AgentLoop CLI 的接入流程封装为 AI Agent 可执行的结构化工作流，核心能力包括：

• 自然语言驱动：用一句话描述接入需求，无需记忆 CLI 命令与参数。

• 场景感知：根据应用类型、语言、部署环境（ECS、ACK/ACS）自动选择探针方案。

• 自动编排：完成 Workspace 确认、APM 初始化、凭证获取、服务注册与探针配置。

• 安全可控：对 Patch Deployment、修改启动参数等变更操作执行两阶段确认，用户审核后再执行。

典型工作流程：

1. 用户描述接入需求（Workspace、应用类型、语言/框架、应用名、部署环境）。若未提供符合 agentloop-{32位编码} 格式的 Workspace，Agent 会主动询问。

2. Agent 检查 CLI 环境与凭证，初始化 APM 基础设施。

3. Agent 生成执行计划，展示命令、影响范围与回滚方式。

4. 用户确认后，Agent 执行探针注入或启动参数变更。

5. Agent 验证接入结果，引导用户通过控制台查看监控数据。

支持的探针方案

前提条件

步骤一：安装并配置 CLI 环境

若尚未安装阿里云 CLI，请先完成安装。

# 确认 CLI 版本 >= 3.3.15
aliyun version

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

若 cms2 命令不可用：

aliyun plugin update

配置访问凭证：

aliyun configure

步骤二：安装 alibabacloud-agentloop-management Skill

1. 打开 Skill 市场页面：alibabacloud-agentloop-management。

2. 根据页面指引，将 Skill 安装到 Cursor、Claude Code 或 QoderWork。

3. 安装完成后，重启 AI 助手或通过对话确认 Skill 已加载。

自然语言触发示例：

步骤三：使用自然语言发起接入

描述接入需求时，建议包含以下信息（缺失时 Agent 会自动探测或询问）：

将 ACK 集群 default 命名空间下的 order-service 部署接入 AgentLoop APM，语言是 Java，Workspace 是 agentloop-2694ecf8****************1f84542d

帮我在 ECS 实例 i-bp1xxxxxxxxxx 上为 Spring Boot 应用 order-api 接入 APM 监控，Workspace 是 agentloop-2694ecf8****************1f84542d

帮我把 ACK 集群里的 Golang 微服务 payment-service 接入 AgentLoop 应用监控，Workspace 是 agentloop-2694ecf8****************1f84542d

帮我把 ACK 集群里的 LangChain 应用 customer-support-agent 接入 AgentLoop 监控，Workspace 是 agentloop-2694ecf8****************1f84542d

帮我在 ECS 上为 DashScope 对话应用 qa-bot 接入 AgentLoop AI 可观测监控，Workspace 是 agentloop-2694ecf8****************1f84542d

我的 Dify 部署在 K8s 上，帮我配置 OpenTelemetry 上报到 AgentLoop，Workspace 是 agentloop-2694ecf8****************1f84542d

步骤四：确认执行计划并完成接入

Agent 生成执行计划后，会展示目标资源、具体命令、影响范围与回滚方式，等待确认后才执行变更操作。

java -javaagent:/opt/arms/AliyunJavaAgent/aliyun-java-agent.jar \
  -Darms.licenseKey=<LicenseKey> \
  -Darms.appName=order-api \
  -Darms.workspace=agentloop-2694ecf8****************1f84542d \
  -jar app.jar

步骤五：验证接入结果

aliyun cms2 apm service list \
    --workspace agentloop-2694ecf8****************1f84542d \
    --service-name <应用名称> \
    --region cn-hangzhou

kubectl rollout status deployment/<deployment-name> -n <namespace>

kubectl get pods -n <namespace> -l app=<app-label> \
  -o jsonpath='{range .items[*]}{.metadata.name}: initContainers={.spec.initContainers[*].name}{"\n"}{end}'

kubectl logs -n <namespace> -l app=<app-label> --tail=30 | grep -i "arms\|OneAgent\|bootstrap\|agent"

# Java 应用：确认进程中已加载 ARMS Agent
ps aux | grep "aliyun-java-agent" | grep -v grep

查看控制台监控数据

1. 登录 AgentLoop 控制台。

2. 选择目标 Workspace。

3. 在左侧导航栏选择所有功能 > 应用可观测 > 应用监控。

4. 单击目标应用名称，查看监控数据：

   • 服务端应用：应用拓扑、接口调用（QPS/RT/错误率）、异常事务、慢事务

   • AI 应用：LLM 调用（模型名称、耗时、成功率）、Token 统计、Agent 链路、Tool Call 拓扑、异常追踪

Agent 执行流程参考

以下以 K8s 场景为例，展示 Agent 接到确认指令后的典型执行流程，仅供了解 Agent 的内部行为，无需手动执行这些命令。Java 服务端与 Python AI 应用步骤相同，仅 Label 的语言标识不同。

（1）获取账号与集群信息

aliyun sts get-caller-identity --force -o json
aliyun cs describe-clusters

（2）初始化 APM 基础设施并获取凭证

aliyun cms2 apm configuration create \
    --workspace agentloop-2694ecf8****************1f84542d \
    --region cn-hangzhou

aliyun cms2 apm configuration get \
    --workspace agentloop-2694ecf8****************1f84542d \
    --region cn-hangzhou -o json

返回的 authToken 即为 LicenseKey，publicDomain / privateDomain 为数据上报 Endpoint。

（3）注册应用服务

# 服务端 Java 应用示例
aliyun cms2 apm service create \
    --workspace agentloop-2694ecf8****************1f84542d \
    --region cn-hangzhou \
    --body '{"serviceName":"order-service","serviceType":"TRACE","attributes":"{\"language\":\"java\"}"}' \
    < /dev/null

# AI Python 应用示例
aliyun cms2 apm service create \
    --workspace agentloop-2694ecf8****************1f84542d \
    --region cn-hangzhou \
    --body '{"serviceName":"customer-support-agent","serviceType":"TRACE","attributes":"{\"language\":\"python\"}"}' \
    < /dev/null

（4）检查 ack-onepilot 组件状态

kubectl get pods -n ack-onepilot

（5）Patch Deployment 注入探针

Java 服务端应用：

kubectl patch deployment order-service -n default \
    --type=strategic -p '{
      "spec":{"template":{"metadata":{"labels":{
        "aliyun.com/app-language":"java",
        "armsPilotAutoEnable":"on",
        "armsPilotCreateAppName":"order-service",
        "armsPilotAppWorkspace":"agentloop-2694ecf8****************1f84542d"
      }}}}}
    }'

Python AI 应用（LangChain / DashScope 等）：

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":"agentloop-2694ecf8****************1f84542d"
      }}}}}
    }'

（6）验证滚动更新

kubectl rollout status deployment/<deployment-name> -n <namespace> --timeout=120s

接入完成后，Agent 会提示等待 2～3 分钟，然后通过控制台查看监控数据。

K8s 接入 Label 配置参考

K8s 场景下，AI Agent 通过为 Pod Template 添加 Label 触发 ack-onepilot 自动注入探针。Label 必须添加在 spec.template.metadata.labels 层级（Pod Template），而非 Deployment 的 metadata.labels。

labels:
  armsPilotAutoEnable: "on"
  armsPilotCreateAppName: "<应用名称>"
  armsPilotAppWorkspace: "<Workspace 名称>"
  aliyun.com/app-language: "<语言>"   # 如 java、golang、python

完整 YAML 示例（Java 服务端应用）：

apiVersion: apps/v1
kind: Deployment
metadata:
  name: order-service
  namespace: default
spec:
  replicas: 2
  selector:
    matchLabels:
      app: order-service
  template:
    metadata:
      labels:
        app: order-service
        armsPilotAutoEnable: "on"
        armsPilotCreateAppName: "order-service"
        armsPilotAppWorkspace: "agentloop-2694ecf8****************1f84542d"
        aliyun.com/app-language: java
    spec:
      containers:
        - name: order-service
          image: registry.example.com/order-service:latest
          ports:
            - containerPort: 8080

完整 YAML 示例（Python AI 应用）：

apiVersion: apps/v1
kind: Deployment
metadata:
  name: customer-support-agent
  namespace: default
spec:
  replicas: 2
  selector:
    matchLabels:
      app: customer-support-agent
  template:
    metadata:
      labels:
        app: customer-support-agent
        armsPilotAutoEnable: "on"
        armsPilotCreateAppName: "customer-support-agent"
        armsPilotAppWorkspace: "agentloop-2694ecf8****************1f84542d"
        aliyun.com/app-language: python
    spec:
      containers:
        - name: customer-support-agent
          image: registry.example.com/customer-support-agent:latest
          ports:
            - containerPort: 8000

常见问题

aliyun upgrade -y
aliyun plugin update
aliyun cms2 --help

kubectl patch deployment <deployment-name> -n <namespace> \
    --type json \
    --patch '[
      {"op": "remove", "path": "/spec/template/metadata/labels/armsPilotAutoEnable"},
      {"op": "remove", "path": "/spec/template/metadata/labels/armsPilotCreateAppName"},
      {"op": "remove", "path": "/spec/template/metadata/labels/armsPilotAppWorkspace"}
    ]'