AgentLoop：通過 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"}
    ]'