Version 1.11.0

Note that all artifacts other than io.opentelemetry.javaagent:opentelemetry-javaagent 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

• The previous release (1.10.0) deprecated the entire io.opentelemetry.instrumentation.api.tracer
  package in the instrumentation-api artifact, and the package was removed in this release.
• The javaagent -slim artifact has been dropped in this release, because the exporters are much
  smaller now and there is no longer a significant size difference between the -slim and default
  artifacts.
• The opentelemetry-aws-lambda-1.0 has been split into two artifacts
  opentelemetry-aws-lambda-core-1.0 and opentelemetry-aws-lambda-events-2.2.

🌟 New javaagent instrumentation

• Spring RMI instrumentation (#5033)

🌟 New library instrumentation

• Ratpack httpclient (#4787)

📈 Enhancements

• Add http.route to server spans where route was already being captured for span name (#5086, #5240, #5242, #5241, #5239)
• Use RPC attributes from spec for AWS SDK (#5166)
• SdkTracerProvider auto closed as separate Context Bean (#5124) (#5125)
• Support redisson 3.16.8+ (#5201)
• Support AWS SDK v1 request object subclasses. (#5231)
• Remove slim artifact (#5251)
• kotlinx-coroutines-reactor context propagation (#5196)
• Log a warning whenever GlobalOpenTelemetry.set() is called (#5264)
• Use http.route in HttpServerMetrics (#5266)
• Use VirtualField for associating netty listener with wrapper (#5282)
• Add code attributes to spring-scheduling spans (#5306)
• Propagate context into redisson async callback (#5313)
• Add max measurements to Micrometer Timer & DistributionSummary (#5303)
• Make it possible to configure base time unit used by the Micrometer bridge (#5304)
• Make HttpClientMetrics report low cardinality metrics (#5319)
• Implement NamingConvention support in Micrometer bridge (#5328)
• Add net.peer.name and net.peer.port attributes for grpc client span (#5324)
• Split lambda instrumentation into core and events (#5326)
• Add jaeger remote sampler to agent (#5346)
• Weak cache optimization (#5344)

🛠️ Bug fixes

• Several micrometer instrumentation fixes (#5118)
• Fix serialisation exception on default lambda events (#4724)
• NoSuchMethodError when using agent and modules (JPMS) (#5169)
• Spring boot cloud gateway, context propagation broken (#5188)
• Akka http server span names are always akka.request #3478 (#5150)
• Recover from duplicate class definition errors (#5185)
• Fix serialization for quartz JobExecutionContext (#5263)
• End jedis span when operation actually ends (#5256)
• Enable oshi ProcessMetrics in javaagent (#5281)
• Add missing return type matchers to the executor instrumentation (#5294)
• Fix triggering of DNS lookup (#5297)
• Avoid potential for reverse name lookup (#5305)
• Fix WeakConcurrentMap memory leak (#5316)
• AWS Lambda instrumentation requires jackson and lambda-events on the classpath (#5326)

🧰 Tooling

• Convert InstrumentationTestRunner from interface to abstract class (#5112)
• Parameterize VirtualField field type (#5165)
• Remove old TraceUtils and use InstrumentationTestRunner#run*Span() (almost) everywhere (#5160)
• Remove deprecated tracer API (#5175)
• Remove HttpServerTest#extraAttributes() method (#5176)
• Rename ServerSpanNaming to HttpRouteHolder (#5211)
• Don't run testLatestDeps on alpha/beta/rc versions (#5258)
• Refactor HTTP attributes extractors to use composition over inheritance (#5030, #5194, #5267)
• Refactor AttributesExtractor so that it extracts route from Context (#5288)
• Publish gradle-plugins to Maven Central (#5333)

🙇 Thank you

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

@acm19
@anuraaga
@Asafb26
@blumamir
@breedx-splk
@domyway
@dynatrace-peterlang
@frommeyerc
@gautam-nutalapati
@gsmirnov-splk
@iNikem
@irizzant
@jack-berg
@jkwatson
@jord1e
@jprinet
@jsalinaspolo
@kubawach
@laurit
@mateuszrzeszutek
@mcmho
@mircea-lemnaru-aera
@mping-exo
@necrolyte2
@ozoz03
@pavolloffay
@pichlermarc
@ralphgj
@Samudraneel24
@trask
@valodzka
@xsmrcek

Version 1.10.1

This is a patch release on the previous 1.10.0 release, fixing the issues below. If you are not affected by any of these, you do not need to update.

🛠️ Bug fixes

• Regression in project reactor context propagation instrumentation (#5188)
• Recover from duplicate class definition errors (#5185)
• StringIndexOutOfBoundsException in AWS SDK v1 when using request object subclass (#5231)
• Update to OTel SDK 1.10.1 (#5218)

Version 1.10.0

This release deprecates the entire io.opentelemetry.instrumentation.api.tracer package in the instrumentation-api artifact, and the package will be removed in the next release.

The new Micrometer instrumentation will now capture metrics already defined in instrumented applications (e.g. some libraries have built-in micrometer metrics, like spring boot for example) and send them out through the agent metrics pipeline.

This release requires the use of OpenTelemetry Java SDK 1.10.0.

Note that all artifacts other than io.opentelemetry.javaagent:opentelemetry-javaagent 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

• The opentelemetry-log4j-2.13.2 artifact has been renamed to opentelemetry-context-data-2.16-autoconfigure
• The opentelemetry-logback-1.0 artifact has been renamed to opentelemetry-logback-mdc-1.0
• The opentelemetry-ratpack-1.4 artifact has been renamed to opentelemetry-ratpack-1.7
  and only supports Ratpack 1.7 and above now

🌟 New javaagent instrumentation

• Logback appender instrumentation to send logs through the OpenTelemetry logging pipeline (#4939, #4968)
• Log4j 2.x appender instrumentation to send logs through the OpenTelemetry logging pipeline (#4944, #4959, #4966)
• Log4j 1.2 appender instrumentation to send logs through the OpenTelemetry logging pipeline (#4943)
• java.util.logging instrumentation to send logs through the OpenTelemetry logging pipeline (#4941)
• Micrometer instrumentation to send micrometer metrics through the OpenTelemetry metrics pipeline (#4919, #5001, #5017)

🌟 New library instrumentation

• Logback appender to send logs through the OpenTelemetry logging pipeline (#4984)
• Log4j 2.x appender to send logs through the OpenTelemetry logging pipeline (#4375, #4907)
• Ktor instrumentation (#4983)
• Micrometer instrumentation to send micrometer metrics through the OpenTelemetry metrics pipeline (#5063)

📈 Enhancements

• Renamed Apache Dubbo and Log4j MDC library artifacts (#4779)
• Added http4 handler to apache-camel instrumentation (#4650)
• Capture servlet request parameters (#4703)
• Propagate Context instead of SpanContext in Kafka instrumentation (#4806)
• Instrument ContextPropagationOperator to bridge lib/agent calls (#4786)
• Add shouldStart() call to Armeria server instrumentation (#4843)
• Capture RPC metrics (#4838)
• Update log4j library base version (#4914)
• Rename log4j-thread-context modules to log4j-context-data (#4957)
• Support latest oshi version (#4993)
• Support latest RxJava version (#4954)
• Create producer span from spring integration instrumentation (#4932)
• Capture servlet request parameters at the end of the request (#5019)
• Don't extract deprecated cassandra keyspace attribute (#5041)
• Add OTLP logs exporters (#5060, #5088)
• End redisson span when the operation actually ends (#5073)
• Don't capture high-cardinality http.target as metrics attribute (#5081)

🛠️ Bug fixes

• Remove virtual field interfaces from reflection results (#4722)
• Work around jvm crash on early 1.8 (#4345)
• Fix http.url handing in vert.x 3 http client (#4739)
• Capture missing RMI spans (#4764)
• Avoid crashing on early 1.8 openjdk vms (#4789)
• Fix Quarkus correlation (#4883)
• Fix RabbitMQ instrumentation consumption on empty headers (#4903)
• Fix NPE in Apache HttpClient 4.0 instrumentation (#4913)
• Fix NPE in RocketMQ instrumentation (#4901)
• Fix time units in HTTP & RPC metrics (#4963)
• Fix some gauge types (#4962)
• Fix context propagation for undertow async dispatch (#4950)
• Fix redefinition failure on openj9 (#5009)
• Fix NPE in rmi server instrumentation (#5042)

🧰 Tooling

• Merge start and end time extractors (#4692)
• Move cache implementations to internal package (#4746)
• Reorganize shared servlet code (intro to #4317) (#4785)
• Move AppServerBridge and MappingResolver to servlet-common:bootstrap (#4817)
• Move ServletContextPath to servlet-common:bootstrap (#4824)
• Expose AutoConfiguredOpenTelemetrySdk to AgentListener (#4831)
• Deprecate the Tracer API (#4868)
• Remove ConfigPropertiesAdapter as it's no longer needed (#4888)
• Refactor ServerSpanNaming (in preparation for http.route) (#4852)
• Move SpanKey to internal package (#4869)

🙇 Thank you

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

@anuraaga
@Asafb26
@breedx-splk
@danhngo-lx
@dengliming
@frommeyerc
@HaloFour
@hellochenpc
@iNikem
@jack-berg
@jamesmoessis
@jkwatson
@jsalinaspolo
@jsuereth
@kubawach
@laurit
@lmolkova
@lokeshcse6
@mateuszrzeszutek
@michaelbannister
@osherv
@previousdeveloper
@ralphgj
@raptium
@rkolesnev
@Samudraneel24
@sh777
@shivanshu1333
@theletterf
@tnaroska
@tomasol
@trask
@yangtaoran
@yonigibbs
@Zane-XY

Version 1.9.2

This is a patch release on the previous 1.9.1 release, fixing the issue below. If you are not affected by this, you do not need to update.

🛠️ Bug fixes

• Fix reactor-netty memory/connection leak (#4867)

Version 1.9.1

This is a patch release on the previous 1.9.0 release, fixing the issue below. If you are not affected by this, you do not need to update.

🛠️ Bug fixes

• Shade class references within AWS SDK service files (#4752)

Version 1.9.0

This release requires the use of OpenTelemetry Java SDK 1.9.0.

Note that all artifacts other than io.opentelemetry.javaagent:opentelemetry-javaagent 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

• Don't report 400 level as error for SERVER spans (#4403)
• Netty instrumentation now captures http.scheme (#4446, #4576)
• Stabilize HTTP headers capturing configuration property names (#4459)
• Add metrics to remaining http instrumentation (#4541)
• Remove hibernate session spans (#4538)
• Support Jedis 4 (#4555)
• Trace DNS resolution in Netty 4.1 and reactor-netty (#4587, #4627)
• Update garbage collector instruments to be async counters (#4600)
• Update HTTP metrics view to match the specification (#4556)
• Improve Spring Integration interceptor ordering (#4602)
• Support Restlet 2.0 (#4535)
• Improved capture of couchbase queries (#4615)
• Trace SSL handshakes in netty 4.0 and 4.1 (#4635, #4604)
• Capture exception on finatra controller spans (#4669)
• Capture exception on async servlet spans (#4677)
• Automatic AWS library instrumentor (#4607)
• Support spring boot 2.6.0 (#4687)

🛠️ Bug fixes

• Preserve caught netty exception in the context instead of calling end () (#4413)
• Extract net attributes both on start and on end in netty HTTP client (#4420)
• Capture metric dimensions from end attributes also (#4430)
• Avoid logging servlet3 muzzle failure when running on servlet2 (#4474)
• Fix JettyHttpClient9TracingInterceptor NullPointerException (#4527)
• Fix context propagation in tomcat thread pool (#4521)
• Add missing java.util.logging.Logger methods to PatchLogger (#4540)
• Fix ClassCircularityError when running with security manager (#4557)
• Fix sun.misc.Unsafe generation on Java 17 (#4558)
• Fix IndexOutOfBounds in apache http clients (#4575)
• Fix RMI instrumentation on Java 17 (#4577)
• Fix Spring Integration instrumentation name (#4601)
• Capture instrumentation version provided by application tracer correctly when using agent (#4630)
• Ensure that netty 4.0 instrumentation is not applied to 4.1 (#4626)
• Fix muzzle problems happening when netty without SSL is used (#4631)
• Fix memory leak when using ktor-client-java (#4637)
• Fix quartz instrumentation name (#4657)
• Fix Spring Integration context leak (#4673)
• Fix exemplars (#4678)
• Fix and enforce Android support (#4671, #4667, #4505)

🧰 Tooling

• Migrate to Spock 2 (#4458)
• Rename newBuilder () to builder () (#4475)
• Sync gradle-plugins version with main project (#4248)
• Muzzle match only once in each class loader (#4543)
• Inject helper resources only once (#4573)
• Improve muzzle check for constructors (#4591)
• Add version to the InstrumenterBuilder and Instrumenter (#4611)
• Add a ClassAndMethod class to Instrumentation API (#4619)
• Implement a dedicated reactor-netty 1.0 instrumentation (#4662)
• Remove gRPC dependency for export (#4674)
• Start using Gradle Enterprise instance (#4663)

🙇 Thank you

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

@alvinhom
@anuraaga
@ben-manes
@breedx-splk
@brunojcm
@bsideup
@castortech
@chenjazz
@chris-pinola-rf
@dboreham
@dengliming
@Enkelian
@HaloFour
@harel-e
@iNikem
@irizzant
@jack-berg
@jkwatson
@jsalinaspolo
@jsuereth
@kubawach
@laurit
@lmolkova
@MartinDai
@mateuszrzeszutek
@michaelbannister
@osherv
@przemekak
@qiansheng91
@radcortez
@runningcode
@shivanshu1333
@steffan-westcott
@steven-aerts
@theletterf
@trask
@zmapleshine

Version 1.8.0 (Bad Release)

Due to an issue in the publishing infrastructure, a bad release was published as 1.8.0. Do not use it.

Version 1.7.2

This is a patch release on the previous 1.7.1 release, fixing the issues below. If you are not affected by these, you do not need to update.

🛠️ Bug fixes

• HTTP exporter does not properly close connections (#4581)
• IndexOutOfBounds in Apache HTTP client instrumentation (#4575)
• Exception in certain logging messages (#4540)
• NPE in Jetty instrumentation (#4527)

Version 1.7.1

This is a patch release on the previous 1.7.0 release, fixing the three issues below. If you are not affected by these, you do not need to update.

🛠️ Bug fixes

• Java agent 1.7.0 fails with prometheus exporter (#4460)
• Android regression in okhttp instrumentation in 1.7.0 (#4452)
• Remove unshaded javax.annotation classes from bootstrap class loader (#4454)

Version 1.7.0

Note: with this release, the -all artifact has been removed and the default artifact (with no classifier) is now the go-to artifact that contains the exporters. If you want an artifact with no exporters, there is a new -slim artifact that is published to maven central. The -all artifact is still attached to this release below (it has the same content as the default artifact), but will no longer be attached to the releases starting from v1.8.0.

This release requires the use of OpenTelemetry Java SDK 1.7.0.

Note that all artifacts other than io.opentelemetry.javaagent:opentelemetry-javaagent 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

• Change the default javaagent artifact to have exporters, introduce new -slim artifact,
  and deprecate the -all artifact (#4106)
• Support jlinked images without jdk.unsupported module (#4154, #4124)
• Added experimental option to suppress messaging receive spans (#4187, #4204)
• Refine 404 handling in Restlet instrumentation (#4206)
• Remove dynamo db.name attribute (#4208)
• Remove capturing http.url in server instrumentation in favor of http.scheme, http.host
  and http.target (#4209)
• Intern db info to reduce memory consumption (#4263)
• Better JAX-RS async cancel handling (#4279)
• Extract HTTP request/response headers as span attributes (#4237, #4309, #4320, #4321, #4328, #4395)
• Support kafka streams 3 (#4236)
• AWS lambda - improvements in custom type handling in wrappers, SQS event wrapper added (#4254)
• Add code attributes to quartz spans (#4332)
• Collect more attributes from servlet instrumenter (#4356)
• Allow reactor instrumentation to pick up spans from reactor context (#4159)
• Hide virtual field accessor interface methods from reflection (#4390)

🛠️ Bug fixes

• Fix spring context reload issue (#4051)
• Remove incorrect lettuce db.statement attribute (#4160)
• Fix tomcat async spans (#4339)

🧰 Tooling

• Add start/end time to RequestListener (#4155)
• Add context customizer hook to Instrumenter API (#4167)
• Transform lambda classes (#4182)
• Separate HTTP client/server AttributesExtractors (#4195)
• Introduce muzzle-specific interface to InstrumentationModule (#4207)
• Make it possible to use InstrumentationContext (now VirtualField) from library instrumentation (#4218)
• Add functionality to generate API changes (#4285)
• Split NetAttributesExtractor into NetClientAttributesExtractor and NetServerAttributesExtractor (#4287)
• Back VirtualField with a volatile field (#4355)
• Convert AttributesExtractor to interface (#4363)
• Rename some *InstrumenterBuilder classes to *InstrumenterFactory (#4391)
• rename newBuilder() to builder() (#4407)

🙇 Thank you

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

@alesj
@anuraaga
@aras112
@ben-manes
@breedx-splk
@brunojcm
@dengliming
@Enkelian
@frommeyerc
@GlowingRuby
@HaloFour
@HyunGook-Kim
@iNikem
@jack-berg
@jantekb
@jkwatson
@kubawach
@laurit
@lmolkova
@MartinDai
@mateuszrzeszutek
@michaelbannister
@Oberon00
@pavolloffay
@shivanshu1333
@theletterf
@trask