支持的库

Java 代理会即时自动检测许多库、框架和应用程序服务器。如果您找不到所需的框架或技术，请考虑 提交问题。

库和框架

以下是支持的库和框架。除非另有说明，否则列出的版本是支持的最低版本。

库/框架自动检测版本独立库检测 [1]功能/语义约定
ActiveJ6.0+不适用HTTP 服务器 Span, HTTP 服务器指标
Akka Actors2.3+不适用上下文传播
Akka HTTP10.0+不适用HTTP 客户端 Span, HTTP 客户端指标, HTTP 服务器 Span, HTTP 服务器指标, 提供 http.route [2]
Alibaba Druid1.0+opentelemetry-alibaba-druid-1.0数据库连接池指标
Apache Axis21.6+不适用提供 http.route [2]，控制器 Span [3]
Apache Camel2.20+ (尚不包括 3.0+)不适用取决于使用的组件
Apache CXF JAX-RS3.2+ (尚不包括 4.0+)不适用提供 http.route [2]，控制器 Span [3]
Apache CXF JAX-WS3.0+ (尚不包括 4.0+)不适用提供 http.route [2]，控制器 Span [3]
Apache DBCP2.0+opentelemetry-apache-dbcp-2.0数据库连接池指标
Apache Dubbo2.7+opentelemetry-apache-dubbo-2.7RPC 客户端 Span, RPC 服务器 Span
Apache ElasticJob3.0+不适用无
Apache HttpAsyncClient4.1+不适用HTTP 客户端 Span, HTTP 客户端指标
Apache HttpClient2.0+opentelemetry-apache-httpclient-4.3,
opentelemetry-apache-httpclient-5.2		HTTP 客户端 Span, HTTP 客户端指标
Apache Iceberg不适用opentelemetry-iceberg-1.8无
Apache ShenYu2.4+不适用提供 http.route [2]
Apache Kafka Connect API2.6+不适用消息 Span
Apache Kafka Producer/Consumer API0.11+opentelemetry-kafka-clients-2.6消息 Span
Apache Kafka Streams API0.11+不适用消息 Span
Apache MyFaces1.2+ (尚不包括 4.0+)不适用提供 http.route [2]，控制器 Span [3]
Apache Pekko Actors1.0+不适用上下文传播
Apache Pekko HTTP1.0+不适用HTTP 客户端 Span, HTTP 客户端指标, HTTP 服务器 Span, HTTP 服务器指标, 提供 http.route [2]
Apache Pulsar2.8+不适用消息 Span
Apache RocketMQ gRPC/Protobuf-based Client5.0+不适用消息 Span
Apache RocketMQ Remoting-based Client4.8+opentelemetry-rocketmq-client-4.8消息 Span
Apache Struts2.3+不适用提供 http.route [2]，控制器 Span [3]
Apache Tapestry5.4+不适用提供 http.route [2]，控制器 Span [3]
Apache Wicket8.0+不适用提供 http.route [2]
Armeria1.3+opentelemetry-armeria-1.3HTTP 客户端 Span, HTTP 客户端指标, HTTP 服务器 Span, HTTP 服务器指标
Armeria gRPC1.14+RPC 客户端 Span, RPC 客户端指标, RPC 服务器 Span, RPC 服务器指标
AsyncHttpClient1.9+不适用HTTP 客户端 Span, HTTP 客户端指标
Avaje Jex3.0+不适用提供 http.route [2]
AWS Lambda1.0+opentelemetry-aws-lambda-core-1.0,
opentelemetry-aws-lambda-events-3.11		FaaS 服务器 Span
AWS SDK1.11 - 1.12.583,
2.2+		opentelemetry-aws-sdk-1.11,
opentelemetry-aws-sdk-1.11-autoconfigure,
opentelemetry-aws-sdk-2.2,
opentelemetry-aws-sdk-2.2-autoconfigure		消息 Span, 数据库客户端 Span, 数据库客户端指标 [6], HTTP 客户端 Span, GenAI 客户端 Span, GenAI 客户端指标
Azure Core1.14+不适用上下文传播
Cassandra Driver3.0+opentelemetry-cassandra-4.4数据库客户端 Span, 数据库客户端指标 [6]
Clickhouse Client V10.5+不适用数据库客户端 Span, 数据库客户端指标 [6]
Clickhouse Client V20.8+不适用数据库客户端 Span, 数据库客户端指标 [6]
Couchbase Client2.0 - 2.7.x不适用数据库客户端 Span, 数据库客户端指标 [6]
Couchbase Client3.1+不适用数据库客户端 Span
c3p00.9.2+opentelemetry-c3p0-0.9数据库连接池指标
Dropwizard Metrics4.0+ (默认禁用)不适用无
Dropwizard Views0.7+不适用控制器 Span [3]
Eclipse Grizzly2.3+不适用HTTP 服务器 Span, HTTP 服务器指标
Eclipse Jersey2.0+不适用提供 http.route [2]，控制器 Span [3]
Eclipse Jetty HTTP Client9.2 - 9.4.x,
12.0+		opentelemetry-jetty-httpclient-9.2
opentelemetry-jetty-httpclient-12.0		HTTP 客户端 Span, HTTP 客户端指标
Eclipse Metro2.2+不适用提供 http.route [2]，控制器 Span [3]
Eclipse Mojarra1.2+ (尚不包括 4.0+)不适用提供 http.route [2]，控制器 Span [3]
Elasticsearch API Client7.16 - 7.17.19,
8.0 - 8.9.+ [4]		不适用Elasticsearch 客户端 Span
Elasticsearch REST Client5.0+不适用数据库客户端 Span, 数据库客户端指标 [6]
Elasticsearch Transport Client5.0+不适用数据库客户端 Span, 数据库客户端指标 [6]
Failsafe不适用opentelemetry-failsafe-3.0无
Finagle23.11+不适用无
Finatra2.9+不适用提供 http.route [2]，控制器 Span [3]
Geode Client1.4+不适用数据库客户端 Span, 数据库客户端指标 [6]
Google HTTP Client1.19+不适用HTTP 客户端 Span, HTTP 客户端指标
Grails3.0+不适用提供 http.route [2]，控制器 Span [3]
GraphQL Java12.0+opentelemetry-graphql-java-12.0,
opentelemetry-graphql-java-20.0		GraphQL 服务器 Span
gRPC1.6+opentelemetry-grpc-1.6RPC 客户端 Span, RPC 客户端指标, RPC 服务器 Span, RPC 服务器指标
Guava ListenableFuture10.0+opentelemetry-guava-10.0上下文传播
GWT2.0+不适用RPC 服务器 Span
Helidon4.3+opentelemetry-helidon-4.3HTTP 服务器 Span, HTTP 服务器指标, 提供 http.route [2]
Hibernate3.3+不适用无
Hibernate Reactive1.0+不适用无
HikariCP3.0+opentelemetry-hikaricp-3.0数据库连接池指标
HttpURLConnectionJava 8+不适用HTTP 客户端 Span, HTTP 客户端指标
Hystrix1.4+不适用无
InfluxDB Client2.4+不适用数据库客户端 Span, 数据库客户端指标 [6]
Java ExecutorsJava 8+不适用上下文传播
Java HTTP ClientJava 11+opentelemetry-java-http-clientHTTP 客户端 Span, HTTP 客户端指标
Java HTTP ServerJava 8+opentelemetry-java-http-serverHTTP 服务器 Span, HTTP 服务器指标
java.util.loggingJava 8+不适用无
Java PlatformJava 8+opentelemetry-runtime-telemetry-java8,
opentelemetry-runtime-telemetry-java17,
opentelemetry-resources		JVM 运行时指标
Javalin5.0+不适用提供 http.route [2]
JAX-RS0.5+不适用提供 http.route [2]，控制器 Span [3]
JAX-RS Client1.1+不适用HTTP 客户端 Span, HTTP 客户端指标
JAX-WS2.0+ (尚不包括 3.0+)不适用提供 http.route [2]，控制器 Span [3]
JBoss Log Manager1.1+不适用无
JDBCJava 8+opentelemetry-jdbc数据库客户端 Span, 数据库客户端指标 [6]
Jedis1.4+不适用数据库客户端 Span, 数据库客户端指标 [6]
JFinal3.2+不适用提供 http.route [2]，控制器 Span [3]
JMS1.1+不适用消息 Span
Jodd HTTP4.2+不适用HTTP 客户端 Span, HTTP 客户端指标
JSP仅 2.3.x不适用控制器 Span [3]
Kotlin Coroutines1.0+不适用上下文传播
Ktor1.0+opentelemetry-ktor-1.0,
opentelemetry-ktor-2.0,
opentelemetry-ktor-3.0		HTTP 客户端 Span, HTTP 客户端指标, HTTP 服务器 Span, HTTP 服务器指标
Kubernetes Client7.0+不适用HTTP 客户端 Span
Lettuce4.0+opentelemetry-lettuce-5.1数据库客户端 Span, 数据库客户端指标 [6]
Log4j 11.2+不适用无
Log4j 22.11+opentelemetry-log4j-appender-2.17,
opentelemetry-log4j-context-data-2.17-autoconfigure		无
Logback1.0+opentelemetry-logback-appender-1.0,
opentelemetry-logback-mdc-1.0		无
Micrometer1.5+ (默认禁用)opentelemetry-micrometer-1.5无
MongoDB Driver3.1+opentelemetry-mongo-3.1数据库客户端 Span, 数据库客户端指标 [6]
MyBatis3.2+不适用无
NATS Client2.17.2+opentelemetry-nats-2.17消息 Span
Netty HTTP codec [5]3.8+opentelemetry-netty-4.1HTTP 客户端 Span, HTTP 客户端指标, HTTP 服务器 Span, HTTP 服务器指标
OpenAI Java SDK1.1+openai-java-1.1GenAI 客户端 Span, GenAI 客户端指标
OpenSearch Java Client3.0+不适用数据库客户端 Span, 数据库客户端指标 [6]
OpenSearch Rest Client1.0+不适用数据库客户端 Span, 数据库客户端指标 [6]
OkHttp2.2+opentelemetry-okhttp-3.0HTTP 客户端 Span, HTTP 客户端指标
Oracle UCP11.2+opentelemetry-oracle-ucp-11.2数据库连接池指标
OSHI5.3.1+opentelemetry-oshi系统指标 (部分支持)
Play MVC2.4+不适用提供 http.route [2]，控制器 Span [3]
Play WS1.0+不适用HTTP 客户端 Span, HTTP 客户端指标
PowerJob4.0.0+不适用无
Quarkus Resteasy Reactive2.16.7+不适用提供 http.route [2]
Quartz2.0+opentelemetry-quartz-2.0无
R2DBC1.0+opentelemetry-r2dbc-1.0数据库客户端 Span, 数据库客户端指标 [6]
RabbitMQ Client2.7+不适用消息 Span
Ratpack1.4+opentelemetry-ratpack-1.7HTTP 客户端 Span, HTTP 客户端指标, HTTP 服务器 Span, HTTP 服务器指标
Reactor3.1+opentelemetry-reactor-3.1上下文传播
Reactor Netty0.9+不适用HTTP 客户端 Span, HTTP 客户端指标
Rediscala1.8+不适用数据库客户端 Span, 数据库客户端指标 [6]
Redisson3.0+不适用数据库客户端 Span, 数据库客户端指标 [6]
RESTEasy3.0+ (尚不包括 6.0+)不适用提供 http.route [2]，控制器 Span [3]
Restlet1.0+opentelemetry-restlet-1.1,
opentelemetry-restlet-2.0		HTTP 服务器 Span, HTTP 服务器指标
RMIJava 8+RPC 客户端 Span, RPC 服务器 Span
RxJava1.0+opentelemetry-rxJava-1.0,
opentelemetry-rxJava-2.0,
opentelemetry-rxJava-3.0,
opentelemetry-rxJava-3.1.1		上下文传播
Scala ForkJoinPool2.8+不适用上下文传播
Servlet2.2+不适用HTTP 服务器 Span, HTTP 服务器指标
Spark Web Framework2.3+不适用提供 http.route [2]
Spring Batch3.0+ (尚不包括 5.0+)不适用无
Spring Bootopentelemetry-spring-boot-resources无
Spring Cloud AWS3.0+不适用消息 Span
Spring Cloud Gateway2.0+不适用提供 http.route [2]
Spring Core2.0+不适用上下文传播
Spring Data1.8+不适用无
Spring Integration4.1+ (尚不包括 6.0+)opentelemetry-spring-integration-4.1消息 Span
Spring JMS2.0+不适用消息 Span
Spring Kafka2.7+opentelemetry-spring-kafka-2.7消息 Span
Spring Pulsar1.0+消息 Span
Spring RabbitMQ1.0+不适用消息 Span
Spring RestTemplate3.1+opentelemetry-spring-web-3.1HTTP 客户端 Span, HTTP 客户端指标
Spring RMI4.0+不适用RPC 客户端 Span, RPC 服务器 Span
Spring Scheduling3.1+不适用无
Spring Web MVC3.1+opentelemetry-spring-webmvc-5.3,
opentelemetry-spring-webmvc-6.0		HTTP 服务器 Span, HTTP 服务器指标, 提供 http.route [2], 控制器 Span [3]
Spring Web Services2.0+ (尚不包括 4.0+)不适用无
Spring WebFlux5.3+opentelemetry-spring-webflux-5.3HTTP 客户端 Span, HTTP 客户端指标, HTTP 服务器 Span, HTTP 服务器指标, 提供 http.route [2], 控制器 Span [3]
Spymemcached2.12+不适用数据库客户端 Span, 数据库客户端指标 [6]
Tomcat JDBC Pool8.5+不适用数据库连接池指标
Twilio6.6+ (尚不包括 8.0+)不适用无
Undertow1.4+不适用HTTP 服务器 Span, HTTP 服务器指标
Vaadin14.2+不适用提供 http.route [2]，控制器 Span [3]
Vert.x HttpClient3.0+不适用HTTP 客户端 Span, HTTP 客户端指标
Vert.x Kafka Client3.6+不适用消息 Span
Vert.x Redis Client4.0+不适用数据库客户端 Span, 数据库客户端指标 [6]
Vert.x RxJava23.5+不适用仅上下文传播
Vert.x SQL Client4.0+不适用数据库客户端 Span, 数据库客户端指标 [6]
Vert.x Web3.0+不适用提供 http.route [2]
Vibur DBCP11.0+opentelemetry-vibur-dbcp-11.0数据库连接池指标
XXL-JOB1.9.2+不适用无
ZIO2.0+不适用上下文传播

[1] 独立库检测指的是无需 Java 代理即可使用的检测。

[2] 提供 http.route：为现有的 SERVER Span 提供基于路由的 Span 名称。如果适用，则为现有的 SERVER Span 和指标提供 http.route Span 和指标属性。

[3] 控制器 Span 是捕获控制器和/或视图执行的 INTERNAL Span。请参阅 抑制控制器和/或视图 Span。

[4] 较新版本的库内置了遥测功能。

[5] 目前不支持捕获 HTTP/2 流量。

[6] 数据库客户端指标可供选择启用 语义约定稳定性 的用户使用。

应用程序服务器

以下是代理 regularmente 测试过的应用程序服务器

应用程序服务器版本JVM
Jetty9.4.53OpenJDK 8, 11, 17, 21, 23
OpenJ9 8, 11, 17, 21, 23
Jetty10.0.19, 11.0.19OpenJDK 11, 17, 21, 23
OpenJ9 11, 17, 21, 23
Jetty12.0.6OpenJDK 17, 21, 23
OpenJ9 17, 21, 23
Open Liberty20.0.0.12OpenJDK 8, 11
OpenJ9 8, 11
Open Liberty21.0.0.12, 22.0.0.12OpenJDK 8, 11, 17
OpenJ9 8, 11, 17
Open Liberty23.0.0.12OpenJDK 8, 11, 17, 20
OpenJ9 8, 11, 17, 20
Payara5.2020.6, 5.2021.8OpenJDK 8, 11
OpenJ9 8, 11
Payara6.2023.12OpenJDK 11, 17
OpenJ9 11, 17, 21, 23
Tomcat7.0.109OpenJDK 8
OpenJ9 8
Tomcat8.5.98, 9.0.85OpenJDK 8, 11, 17, 21, 23
OpenJ9 8, 11, 17, 21, 23
Tomcat10.1.18OpenJDK 11, 17, 21, 23
OpenJ9 11, 17, 21, 23
TomEE7.0.9, 7.1.4OpenJDK 8
OpenJ9 8
TomEE8.0.16OpenJDK 8, 11, 17, 21, 23
OpenJ9 8, 11, 17, 21, 23
TomEE9.1.2OpenJDK 11, 17, 21, 23
OpenJ9 11, 17, 21, 23
Websphere Traditional8.5.5.22, 9.0.5.14IBM JDK 8
WildFly13.0.0.FinalOpenJDK 8
OpenJ9 8
WildFly17.0.1.Final, 21.0.0.FinalOpenJDK 8, 11, 17, 21
OpenJ9 8, 11, 17, 21
WildFly28.0.1.Final, 29.0.1.Final, 30.0.1.FinalOpenJDK 11, 17, 21, 23
OpenJ9 11, 17, 21, 23

最后修改于 2025 年 12 月 16 日: Java 代理库更新至 2.23.0 (#8661) (05be6c20)