arms-obi add-on: prerequisites, capabilities, and release notes-阿里云帮助中心

arms-obi is a non-intrusive application monitoring add-on provided by Alibaba Cloud CloudMonitor 2.0. It lets you integrate Kubernetes applications with CloudMonitor 2.0 without changing application code.

Prerequisites

Note

Alibaba Cloud Linux 3 and Alibaba Cloud Linux 4 meet all of the following requirements by default.

arms-obi supports only Linux environments that meet all of the following requirements:

Requirement	Supported range
Kernel version	Linux 5.8 or later. RHEL-based kernels, Linux 4.18 or later, for RHEL-family distributions that include the eBPF backport patches.
BTF	The kernel must expose BTF (BPF Type Format) information.
CPU architecture	amd64 (x86_64) and arm64 (aarch64).
Permissions	`BPF`: loads BPF programs. `SYS_ADMIN`: replaces the PERFMON permission (applicable to ACK kernels where `perf_event_paranoid≥2`) and is used for Trace Context propagation in Go applications. `NET_ADMIN`: used by TC and XDP network-related BPF programs and for Trace Context propagation in Go applications. `NET_RAW`: creates AF_PACKET raw sockets. `SYS_PTRACE`: reads `/proc/pid/exe` and executable module symbols. `DAC_READ_SEARCH`: reads `/proc/self/mem` to obtain the kernel version. `CHECKPOINT_RESTORE`: accesses symlinks in `/proc` to obtain process information.

To verify whether a target Linux environment meets these requirements, run the following commands in that environment:

# 1. Check the kernel version (must be >= 5.8; RHEL-based >= 4.18).
uname -r

# 2. Check the CPU architecture (must be amd64 or arm64).
uname -m

# 3. Check whether BTF is available (the file exists if BTF is supported).
ls /sys/kernel/btf/vmlinux

Overview

arms-obi is the application monitoring add-on provided by CloudMonitor 2.0. It helps you integrate your applications with CloudMonitor 2.0. The add-on provides the following features:

Automatically collects application monitoring data (including application topology, API calls, exception transactions, and slow transactions) and network data in container environments, and reports the data to CloudMonitor 2.0. No application code changes are required. Supports multiple programming languages, including Java, Go, Python, Node.js, C++, Rust, .NET, and Ruby.
Supports integrating AI Agent data with CloudMonitor 2.0, covering scenarios such as MCP calls, OpenAI, Qwen, Embedding, and Rerank.
Supports both amd64 and arm64 CPU architectures.

Usage notes

To learn how to integrate applications with CloudMonitor 2.0 through arms-obi, see Enable observability on ACK with OBI.

Release notes

July 2026

Version	Image address	Release date	Changes	Impact
0.10.0	`registry.{REGION}.aliyuncs.com/acs/obi:0.10.0`	July 3, 2026	Prevented leaking error text in span status for GenAI scenarios. Synchronized bug fixes from the community.	This upgrade has no impact on your workloads.

June 2026

Version	Image address	Release date	Changes	Impact
0.9.5	`registry.{REGION}.aliyuncs.com/acs/obi:0.9.5`	June 24, 2026	Added observability for AI Agents, including LLM, Embedding, MCP, Rerank, Retrieval, and Tool. Changed path convergence to a threshold-based approach. Fixed trace correlation issues across multiple applications.	This upgrade has no impact on your workloads.
0.9.4	`registry.{REGION}.aliyuncs.com/acs/obi:0.9.4`	June 10, 2026	Added support for application integration without restarting the OBI add-on.	This upgrade has no impact on your workloads.
0.9.3	`registry.{REGION}.aliyuncs.com/acs/obi:0.9.3`	June 3, 2026	Added the profiling data collection component.	This upgrade has no impact on your workloads.

May 2026

Version	Image address	Release date	Changes	Impact
0.9.2	`registry.{REGION}.aliyuncs.com/acs/obi:0.9.2`	May 27, 2026	Added support for integrating applications through the CloudMonitor 2.0 Access Center.	This upgrade has no impact on your workloads.
0.9.1	`registry.{REGION}.aliyuncs.com/acs/obi:0.9.1`	May 24, 2026	Added support for ACK clusters.	This upgrade has no impact on your workloads.
0.9.0	`registry.{REGION}.aliyuncs.com/acs/obi:0.9.0`	May 22, 2026	First release of arms-obi. Supports non-intrusive application monitoring data collection.	This upgrade has no impact on your workloads.