Version 1.27.0

This release targets the OpenTelemetry SDK 1.27.0.

Note that many artifacts have the -alpha suffix attached to their version number, reflecting that they are still alpha quality and will continue to have breaking changes. Please see the VERSIONING.md for more details.

Migration notes

• Jersey 3.0 instrumentation suppression keys have changed from jaxrs-2.0 to jaxrs-3.0, and from jersey-2.0 to jersey-3.0 (#8486)
• The opentelemetry-runtime-metrics artifact has been renamed and split into opentelemetry-runtime-telemetry-java8 and opentelemetry-runtime-telemetry-java17 (#8165, #8715)
• InetSocketAddressNetServerAttributesGetter and InetSocketAddressNetClientAttributesGetter have been deprecated (#8341, #8591)
• The new HTTP and network semantic conventions can be opted into using either the system property otel.semconv-stability.opt-in or the environment variable OTEL_SEMCONV_STABILITY_OPT_IN, which support two values:
  • http - emit the new, stable HTTP and networking attributes, and stop emitting the old experimental HTTP and networking attributes that the instrumentation emitted previously.
  • http/dup - emit both the old and the stable HTTP and networking attributes, allowing for a more seamless transition.
  • The default behavior (in the absence of one of these values) is to continue emitting the same HTTP and network semantic conventions that were emitted in 1.26.0.
  • Note: this option will be removed later this year after the new HTTP and network semantic conventions are marked stable, at which time the Java instrumentation version will be bumped from 1.x to 2.0, and the old HTTP and network semantic conventions will no longer be supported.

🌟 New javaagent instrumentation

• Quarkus RESTEasy Reactive (#8487)
• Reactor Kafka (#8439, #8529)

📈 Enhancements

• Use histogram advice in the Micrometer bridge (#8334)
• Disable by default gauge-based histograms in the Micrometer bridge (#8360)
• Specify ...jvm.gc.duration buckets using advice API (#8436)
• Make spanKindExtractor configurable in Ktor instrumentations (#8255)
• aws-sdk-2.2: Support non-X-Ray propagation for SQS (#8405)
• Implement HTTP resend spec for OkHttp 3 (#7652)
• Use jakarta.servlet.error.exception request attribute on jetty11 (#8503)
• Provide spring-boot-autoconfigure configuration metadata (#8516)
• Read AWS lambda tracing info from com.amazonaws.xray.traceHeader system property (#8368)
• Skip not decorator check for classes in boot loader (#8594)
• Change context propagation debug failures from error to warn (#8601)
• JavaScript Snippet Injection Support Servlet 5 (#8569)
• Faster type matching (#8525)
• Explicitly disable the logging exporter by default to override the upcoming SDK autoconfigure module change in 1.27.0 and preserve existing behavior (#8647)
• Support otel.sdk.disabled in the spring boot starter (#8602)
• Add OTLP log exporter to the OpenTelemetry Spring Starter (#8493)
• Suppress Spring Actuator instrumentation when micrometer instrumentation is suppressed (#8677)
• Replace "1" with the appropriate units and don't fall back to "1" if the unit is unknown (#8668)
• Added setOpenTelemetry method to log4j appender (#8231)

🛠️ Bug fixes

• Fix using logback mdc instrumentation along with SocketAppender (#8498)
• Fix failure when kafka metrics reporter is set to an empty string (#8523)
• Remove extra space from kubernetes client span name (#8540)
• Fix jetty context leak (#8552)
• Filter out scalar Mono/Flux instances (#8571)
• End netty client span when channel is closed (#8605)
• Unregistering jmx gc metrics on close (#8650)
• Fix snippet injection ClassCastException (#8701)
• Only instrument the actual Spring TaskScheduler implementations (#8676)

🙇 Thank you

This release was possible thanks to the following contributors who shared their brilliant ideas and awesome pull requests:

@62mkv
@bcoquell
@breedx-splk
@brunobat
@edzebo
@gavlyukovskiy
@huange7
@insotriplesix
@irizzant
@jack-berg
@jdoherty
@jeanbisutti
@kes2464
@kurvatch
@laurit
@mateuszrzeszutek
@michaeljohnalbers
@Oberon00
@orangain
@qiansheng91
@roberttoyonaga
@rotscher
@rupinder10
@sakthiraam
@siyuniu-ms
@smirnoal
@theletterf
@trask
@tylerbenson
@ViliusS
@will-zdu
@zeitlinger
@zoobert

Version 1.26.0

This release targets the OpenTelemetry SDK 1.26.0.

Note that many artifacts have the -alpha suffix attached to their version number, reflecting that they are still alpha quality and will continue to have breaking changes. Please see the VERSIONING.md for more details.

Migration notes

• java.util.concurrent executors instrumentation suppression key has changed from executor to executors (#8451)

🌟 New javaagent instrumentation

• Add instrumentation for vertx-sql-client (#8311)

🌟 New library instrumentation

📈 Enhancements

• Make net.transport an optional attribute (#8279)
• Introduce @AddingSpanAttributes annotation (#7787)
• JavaScript snippet injection (#7650)
• Map peer.service also from net.sock.peer.name (#7888)
• Set up EarlyInitAgentConfig even earlier (#8413)

🛠️ Bug fixes

• Fix nested http.route (#8282)
• Fix undertow instrumentation with http pipelining (#8400)
• Fix http pipelining on Grizzly (#8411)
• Fix http pipelining on Netty 4.1 server (#8412)
• Allow transforming classes with missing field types (#8393)
• Fix reactor flux retry context leak (#8456)

🧰 Tooling

• Introduce new incubating InstrumenterBuilder methods (#8392)

🙇 Thank you

This release was possible thanks to the following contributors who shared their brilliant ideas and awesome pull requests:

@apanasevich
@breedx-splk
@BroadWFarmer
@brunobat
@dmarkwat
@edison-moreno
@ericsyh
@fmhwong
@hannahchan
@heyams
@kaibocai7
@laurit
@lmolkova
@mateuszrzeszutek
@niteshs7
@PeterF778
@rahuldimri
@sfriberg
@shuwpan
@siyuniu-ms
@stevesea
@theletterf
@trask
@tylerbenson
@xiangtianyu
@yzhuang93

Version 1.25.1

This is a patch release on the previous 1.25.0 release, fixing the issue(s) below.

• Fix apache pulsar instrumentation missing from the Java agent (#8378)

Version 1.25.0

This release targets the OpenTelemetry SDK 1.25.0.

Note that many artifacts have the -alpha suffix attached to their version number, reflecting that they are still alpha quality and will continue to have breaking changes. Please see the VERSIONING.md for more details.

Migration notes

• Apache Pulsar instrumentation name is changed from io.opentelemetry.apache-pulsar-2.8 to io.opentelemetry.pulsar-2.8 and Apache Camel instrumentation name is changed from io.opentelemetry.apache-camel-2.20 to io.opentelemetry.camel-2.20 (#8195)
• Mojarra instrumentation suppression key has changed from mojarra to jsf-mojarra and MyFaces instrumentation suppression key has changed from myfaces to jsf-myfaces (#7811)

🌟 New javaagent instrumentation

• R2DBC (#7977)
• Add JFR streaming metrics gatherer (#7886)
• ZIO 2.0 instrumentation (#7980)

🌟 New library instrumentation

• R2DBC (#7977)
• Add JFR streaming metrics gatherer (#7886)
• Add library instrumentation for java http client (#8138)

📈 Enhancements

• Move X-Ray Env Variable propagation to span link instead of parent (#7970)
• Reduce memory usage for ClassLoaderHasClassesNamedMatcher (#7866)
• Remove password from db.user parsed from JDBC url (#8106)
• Ignore appd agent classes (#8065)
• Add http client metrics to apache http library instrumentation (#8128)
• Instrument additional pulsar receive methods (#8171)
• Support latest Hibernate 6 version (#8189)
• Support spring boot service name detector when spring boot application is packaged in one jar (#8101)
• Support parsing Spring boot service name when more than one yaml is defined (#8006)
• Add option to capture logback key value pairs (#8074)
• Bridge agent logs into application's slf4j logger (#7339, #8228)
• Better container ID parsing (#8206)
• Pulsar batch receive instrumentation (#8173)
• Improve compatibility with SecurityManager (#7983)
• Instrument akka-http bindAndHandle (#8174)
• Spring scheduling: run error handler with the same context as task (#8220)
• Switch from http.flavor to net.protocol.* (#8131, #8244)
• Support latest Armeria release (#8247)
• Populate process.command_args for Java 9+ and improve process.command_line for Java 8 (#8130)

🛠️ Bug fixes

• Fix TracingCqlSession ClassCastException (#8041)
• Kafka: avoid registering duplicate metrics reporter (#8099)
• Prefix baggage key not value when adding it to logback mdc (#8066)
• Fix error when using shardingsphere (#8110)
• Fix order of cxf handlers to enable symmetric tracing around jaxws handler chain (#8160)
• Fix javaagent armeria server instrumentation (#8281)

🧰 Tooling

• Add HttpServerResponseCustomizer support for various servers (#8094, #8095, #8265, #8264, #8273, #8263, #8274, #8272)
• Add removeJarVersionNumbers build setting (#8116)
• Add disableShadowRelocate build setting (#8117)

🙇 Thank you

This release was possible thanks to the following contributors who shared their brilliant ideas and awesome pull requests:

@abhisesh
@adamleantech
@agoallikmaa
@amseager
@anuraaga
@arminru
@aschugunov
@bcoquell
@blumamir
@breedx-splk
@cleverchuk
@coderzc
@dmytr
@duartesaraiva98
@huange7
@jack-berg
@jeanbisutti
@jkwatson
@juandaco
@laurit
@lmolkova
@makssobolevs
@marcingrzejszczak
@mateuszrzeszutek
@maverick-devil
@niteshs7
@pellmont
@PhilKes
@roberttoyonaga
@robododge
@ryandens
@sirianni
@transfercai
@trask
@trudyq
@tsloughter
@tylerbenson
@Volodymyr-Maiboroda-Imprivata
@wzy531a
@zackman0010

Version 1.24.0

This release targets the OpenTelemetry SDK 1.24.0.

Note that many artifacts have the -alpha suffix attached to their version number, reflecting that they are still alpha quality and will continue to have breaking changes. Please see the VERSIONING.md for more details.

Migration notes

🌟 New javaagent instrumentation

• Add Apache Pulsar client instrumentation (#5926, #7999, #7943, #8007)
• Add Jodd-Http instrumentation (#7868)

🌟 New library instrumentation

• Add Ktor client instrumentation (#7982, #7997)
• Add Spring Webflux server instrumentation (#7899)

📈 Enhancements

• Implement messaging.kafka.* attributes spec (#7824, #7860)
• Make RxJava2 instrumentation Android-friendly (#7895)
• Support more semantic convention for RocketMQ trace (#7871)
• Instrumenting cassandra executeReactive method (#6441)
• Make the OpenTelemetry Logback appender work with GraalVM native images (#7989)
• Add baggage to Logback MDC; controlled by a configuration flag (#7892)
• Make the Spring Boot autoconfigure module work with Spring Boot 3 (#8028, #8051)

🛠️ Bug fixes

• Handle JMX MBean attributes with embedded dots (#7841)
• Fix ClassCastException when using -Dotel.jmx.target.system=tomcat (#7884)
• Fix NPE in the AWS SDK 2 instrumentation when request instrumentation is suppressed (#7953)
• Fix Kotlin coroutine context propagation (#7879)
• Fix the JAX-RS annotation instrumentation on Open Liberty (#7890)
• Fix an AbstractMethodError in the Logback instrumentation (#7967)
• Fix NPE in the RabbitMQ instrumentation (#8021)
• Fix JMX metrics usage examples (#7877)

🧰 Tooling

• Remove deprecated instrumentation-api-semconv code (#7838)
• Look up helper class bytes when they are needed (#7839)
• Run smoke tests using Open Liberty 21.0.0.12 and 22.0.0.12 (#7878, #7857)
• Add additional groovy script classloaders to ignore list. (#7460)
• Make AggregationTemporality configurable for OtlpInMemoryMetricExporter in the agent-for-testing module (#7904)
• Upgrade to gradle 8.0.2 (#7910, 7978)
• Replace the test-sets plugin with Gradle test suites (#7930, #7933, #7932, #7931, #7929, #7946, #7945, #7944, #7943, #7942, #7928, #7951)
• Add a utility for tracking HTTP resends (#7986)
• Remove deprecated messaging.url attribute from messaging getter (#8008)
• Add protocol name&version to net attribute getters (#7994)
• Test http client captured headers (#7993)
• Improve compatibility with other agents (#7916)
• Share timer class used by messaging instrumentations (#8009)
• Convert groovy tests to java (#7976, #7975, #7912)
• Check that extracting extension jar doesn't escape designated directory (#7908)
• Assert user agent when it is present in HTTP client tests (#7918)
• Update the OpenTelemetry SDK version to 1.24.0 (#8027)
• Provide ability to add HTTP server response headers, with Tomcat implementation (#7990)

🙇 Thank you

This release was possible thanks to the following contributors who shared their brilliant ideas and awesome pull requests:

@aaron-ai
@adamleantech
@agoallikmaa
@amexboy
@anuragagarwal561994
@arik-dig
@asarkar
@awelless
@bherbst
@breedx-splk
@devkanro
@fmhwong
@hansh0801
@heyams
@hubxx
@jack-berg
@jamesmoessis
@jeanbisutti
@KevinLiLu
@laurit
@lennartfricke
@mateuszrzeszutek
@mellis3000
@neroux
@oswin886
@PeterF778
@PhilKes
@ptrdom
@raamcosta
@riferrei
@SimoneGiusso
@tjiuming
@trask
@tylerbenson
@yonigibbs
@zeitlinger

Version 1.23.0

This release targets the OpenTelemetry SDK 1.23.1.

Note that many artifacts have the -alpha suffix attached to their version number, reflecting that they are still alpha quality and will continue to have breaking changes. Please see the VERSIONING.md for more details.

Migration notes

• HTTP span names are now "{http.method} {http.route}" instead of just "{http.route}", reflecting the recent change in the HTTP semantic conventions (#7730)
• Added the base version into library package names to make room for other base versions without breaking backwards compatibility in the future once these artifacts are declared stable (#7608, #7752, #7764)
  • io.opentelemetry.instrumentation.spring.web.SpringWebTelemetry → io.opentelemetry.instrumentation.spring.web.v3_1.SpringWebTelemetry
  • io.opentelemetry.instrumentation.spring.webflux.SpringWebfluxTelemetry → io.opentelemetry.instrumentation.spring.webflux.v5_0.SpringWebfluxTelemetry
  • io.opentelemetry.instrumentation.spring.integration.SpringIntegrationTelemetry → io.opentelemetry.instrumentation.spring.integration.v4_1.SpringIntegrationTelemetry
  • io.opentelemetry.instrumentation.logback.v1_0.OpenTelemetryAppender → io.opentelemetry.instrumentation.logback.mdc.v1_0.OpenTelemetryAppender
  • io.opentelemetry.instrumentation.apachedbcp.ApacheDbcpTelemetry → io.opentelemetry.instrumentation.apachedbcp.v2_0.ApacheDbcpTelemetry
  • io.opentelemetry.instrumentation.c3p0.C3p0Telemetry → io.opentelemetry.instrumentation.c3p0.v0_9.C3p0Telemetry
  • io.opentelemetry.instrumentation.graphql.GraphQLTelemetry → io.opentelemetry.instrumentation.graphql.v12_0.GraphQLTelemetry
  • io.opentelemetry.instrumentation.guava.GuavaAsyncOperationEndStrategy → io.opentelemetry.instrumentation.guava.v10_0.GuavaAsyncOperationEndStrategy
  • io.opentelemetry.instrumentation.hikaricp.HikariTelemetry → io.opentelemetry.instrumentation.hikaricp.v3_0.HikariTelemetry
  • io.opentelemetry.instrumentation.kafkaclients.KafkaTelemetry → io.opentelemetry.instrumentation.kafkaclients.v2_6.KafkaTelemetry
  • io.opentelemetry.instrumentation.oracleucp.OracleUcpTelemetry → io.opentelemetry.instrumentation.oracleucp.v11_2.OracleUcpTelemetry
  • io.opentelemetry.instrumentation.ratpack.RatpackTelemetry → io.opentelemetry.instrumentation.ratpack.v1_7.RatpackTelemetry
  • io.opentelemetry.instrumentation.reactor.ContextPropagationOperator → io.opentelemetry.instrumentation.reactor.v3_1.ContextPropagationOperator
  • io.opentelemetry.instrumentation.viburdbcp.ViburTelemetry → io.opentelemetry.instrumentation.viburdbcp.v11_0.ViburTelemetry
• Several instrumentation scope names have been fixed (#7632)
  • io.opentelemetry.cxf-jaxrs-3.2 → io.opentelemetry.jaxrs-2.0-cxf-3.2
  • io.opentelemetry.jersey-2.0 → io.opentelemetry.jaxrs-2.0-jersey-2.0 or io.opentelemetry.jaxrs-3.0-jersey-3.0 as appropriate
  • io.opentelemetry.resteasy-3.0 → io.opentelemetry.jaxrs-2.0-resteasy-3.0
  • io.opentelemetry.resteasy-3.1 → io.opentelemetry.jaxrs-2.0-resteasy-3.1
  • io.opentelemetry.resteasy-6.0 → io.opentelemetry.jaxrs-3.0-resteasy-6.0
  • io.opentelemetry.jws-1.1 → io.opentelemetry.jaxws-jws-api-1.1
  • io.opentelemetry.vertx-kafka-client-3.5 → io.opentelemetry.vertx-kafka-client-3.6
  • io.opentelemetry.hibernate-4.3 → io.opentelemetry.hibernate-procedure-call-4.3
• All methods in all *Getter classes in instrumentation-api-semconv have been renamed to use the get*() naming scheme (#7619)
• Return interfaces instead of concrete implementations in instrumentation-api-semconv (#7658)

📈 Enhancements

• Support Spring Web 6 in library instrumentation (#7551)
• Add gRPC request metadata instrumentation (#7011)
• Pass context to content length http metrics meters (#7506)
• Update SQL span name for procedures (#7557)
• Ratpack services OpenTelemetry (#7477)
• Ignore janino classloader (#7710)
• Improve type resolution cache for classes in java package (#7714)
• End netty client span before callbacks (#7737)
• Support slf4j to log4j2 (#7656)
• Add net.host.port to the http.server.active_requests metric (#7757)
• Allow JDBC library instrumentation to use a custom OpenTelemetry instance to be more DI (e.g. Spring Boot) friendly (#7697)
• Dubbo: don't create spans for calls inside the same jvm (#7761)
• Bridge OpenTelemetry metrics batch API (#7762)
• Support Spring Boot 3 in autoconfigure module (#7784)
• Change Spring Scheduling to not capture span for one-time jobs (only repeated jobs) (#7760)
• Add instrumentation for hibernate 6 (#7773)
• Put http.route attribute onto http.server.duration on Play framework request processing (#7801)
• Add Jakarta JSF 3.0+ instrumentation (#7786)
• Capture net.sock.peer.addr more reliably in grpc client instrumentation (#7742)

🛠️ Bug fixes

• Fix potential startup failure (#7567)
• Fix NoClassDefFoundError happening when snakeyaml is used on a custom JRE (#7598)
• Fix inconsistent handling of net.peer.port in HTTP instrumentations (#7618)
• Fix concurrency issue in OpenTelemetryDriver (#7628)
• Fix ClassCastException with redisson batch with atomic write option (#7743)
• Ensure kafka configuration remains serializable (#7754, #7789)

🙇 Thank you

This release was possible thanks to the following contributors who shared their brilliant ideas and awesome pull requests:

@akats7
@anuragagarwal561994
@arbiv
@aschugunov
@astappiev
@bcmedeiros
@blumamir
@breedx-splk
@cuichenli
@FranPregernik
@heyams
@jack-berg
@jarias-lfx
@jkwatson
@jsalinaspolo
@kaibocai
@laurit
@lmolkova
@mateuszrzeszutek
@MosheElisha
@moznion
@PeterF778
@plevart
@robododge
@samimusallam
@ShinJJang
@Tavh
@theletterf
@trask
@xiangtianyu
@zeitlinger
@zewade

Version 1.22.1

This is a patch release on the previous 1.22.0 release, fixing the issue(s) below.

• Fix potential startup failure (#7567)

Version 1.22.0

This release targets the OpenTelemetry SDK 1.22.0.

Note that many artifacts have the -alpha suffix attached to their version number, reflecting that they are still alpha quality and will continue to have breaking changes. Please see the VERSIONING.md for more details.

📈 Enhancements

• Add resource injection for getResourceAsStream (#7476)
• GRPC: Adds peer socket address when the client call is ready (#7451)
• Make OpenTelemetryAppender.Builder public (#7521)
• Disable internal TaskScheduler spans in Spring Kafka instrumentation (#7553)
• Support Spring Web MVC in library instrumentation (#7552)
• Instrument JMS 3.0 (Jakarta) (#7418)
• Shade application.io.opentelemetry in agent extension class loader (#7519)
• Use new reactor contextWrite when available (from reactor 3.4.0) (#7538)
• Make config file available in early agent initialization phase (#7550)
• Support Spring JMS 6.0 (#7438)

🛠️ Bug fixes

• Preserve original exception in jetty http client wrappers (#7455)
• Propagate original exception through kafka wrapper (#7452)
• Fix class file load error when using spring-guice together with spring-web instrumentation (#7447)
• Fix NPE in servlet AsyncListener on OpenLiberty (#7498)

🧰 Tooling

• Muzzle logs should be logged using the io.opentelemetry.* logger name (#7446)

🙇 Thank you

This release was possible thanks to the following contributors who shared their brilliant ideas and awesome pull requests:

@anuragagarwal561994
@axelczk
@breedx-splk
@cschieb
@jack-berg
@kingkongpoon
@laurit
@liangyuanpeng
@mateuszrzeszutek
@pellmont
@PeterF778
@sodared
@theletterf
@trask
@tylerbenson
@wallezhang
@wzy531a

Version 1.21.0

This release targets the OpenTelemetry SDK 1.21.0.

Note that many artifacts have the -alpha suffix attached to their version number, reflecting that they are still alpha quality and will continue to have breaking changes. Please see the VERSIONING.md for more details.

📈 Enhancements

• Remove deprecated HTTP semconv code (#7259)
• Rocketmq 5: set context for async callback (#7238)
• HTTP semconv: filter out default peer/host ports (#7258)
• Allow multiple YAML configuration files for JMX rules (#7284)
• OpenTelemetryDriver better support for native images (#7089)
• Support Spring Kafka 3 (#7271)
• Add instrumentation for opentelemetry-extension-kotlin (#7341)
• Populate messaging.kafka.message.offset in all kafka instrumentations (#7374)
• More flexible cgroupv2 container id parsing (and podman support) (#7361)
• Instrument spring-web 6 & spring-webmvc 6 (#7366)
• Change log4j MapMessage attribute names (#7397)
• Don't call Thread#setContextClassLoader() (#7391)

🛠️ Bug fixes

• Webflux instrumentation doesn't capture http.status_code in some cases (#7251)
• Clean WeakConcurrentMap from background thread (#6240)
• Update gwt rpc span from INTERNAL to SERVER (#7342)
• JMXMetricInsight should log nothing at INFO level (#7367)
• Fix NullPointerException when uri is null (#7387)
• Agent context storage wrapper should not override other wrappers (#7355)
• Do not install GC metrics when GarbageCollectionNotificationInfo is not available (#7405)
• Fix connection pool timeouts unit (#7404)

🧰 Tooling

• Allow disabling muzzle checks for specific methods (#7289)

🙇 Thank you

This release was possible thanks to the following contributors who shared their brilliant ideas and awesome pull requests:

@aaron-ai
@anuraaga
@breedx-splk
@brianmolinaspring
@brunobat
@devnewton
@fmhwong
@Iapetus999
@IcebergXTY
@jack-berg
@jamesylgan
@jkwatson
@laurit
@mateuszrzeszutek
@michalvavrik
@mpeyper
@oleborne
@PeterF778
@theletterf
@trask
@vasireddy99

Version 1.20.2

This is a patch release on the previous 1.20.1 release, fixing the issue(s) below.

🛠️ Bug fixes

• Fix the boms (#7252)