ARMS 應用監控支援自動埋點常見 Java 第三方組件和架構。本文按探針版本(5.X、4.X、3.X)分別列出支援的 JDK 版本、架構和組件,根據當前使用的探針版本查閱對應章節。
支援的 JDK 版本
| 版本 | 說明 |
| JDK 25 | 從探針 4.7.x 版本開始支援 JDK 25。 |
| JDK 21 | ARMS 應用監控探針從 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.7 | ARMS 應用監控將於 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 用戶端/架構 | AgentScope | 1.0.0+ | |
| OpenAI Java SDK | 1.1.0+、2.X+、3.X+ | 採集 ChatCompletion 調用相關指標以及 Span;採集 Completion 調用相關指標以及 Span;採集 Embedding 調用相關指標以及 Span | |
| Spring AI | 1.X+ | 採集 OpenAI ChatModel 調用相關指標以及 Span;採集 Default ChatClient 調用相關指標以及 Span;採集 Default ToolManager 調用相關指標以及 Span | |
| Spring AI Alibaba | 1.0.0.3+ | 採集 DashScope ChatModel 調用相關指標以及 Span | |
| Agent 協議 | A2A (Agent-to-Agent) Java SDK | 0.3.3+ | 採集 Agent-to-Agent 通訊 Client 和 Server 調用相關指標以及 Span |
| MCP Java SDK | 0.17.0+ | 採集 Model Context Protocol Client 和 Server 調用相關指標以及 Span | |
| Web 容器 | cxf | 3.0+ | 採集 cxf 相關 RED 指標以及 Span |
| restlet | 1.1.0+ | 採集 restlet 相關 RED 指標以及 Span | |
| Tomcat | 7.X ~ 10.X | 採集 HTTP 相關 RED 指標以及 Span;採集 Tomcat 線程池指標 | |
| Jetty | 8.X ~ 11.X | 採集 HTTP 相關 RED 指標以及 Span;採集 Jetty 線程池指標 | |
| Play Framework | 2.4+ | 採集 HTTP 相關 RED 指標以及 Span | |
| WebLogic | 10.3.0 ~ 12.2.X | 採集 HTTP 相關 RED 指標以及 Span | |
| Undertow | 1.4.0+ | 採集 HTTP 相關 RED 指標以及 Span;採集 Undertow 線程池指標 | |
| Vertx | 3.0.0+ | 採集 HTTP 相關 RED 指標以及 Span | |
| Webflux | 5.0.0.RELEASE+ | 採集 HTTP 相關 RED 指標以及 Span | |
| Spring Cloud Gateway | 2.0.0.RELEASE+ | 採集 HTTP 相關 RED 指標以及 Span | |
| jFinal | 3.6+ | 採集 HTTP 相關 RED 指標以及 Span | |
| WebSphere | 9.0+ | 採集 HTTP 相關 RED 指標以及 Span | |
| HTTP 用戶端 | Apache HTTP Client | 2.0 ~ 5.3.1 | 採集 HTTP 相關 RED 指標以及 Span |
| Google HTTP Client | 1.19.0+ | 採集 HTTP 相關 RED 指標以及 Span | |
| Java HTTP Client | JDK11+ | 採集 HTTP 相關 RED 指標以及 Span | |
| OkHttp | 2.2+ | 採集 HTTP 相關 RED 指標以及 Span | |
| Async HTTP Client | 1.8 ~ 2.12.3 | 採集 HTTP 相關 RED 指標以及 Span | |
| RPC 架構 | Alibaba Dubbo | 2.5.10 ~ 2.6.12 | 採集 Dubbo 相關 RED 指標以及 Span |
| Apache Dubbo | 2.7.0+ | 採集 Dubbo 相關 RED 指標以及 Span | |
| HSF | 2.2 ~ 3.0 | 採集 HSF 相關 RED 指標以及 Span | |
| gRPC | 1.6.0+ | 採集 gRPC 相關 RED 指標以及 Span | |
| Motan | 0.3.0+ | 採集 Motan 相關 RED 指標以及 Span | |
| SofaRPC | 5.4.0+ | 採集 SofaRPC 相關 RED 指標以及 Span | |
| JDBC | OceanBase | 2.4.0+ | 採集資料庫調用相關指標以及 Span。 說明 部分組件支援多種方式訪問資料庫,探針僅監控通過 JDBC 規範進行的資料庫增刪改查操作。 |
| MySQL | 5.1.1+ | 採集資料庫調用相關指標以及 Span | |
| PostgreSQL | 42.0.0+ | 採集資料庫調用相關指標以及 Span | |
| SQL Server | 6.2.0.jre7+ | 採集資料庫調用相關指標以及 Span | |
| MariaDB | 1.5.2+ | 採集資料庫調用相關指標以及 Span | |
| Oracle | 12.2.0.1+ | 採集資料庫調用相關指標以及 Span | |
| PolarDB | 1.0.0+ | 採集資料庫調用相關指標以及 Span | |
| ClickHouse | 0.1.28+ | 採集資料庫調用相關指標以及 Span | |
| NoSQL | HBase | 2.0 ~ 3.0 | 採集 NoSQL 調用相關指標以及 Span |
| Jedis | 1.4+ | 採集 NoSQL 調用相關指標以及 Span | |
| Lettuce | 4.0.Final+ | 採集 NoSQL 調用相關指標以及 Span;採集 Lettuce 串連池指標;收集 NoSQL 響應大小指標 | |
| Redisson | 3.0 ~ 3.25.2 | 採集 NoSQL 調用相關指標以及 Span | |
| Memcached | 2.12.0 ~ 2.12.3 | 採集 NoSQL 調用相關指標以及 Span | |
| MongoDB | 3.1+ | 採集 NoSQL 調用相關指標以及 Span | |
| Elasticsearch | 5.0+ | 採集 NoSQL 調用相關指標以及 Span。 說明 僅支援採集使用 HTTP 協議方式訪問 ES 服務端的資料,不支援採集 TCP 協議訪問 ES 服務端的資料。 | |
| InfluxDB | 2.7 ~ 2.23 | 採集 NoSQL 調用相關指標以及 Span | |
| Cassandra | 3.0+ | 採集 NoSQL 調用相關指標以及 Span | |
| 訊息 | Eclipse Paho Client MQTTv3 | 1.0.2+ | 採集 Consumer 調用相關 RED 指標以及 Span |
| RocketMQ Java Client | 4.4.0、4.5.1+、5.X+ | 採集 Consumer、Producer 調用相關 RED 指標以及 Span;採集訊息延遲指標 | |
| RocketMQ Java Client V5 | 5.0.0+ | 採集 Consumer、Producer 調用相關 RED 指標以及 Span;採集訊息延遲指標 | |
| Aliyun MNS SDK | 1.3.0+ | 採集 Producer、Consumer 調用相關 RED 指標以及 Span | |
| Aliyun ONS | 1.7.0.Final+、2.0.0.Final+ | 採集 Consumer、Producer 調用相關 RED 指標以及 Span;採集訊息延遲指標 | |
| Qpid JMS Client | 0.49.0+ | 採集 Consumer 調用相關 RED 指標以及 Span | |
| RabbitMQ | 4.X+ | 採集 Consumer、Producer 調用相關 RED 指標以及 Span;採集所有 Channel、Command 操作的 Span | |
| Kafka | 0.11.0.0+、1.X+、2.X+、3.X+ | 採集 Consumer、Producer 調用相關 RED 指標以及 Span | |
| Spring-Kafka | 2.7.0+ | 採集 Consumer(Message Listener)調用相關 RED 指標以及 Span。為防止重複,Spring-Kafka 統計到調用鏈後,底層的 Kafka 增強不再生效。 | |
| 定時任務 | XXLJob | 2.0.2+ | 採集定時任務調用相關 RED 指標以及 Span |
| SchedulerX | 1.2.1 ~ 1.11.6 | 採集定時任務調用相關 RED 指標以及 Span | |
| Spring Scheduled | 3.1.0.RELEASE+ | 採集定時任務調用相關 RED 指標以及 Span | |
| ElasticJob | 3.0.0 ~ 3.0.4 | 採集定時任務調用相關 RED 指標以及 Span | |
| 日誌架構 | Log4j | 1.2+ | 往該類日誌上下文填充 EagleEye-TraceID;採集該類日誌架構列印日誌條數相關指標 |
| Log4j2 | 2.0+ | 往該類日誌上下文填充 EagleEye-TraceID;採集該類日誌架構列印日誌條數相關指標 | |
| Logback | 1.0.0 ~ 1.2.3 | 往該類日誌上下文填充 EagleEye-TraceID;採集該類日誌架構列印日誌條數相關指標 | |
| 資料庫連接池 | Druid | 1.0.25+ | 採集串連池指標;採集擷取串連操作的 Span |
| HikariCP | 3.0.0+ | 採集串連池指標 | |
| C3P0 | 0.9.5+ | 採集串連池指標 | |
| MyBatis | 3.1.0+ | 採集 MyBatis 操作的 Span | |
| DBCP | 2+ | 採集串連池指標 | |
| 其他 | Spring | 4.1.0.RELEASE+ | 埋點 Spring 的請求指派代碼,獲得一次 HTTP 要求的路由 |
| Spring-Bean | 4.1.0.RELEASE+ | 埋點 Spring 受管理 Bean 中每個 Public 方法並產生 Span |
4.X 探針支援的架構和組件
以下為最新 4.X 版本探針支援的架構和組件。4.X 與 5.X 探針支援的組件基本一致,區別在於 4.X 不包含 SofaRPC。
| 組件類型 | 組件 | 支援版本 | 作用 |
| LLM 用戶端/架構 | AgentScope | 1.0.0+ | |
| OpenAI Java SDK | 1.1.0+、2.X+、3.X+ | 採集 ChatCompletion 調用相關指標以及 Span;採集 Completion 調用相關指標以及 Span;採集 Embedding 調用相關指標以及 Span | |
| Spring AI | 1.X+ | 採集 OpenAI ChatModel 調用相關指標以及 Span;採集 Default ChatClient 調用相關指標以及 Span;採集 Default ToolManager 調用相關指標以及 Span | |
| Spring AI Alibaba | 1.0.0.3+ | 採集 DashScope ChatModel 調用相關指標以及 Span | |
| Agent 協議 | A2A (Agent-to-Agent) Java SDK | 0.3.3+ | 採集 Agent-to-Agent 通訊 Client 和 Server 調用相關指標以及 Span |
| MCP Java SDK | 0.17.0+ | 採集 Model Context Protocol Client 和 Server 調用相關指標以及 Span | |
| Web 容器 | cxf | 3.0+ | 採集 cxf 相關 RED 指標以及 Span |
| restlet | 1.1.0+ | 採集 restlet 相關 RED 指標以及 Span | |
| Tomcat | 7.X ~ 10.X | 採集 HTTP 相關 RED 指標以及 Span;採集 Tomcat 線程池指標 | |
| Jetty | 8.X ~ 11.X | 採集 HTTP 相關 RED 指標以及 Span;採集 Jetty 線程池指標 | |
| Play Framework | 2.4+ | 採集 HTTP 相關 RED 指標以及 Span | |
| WebLogic | 10.3.0 ~ 12.2.X | 採集 HTTP 相關 RED 指標以及 Span | |
| Undertow | 1.4.0+ | 採集 HTTP 相關 RED 指標以及 Span;採集 Undertow 線程池指標 | |
| Vertx | 3.0.0+ | 採集 HTTP 相關 RED 指標以及 Span | |
| Webflux | 5.0.0.RELEASE+ | 採集 HTTP 相關 RED 指標以及 Span | |
| Spring Cloud Gateway | 2.0.0.RELEASE+ | 採集 HTTP 相關 RED 指標以及 Span | |
| jFinal | 3.6+ | 採集 HTTP 相關 RED 指標以及 Span | |
| WebSphere | 9.0+ | 採集 HTTP 相關 RED 指標以及 Span | |
| HTTP 用戶端 | Apache HTTP Client | 2.0 ~ 5.3.1 | 採集 HTTP 相關 RED 指標以及 Span |
| Google HTTP Client | 1.19.0+ | 採集 HTTP 相關 RED 指標以及 Span | |
| Java HTTP Client | JDK11+ | 採集 HTTP 相關 RED 指標以及 Span | |
| OkHttp | 2.2+ | 採集 HTTP 相關 RED 指標以及 Span | |
| Async HTTP Client | 1.8 ~ 2.12.3 | 採集 HTTP 相關 RED 指標以及 Span | |
| RPC 架構 | Alibaba Dubbo | 2.5.10 ~ 2.6.12 | 採集 Dubbo 相關 RED 指標以及 Span |
| Apache Dubbo | 2.7.0+ | 採集 Dubbo 相關 RED 指標以及 Span | |
| HSF | 2.2 ~ 3.0 | 採集 HSF 相關 RED 指標以及 Span | |
| gRPC | 1.6.0+ | 採集 gRPC 相關 RED 指標以及 Span | |
| Motan | 0.3.0+ | 採集 Motan 相關 RED 指標以及 Span | |
| JDBC | OceanBase | 2.4.0+ | 採集資料庫調用相關指標以及 Span。 說明 部分組件支援多種方式訪問資料庫,探針僅監控通過 JDBC 規範進行的資料庫增刪改查操作。 |
| MySQL | 5.1.1+ | 採集資料庫調用相關指標以及 Span | |
| PostgreSQL | 42.0.0+ | 採集資料庫調用相關指標以及 Span | |
| SQL Server | 6.2.0.jre7+ | 採集資料庫調用相關指標以及 Span | |
| MariaDB | 1.5.2+ | 採集資料庫調用相關指標以及 Span | |
| Oracle | 12.2.0.1+ | 採集資料庫調用相關指標以及 Span | |
| PolarDB | 1.0.0+ | 採集資料庫調用相關指標以及 Span | |
| ClickHouse | 0.1.28+ | 採集資料庫調用相關指標以及 Span | |
| NoSQL | HBase | 2.0 ~ 3.0 | 採集 NoSQL 調用相關指標以及 Span |
| Jedis | 1.4+ | 採集 NoSQL 調用相關指標以及 Span | |
| Lettuce | 4.0.Final+ | 採集 NoSQL 調用相關指標以及 Span;採集 Lettuce 串連池指標;收集 NoSQL 響應大小指標 | |
| Redisson | 3.0 ~ 3.25.2 | 採集 NoSQL 調用相關指標以及 Span | |
| Memcached | 2.12.0 ~ 2.12.3 | 採集 NoSQL 調用相關指標以及 Span | |
| MongoDB | 3.1+ | 採集 NoSQL 調用相關指標以及 Span | |
| Elasticsearch | 5.0+ | 採集 NoSQL 調用相關指標以及 Span。 說明 僅支援採集使用 HTTP 協議方式訪問 ES 服務端的資料,不支援採集 TCP 協議訪問 ES 服務端的資料。 | |
| InfluxDB | 2.7 ~ 2.23 | 採集 NoSQL 調用相關指標以及 Span | |
| Cassandra | 3.0+ | 採集 NoSQL 調用相關指標以及 Span | |
| 訊息 | Eclipse Paho Client MQTTv3 | 1.0.2+ | 採集 Consumer 調用相關 RED 指標以及 Span |
| RocketMQ Java Client | 4.4.0、4.5.1+、5.X+ | 採集 Consumer、Producer 調用相關 RED 指標以及 Span;採集訊息延遲指標 | |
| RocketMQ Java Client V5 | 5.0.0+ | 採集 Consumer、Producer 調用相關 RED 指標以及 Span;採集訊息延遲指標 | |
| Aliyun MNS SDK | 1.3.0+ | 採集 Producer、Consumer 調用相關 RED 指標以及 Span | |
| Aliyun ONS | 1.7.0.Final+、2.0.0.Final+ | 採集 Consumer、Producer 調用相關 RED 指標以及 Span;採集訊息延遲指標 | |
| Qpid JMS Client | 0.49.0+ | 採集 Consumer 調用相關 RED 指標以及 Span | |
| RabbitMQ | 4.X+ | 採集 Consumer、Producer 調用相關 RED 指標以及 Span;採集所有 Channel、Command 操作的 Span | |
| Kafka | 0.11.0.0+、1.X+、2.X+、3.X+ | 採集 Consumer、Producer 調用相關 RED 指標以及 Span | |
| Spring-Kafka | 2.7.0+ | 採集 Consumer(Message Listener)調用相關 RED 指標以及 Span。為防止重複,Spring-Kafka 統計到調用鏈後,底層的 Kafka 增強不再生效。 | |
| 定時任務 | XXLJob | 2.0.2+ | 採集定時任務調用相關 RED 指標以及 Span |
| SchedulerX | 1.2.1 ~ 1.11.6 | 採集定時任務調用相關 RED 指標以及 Span | |
| Spring Scheduled | 3.1.0.RELEASE+ | 採集定時任務調用相關 RED 指標以及 Span | |
| ElasticJob | 3.0.0 ~ 3.0.4 | 採集定時任務調用相關 RED 指標以及 Span | |
| 日誌架構 | Log4j | 1.2+ | 往該類日誌上下文填充 EagleEye-TraceID;採集該類日誌架構列印日誌條數相關指標 |
| Log4j2 | 2.0+ | 往該類日誌上下文填充 EagleEye-TraceID;採集該類日誌架構列印日誌條數相關指標 | |
| Logback | 1.0.0 ~ 1.2.3 | 往該類日誌上下文填充 EagleEye-TraceID;採集該類日誌架構列印日誌條數相關指標 | |
| 資料庫連接池 | Druid | 1.0.25+ | 採集串連池指標;採集擷取串連操作的 Span |
| HikariCP | 3.0.0+ | 採集串連池指標 | |
| C3P0 | 0.9.5+ | 採集串連池指標 | |
| MyBatis | 3.1.0+ | 採集 MyBatis 操作的 Span | |
| DBCP | 2+ | 採集串連池指標 | |
| 其他 | Spring | 4.1.0.RELEASE+ | 埋點 Spring 的請求指派代碼,獲得一次 HTTP 要求的路由 |
| Spring-Bean | 4.1.0.RELEASE+ | 埋點 Spring 受管理 Bean 中每個 Public 方法並產生 Span |
3.X 探針支援的架構和組件
以下為最新 3.X 版本探針支援的架構和組件。
| 組件類型 | 組件 | 支援版本 |
| Web 容器 | 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 用戶端 | 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 相關 | Spring MVC | 3.0.5.RELEASE+ |
| Spring Scheduled | 3.1.0.RELEASE+ | |
| Spring Cloud 相關 | 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 架構 | 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 相關 | PolarDB | 1.1.2+(4.x 及以上版本探針支援) |
| 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 調用相關 | 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 | - | |
| 訊息相關 | 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+ | |
| 定時任務 | 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 | |
| 非同步/響應式編程架構 | SpringAsync | 4.0.X ~ 5.3.X |
| RxJAVA | 2.0.X ~ 3.1.X | |
| Reactor | 3.0.X ~ 3.5.X | |
| 日誌架構 | Log4j | 1.2.16 ~ 1.2.17 |
| Log4j2 | 2.0 ~ 2.20.0 | |
| Logback | 1.0.13 ~ 1.4.8 |
ARMS 應用監控針對支援的組件可以實現自動埋點。如果使用的組件不在上述範圍內,可以手工埋點,具體操作參見通過OpenTelemetry Java SDK為調用鏈增加自訂埋點。