应用实时监控服务ARMS：通过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. 登录容器服务管理控制台，在左侧导航栏选择集群列表，单击目标集群名称。

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 刷新失败的错误）。