Supported Java components and frameworks-Application Real-Time Monitoring Service(ARMS)-阿里云帮助中心

Application Real-Time Monitoring Service (ARMS) provides automatic instrumentation for Java applications. The following sections list the supported JDK versions, JDK distributions, and third-party frameworks and components for each ARMS agent series (5.x, 4.x, and 3.x). Refer to the section that corresponds to your deployed agent version.

Supported JDK versions

Upgrade the ARMS agent

Enable continuous profiling

[Product changes] ARMS Application Monitoring no longer supports Java 7

Version	Description
JDK 25	Supported by agent version 4.7.x and later.
JDK 21	To use JDK 21, you must upgrade the ARMS agent to version 3.1.4 or later.
JDK 17	To use advanced ARMS features such as continuous profiling, use JDK 17.0.9 or later. For more information, see Enable continuous profiling.
JDK 11	To use advanced ARMS features such as continuous profiling, use JDK 11.0.17 or later. For more information, see Enable continuous profiling.
JDK 1.8	For deployments in Kubernetes clusters, use JDK 8u212 or later. To use advanced ARMS features such as continuous profiling, use JDK 8u352 or later. For more information, see Enable continuous profiling.
JDK 1.7	ARMS Application Monitoring has ended support for Java 7 in agent versions 3.0.x and later. If you are still using Java 7, upgrade your Java version. For more information, see [Product Change] ARMS Application Monitoring Ends Support for Java 7.

Supported JDK distributions

OpenJDK (Recommended)

Alibaba Dragonwell (Recommended)

Temurin

AdoptOpenJDK

Amazon Corretto

Azul

Java HotSpot VM

Avoid Eclipse OpenJ9 because of compatibility issues with ARMS.

5.x agent: Supported frameworks and components

This compatibility information applies to the latest 5.x agent.

For JDBC components, the agent monitors only the create, read, update, and delete (CRUD) operations performed via the JDBC specification, even if a component supports other database access methods.

Type	Component	Supported version	Description
LLM client/framework	AgentScope	1.0.0+
	OpenAI Java SDK	1.1.0+, 2.X+, 3.X+	Collects metrics and spans for ChatCompletion calls. Collects metrics and spans for Completion calls. Collects metrics and spans for Embedding calls.
	Spring AI	1.X+	Collects metrics and spans for OpenAI ChatModel calls. Collects metrics and spans for Default ChatClient calls. Collects metrics and spans for Default ToolManager calls.
	Spring AI Alibaba	1.0.0.3+	Collects metrics and spans for DashScope ChatModel calls.
Agent protocol	A2A (Agent-to-Agent) Java SDK	0.3.3+	Collects metrics and spans for Agent-to-Agent client and server calls.
	MCP Java SDK	0.17.0+	Collects metrics and spans for Model Context Protocol client and server calls.
Web container	CXF	3.0+	Collects RED metrics and spans for CXF.
	Restlet	1.1.0+	Collects RED metrics and spans for Restlet.
	Tomcat	7.X to 10.X	Collects RED metrics and spans for HTTP. Collects Tomcat thread pool metrics.
	Jetty	8.X to 11.X	Collects RED metrics and spans for HTTP. Collects Jetty thread pool metrics.
	Play Framework	2.4+	Collects RED metrics and spans for HTTP.
	WebLogic	10.3.0 to 12.2.X	Collects RED metrics and spans for HTTP.
	Undertow	1.4.0+	Collects RED metrics and spans for HTTP. Collects Undertow thread pool metrics.
	Vert.x	3.0.0+	Collects RED metrics and spans for HTTP.
	Webflux	5.0.0.RELEASE+	Collects RED metrics and spans for HTTP.
	Spring Cloud Gateway	2.0.0.RELEASE+	Collects RED metrics and spans for HTTP.
	JFinal	3.6+	Collects RED metrics and spans for HTTP.
	WebSphere	9.0+	Collects RED metrics and spans for HTTP.
HTTP client	Apache HTTP Client	2.0 to 5.3.1	Collects RED metrics and spans for HTTP.
	Google HTTP Client	1.19.0+	Collects RED metrics and spans for HTTP.
	Java HTTP Client	JDK 11+	Collects RED metrics and spans for HTTP.
	OkHttp	2.2+	Collects RED metrics and spans for HTTP.
	Async HTTP Client	1.8 to 2.12.3	Collects RED metrics and spans for HTTP.
RPC framework	Alibaba Dubbo	2.5.10 to 2.6.12	Collects RED metrics and spans for Dubbo.
	Apache Dubbo	2.7.0+	Collects RED metrics and spans for Dubbo.
	HSF	2.2 to 3.0	Collects RED metrics and spans for HSF.
	gRPC	1.6.0+	Collects RED metrics and spans for gRPC.
	Motan	0.3.0+	Collects RED metrics and spans for Motan.
	SofaRPC	5.4.0+	Collects RED metrics and spans for SofaRPC.
JDBC	OceanBase	2.4.0+	Collects metrics and spans for database calls.
	MySQL	5.1.1+	Collects metrics and spans for database calls.
	PostgreSQL	42.0.0+	Collects metrics and spans for database calls.
	SQL Server	6.2.0.jre7+	Collects metrics and spans for database calls.
	MariaDB	1.5.2+	Collects metrics and spans for database calls.
	Oracle	12.2.0.1+	Collects metrics and spans for database calls.
	PolarDB	1.0.0+	Collects metrics and spans for database calls.
	ClickHouse	0.1.28+	Collects metrics and spans for database calls.
NoSQL	HBase	2.0 to 3.0	Collects metrics and spans for NoSQL calls.
	Jedis	1.4+	Collects metrics and spans for NoSQL calls.
	Lettuce	4.0.Final+	Collects metrics and spans for NoSQL calls. Collects Lettuce connection pool metrics. Collects NoSQL response size metrics.
	Redisson	3.0 to 3.25.2	Collects metrics and spans for NoSQL calls.
	Memcached	2.12.0 to 2.12.3	Collects metrics and spans for NoSQL calls.
	MongoDB	3.1+	Collects metrics and spans for NoSQL calls.
	Elasticsearch	5.0+	Collects metrics and spans for NoSQL calls. Monitors Elasticsearch access only over HTTP; access over TCP is not supported.
	InfluxDB	2.7 to 2.23	Collects metrics and spans for NoSQL calls.
	Cassandra	3.0+	Collects metrics and spans for NoSQL calls.
Messaging	Eclipse Paho Client MQTTv3	1.0.2+	Collects RED metrics and spans for consumer calls.
	RocketMQ Java Client	4.4.0, 4.5.1+, 5.X+	Collects RED metrics and spans for consumer and producer calls. Collects message latency metrics.
	RocketMQ Java Client V5	5.0.0+	Collects RED metrics and spans for consumer and producer calls. Collects message latency metrics.
	Alibaba Cloud MNS SDK	1.3.0+	Collects RED metrics and spans for producer and consumer calls.
	ApsaraMQ for RocketMQ	1.7.0.Final+, 2.0.0.Final+	Collects RED metrics and spans for consumer and producer calls. Collects message latency metrics.
	Qpid JMS Client	0.49.0+	Collects RED metrics and spans for consumer calls.
	RabbitMQ	4.X+	Collects RED metrics and spans for consumer and producer calls. Collects spans for all channel and command operations.
	Kafka	0.11.0.0+, 1.X+, 2.X+, 3.X+	Collects RED metrics and spans for consumer and producer calls.
	Spring Kafka	2.7.0+	Collects RED metrics and spans for consumer (Message Listener) calls. To prevent duplicate data, the probe disables the underlying Kafka instrumentation when Spring Kafka instrumentation is active.
Scheduled task	XXLJob	2.0.2+	Collects RED metrics and spans for scheduled task calls.
	SchedulerX 2.0	1.2.1 to 1.11.6	Collects RED metrics and spans for scheduled task calls.
	Spring Scheduled	3.1.0.RELEASE+	Collects RED metrics and spans for scheduled task calls.
	ElasticJob	3.0.0 to 3.0.4	Collects RED metrics and spans for scheduled task calls.
Logging framework	Log4j	1.2+	Injects the EagleEye-TraceID into the log context. Collects log count metrics.
	Log4j2	2.0+	Injects the EagleEye-TraceID into the log context. Collects log count metrics.
	Logback	1.0.0 to 1.2.3	Injects the EagleEye-TraceID into the log context. Collects log count metrics.
Database connection pool	Druid	1.0.25+	Collects connection pool metrics. Collects spans for connection acquisition operations.
	HikariCP	3.0.0+	Collects connection pool metrics.
	C3P0	0.9.5+	Collects connection pool metrics.
	MyBatis	3.1.0+	Collects spans for MyBatis operations.
	DBCP	2+	Collects connection pool metrics.
Other	Spring	4.1.0.RELEASE+	Instruments Spring's request dispatching code to determine the route for an HTTP request.
	Spring Bean	4.1.0.RELEASE+	Instruments every public method in Spring-managed beans and generates spans.

4.x agent: Supported frameworks and components

The latest 4.x agent supports the following frameworks and components.

For JDBC components, the agent monitors only CRUD (create, read, update, and delete) operations that use the JDBC specification, even if a component supports other database access methods.

Type	Component	Supported version	Description
LLM client/framework	AgentScope	1.0.0+
	OpenAI Java SDK	1.1.0+, 2.X+, 3.X+	Collects metrics and spans for ChatCompletion calls. Collects metrics and spans for Completion calls. Collects metrics and spans for Embedding calls.
	Spring AI	1.X+	Collects metrics and spans for OpenAI ChatModel calls. Collects metrics and spans for Default ChatClient calls. Collects metrics and spans for Default ToolManager calls.
	Spring AI Alibaba	1.0.0.3+	Collects metrics and spans for DashScope ChatModel calls.
Agent protocol	A2A (Agent-to-Agent) Java SDK	0.3.3+	Collects metrics and spans for Agent-to-Agent client and server calls.
	MCP Java SDK	0.17.0+	Collects metrics and spans for Model Context Protocol client and server calls.
Web container	CXF	3.0+	Collects RED metrics and spans for CXF.
	Restlet	1.1.0+	Collects RED metrics and spans for Restlet.
	Tomcat	7.X to 10.X	Collects RED metrics and spans for HTTP requests. Collects Tomcat thread pool metrics.
	Jetty	8.X to 11.X	Collects RED metrics and spans for HTTP requests. Collects Jetty thread pool metrics.
	Play Framework	2.4+	Collects RED metrics and spans for HTTP requests.
	WebLogic	10.3.0 to 12.2.X	Collects RED metrics and spans for HTTP requests.
	Undertow	1.4.0+	Collects RED metrics and spans for HTTP requests. Collects Undertow thread pool metrics.
	Vert.x	3.0.0+	Collects RED metrics and spans for HTTP requests.
	Webflux	5.0.0.RELEASE+	Collects RED metrics and spans for HTTP requests.
	Spring Cloud Gateway	2.0.0.RELEASE+	Collects RED metrics and spans for HTTP requests.
	JFinal	3.6+	Collects RED metrics and spans for HTTP requests.
	WebSphere	9.0+	Collects RED metrics and spans for HTTP requests.
HTTP client	Apache HTTP Client	2.0 to 5.3.1	Collects RED metrics and spans for HTTP requests.
	Google HTTP Client	1.19.0+	Collects RED metrics and spans for HTTP requests.
	Java HTTP Client	JDK 11+	Collects RED metrics and spans for HTTP requests.
	OkHttp	2.2+	Collects RED metrics and spans for HTTP requests.
	Async HTTP Client	1.8 to 2.12.3	Collects RED metrics and spans for HTTP requests.
RPC framework	Alibaba Dubbo	2.5.10 to 2.6.12	Collects RED metrics and spans for Dubbo.
	Apache Dubbo	2.7.0+	Collects RED metrics and spans for Dubbo.
	HSF	2.2 to 3.0	Collects RED metrics and spans for HSF.
	gRPC	1.6.0+	Collects RED metrics and spans for gRPC.
	Motan	0.3.0+	Collects RED metrics and spans for Motan.
JDBC	OceanBase	2.4.0+	Collects metrics and spans for database calls.
	MySQL	5.1.1+	Collects metrics and spans for database calls.
	PostgreSQL	42.0.0+	Collects metrics and spans for database calls.
	SQL Server	6.2.0.jre7+	Collects metrics and spans for database calls.
	MariaDB	1.5.2+	Collects metrics and spans for database calls.
	Oracle	12.2.0.1+	Collects metrics and spans for database calls.
	PolarDB	1.0.0+	Collects metrics and spans for database calls.
	ClickHouse	0.1.28+	Collects metrics and spans for database calls.
NoSQL	HBase	2.0 to 3.0	Collects metrics and spans for NoSQL calls.
	Jedis	1.4+	Collects metrics and spans for NoSQL calls.
	Lettuce	4.0.Final+	Collects metrics and spans for NoSQL calls. Collects Lettuce connection pool metrics. Collects NoSQL response size metrics.
	Redisson	3.0 to 3.25.2	Collects metrics and spans for NoSQL calls.
	Memcached	2.12.0 to 2.12.3	Collects metrics and spans for NoSQL calls.
	MongoDB	3.1+	Collects metrics and spans for NoSQL calls.
	Elasticsearch	5.0+	Collects metrics and spans for NoSQL calls. Data collection is supported for clients that access Elasticsearch servers over HTTP. Access over TCP is not supported.
	InfluxDB	2.7 to 2.23	Collects metrics and spans for NoSQL calls.
	Cassandra	3.0+	Collects metrics and spans for NoSQL calls.
Messaging	Eclipse Paho Client MQTTv3	1.0.2+	Collects RED metrics and spans for consumer calls.
	RocketMQ Java Client	4.4.0, 4.5.1+, 5.X+	Collects RED metrics and spans for producer and consumer calls. Collects message latency metrics.
	RocketMQ Java Client V5	5.0.0+	Collects RED metrics and spans for producer and consumer calls. Collects message latency metrics.
	Alibaba Cloud MNS SDK	1.3.0+	Collects RED metrics and spans for producer and consumer calls.
	ApsaraMQ for RocketMQ	1.7.0.Final+, 2.0.0.Final+	Collects RED metrics and spans for producer and consumer calls. Collects message latency metrics.
	Qpid JMS Client	0.49.0+	Collects RED metrics and spans for consumer calls.
	RabbitMQ	4.X+	Collects RED metrics and spans for producer and consumer calls. Collects spans for all channel and command operations.
	Kafka	0.11.0.0+, 1.X+, 2.X+, 3.X+	Collects RED metrics and spans for producer and consumer calls.
	Spring Kafka	2.7.0+	Collects RED metrics and spans for consumer (message listener) calls. To prevent duplicate reporting, the underlying Kafka instrumentation is disabled when the Spring Kafka instrumentation is active.
Scheduled task	XXLJob	2.0.2+	Collects RED metrics and spans for scheduled task calls.
	SchedulerX	1.2.1 to 1.11.6	Collects RED metrics and spans for scheduled task calls.
	Spring Scheduled	3.1.0.RELEASE+	Collects RED metrics and spans for scheduled task calls.
	ElasticJob	3.0.0 to 3.0.4	Collects RED metrics and spans for scheduled task calls.
Logging framework	Log4j	1.2+	Injects the EagleEye-TraceID into the log context. Collects metrics on the number of logs the framework generates.
	Log4j2	2.0+	Injects the EagleEye-TraceID into the log context. Collects metrics on the number of logs the framework generates.
	Logback	1.0.0 to 1.2.3	Injects the EagleEye-TraceID into the log context. Collects metrics on the number of logs the framework generates.
Database connection pool	Druid	1.0.25+	Collects connection pool metrics. Collects spans for connection acquisition operations.
	HikariCP	3.0.0+	Collects connection pool metrics.
	C3P0	0.9.5+	Collects connection pool metrics.
	MyBatis	3.1.0+	Collects spans for MyBatis operations.
	DBCP	2+	Collects connection pool metrics.
Other	Spring	4.1.0.RELEASE+	Instruments Spring's request dispatching code to get an HTTP request's route.
	Spring Bean	4.1.0.RELEASE+	Instruments each public method in a Spring-managed bean to create a span.

3.x agent: Supported frameworks and components

The following frameworks and components are supported by the latest 3.x agent.

Type	Component	Supported version
Web container	Tomcat	7.X to 10.X
	Jetty	8.1.X to 11.0.X
	Play Framework	2.2.X to 2.8.X
	WebLogic	10.3.X to 12.2.X
	Undertow	1.4.X to 2.2.X
	Vert.x	3.3.X+
	Reactor Netty	0.7.X+
	Webflux	5.0.X+
HTTP client	Apache HttpClient	3.0.X+
	Google HTTP Client	1.19.X+
	OkHttp/OkHttp3	2.1.X to 4.11.X
	Spring Web (RestTemplate)
	AsyncHttpClient	2.0.X to 2.12.X
Spring	Spring MVC	3.0.5.RELEASE+
	Spring Scheduled	3.1.0.RELEASE+
Spring Cloud	Hystrix	1.0.X to 1.5.X
	Feign	9.0.X to 12.4.X
	Spring Webflux	5.0.X to 6.0.X
	Spring Cloud Gateway	2.1.X to 4.0.X
RPC framework	Dubbo	2.4.X+
	Ali-HSF (High Speed Framework)	2.2.X+
	gRPC	0.7.X to 1.56.X
	Thrift	0.1.X to 0.18.X
JDBC	PolarDB	1.1.2+ (Requires agent 4.X or later)
	MySQL Connector	5.0.X+
	PostgreSQL JDBC Driver	42.1.X+
	Microsoft JDBC Driver for SQL Server	6.4.X to 12.2.X
	MariaDB Java Client	1.5.X to 3.1.X
	Oracle ojdbc	7, 8, 10, 14
	Sharding-jdbc	4.0.X to 4.1.X
	Druid	1.0.X+
	Hikari-CP	2.3.X+
	MyBatis	3.1.X to 3.5.X
	MyBatisPlus	1.0.X to 1.7.X
NoSQL client	Jedis	2.X to 4.X
	Lettuce	5.2.X+
	Redisson	2.5.X+
	Memcached	2.8.X to 2.12.X
	MongoDB Java Driver	3.X
	Spring Data MongoDB	2.0.X to 3.4.X
	Elasticsearch Rest Client	5.X to 7.X
	Elasticsearch Rest High Level Client	6.X to 7.X
	ClickHouse JDBC Driver	0.3.X to 0.4.X
	InfluxDB	-
Messaging client	RocketMQ Java Client	4.4.0, 4.5.1+, 5.X+
	RocketMQ Java Client V5	5.X+
	Spring for Apache RocketMQ	2.0.2+
	Alibaba Cloud ONS	1.7.0.Final+, 2.0.0.Final+
	RabbitMQ Java Client	4.X+
	Kafka Client	0.11.0.0+, 1.X+, 2.X+, 3.X+
Task scheduling framework	XXL-JOB	2.0.X to 2.4.X
	ElasticJob	2.0.X to 2.1.X
	SchedulerX	1.2.X to 1.5.X
	Spring Scheduled	3.2.X to 5.3.X
Async/reactive programming framework	Spring @Async	4.0.X to 5.3.X
	RxJava	2.0.X to 3.1.X
	Reactor	3.0.X to 3.5.X
Logging framework	Log4j	1.2.16 to 1.2.17
	Log4j2	2.0 to 2.20.0
	Logback	1.0.13 to 1.4.8

ARMS provides automatic instrumentation for the supported components. If your application uses a library not on this list, you can add support using manual instrumentation. For more information, see Add custom instrumentation to traces by using the OpenTelemetry Java SDK.