支持的库

Java 代理开箱即用地对许多库、框架和应用服务器进行自动插桩。
如果您没有看到您正在寻找的框架或技术，
请考虑提交一个问题。

库与框架 {#supported-libraries}

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

库与框架	能被自动插桩版本	独立库插桩[1]	功能与语义约定
ActiveJ	6.0+	N/A	HTTP Server Spans、HTTP Server Metrics
Akka Actors	2.3+	N/A	上下文传播
Akka HTTP	10.0+	N/A	HTTP Client Spans、HTTP Client Metrics、HTTP Server Spans、HTTP Server Metrics、提供 http.route [2]
Alibaba Druid	1.0+	opentelemetry-alibaba-druid-1.0	Database Pool Metrics
Apache Axis2	1.6+	N/A	提供 http.route [2]、控制器 Span [3]
Apache Camel	2.20+ (not including 3.0+ yet)	N/A	依赖于所使用的组件
Apache CXF JAX-RS	3.2+ (not including 4.0+ yet)	N/A	提供 http.route [2]、控制器 Span [3]
Apache CXF JAX-WS	3.0+ (not including 4.0+ yet)	N/A	提供 http.route [2]、控制器 Span [3]
Apache DBCP	2.0+	opentelemetry-apache-dbcp-2.0	Database Pool Metrics
Apache Dubbo	2.7+	opentelemetry-apache-dubbo-2.7	RPC Client Spans、RPC Server Spans
Apache HttpAsyncClient	4.1+	N/A	HTTP Client Spans、HTTP Client Metrics
Apache HttpClient	2.0+	opentelemetry-apache-httpclient-4.3、 opentelemetry-apache-httpclient-5.2	HTTP Client Spans、HTTP Client Metrics
Apache ShenYu	2.4+	N/A	提供 http.route [2]
Apache Kafka Producer/Consumer API	0.11+	opentelemetry-kafka-clients-2.6	Messaging Spans
Apache Kafka Streams API	0.11+	N/A	Messaging Spans
Apache MyFaces	1.2+ (not including 4.0+ yet)	N/A	提供 http.route [2]、控制器 Span [3]
Apache Pekko Actors	1.0+	N/A	上下文传播
Apache Pekko HTTP	1.0+	N/A	HTTP Client Spans、HTTP Client Metrics、HTTP Server Spans、HTTP Server Metrics、提供 http.route [2]
Apache Pulsar	2.8+	N/A	Messaging Spans
Apache RocketMQ gRPC/Protobuf-based Client	5.0+	N/A	Messaging Spans
Apache RocketMQ Remoting-based Client	4.8+	opentelemetry-rocketmq-client-4.8	Messaging Spans
Apache Struts	2.3+	N/A	提供 http.route [2]、控制器 Span [3]
Apache Tapestry	5.4+	N/A	提供 http.route [2]、控制器 Span [3]
Apache Wicket	8.0+	N/A	提供 http.route [2]
Armeria	1.3+	opentelemetry-armeria-1.3	HTTP Client Spans、HTTP Client Metrics、HTTP Server Spans、HTTP Server Metrics
Armeria gRPC	1.14+		RPC Client Spans、RPC Client Metrics、RPC Server Spans、RPC Server Metrics
AsyncHttpClient	1.9+	N/A	HTTP Client Spans、HTTP Client Metrics
Avaje Jex	3.0+	N/A	提供 http.route [2]
AWS Lambda	1.0+	opentelemetry-aws-lambda-core-1.0, opentelemetry-aws-lambda-events-3.11	FaaS Server Spans
AWS SDK	1.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	Messaging Spans、Database Client Spans、Database Client Metrics [6]、HTTP Client Spans、GenAI Client Spans、GenAI Client Metrics
Azure Core	1.14+	N/A	上下文传播
Cassandra Driver	3.0+	opentelemetry-cassandra-4.4	Database Client Spans、Database Client Metrics [6]
Clickhouse Client	0.5+	N/A	Database Client Spans、Database Client Metrics [6]
Couchbase Client	2.0 - 2.7.x	N/A	Database Client Spans、Database Client Metrics [6]
Couchbase Client	3.1+	N/A	Database Client Spans
c3p0	0.9.2+	opentelemetry-c3p0-0.9	Database Pool Metrics
Dropwizard Metrics	4.0+ (disabled by default)	N/A	none
Dropwizard Views	0.7+	N/A	控制器 Span [3]
Eclipse Grizzly	2.3+	N/A	HTTP Server Spans、HTTP Server Metrics
Eclipse Jersey	2.0+	N/A	提供 http.route [2]、控制器 Span [3]
Eclipse Jetty HTTP Client	9.2 - 9.4.x, 12.0+	opentelemetry-jetty-httpclient-9.2 opentelemetry-jetty-httpclient-12.0	HTTP Client Spans、HTTP Client Metrics
Eclipse Metro	2.2+	N/A	提供 http.route [2]、控制器 Span [3]
Eclipse Mojarra	1.2+ (not including 4.0+ yet)	N/A	提供 http.route [2]、控制器 Span [3]
Elasticsearch API Client	7.16 - 7.17.19, 8.0 - 8.9.+ [4]	N/A	Elasticsearch Client Spans
Elasticsearch REST Client	5.0+	N/A	Database Client Spans、Database Client Metrics [6]
Elasticsearch Transport Client	5.0+	N/A	Database Client Spans、Database Client Metrics [6]
Finagle	23.11+	N/A	none
Finatra	2.9+	N/A	提供 http.route [2]、控制器 Span [3]
Geode Client	1.4+	N/A	Database Client Spans、Database Client Metrics [6]
Google HTTP Client	1.19+	N/A	HTTP Client Spans、HTTP Client Metrics
Grails	3.0+	N/A	提供 http.route [2]、控制器 Span [3]
GraphQL Java	12.0+	opentelemetry-graphql-java-12.0, opentelemetry-graphql-java-20.0	GraphQL Server Spans
gRPC	1.6+	opentelemetry-grpc-1.6	RPC Client Spans、RPC Client Metrics、RPC Server Spans、RPC Server Metrics
Guava ListenableFuture	10.0+	opentelemetry-guava-10.0	上下文传播
GWT	2.0+	N/A	RPC Server Spans
Hibernate	3.3+	N/A	none
Hibernate Reactive	1.0+	N/A	none
HikariCP	3.0+	opentelemetry-hikaricp-3.0	Database Pool Metrics
HttpURLConnection	Java 8+	N/A	HTTP Client Spans、HTTP Client Metrics
Hystrix	1.4+	N/A	none
InfluxDB Client	2.4+	N/A	Database Client Spans、Database Client Metrics [6]
Java Executors	Java 8+	N/A	上下文传播
Java HTTP Client	Java 11+	opentelemetry-java-http-client	HTTP Client Spans、HTTP Client Metrics
Java HTTP Server	Java 8+	opentelemetry-java-http-server	HTTP Server Spans、HTTP Server Metrics
java.util.logging	Java 8+	N/A	none
Java Platform	Java 8+	opentelemetry-runtime-telemetry-java8, opentelemetry-runtime-telemetry-java17, opentelemetry-resources	JVM Runtime Metrics
Javalin	5.0+	N/A	提供 http.route [2]
JAX-RS	0.5+	N/A	提供 http.route [2]、控制器 Span [3]
JAX-RS Client	1.1+	N/A	HTTP Client Spans、HTTP Client Metrics
JAX-WS	2.0+ (not including 3.0+ yet)	N/A	提供 http.route [2]、控制器 Span [3]
JBoss Log Manager	1.1+	N/A	none
JDBC	Java 8+	opentelemetry-jdbc	Database Client Spans、Database Client Metrics [6]
Jedis	1.4+	N/A	Database Client Spans、Database Client Metrics [6]
JMS	1.1+	N/A	Messaging Spans
Jodd HTTP	4.2+	N/A	HTTP Client Spans、HTTP Client Metrics
JSP	2.3.x only	N/A	控制器 Span [3]
Kotlin Coroutines	1.0+	N/A	上下文传播
Ktor	1.0+	opentelemetry-ktor-1.0, opentelemetry-ktor-2.0, opentelemetry-ktor-3.0	HTTP Client Spans、HTTP Client Metrics、HTTP Server Spans、HTTP Server Metrics
Kubernetes Client	7.0+	N/A	HTTP Client Spans
Lettuce	4.0+	opentelemetry-lettuce-5.1	Database Client Spans、Database Client Metrics [6]
Log4j 1	1.2+	N/A	none
Log4j 2	2.11+	opentelemetry-log4j-appender-2.17, opentelemetry-log4j-context-data-2.17-autoconfigure	none
Logback	1.0+	opentelemetry-logback-appender-1.0, opentelemetry-logback-mdc-1.0	none
Micrometer	1.5+ (disabled by default)	opentelemetry-micrometer-1.5	none
MongoDB Driver	3.1+	opentelemetry-mongo-3.1	Database Client Spans、Database Client Metrics [6]
MyBatis	3.2+	N/A	none
Netty HTTP codec [5]	3.8+	opentelemetry-netty-4.1	HTTP Client Spans、HTTP Client Metrics、HTTP Server Spans、HTTP Server Metrics
OpenAI Java SDK	1.1+	openai-java-1.1	GenAI Client Spans、GenAI Client Metrics
OpenSearch Rest Client	1.0+		Database Client Spans、Database Client Metrics [6]
OkHttp	2.2+	opentelemetry-okhttp-3.0	HTTP Client Spans、HTTP Client Metrics
Oracle UCP	11.2+	opentelemetry-oracle-ucp-11.2	Database Pool Metrics
OSHI	5.3.1+	opentelemetry-oshi	System Metrics (partial support)
Play MVC	2.4+	N/A	提供 http.route [2]、控制器 Span [3]
Play WS	1.0+	N/A	HTTP Client Spans、HTTP Client Metrics
PowerJob	4.0.0+	N/A	none
Quarkus Resteasy Reactive	2.16.7+	N/A	提供 http.route [2]
Quartz	2.0+	opentelemetry-quartz-2.0	none
R2DBC	1.0+	opentelemetry-r2dbc-1.0	Database Client Spans、Database Client Metrics [6]
RabbitMQ Client	2.7+	N/A	Messaging Spans
Ratpack	1.4+	opentelemetry-ratpack-1.7	HTTP Client Spans、HTTP Client Metrics、HTTP Server Spans、HTTP Server Metrics
Reactor	3.1+	opentelemetry-reactor-3.1	上下文传播
Reactor Netty	0.9+	N/A	HTTP Client Spans、HTTP Client Metrics
Rediscala	1.8+	N/A	Database Client Spans、Database Client Metrics [6]
Redisson	3.0+	N/A	Database Client Spans、Database Client Metrics [6]
RESTEasy	3.0+ (not including 6.0+ yet)	N/A	提供 http.route [2]、控制器 Span [3]
Restlet	1.0+	opentelemetry-restlet-1.1, opentelemetry-restlet-2.0	HTTP Server Spans、HTTP Server Metrics
RMI	Java 8+		RPC Client Spans、RPC Server Spans
RxJava	1.0+	opentelemetry-rxJava-1.0, opentelemetry-rxJava-2.0, opentelemetry-rxJava-3.0, opentelemetry-rxJava-3.1.1	上下文传播
Scala ForkJoinPool	2.8+	N/A	上下文传播
Servlet	2.2+	N/A	HTTP Server Spans、HTTP Server Metrics
Spark Web Framework	2.3+	N/A	提供 http.route [2]
Spring Batch	3.0+ (not including 5.0+ yet)	N/A	none
Spring Boot		opentelemetry-spring-boot-resources	none
Spring Cloud AWS	3.0+	N/A	Messaging Spans
Spring Cloud Gateway	2.0+	N/A	提供 http.route [2]
Spring Core	2.0+	N/A	上下文传播
Spring Data	1.8+	N/A	none
Spring Integration	4.1+ (not including 6.0+ yet)	opentelemetry-spring-integration-4.1	Messaging Spans
Spring JMS	2.0+	N/A	Messaging Spans
Spring Kafka	2.7+	opentelemetry-spring-kafka-2.7	Messaging Spans
Spring Pulsar	1.0+		Messaging Spans
Spring RabbitMQ	1.0+	N/A	Messaging Spans
Spring RestTemplate	3.1+	opentelemetry-spring-web-3.1	HTTP Client Spans、HTTP Client Metrics
Spring RMI	4.0+	N/A	RPC Client Spans、RPC Server Spans
Spring Scheduling	3.1+	N/A	none
Spring Web MVC	3.1+	opentelemetry-spring-webmvc-5.3, opentelemetry-spring-webmvc-6.0	HTTP Server Spans、HTTP Server Metrics、提供 http.route [2]、控制器 Span [3]
Spring Web Services	2.0+ (not including 4.0+ yet)	N/A	none
Spring WebFlux	5.3+	opentelemetry-spring-webflux-5.3	HTTP Client Spans、HTTP Client Metrics、HTTP Server Spans、HTTP Server Metrics、提供 http.route [2]、控制器 Span [3]
Spymemcached	2.12+	N/A	Database Client Spans、Database Client Metrics [6]
Tomcat JDBC Pool	8.5+	N/A	Database Pool Metrics
Twilio	6.6+ (not including 8.0+ yet)	N/A	none
Undertow	1.4+	N/A	HTTP Server Spans、HTTP Server Metrics
Vaadin	14.2+	N/A	提供 http.route [2]、控制器 Span [3]
Vert.x HttpClient	3.0+	N/A	HTTP Client Spans、HTTP Client Metrics
Vert.x Kafka Client	3.6+	N/A	Messaging Spans
Vert.x Redis Client	4.0+	N/A	Database Client Spans、Database Client Metrics [6]
Vert.x RxJava2	3.5+	N/A	仅上下文传播
Vert.x SQL Client	4.0+	N/A	Database Client Spans、Database Client Metrics [6]
Vert.x Web	3.0+	N/A	提供 http.route [2]
Vibur DBCP	11.0+	opentelemetry-vibur-dbcp-11.0	Database Pool Metrics
XXL-JOB	1.9.2+	N/A	none
ZIO	2.0+	N/A	上下文传播

[1] 独立库插桩指的是无需依赖 Java 代理即可使用的插桩方式。

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

[3] 控制器 Span 是捕获控制器、视图执行的 INTERNAL Span。请参阅禁用控制器、视图 Span。

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

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

[6] 数据库客户端指标适用于选择加入语义约定稳定性的用户。

应用服务器 {#application-servers}

以下是经过该代理定期测试的应用服务器：

应用服务器	版本	JVM
Jetty	9.4.53	OpenJDK 8, 11, 17, 21, 23 OpenJ9 8, 11, 17, 21, 23
Jetty	10.0.19, 11.0.19	OpenJDK 11, 17, 21, 23 OpenJ9 11, 17, 21, 23
Jetty	12.0.6	OpenJDK 17, 21, 23 OpenJ9 17, 21, 23
Open Liberty	20.0.0.12	OpenJDK 8, 11 OpenJ9 8, 11
Open Liberty	21.0.0.12, 22.0.0.12	OpenJDK 8, 11, 17 OpenJ9 8, 11, 17
Open Liberty	23.0.0.12	OpenJDK 8, 11, 17, 20 OpenJ9 8, 11, 17, 20
Payara	5.2020.6, 5.2021.8	OpenJDK 8, 11 OpenJ9 8, 11
Payara	6.2023.12	OpenJDK 11, 17 OpenJ9 11, 17, 21, 23
Tomcat	7.0.109	OpenJDK 8 OpenJ9 8
Tomcat	8.5.98, 9.0.85	OpenJDK 8, 11, 17, 21, 23 OpenJ9 8, 11, 17, 21, 23
Tomcat	10.1.18	OpenJDK 11, 17, 21, 23 OpenJ9 11, 17, 21, 23
TomEE	7.0.9, 7.1.4	OpenJDK 8 OpenJ9 8
TomEE	8.0.16	OpenJDK 8, 11, 17, 21, 23 OpenJ9 8, 11, 17, 21, 23
TomEE	9.1.2	OpenJDK 11, 17, 21, 23 OpenJ9 11, 17, 21, 23
Websphere Traditional	8.5.5.22, 9.0.5.14	IBM JDK 8
WildFly	13.0.0.Final	OpenJDK 8 OpenJ9 8
WildFly	17.0.1.Final, 21.0.0.Final	OpenJDK 8, 11, 17, 21 OpenJ9 8, 11, 17, 21
WildFly	28.0.1.Final, 29.0.1.Final, 30.0.1.Final	OpenJDK 11, 17, 21, 23 OpenJ9 11, 17, 21, 23