Supported Java components and frameworks

更新时间:
复制 MD 格式

This topic lists the Java third-party components and frameworks that Application Real-Time Monitoring Service (ARMS) supports.

Supported JDK versions

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

Note

Avoid Eclipse OpenJ9 because of compatibility issues with Application Real-Time Monitoring Service (ARMS).

Supported frameworks and components

Note

This compatibility information applies to the latest 5.X probe.

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.

Vertx

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

Note

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

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.

Note

This probe monitors Elasticsearch access only via the HTTP protocol; it does not support access via the TCP protocol.

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.

Others

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

Note

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

Component 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 - 10.X

  • Collects RED metrics and spans for HTTP requests

  • Collects Tomcat thread pool metrics

Jetty

8.X - 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 - 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 - 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 - 2.12.3

  • Collects RED metrics and spans for HTTP requests

RPC framework

Alibaba Dubbo

2.5.10 - 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 - 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

Note

Although listed components may support multiple database access methods, this instrumentation only monitors CRUD (create, read, update, and delete) operations that use the JDBC specification.

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 - 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 - 3.25.2

  • Collects metrics and spans for NoSQL calls

Memcached

2.12.0 - 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

Note

Data collection is supported for clients that access Elasticsearch servers over HTTP. Access over TCP is not supported.

InfluxDB

2.7 - 2.23

  • Collects metrics and spans for NoSQL calls

Cassandra

3.0+

  • Collects metrics and spans for NoSQL calls

Messaging system

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

Alibaba Cloud ONS

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 - 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 - 3.0.4

  • Collects RED metrics and spans for scheduled task calls

Log 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 - 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.

Supported frameworks and components for the 3.X agent

Note

The frameworks and components listed below are supported by the latest 3.X agent.

Category

Component

Supported version

web containers

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 clients

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 frameworks

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 clients

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 clients

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 frameworks

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 frameworks

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 frameworks

Log4j

1.2.16 to 1.2.17

Log4j2

2.0 to 2.20.0

Logback

1.0.13 to 1.4.8

Note

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.