AI 助理
文档备案控制台
官方文档
首页

ARMS 应用监控支持的 Java 组件和框架

更新时间：
复制 MD 格式
产品详情
我的收藏

ARMS 应用监控支持自动埋点常见 Java 第三方组件和框架。本文按探针版本（5.X、4.X、3.X）分别列出支持的 JDK 版本、框架和组件，根据当前使用的探针版本查阅对应章节。

支持的 JDK 版本

升级ARMS探针

接入持续剖析功能

接入持续剖析功能

接入持续剖析功能

【产品变更】ARMS应用监控终止对Java 7的支持

版本说明
JDK 25从探针 4.7.x 版本开始支持 JDK 25。
JDK 21ARMS 应用监控探针从 3.1.4 版本开始支持 JDK 21。如果 JDK 版本为 JDK 21，需升级探针版本至 3.1.4 或以上，探针升级方式请参见。
JDK 17为满足持续剖析等 ARMS 高阶能力所需的 JDK 版本要求，建议使用 JDK 17.0.9+。更多信息，请参见。
JDK 11为满足持续剖析等 ARMS 高阶能力所需的 JDK 版本要求，建议使用 JDK 11.0.17+。更多信息，请参见。
JDK 1.8对于 Kubernetes 集群应用部署，建议使用 JDK 8u212+。为满足持续剖析等 ARMS 高阶能力所需的 JDK 版本要求，建议使用 JDK 8u352+。更多信息，请参见。
JDK 1.7ARMS 应用监控将于 3.0.X 探针版本终止支持 Java 7。如果仍在使用 Java 7，请尽快升级 Java 版本。更多信息，请参见。

支持的 JDK 发行版

  • OpenJDK （推荐）

  • Alibaba Dragonwell （推荐）

  • Temurin

  • AdoptOpenJDK

  • Amazon Corretto

  • Azul

  • Java HotSpot VM

Eclipse OpenJ9 与 ARMS 应用监控存在一定的兼容性问题，不建议使用。

5.X 探针支持的框架和组件

以下为最新 5.X 版本探针支持的框架和组件。

组件类型组件支持版本作用
LLM 客户端/框架AgentScope1.0.0+
OpenAI Java SDK1.1.0+、2.X+、3.X+采集 ChatCompletion 调用相关指标以及 Span；采集 Completion 调用相关指标以及 Span；采集 Embedding 调用相关指标以及 Span
Spring AI1.X+采集 OpenAI ChatModel 调用相关指标以及 Span；采集 Default ChatClient 调用相关指标以及 Span；采集 Default ToolManager 调用相关指标以及 Span
Spring AI Alibaba1.0.0.3+采集 DashScope ChatModel 调用相关指标以及 Span
Agent 协议A2A (Agent-to-Agent) Java SDK0.3.3+采集 Agent-to-Agent 通信 Client 和 Server 调用相关指标以及 Span
MCP Java SDK0.17.0+采集 Model Context Protocol Client 和 Server 调用相关指标以及 Span
Web 容器cxf3.0+采集 cxf 相关 RED 指标以及 Span
restlet1.1.0+采集 restlet 相关 RED 指标以及 Span
Tomcat7.X ~ 10.X采集 HTTP 相关 RED 指标以及 Span；采集 Tomcat 线程池指标
Jetty8.X ~ 11.X采集 HTTP 相关 RED 指标以及 Span；采集 Jetty 线程池指标
Play Framework2.4+采集 HTTP 相关 RED 指标以及 Span
WebLogic10.3.0 ~ 12.2.X采集 HTTP 相关 RED 指标以及 Span
Undertow1.4.0+采集 HTTP 相关 RED 指标以及 Span；采集 Undertow 线程池指标
Vertx3.0.0+采集 HTTP 相关 RED 指标以及 Span
Webflux5.0.0.RELEASE+采集 HTTP 相关 RED 指标以及 Span
Spring Cloud Gateway2.0.0.RELEASE+采集 HTTP 相关 RED 指标以及 Span
jFinal3.6+采集 HTTP 相关 RED 指标以及 Span
WebSphere9.0+采集 HTTP 相关 RED 指标以及 Span
HTTP 客户端Apache HTTP Client2.0 ~ 5.3.1采集 HTTP 相关 RED 指标以及 Span
Google HTTP Client1.19.0+采集 HTTP 相关 RED 指标以及 Span
Java HTTP ClientJDK11+采集 HTTP 相关 RED 指标以及 Span
OkHttp2.2+采集 HTTP 相关 RED 指标以及 Span
Async HTTP Client1.8 ~ 2.12.3采集 HTTP 相关 RED 指标以及 Span
RPC 框架Alibaba Dubbo2.5.10 ~ 2.6.12采集 Dubbo 相关 RED 指标以及 Span
Apache Dubbo2.7.0+采集 Dubbo 相关 RED 指标以及 Span
HSF2.2 ~ 3.0采集 HSF 相关 RED 指标以及 Span
gRPC1.6.0+采集 gRPC 相关 RED 指标以及 Span
Motan0.3.0+采集 Motan 相关 RED 指标以及 Span
SofaRPC5.4.0+采集 SofaRPC 相关 RED 指标以及 Span
JDBCOceanBase2.4.0+

采集数据库调用相关指标以及 Span。

说明

部分组件支持多种方式访问数据库，探针仅监控通过 JDBC 规范进行的数据库增删改查操作。

MySQL5.1.1+采集数据库调用相关指标以及 Span
PostgreSQL42.0.0+采集数据库调用相关指标以及 Span
SQL Server6.2.0.jre7+采集数据库调用相关指标以及 Span
MariaDB1.5.2+采集数据库调用相关指标以及 Span
Oracle12.2.0.1+采集数据库调用相关指标以及 Span
PolarDB1.0.0+采集数据库调用相关指标以及 Span
ClickHouse0.1.28+采集数据库调用相关指标以及 Span
NoSQLHBase2.0 ～ 3.0采集 NoSQL 调用相关指标以及 Span
Jedis1.4+采集 NoSQL 调用相关指标以及 Span
Lettuce4.0.Final+采集 NoSQL 调用相关指标以及 Span；采集 Lettuce 连接池指标；收集 NoSQL 响应大小指标
Redisson3.0 ~ 3.25.2采集 NoSQL 调用相关指标以及 Span
Memcached2.12.0 ~ 2.12.3采集 NoSQL 调用相关指标以及 Span
MongoDB3.1+采集 NoSQL 调用相关指标以及 Span
Elasticsearch5.0+

采集 NoSQL 调用相关指标以及 Span。

说明

仅支持采集使用 HTTP 协议方式访问 ES 服务端的数据，不支持采集 TCP 协议访问 ES 服务端的数据。

InfluxDB2.7 ~ 2.23采集 NoSQL 调用相关指标以及 Span
Cassandra3.0+采集 NoSQL 调用相关指标以及 Span
消息Eclipse Paho Client MQTTv31.0.2+采集 Consumer 调用相关 RED 指标以及 Span
RocketMQ Java Client4.4.0、4.5.1+、5.X+采集 Consumer、Producer 调用相关 RED 指标以及 Span；采集消息延迟指标
RocketMQ Java Client V55.0.0+采集 Consumer、Producer 调用相关 RED 指标以及 Span；采集消息延迟指标
Aliyun MNS SDK1.3.0+采集 Producer、Consumer 调用相关 RED 指标以及 Span
Aliyun ONS1.7.0.Final+、2.0.0.Final+采集 Consumer、Producer 调用相关 RED 指标以及 Span；采集消息延迟指标
Qpid JMS Client0.49.0+采集 Consumer 调用相关 RED 指标以及 Span
RabbitMQ4.X+采集 Consumer、Producer 调用相关 RED 指标以及 Span；采集所有 Channel、Command 操作的 Span
Kafka0.11.0.0+、1.X+、2.X+、3.X+采集 Consumer、Producer 调用相关 RED 指标以及 Span
Spring-Kafka2.7.0+采集 Consumer（Message Listener）调用相关 RED 指标以及 Span。为防止重复，Spring-Kafka 统计到调用链后，底层的 Kafka 增强不再生效。
定时任务XXLJob2.0.2+采集定时任务调用相关 RED 指标以及 Span
SchedulerX1.2.1 ~ 1.11.6采集定时任务调用相关 RED 指标以及 Span
Spring Scheduled3.1.0.RELEASE+采集定时任务调用相关 RED 指标以及 Span
ElasticJob3.0.0 ~ 3.0.4采集定时任务调用相关 RED 指标以及 Span
日志框架Log4j1.2+往该类日志上下文填充 EagleEye-TraceID；采集该类日志框架打印日志条数相关指标
Log4j22.0+往该类日志上下文填充 EagleEye-TraceID；采集该类日志框架打印日志条数相关指标
Logback1.0.0 ~ 1.2.3往该类日志上下文填充 EagleEye-TraceID；采集该类日志框架打印日志条数相关指标
数据库连接池Druid1.0.25+采集连接池指标；采集获取连接操作的 Span
HikariCP3.0.0+采集连接池指标
C3P00.9.5+采集连接池指标
MyBatis3.1.0+采集 MyBatis 操作的 Span
DBCP2+采集连接池指标
其他Spring4.1.0.RELEASE+埋点 Spring 的请求分派代码，获得一次 HTTP 请求的路由
Spring-Bean4.1.0.RELEASE+埋点 Spring 托管 Bean 中每个 Public 方法并生成 Span

4.X 探针支持的框架和组件

以下为最新 4.X 版本探针支持的框架和组件。4.X 与 5.X 探针支持的组件基本一致，区别在于 4.X 不包含 SofaRPC。

组件类型组件支持版本作用
LLM 客户端/框架AgentScope1.0.0+
OpenAI Java SDK1.1.0+、2.X+、3.X+采集 ChatCompletion 调用相关指标以及 Span；采集 Completion 调用相关指标以及 Span；采集 Embedding 调用相关指标以及 Span
Spring AI1.X+采集 OpenAI ChatModel 调用相关指标以及 Span；采集 Default ChatClient 调用相关指标以及 Span；采集 Default ToolManager 调用相关指标以及 Span
Spring AI Alibaba1.0.0.3+采集 DashScope ChatModel 调用相关指标以及 Span
Agent 协议A2A (Agent-to-Agent) Java SDK0.3.3+采集 Agent-to-Agent 通信 Client 和 Server 调用相关指标以及 Span
MCP Java SDK0.17.0+采集 Model Context Protocol Client 和 Server 调用相关指标以及 Span
Web 容器cxf3.0+采集 cxf 相关 RED 指标以及 Span
restlet1.1.0+采集 restlet 相关 RED 指标以及 Span
Tomcat7.X ~ 10.X采集 HTTP 相关 RED 指标以及 Span；采集 Tomcat 线程池指标
Jetty8.X ~ 11.X采集 HTTP 相关 RED 指标以及 Span；采集 Jetty 线程池指标
Play Framework2.4+采集 HTTP 相关 RED 指标以及 Span
WebLogic10.3.0 ~ 12.2.X采集 HTTP 相关 RED 指标以及 Span
Undertow1.4.0+采集 HTTP 相关 RED 指标以及 Span；采集 Undertow 线程池指标
Vertx3.0.0+采集 HTTP 相关 RED 指标以及 Span
Webflux5.0.0.RELEASE+采集 HTTP 相关 RED 指标以及 Span
Spring Cloud Gateway2.0.0.RELEASE+采集 HTTP 相关 RED 指标以及 Span
jFinal3.6+采集 HTTP 相关 RED 指标以及 Span
WebSphere9.0+采集 HTTP 相关 RED 指标以及 Span
HTTP 客户端Apache HTTP Client2.0 ~ 5.3.1采集 HTTP 相关 RED 指标以及 Span
Google HTTP Client1.19.0+采集 HTTP 相关 RED 指标以及 Span
Java HTTP ClientJDK11+采集 HTTP 相关 RED 指标以及 Span
OkHttp2.2+采集 HTTP 相关 RED 指标以及 Span
Async HTTP Client1.8 ~ 2.12.3采集 HTTP 相关 RED 指标以及 Span
RPC 框架Alibaba Dubbo2.5.10 ~ 2.6.12采集 Dubbo 相关 RED 指标以及 Span
Apache Dubbo2.7.0+采集 Dubbo 相关 RED 指标以及 Span
HSF2.2 ~ 3.0采集 HSF 相关 RED 指标以及 Span
gRPC1.6.0+采集 gRPC 相关 RED 指标以及 Span
Motan0.3.0+采集 Motan 相关 RED 指标以及 Span
JDBCOceanBase2.4.0+

采集数据库调用相关指标以及 Span。

说明

部分组件支持多种方式访问数据库，探针仅监控通过 JDBC 规范进行的数据库增删改查操作。

MySQL5.1.1+采集数据库调用相关指标以及 Span
PostgreSQL42.0.0+采集数据库调用相关指标以及 Span
SQL Server6.2.0.jre7+采集数据库调用相关指标以及 Span
MariaDB1.5.2+采集数据库调用相关指标以及 Span
Oracle12.2.0.1+采集数据库调用相关指标以及 Span
PolarDB1.0.0+采集数据库调用相关指标以及 Span
ClickHouse0.1.28+采集数据库调用相关指标以及 Span
NoSQLHBase2.0 ～ 3.0采集 NoSQL 调用相关指标以及 Span
Jedis1.4+采集 NoSQL 调用相关指标以及 Span
Lettuce4.0.Final+采集 NoSQL 调用相关指标以及 Span；采集 Lettuce 连接池指标；收集 NoSQL 响应大小指标
Redisson3.0 ~ 3.25.2采集 NoSQL 调用相关指标以及 Span
Memcached2.12.0 ~ 2.12.3采集 NoSQL 调用相关指标以及 Span
MongoDB3.1+采集 NoSQL 调用相关指标以及 Span
Elasticsearch5.0+

采集 NoSQL 调用相关指标以及 Span。

说明

仅支持采集使用 HTTP 协议方式访问 ES 服务端的数据，不支持采集 TCP 协议访问 ES 服务端的数据。

InfluxDB2.7 ~ 2.23采集 NoSQL 调用相关指标以及 Span
Cassandra3.0+采集 NoSQL 调用相关指标以及 Span
消息Eclipse Paho Client MQTTv31.0.2+采集 Consumer 调用相关 RED 指标以及 Span
RocketMQ Java Client4.4.0、4.5.1+、5.X+采集 Consumer、Producer 调用相关 RED 指标以及 Span；采集消息延迟指标
RocketMQ Java Client V55.0.0+采集 Consumer、Producer 调用相关 RED 指标以及 Span；采集消息延迟指标
Aliyun MNS SDK1.3.0+采集 Producer、Consumer 调用相关 RED 指标以及 Span
Aliyun ONS1.7.0.Final+、2.0.0.Final+采集 Consumer、Producer 调用相关 RED 指标以及 Span；采集消息延迟指标
Qpid JMS Client0.49.0+采集 Consumer 调用相关 RED 指标以及 Span
RabbitMQ4.X+采集 Consumer、Producer 调用相关 RED 指标以及 Span；采集所有 Channel、Command 操作的 Span
Kafka0.11.0.0+、1.X+、2.X+、3.X+采集 Consumer、Producer 调用相关 RED 指标以及 Span
Spring-Kafka2.7.0+采集 Consumer（Message Listener）调用相关 RED 指标以及 Span。为防止重复，Spring-Kafka 统计到调用链后，底层的 Kafka 增强不再生效。
定时任务XXLJob2.0.2+采集定时任务调用相关 RED 指标以及 Span
SchedulerX1.2.1 ~ 1.11.6采集定时任务调用相关 RED 指标以及 Span
Spring Scheduled3.1.0.RELEASE+采集定时任务调用相关 RED 指标以及 Span
ElasticJob3.0.0 ~ 3.0.4采集定时任务调用相关 RED 指标以及 Span
日志框架Log4j1.2+往该类日志上下文填充 EagleEye-TraceID；采集该类日志框架打印日志条数相关指标
Log4j22.0+往该类日志上下文填充 EagleEye-TraceID；采集该类日志框架打印日志条数相关指标
Logback1.0.0 ~ 1.2.3往该类日志上下文填充 EagleEye-TraceID；采集该类日志框架打印日志条数相关指标
数据库连接池Druid1.0.25+采集连接池指标；采集获取连接操作的 Span
HikariCP3.0.0+采集连接池指标
C3P00.9.5+采集连接池指标
MyBatis3.1.0+采集 MyBatis 操作的 Span
DBCP2+采集连接池指标
其他Spring4.1.0.RELEASE+埋点 Spring 的请求分派代码，获得一次 HTTP 请求的路由
Spring-Bean4.1.0.RELEASE+埋点 Spring 托管 Bean 中每个 Public 方法并生成 Span

3.X 探针支持的框架和组件

以下为最新 3.X 版本探针支持的框架和组件。

组件类型组件支持版本
Web 容器Tomcat7.X ~ 10.X
Jetty8.1.X ~ 11.0.X
Play Framework2.2.X ~ 2.8.X
WebLogic10.3.X ~ 12.2.X
Undertow1.4.X ~ 2.2.X
Vertx3.3.X+
Reactor Netty0.7.X+
Webflux5.0.X+
HTTP 客户端Apache HttpClient3.0.X+
Google HTTP Client1.19.X+
OkHttp/OkHttp32.1.X ~ 4.11.X
Spring Web（RestTemplate）
AsyncHttpClient2.0.X ~ 2.12.X
Spring 相关Spring MVC3.0.5.RELEASE+
Spring Scheduled3.1.0.RELEASE+
Spring Cloud 相关Hystrix1.0.X ~ 1.5.X
Feign9.0.X ~ 12.4.X
Spring Webflux5.0.X ~ 6.0.X
Spring Cloud Gateway2.1.X ~ 4.0.X
RPC 框架Dubbo2.4.X+
Ali-HSF（High Speed Framework）2.2.X+
GRpc0.7.X ~ 1.56.X
Thrift0.1.X ~ 0.18.X
JDBC 相关PolarDB1.1.2+（4.x 及以上版本探针支持）
Mysql Connector5.0.X+
Postgresql JDBC Driver42.1.X+
Microsoft JDBC Driver for SQL Server6.4.X ~ 12.2.X
MariaDB Java Client1.5.X ~ 3.1.X
Oracle ojdbc7, 8, 10, 14
Sharding-jdbc4.0.X ~ 4.1.X
Druid1.0.X+
Hikari-CP2.3.X+
MyBatis3.1.X ~ 3.5.X
MyBatisPlus1.0.X ~ 1.7.X
NoSQL 调用相关Jedis2.X ~ 4.X
Lettuce5.2.X+
Redisson2.5.X+
MemCached2.8.X ~ 2.12.X
MongoDB Java Driver3.X
Spring-MongoDB2.0.X ~ 3.4.X
Elasticsearch Rest Client5.X ~ 7.X
Elasticsearch Rest High Level Client6.X ~ 7.X
Clickhouse JDBC Driver0.3.X ~ 0.4.X
influxDB-
消息相关RocketMQ Java Client4.4.0、4.5.1+、5.X+
RocketMQ Java Client V55.X+
Spring-RocketMQ2.0.2+
Aliyun ONS1.7.0.Final+、2.0.0.Final+
RabbitMQ Java Client4.X+
Kafka Client0.11.0.0+、1.X+、2.X+、3.X+
定时任务XXLJob2.0.X ~ 2.4.X
ElasticJob2.0.X ~ 2.1.X
SchedulerX1.2.X ~ 1.5.X
Spring Scheduled3.2.X ~ 5.3.X
异步/响应式编程框架SpringAsync4.0.X ~ 5.3.X
RxJAVA2.0.X ~ 3.1.X
Reactor3.0.X ~ 3.5.X
日志框架Log4j1.2.16 ~ 1.2.17
Log4j22.0 ~ 2.20.0
Logback1.0.13 ~ 1.4.8

ARMS 应用监控针对支持的组件可以实现自动埋点。如果使用的组件不在上述范围内，可以手工埋点，具体操作参见通过OpenTelemetry Java SDK为调用链增加自定义埋点。

上一篇：3.x版本Java探针性能压测报告下一篇：ARMS Java SDK使用说明（不推荐）