技术类型支持矩阵
SmartAgent 在不同的部署模式下对操作系统、系统架构和运行环境有一定的要求。在安装前，请确保目标环境满足相应的条件。
注意
对于列表中未列出的版本，并不意味着不支持，而是尚未经过官方验证。
支持的系统与架构
Linux 要求 GNU libc ≥ 2.5（可通过 ldd --version 查看版本号）以下表格为已测试过的系统版本
| 操作系统 | 版本要求 | 支持架构 | 说明 |
|---|---|---|---|
| CentOS | 5.11~8.5 | x86, x86_64, aarch64 | amd：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 Linux | 6.10~8.4 | x86, x86_64 | 具体版本：6.10、7.1、7.6、8.2、8.4 |
| Fedora | 20~39 | x86_64 | 具体版本：20、30、32、35、36、39 |
| Debian | 6.0~12 | x86_64 | 具体版本：6.0.10、7.11.0、5.11.0、9.12.0、10.4.0、11.5.0、12 |
| Ubuntu | 12.04~23 | x86_64 | 具体版本：12.04.5、14.04.6、16.04.6、18.04、19.04、20.04、21、22、23 不支持监控通过Snap安装的软件包（由于其内的软件是通过沙箱运行，无法访问探针文件）。执行Snap内的软件时，会出现以下报错：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 Linux | 6.1~9 | x86, x86_64 | 具体版本：6.1、7.8、8.2、8.4、9.0 |
| openSUSE | 11 | x86_64 | |
| SUSE Enterprise Linux | 11.4~15 | x86_64 | 具体版本：11 SP4、12 SP3、12 SP5、15 |
| 统信UOS | V20-1020、1021、1030、1032 | aarch64 | |
| 麒麟系统 | 中标麒麟V7版本、银河麒麟V10版本 | aarch64 | |
| openEuler | 20.03、21.09、 24.03 | x86_64, aarch64 | |
| Windows | Windows Server 2003、Server 2008、 Server 2012、Server 2016、Server 2019、 Windows 7、7SP1、8、8.1、10 1909（windows2003 需要手动加 -javaagent 参数) | x86, x86_64 | 仅支持在宿主机上安装，不支持容器化场景 |
| AIX | 5.3、6.1、7.1、7.2（仅支持自动监控64位的应用，32位的应用手动加 -javaagent 参数） | PowerPC 64 | 【2025年终止维护，可通过 -javaagent 方式监控应用】 |
| 集成组件：node-problem-detector | linux 内核版本限制：2.6.23+（测试过的内核版本：3.10.0、5.10.0） | x86_64 | 仅支持 linux 64位系统 |
部署方式支持矩阵
| 部署方式 | Linux (x86) | Linux (x86_64) | Linux (aarch64) | Windows | 自动监控容器化应用及容器指标 |
|---|---|---|---|---|---|
| 在宿主机上安装 - root | ✅ | ✅ | ✅ | ✅ | ✅ |
| 在宿主机上安装 - 非 root | ✅ | ✅ | ✅ | ❌ | ❌ |
| Kubernetes DaemonSet | ❌ | ✅ | ✅ | ❌ | ✅ |
| Bonree Operator | ❌ | ✅ | ✅ | ❌ | ✅ |
| Serverless | ✅ | ✅ | ✅ | ✅ | ✅（通过将Serverless包自行集成至容器镜像内实现） ❌不支持采集容器指标 |
支持的应用类型与版本
SmartAgent 支持多种语言运行时与常见中间件的探针部署，以下为已验证版本范围。
| 类型 | 支持版本 | 系统 | 支持架构 | 备注 |
|---|---|---|---|---|
| Java JVM | Oracle Hotspot 6~21 | Linux / Windows | x86, x86_64, aarch64 | aarch64 仅支持 Linux |
| IBM J9 VM 1.6 ~ 1.8 | Linux / Windows | x86, x86_64, aarch64 | aarch64 仅支持 Linux | |
| OpenJ9 0.8~0.11 | Linux / Windows | x86, x86_64, aarch64 | aarch64 仅支持 Linux | |
| Oracle JRockit 1.6 | Linux / Windows | x86, x86_64, aarch64 | aarch64 仅支持 Linux | |
| OpenJDK 1.6 ~ 21 | Linux / Windows | x86, x86_64, aarch64 | aarch64 仅支持 Linux | |
| 华为为昇JDK 8/11/17 | Linux / Windows | x86, x86_64, aarch64 | aarch64 仅支持 Linux | |
| .NET Core | 2.0 / 2.1 / 2.2 / 3.0 / 3.1 / 5.0 | Linux / Windows | x86_64, aarch64 | - |
| .NET | 4.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.0 | Windows | x86,x86_64 | 2.0、3.0、3.5（未详细测试，谨慎安装） |
| PHP | 5.2.14 ~ 5.6.* 7.0 ~ 7.4 8.0 ~ 8.1.7 | Linux | x86, x86_64, aarch64 | - |
| Python | 2.6, 2.7, 3.4 ~ 3.12 | Linux | x86, x86_64, aarch64 | - |
| Nginx | 1.13.* ~ 1.28.0 | Linux | x86, x86_64, aarch64 | - |
| OpenResty | 1.13.* ~ 1.19.*、1.21.4.*、1.25.3.*、1.27.1.* | Linux | x86, x86_64, aarch64 | - |
| Tengine | 2.3.0 ~ 2.3.2、2.4.0、3.1.0 | Linux | x86, x86_64, aarch64 | - |
| Golang | 1.13 ~ 1.23 | Linux | x86_64 | 仅 Linux x86_64 支持，其中基于musl libc的应用仅 1.13.*经过完整测试 |
| Apache | 2.2.3 ~ 2.2.34, 2.4.1 ~ 2.4.56 | Linux | x86, x86_64 | - |
| Node.js | 6.14.2+, 8.*, 10, 12, 14, 16 | Linux | x86, x86_64 | - |
支持的容器环境
SmartAgent 支持自动监控在容器环境中运行的应用服务，以下为已验证版本范围。
| 容器类型 | 运行方式 | 版本 | 支持系统 | 支持架构 | 备注 |
|---|---|---|---|---|---|
| Docker Engine | - | 1.11.1、1.12.6 | Linux | x86_64 | 已测试 |
| Docker CE / EE | - | 17.* ~ 24.*（17.03、18.03、19、20、24） | Linux | x86_64, aarch64 | 已测试 |
| containerd | - | 1.6.8、1.6.9 | Linux | x86_64, aarch64 | 已测试 |
| Podman | root / 非 root（未测试） | 1.0.0 | Linux | x86_64 | 非 root 容器指在非 root 用户权限下创建的容器 |
| root / 非 root | 1.6.4 | Linux | x86_64 | 已测试 | |
| root / 非 root | 1.8.0 | Linux | x86_64 | 已测试 | |
| root / 非 root | 2.0.5 | Linux | x86_64 | 已测试 | |
| root / 非 root | 2.2.1 | Linux | x86_64 | 已测试 | |
| root / 非 root | 3.0.0 | Linux | x86_64 | 已测试 | |
| root / 非 root | 3.1.0 | Linux | x86_64 | 已测试 | |
| root / 非 root | 3.3.1 | Linux | x86_64 | 已测试 | |
| root / 非 root | 4.7.2 | Linux | x86_64 | 已测试 | |
| CRI-O | root 容器 | 1.18.* ~ 1.24.*（1.18、1.19、1.20、1.21、1.24） | Linux | x86_64 | 已测试 |
注意
需要注意的是，当使用 Podman 同时重启多个容器时，可能只会成功监控其中一个容器。
例如：podman restart 容器A 容器B 容器C
支持的容器编排工具
| 容器编排工具 | 版本要求 | 备注说明 |
|---|---|---|
| Kubernetes | 仅支持Linux 1.17 ~ 1.28 （已测试版本：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敏捷版：v1.28.5-r11） |
|