All Products
Search

This Product

    Application Real-Time Monitoring Service:Java components and frameworks supported by ARMS

    Document Center

    Application Real-Time Monitoring Service:Java components and frameworks supported by ARMS

    Last Updated:Dec 27, 2024

    This topic outlines the third-party Java components and frameworks compatible with Application Real-Time Monitoring Service (ARMS).

    Supported JDK versions

    • JDK 1.7

      Important

      The ARMS agent V3.0.X and later will no longer support Java 7. If you are still using Java 7, we recommend that you upgrade your Java version. For more information, see Application Monitoring no longer supports Java 7.

    • JDK 1.8

      Note

      For applications deployed in Kubernetes clusters, JDK 8u212 or newer is recommended. For advanced ARMS features like continuous profiling, JDK 8u352 or above is advised. For more information, see the referenced document.

    • JDK 11

      Note

      For advanced ARMS capabilities such as continuous profiling, JDK 11.0.17 or later is recommended. For more information, see the referenced document.

    • JDK 17

      Note

      To utilize advanced ARMS features like continuous profiling, JDK 17.0.9 or newer is recommended. For more information, see the referenced document.

    • JDK 21

      Note

      The ARMS application monitoring agent now supports JDK 21 starting with version 3.1.4. If you are using JDK 21, ensure the agent is updated to version 3.1.4 or later. For the agent upgrade process, see the referenced document.

    Supported JDK distributions

    • OpenJDK (recommended)

    • Alibaba Dragonwell (recommended)

    • Temurin

    • AdoptOpenJDK

    • Amazon Corretto

    • Azul

    • Java HotSpot VM

    Note

    Eclipse OpenJ9 is not recommended due to incompatibility with Application Monitoring.

    Frameworks and components supported by the 4.X agent

    Note

    The list below details frameworks and components supported by the latest 4.X version of the agent.

    Component type

    Component

    Supported version

    Function

    Web container

    Tomcat

    7.X ~ 10.X

    • Collect HTTP-related RED metrics and Span

    • Collect Tomcat thread pool metrics

    Jetty

    8.X ~ 11.X

    • Collect HTTP-related RED metrics and Span

    • Collect Jetty thread pool metrics

    Play Framework

    2.4 +

    • Collect HTTP-related RED metrics and Span

    WebLogic

    10.3.0 ~ 12.2.X

    • Collect HTTP-related RED metrics and Span

    Undertow

    1.4.0 +

    • Collect HTTP-related RED metrics and Span

    • Collect Undertow thread pool metrics

    Vertx

    3.0.0 +

    • Collect HTTP-related RED metrics and Span

    Webflux

    5.0.0.RELEASE +

    • Collect HTTP-related RED metrics and Span

    Spring Cloud Gateway

    2.0.0.RELEASE +

    • Collect HTTP-related RED metrics and Span

    jFinal

    3.6 +

    • Collect HTTP-related RED metrics and Span

    WebSphere

    9.0 +

    • Collect HTTP-related RED metrics and Span

    HTTP client

    Apache HTTP Client

    2.0 ~ 5.3.1

    • Collect HTTP-related RED metrics and Span

    Google HTTP Client

    1.19.0 +

    • Collect HTTP-related RED metrics and Span

    OkHttp

    2.2 +

    • Collect HTTP-related RED metrics and Span

    Async HTTP Client

    1.8 ~ 2.12.3

    • Collect HTTP-related RED metrics and Span

    RPC framework

    Alibaba Dubbo

    2.5.10 ~ 2.6.12

    • Collect Dubbo-related RED metrics and Span

    Apache Dubbo

    2.7.0 ~ 2.7.7

    • Collect Dubbo-related RED metrics and Span

    HSF

    2.2 ~ 3.0

    • Collect HSF-related RED metrics and Span

    gRPC

    1.6.0 +

    • Collect gRPC-related RED metrics and Span

    JDBC

    MySQL

    5.1.1 +

    • Collect database call-related metrics and Span

    PostgreSQL

    42.0.0 +

    • Collect database call-related metrics and Span

    SQL Server

    6.2.0.jre7 +

    • Collect database call-related metrics and Span

    MariaDB

    1.5.2 +

    • Collect database call-related metrics and Span

    Oracle

    12.2.0.1 +

    • Collect database call-related metrics and Span

    PolarDB

    1.0.0 +

    • Collect database call-related metrics and Span

    ClickHouse

    0.1.28 +

    • Collect database call-related metrics and Span

    NoSQL

    Jedis

    1.4 +

    • Collect NoSQL call-related metrics and Span

    Lettuce

    4.0.Final +

    • Collect NoSQL call-related metrics and Span

    • Collect Lettuce connection pool metrics

    • Collect NoSQL response size metrics

    Redisson

    3.0-3.25.2

    • Collect NoSQL call-related metrics and Span

    Memcached

    2.12.0 ~ 2.12.3

    • Collect NoSQL call-related metrics and Span

    MongoDB

    3.1 +

    • Collect NoSQL call-related metrics and Span

    Elasticsearch

    5.0 +

    • Collect NoSQL call-related metrics and Span

    Note

    Only supports collecting data accessed using the HTTP protocol to the ES server. Does not support collecting data accessed using the TCP protocol to the ES server.

    InfluxDB

    2.7 ~ 2.23

    • Collect NoSQL call-related metrics and Span

    Cassandra

    3.0 +

    • Collect NoSQL call-related metrics and Span

    Message

    RocketMQ Java Client

    4.4.0, 4.5.1 +, 5.X +

    • Collect consumer and producer call-related RED metrics and Span

    • Collect message latency metrics

    RocketMQ Java Client V5

    5.0.0 +

    • Collect consumer and producer call-related RED metrics and Span

    • Collect message latency metrics

    Aliyun ONS

    1.7.0.Final +, 2.0.0.Final +

    • Collect consumer and producer call-related RED metrics and Span

    • Collect message latency metrics

    RabbitMQ

    4.X +

    • Collect consumer and producer call-related RED metrics and Span

    • Collect Span for all channel and command operations

    Kafka

    0.11.0.0 +, 1.X +, 2.X +, 3.X +

    • Collect consumer and producer call-related RED metrics and Span

    Spring-Kafka

    2.7.0 +

    • Collect RED metrics and spans related to Consumer (Message Listener) invocation.

      Collect consumer (message listener) call-related RED metrics and Span. To prevent duplication, after Spring-Kafka is counted in the call chain, the underlying Kafka enhancement is no longer effective.

    Scheduled task

    XXLJob

    2.0.2 +

    • Collect scheduled task call-related RED metrics and Span

    SchedulerX

    1.2.1 ~ 1.11.6

    • Collect scheduled task call-related RED metrics and Span

    Spring Scheduled

    3.1.0.RELEASE +

    • Collect scheduled task call-related RED metrics and Span

    ElasticJob

    3.0.0 ~ 3.0.4

    • Collect scheduled task call-related RED metrics and Span

    Log framework

    Log4j

    1.2 +

    • Fill the log context with EagleEye-TraceID

    • Collect metrics related to the number of logs printed by the log framework

    Log4j2

    2.0 +

    • Fill the log context with EagleEye-TraceID

    • Collect metrics related to the number of logs printed by the log framework

    Logback

    1.0.0 ~ 1.2.3

    • Fill the log context with EagleEye-TraceID

    • Collect metrics related to the number of logs printed by the log framework

    Database connection pool

    Druid

    1.0.25 +

    • Collect connection pool metrics

    • Collect Span for obtaining connection operations

    HikariCP

    3.0.0 +

    • Collect connection pool metrics

    C3P0

    0.9.5 +

    • Collect connection pool metrics

    MyBatis

    3.1.0 +

    • Collect Span for MyBatis operations

    DBCP

    2 +

    • Collect connection pool metrics

    Other

    Spring

    4.1.0.RELEASE +

    Instrument Spring's request dispatch code to obtain the routing of an HTTP request

    Spring-Bean

    4.1.0.RELEASE +

    Instrument each public method in Spring-managed beans and generate Span

    Frameworks and components supported by the 3.X agent

    Note

    The list below details frameworks and components supported by the latest 3.X version of the agent.

    Component type

    Component

    Supported version

    Web container

    Tomcat

    7.X ~ 10.X

    Jetty

    8.1.X ~ 11.0.X

    Play Framework

    2.2.X ~ 2.8.X

    WebLogic

    10.3.X ~ 12.2.X

    Undertow

    1.4.X ~ 2.2.X

    Vertx

    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 ~ 4.11.X

    Spring Web (RestTemplate)

    AsyncHttpClient

    2.0.X ~ 2.12.X

    Spring-related

    Spring MVC

    3.0.5.RELEASE+

    Spring Scheduled

    3.1.0.RELEASE+

    Spring Cloud-related

    Hystrix

    1.0.X ~ 1.5.X

    Feign

    9.0.X ~ 12.4.X

    Spring Webflux

    5.0.X ~ 6.0.X

    Spring Cloud Gateway

    2.1.X ~ 4.0.X

    RPC framework

    Dubbo

    2.4.X+

    Ali-HSF (High Speed Framework)

    2.2.X+

    GRpc

    0.7.X ~ 1.56.X

    Thrift

    0.1.X ~ 0.18.X

    JDBC-related

    PolarDB

    1.1.2+ (supported by the ARMS agent V4.X and later)

    Mysql Connector

    5.0.X+

    Postgresql JDBC Driver

    42.1.X+

    Microsoft JDBC Driver for SQL Server

    6.4.X ~ 12.2.X

    MariaDB Java Client

    1.5.X ~ 3.1.X

    Oracle ojdbc

    7, 8, 10, 14

    Sharding-jdbc

    4.0.X ~ 4.1.X

    Druid

    1.0.X+

    Hikari-CP

    2.3.X+

    MyBatis

    3.1.X ~ 3.5.X

    MyBatisPlus

    1.0.X ~ 1.7.X

    NoSQL-related

    Jedis

    2.X ~ 4.X

    Lettuce

    5.2.X+

    Redisson

    2.5.X+

    MemCached

    2.8.X ~ 2.12.X

    MongoDB Java Driver

    3.X

    Spring-MongoDB

    2.0.X ~ 3.4.X

    Elasticsearch Rest Client

    5.X ~ 7.X

    Elasticsearch Rest High Level Client

    6.X ~ 7.X

    Clickhouse JDBC Driver

    0.3.X ~ 0.4.X

    influxDB

    -

    Message-related

    RocketMQ Java Client

    4.4.0, 4.5.1+, 5.X+

    RocketMQ Java Client V5

    5.X+

    Spring-RocketMQ

    2.0.2+

    Aliyun 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+

    Scheduled task

    XXLJob

    2.0.X ~ 2.4.X

    ElasticJob

    2.0.X ~ 2.1.X

    SchedulerX

    1.2.X ~ 1.5.X

    Spring Scheduled

    3.2.X ~ 5.3.X

    Asynchronous or responsive programming framework

    SpringAsync

    4.0.X ~ 5.3.X

    RxJAVA

    2.0.X ~ 3.1.X

    Reactor

    3.0.X ~ 3.5.X

    Log framework

    Log4j

    1.2.16 ~ 1.2.17

    Log4j2

    2.0 ~ 2.20.0

    Logback

    1.0.13 ~ 1.4.8

    Note

    ARMS application monitoring offers automatic instrumentation for supported components. For components not listed, manual instrumentation is possible. For detailed instructions, see the referenced document.