arms-obi

更新时间:
复制 MD 格式

arms-obi 是阿里云云监控 2.0 针对 Kubernetes 应用接入场景提供的无侵入式应用监控组件。本文介绍 arms-obi 组件的基本信息、使用说明及变更记录。

使用前提

说明

Alibaba Cloud Linux 3 和 Alibaba Cloud Linux 4 操作系统默认满足以下所有条件。

arms-obi 仅支持同时满足以下所有条件的 Linux 环境:

要求项

支持范围

内核版本

  • Linux 5.8 及以上

  • RHEL 系内核,Linux 4.18 及以上,适用于已合入 eBPF 回移补丁的 RHEL 系发行版。

BTF

内核须暴露 BTF(BPF Type Format)信息。

CPU 架构

amd64(x86_64)、arm64(aarch64)。

权限

  • BPF:加载 BPF 程序。

  • SYS_ADMIN:替代 PERFMON 权限(适用于 ACK 内核 perf_event_paranoid≥2 场景),并用于Go 应用的 Trace Context 传播。

  • NET_ADMIN:用于 TC/XDP 网络相关 BPF 程序及Go 应用的 Trace Context 传播。

  • NET_RAW:创建 AF_PACKET raw socket。

  • SYS_PTRACE:读取 /proc/pid/exe 及可执行模块符号。

  • DAC_READ_SEARCH:读取 /proc/self/mem 以获取内核版本。

  • CHECKPOINT_RESTORE:访问 /proc 中的 symlink 以获取进程信息。

如需确认目标 Linux 环境是否满足上述条件,可在该环境中依次执行以下命令逐项检查:

# 1. 查看内核版本(需 >= 5.8;RHEL 系 >= 4.18)
uname -r

# 2. 查看 CPU 架构(需为 amd64 或 arm64)
uname -m

# 3. 检查 BTF 是否可用(文件存在即表示支持)
ls /sys/kernel/btf/vmlinux

组件介绍

arms-obi 是云监控 2.0 提供的应用监控系统组件,用于帮助用户便捷地接入云监控 2.0。该组件提供以下功能:

  • 在容器环境中自动采集应用监控数据(包括应用拓扑、接口调用、异常事务和慢事务等)及网络数据,并上报至云监控 2.0。无需修改应用代码,支持 Java、Go、Python、Node.js、C++、Rust、.NET、Ruby 等多种语言。

  • 支持将 AI Agent 数据接入云监控 2.0,涵盖 MCP 调用、OpenAI、Qwen、Embedding、Rerank 等场景。

  • 同时支持 amd64 和 arm64 两种 CPU 架构。

使用说明

关于如何通过 arms-obi 将应用接入云监控 2.0,请参见 ACK上通过OpenTelemetry eBPF(OBI)接入可观测

变更记录

2026 年 7 月

版本号

镜像地址

变更时间

变更内容

变更影响

0.10.0

registry.{REGION}.aliyuncs.com/acs/obi:0.10.0

2026 年 7 月 3 日

  • GenAI 场景避免在 span status 中泄露错误文本。

  • 同步社区 BugFix。

此次升级不会对业务造成影响。

2026 年 6 月

版本号

镜像地址

变更时间

变更内容

变更影响

0.9.5

registry.{REGION}.aliyuncs.com/acs/obi:0.9.5

2026 年 6 月 24 日

  • 增加对 AI Agent 的可观测能力,如 LLM、Embedding、MCP、Rerank、Retrieval、Tool 等。

  • 路径收敛改为阈值方式。

  • 修复多应用间的 Trace 串联问题。

此次升级不会对业务造成影响。

0.9.4

registry.{REGION}.aliyuncs.com/acs/obi:0.9.4

2026 年 6 月 10 日

支持不重启 OBI 组件完成应用接入。

此次升级不会对业务造成影响。

0.9.3

registry.{REGION}.aliyuncs.com/acs/obi:0.9.3

2026 年 6 月 3 日

增加 profiling 采集组件。

此次升级不会对业务造成影响。

2026 年 5 月

版本号

镜像地址

变更时间

变更内容

变更影响

0.9.2

registry.{REGION}.aliyuncs.com/acs/obi:0.9.2

2026 年 5 月 27 日

支持通过云监控 2.0 接入中心接入应用。

此次升级不会对业务造成影响。

0.9.1

registry.{REGION}.aliyuncs.com/acs/obi:0.9.1

2026 年 5 月 24 日

新增对 ACK 集群的支持。

此次升级不会对业务造成影响。

0.9.0

registry.{REGION}.aliyuncs.com/acs/obi:0.9.0

2026 年 5 月 22 日

arms-obi 组件首次发布上线,支持无侵入式应用监控数据采集。

此次升级不会对业务造成影响。