Application Real-Time Monitoring Service：通過arms-obi採集Go應用pprof資料

代碼接入

在 Go 服務的 main 包中匯入 net/http/pprof 並啟動一個獨立的 HTTP 服務：

import _ "net/http/pprof"

func main() {
    // 在獨立連接埠啟動 pprof 服務，避免與業務連接埠衝突
    go func() {
        http.ListenAndServe(":6060", nil)
    }()
    // ... 業務代碼
}

容器環境變數

在業務 Pod 的容器 spec 中設定 pprof 連接埠環境變數，環境變數名稱可配置，預設為 ILOGTAIL_PROFILE_PORT，可根據需要調整 values 配置：

containers:
  - name: myapp
    env:
      - name: ILOGTAIL_PROFILE_PORT  # 與 arms-obi 配置的 port_env_name 一致
        value: "6060"

arms-obi 會讀取該環境變數的值來確定採集目標連接埠。

採集配置（collector）

Profile 採集 URL 構造規則：http://<podIP>:<port><pprof_path>/<profile>

過濾配置（selector）

控制哪些 Pod 會被採集。所有條件為 AND 關係，白名單內部為 OR 關係。

LabelKV 格式：{key: "app", value: "myservice"}，value 為空白時僅檢查 key 是否存在。

過濾流水線執行順序：

1. 節點過濾 — 僅採集當前節點上的 Pod（自動完成）。

2. Pod Phase — 僅保留 Running 狀態且有 PodIP 的 Pod。

3. 正則過濾 — namespace / pod_name。

4. Label 白名單 → Label 黑名單。

5. Env 白名單 → Env 黑名單。

6. 連接埠解析 — 從容器 env 中讀取 port_env_name 對應的連接埠值。

ARMS 配置

配置更新

1. 登入Container Service管理主控台，在左側導覽列選擇叢集列表，單擊目的地組群名稱。

2. 在左側導覽列選擇組件管理，找到arms-obi組件，點擊配置，修改profiling採集配置即可。

Agent 日誌中持續出現 "arms sts not ready yet"

ARMS STS 憑證尚未擷取成功。檢查：

• 叢集網路是否可訪問 ARMS 中繼資料 API（{region_id}-intranet-arms.aliyuncs.com）。

• 可通過 kubectl logs 查看詳細錯誤資訊。

沒有發現任何 Pod

檢查過濾規則配置：

• 確認業務 Pod 的容器中設定了 port_env_name 指定的環境變數（預設 ILOGTAIL_PROFILE_PORT）。

• 確認 selector 的 namespace/pod_name 正則、label/env 白名單黑名單配置正確。

• 查看 Agent 日誌中 pod_count 欄位確認發現的 Pod 數量。

採集失敗

常見原因：

• 業務 Pod 未暴露 pprof 介面（確認已 import _ "net/http/pprof" 並啟動 HTTP 服務）。

• pprof 連接埠與 port_env_name 環境變數中配置的連接埠不一致。

• pprof_path 與商務服務的路徑首碼不匹配。

• 網路原則阻止了 Agent Pod 到業務 Pod 的 HTTP 串連。

上傳失敗

常見原因：

• VPC 內網 endpoint 不可達。

• ARMS STS 憑證到期（Agent 會自動重新整理，檢查日誌中是否有 STS 重新整理失敗的錯誤）。