arms-obi

Updated at:

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

Prerequisites

Alibaba Cloud Linux 3 and Alibaba Cloud Linux 4 meet the kernel version, BTF, CPU architecture, and permission requirements by default.

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

Requirement

Description

Kernel version

  • Linux 5.8 or later.

  • RHEL-based kernels running Linux 4.18 or later, applicable to RHEL-based distributions that include eBPF backport patches.

BTF

The kernel must expose BPF Type Format (BTF) information.

CPU architecture

amd64 (x86_64) and arm64 (aarch64).

Permissions

  • BPF: Loads BPF programs.

  • SYS_ADMIN: Replaces the PERFMON permission for Container Service for Kubernetes (ACK) kernels where perf_event_paranoid≥2, and is used for Trace Context propagation in Go applications.

  • NET_ADMIN: Used by TC/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 kernels must be >= 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

Add-on overview

The arms-obi add-on provides the following features:

  • Collects application monitoring data automatically, including application topology, API calls, exception transactions, and slow transactions, as well as network data in container environments. Reports the data to Cloud Monitor 2.0.

  • Supports multiple programming languages, including Java, Go, Python, Node.js, C++, Rust, .NET, and Ruby.

  • Supports integrating AI Agent data with Cloud Monitor 2.0, including MCP calls, OpenAI, Qwen, Embedding, and Rerank.

  • Supports both amd64 and arm64 CPU architectures.

Usage notes

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

Release notes

October 2026

Version

Image address

Release date

Changes

Impact

0.14.0

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

October 16, 2026

  • Added GPU card metric collection.

  • Synchronized bug fixes from the community.

This upgrade has no impact on your workloads.

0.13.1

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

October 9, 2026

  • Fixed an issue that prevented collection of MySQL data.

  • Added CUDA GPU metrics.

  • Added MCP metrics.

  • Synchronized bug fixes from the community.

This upgrade has no impact on your workloads.

September 2026

Version

Image address

Release date

Changes

Impact

0.13.0

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

September 15, 2026

  • Added support for Kubernetes 1.24.

  • Added sampling for network metric collection.

  • Synchronized bug fixes from the community.

This upgrade has no impact on your workloads.

0.12.0

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

September 5, 2026

  • Added support for collecting Go profiling data by using a Deployment.

  • Synchronized bug fixes from the community.

This upgrade has no impact on your workloads.

July 2026

Version

Image address

Release date

Changes

Impact

0.10.2

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

July 28, 2026

  • Added support for Kubernetes 1.26 and later.

  • Synchronized bug fixes from the community.

  • Added support for LLM gateways and server-side adaptive integration with AI Agent applications.

This upgrade has no impact on your workloads.

0.10.1

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

July 20, 2026

  • Reduced kernel resource consumption and removed PID information for processes that do not require monitoring.

  • Synchronized bug fixes from the community.

This upgrade has no impact on your workloads.

0.10.0

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

July 3, 2026

  • Prevented error text from being exposed in span status in 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 arms-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 a profiling data collection add-on.

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 Cloud Monitor 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

The arms-obi add-on was initially released, with support for non-intrusive application monitoring data collection.

The initial installation has no impact on your workloads.