Cloud Monitor：接入 AI 編程助手

使用限制

• 作業系統：支援 macOS、Linux 和 WSL。Windows 原生環境暫不支援。

• Node.js：建議安裝 Node.js 22，要求 Node.js 18 及以上版本。

• AI 編程助手：已安裝並使用過 Qoder IDE、Qoder CLI 或 Codex 等 AI 編程助手。Pilot 需要在日常使用這些工具的同一個作業系統使用者下安裝。

• CloudMonitor服務：已開通CloudMonitor 2.0 服務，並建立了目標工作空間。

• Trace 接入：如需上報 Trace，需在接入中心擷取 Trace 接入 LicenseKey 和 Trace Endpoint。

• 日誌接入：如需上報日誌，需在接入中心完成日誌接入資源初始化，並擷取Log Service Project、Logstore 和 Endpoint。

步驟一：擷取接入命令

在安裝 LoongSuite Pilot 前，您需要先從CloudMonitor 2.0 控制台擷取接入命令。

1. 登入CloudMonitor 2.0 控制台，選擇目標工作空間。

2. 在左側導覽列單擊接入中心。

3. 在AI 應用可觀測地區單擊LoongSuite Pilot或對應 AI 編程助手接入卡片。

4. 在參數配置地區完成配置。串連方式選擇公網方式或阿里雲內網方式；應用程式名稱首碼用於產生服務名，例如 ai-coding-agent 會產生 ai-coding-agent-qoder、ai-coding-agent-codex 等服務名；Trace 接入開啟後需要擷取 LicenseKey；日誌接入開啟後需要完成日誌接入資源初始化。

頁面下方將根據配置參數產生相應的安裝命令。命令中如果仍顯示“請先...”佔位，請先回到上方完成 LicenseKey 擷取或日誌資源初始化後再執行。

步驟二：安裝接入

# 安裝 nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash

# 用 nvm 安裝 v22 版本的 Node.js
nvm install 22

curl -fsSL https://aliyun-observability-release-cn-shanghai.oss-cn-shanghai.aliyuncs.com/loongsuite-pilot/installer.sh -o /tmp/loongsuite-pilot-installer.sh && bash /tmp/loongsuite-pilot-installer.sh install \
  --collect-log "true" \
  --collect-trace "true" \
  --sls-project "<Log ServiceProject>" \
  --sls-logstore "pilot-audit-log" \
  --sls-endpoint "<Log ServiceEndpoint>" \
  --cms-license-key "<Trace接入LicenseKey>" \
  --cms-endpoint "<Trace接入Endpoint>" \
  --cms-workspace "<CloudMonitor工作空間>" \
  --service-name-prefix "<應用程式名稱首碼>"

步驟三：驗證安裝

安裝完成後，執行以下命令檢查 LoongSuite Pilot 是否正常運行：

loongsuite-pilot status
loongsuite-pilot info
ls "$HOME/.loongsuite-pilot/logs/output"

使用 Qoder IDE、Qoder CLI 或 Codex 完成一次 AI 產生或對話後，等待採集服務重新整理。預設 JSONL 兜底輸出目錄應產生增量採集結果：

ls -lt "$HOME/.loongsuite-pilot/logs/output"

如果開啟了日誌接入，可以在 AgentLoop 的審計 > AI Agent洞察中查看 AI Agent 日誌，也可以在Log Service目標 Project 的 pilot-audit-log 中檢索原始 Agent 活動事件。如果開啟了 Trace 接入，可以在CloudMonitor 2.0 的 AI 應用可觀測中查看對應服務的調用鏈路。

步驟四：查看監控資料

Trace 資料在CloudMonitor 2.0 的 AI 應用可觀測中查看；日誌接入產生的 Agent 審計資料在 AgentLoop 的 AI Agent洞察中查看。

1. 登入CloudMonitor 2.0 控制台，選擇目標工作空間。

2. 在左側導覽列選擇應用可觀測 > AI 應用可觀測。

3. 在應用列表中尋找安裝時配置的服務名首碼。例如應用程式名稱首碼為 ai-coding-agent 時，可尋找 ai-coding-agent-qoder、ai-coding-agent-codex 等服務。

4. 單擊應用程式名稱或選擇調用鏈分析，查看會話、Turn、Step、LLM 調用、工具調用、Token 消耗和耗時分布。

5. 如需查看日誌接入上報的 Agent 活動事件，進入 AgentLoop，選擇目標工作空間，在左側導覽列選擇審計 > AI Agent洞察，查看 AI Agent 日誌、會話記錄和工具調用審計資料。

升級和卸載

LoongSuite Pilot 會自動檢查並在後台完成升級，無需手動執行升級命令；升級後會繼續使用當前採集配置。

如需完全卸載 LoongSuite Pilot，並刪除本地配置和日誌資料，執行以下命令：

curl -fsSL https://aliyun-observability-release-cn-shanghai.oss-cn-shanghai.aliyuncs.com/loongsuite-pilot/installer.sh | bash -s -- uninstall --purge

支援範圍

常見問題