Skip to main content
Version: 3.7.0

Technology Support Matrix

SmartAgent has certain requirements for operating systems, system architectures, and runtime environments depending on the deployment mode. Please ensure the target environment meets the corresponding requirements before installation.

warning

The versions not listed in the table do not mean they are unsupported; they have just not been officially validated.

Supported Systems & Architectures​

Linux requires GNU libc ≥ 2.5 (check version with ldd --version). The following table lists the tested system versions:

Operating SystemVersion RequirementSupported ArchitectureNotes
CentOS5.11~8.5x86, x86_64, aarch64amd: 5.11, 6.0, 6.5, 6.10, 7.2, 7.6, 7.8, 7.9, 8.1, 8.2, 8.5
arm: 7.6, 7.9, 8
Red Hat Enterprise Linux6.10~8.4x86, x86_64Specific versions: 6.10, 7.1, 7.6, 8.2, 8.4
Fedora20~39x86_64Specific versions: 20, 30, 32, 35, 36, 39
Debian6.0~12x86_64Specific versions: 6.0.10, 7.11.0, 5.11.0, 9.12.0, 10.4.0, 11.5.0, 12
Ubuntu12.04~23x86_64Specific versions: 12.04.5, 14.04.6, 16.04.6, 18.04, 19.04, 20.04, 21, 22, 23
Snap-installed packages are not supported (apps inside Snap run in a sandbox and cannot access agent files). Running Snap-installed apps may show: ERROR: ld.so: object '/lib/x86_64-linux-gnu/libagentloader.so' from /etc/ld.so.preload cannot be preloaded (failed to map segment from shared object): ignored.
Oracle Linux6.1~9x86, x86_64Specific versions: 6.1, 7.8, 8.2, 8.4, 9.0
openSUSE11x86_64
SUSE Enterprise Linux11.4~15x86_64Specific versions: 11 SP4, 12 SP3, 12 SP5, 15
UnionTech UOSV20-1020, 1021, 1030, 1032aarch64
Kylin OSNeoKylin V7, Galaxy Kylin V10aarch64
openEuler20.03, 21.09, 24.03x86_64, aarch64
WindowsWindows Server 2003、Server 2008、 Server 2012、Server 2016、Server 2019、
Windows 7、7SP1、8、8.1、10 1909 (Windows Server 2003 requires manual -javaagent)		x86, x86_64Only supported on host machine; containerized environments not supported
AIX5.3, 6.1, 7.1, 7.2 (only automatic monitoring for 64-bit apps; 32-bit apps require manual -javaagent)PowerPC 64Maintenance ends 2025; can monitor apps via -javaagent
Integrated Component: node-problem-detectorLinux kernel ≥ 2.6.23 (tested: 3.10.0, 5.10.0)x86_64Only supports Linux 64-bit

Deployment Support Matrix​

Deployment MethodLinux (x86)Linux (x86_64)Linux (aarch64)WindowsAuto Monitoring Containerized Application & Container Metrics
Install on Host - root✅✅✅✅✅
Install on Host - non-root✅✅✅❌❌
Deploy via Kubernetes DaemonSet❌✅✅❌✅
Deploy via Bonree Operator❌✅✅❌✅
Serverless✅✅✅✅✅ (By integrating the Serverless package into the container image yourself)
❌ Does not support collecting container metrics

Supported Application Types & Versions​

SmartAgent supports agents for multiple language runtimes and common middleware. The following versions are verified:

TypeSupported VersionsOSArchitectureNotes
Java JVMOracle Hotspot 6~21Linux / Windowsx86, x86_64, aarch64aarch64 only supported on Linux
IBM J9 VM 1.6 ~ 1.8Linux / Windowsx86, x86_64, aarch64aarch64 only supported on Linux
OpenJ9 0.8~0.11Linux / Windowsx86, x86_64, aarch64aarch64 only supported on Linux
Oracle JRockit 1.6Linux / Windowsx86, x86_64, aarch64aarch64 only supported on Linux
OpenJDK 1.6 ~ 21Linux / Windowsx86, x86_64, aarch64aarch64 only supported on Linux
Huawei Bisheng JDK 8/11/17Linux / Windowsx86, x86_64, aarch64aarch64 only supported on Linux
.NET Core2.0 / 2.1 / 2.2 / 3.0 / 3.1 / 5.0Linux / Windowsx86_64, aarch64-
.NET4.0 / 4.5 / 4.5.1 / 4.5.2 / 4.6 / 4.6.1 / 4.7 / 4.8 / 5.0 / 6.0 / 7.0 / 8.0Windowsx86, x86_642.0, 3.0, 3.5 (not fully tested; use with caution)
PHP5.2.14 ~ 5.6.*
7.0 ~ 7.4
8.0 ~ 8.1.7		Linuxx86, x86_64, aarch64-
Python2.6, 2.7, 3.4 ~ 3.12Linuxx86, x86_64, aarch64-
Nginx1.13.* ~ 1.28.0Linuxx86, x86_64, aarch64-
OpenResty1.13.* ~ 1.19.*, 1.21.4.*, 1.25.3.*, 1.27.1.*Linuxx86, x86_64, aarch64-
Tengine2.3.0 ~ 2.3.2, 2.4.0, 3.1.0Linuxx86, x86_64, aarch64-
Golang1.13 ~ 1.23Linuxx86_64Only Linux x86_64 supported; musl libc-based apps only fully tested for 1.13.*
Apache2.2.3 ~ 2.2.34, 2.4.1 ~ 2.4.56Linuxx86, x86_64-
Node.js6.14.2+, 8.*, 10, 12, 14, 16Linuxx86, x86_64-

Supported Container Environments​

SmartAgent supports automatic monitoring of applications running in container environments. Verified versions are listed below:

Container TypeRuntime ModeVersionSupported OSArchitectureNotes
Docker Engine-1.11.1, 1.12.6Linuxx86_64Tested
Docker CE / EE-17.* ~ 24.* (17.03, 18.03, 19, 20, 24)Linuxx86_64, aarch64Tested
containerd-1.6.8, 1.6.9Linuxx86_64, aarch64Tested
Podmanroot / non-root (untested)1.0.0Linuxx86_64Non-root container means created under non-root user
root / non-root1.6.4Linuxx86_64Tested
root / non-root1.8.0Linuxx86_64Tested
root / non-root2.0.5Linuxx86_64Tested
root / non-root2.2.1Linuxx86_64Tested
root / non-root3.0.0Linuxx86_64Tested
root / non-root3.1.0Linuxx86_64Tested
root / non-root3.3.1Linuxx86_64Tested
root / non-root4.7.2Linuxx86_64Tested
CRI-Oroot container1.18.* ~ 1.24.* (1.18, 1.19, 1.20, 1.21, 1.24)Linuxx86_64Tested
warning

Note that when using Podman to restart multiple containers simultaneously, only one container may be successfully monitored.
For example: podman restart containerA containerB containerC

Supported Container Orchestration Tools​

Container Orchestration ToolVersion RequirementsNotes
KubernetesLinux only
1.17 ~ 1.28
（Tested versions: 1.17.17, 1.19.0, 1.19.3, 1.21.1, 1.22.2, 1.23.5, 1.24.0, 1.28.2; CCE Agile: v1.28.5-r11）
  • Non-standard Kubernetes is not supported (such as Tencent Cloud EKS supernodes, which have not been fully verified and require risk assessment by users)
  • Container deployment testing in clusters only covers minimal Pod configurations (apiVersion, kind, metadata.name, spec.containers) and fields including imagePullPolicy, ports, resources, replicas, strategy, revisionHistoryLimit
  • Other configuration items outside the tested scope may not be supported, please verify on your own