Sourced from io.opentelemetry.instrumentation:opentelemetry-instrumentation-bom's releases.

Version 2.21.0

This release targets the OpenTelemetry SDK 1.55.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.

⚠️ Breaking Changes

• Hadoop JMX metrics have been renamed to align with semantic conventions. If you are using Hadoop JMX metrics, you will need to update your dashboards and alerts. (#14411)
• Lettuce 5.1 instrumentation now aligns with other instrumentations and no longer sets the span status description. (#14886)

🚫 Deprecations

• The following Logback appender configuration properties have been renamed for clarity. The old property names have been deprecated and will be removed in a future release: - Java agent: otel.instrumentation.logback-appender.experimental.capture-logstash-attributes → otel.instrumentation.logback-appender.experimental.capture-logstash-marker-attributes - Spring Boot starterotel.instrumentation.logback-appender.experimental.capture-logstash-markers → otel.instrumentation.logback-appender.experimental.capture-logstash-marker-attributes - Logback appender configuration property: captureLogstashAttributes → captureLogstashMarkerAttributes - Logback appender API: setCaptureLogstashAttributes() → setCaptureLogstashMarkerAttributes() (#14959)

🌟 New javaagent instrumentation

• Add Helidon instrumentation (#13776)
• Add NATS instrumentation (#13999)
• OpenSearch Transport v3.0 Implementation (#14823)
• Add Kafka Connect API instrumentation (#14478)

🌟 New library instrumentation

• Add Helidon Instrumentation (#13776)
• Add NATS instrumentation (#13999)
• Failsafe 3.0 instrumentation introduced (#14057)

📈 Enhancements

• Add experimental sqlcommenter support for JDBC and R2DBC (#13714)
• Align Hadoop JMX metrics with semantic conventions (#14411)
• Introduce experimental API for operation attributes to be passed only to OperationListeners (#14590)
• Add span logging support for declarative configuration (#14591)
• Add span logging support for Spring Boot starter (#14594)
• Support capturing event names in logback, log4j, and jboss-logmanager appenders (#14649)
• Include contrib sampler in java agent, e.g. for filtering health check endpoints (#14677)
• Collect RPC metrics in Apache Dubbo instrumentation (#14690)
• Add experimental option to disable noisy redis.encode span events in Lettuce instrumentation (#14750)
• Support ListIterator in Kafka consumer instrumentation for Spark Structured Streaming (#14757)
• Exclude wrapper classes in JDBC instrumentation (#14760)
• Support JDBC URL parsing for OceanBase, PolarDB, and Lindorm databases (#14790)
• Support context propagation in Guava AsyncEventBus (#14791)
• Make db.statement attribute available during sampling in Lettuce instrumentation (#14856)
• Add code.namespace and code.function attributes to Vaadin controller spans (#14882)
• Add code.namespace and code.function attributes to Grails controller spans (#14885)
• Support Hibernate 7.2.0.CR1 (#14921)
• Support capturing Logstash StructuredArguments as log record attributes (#14959)
• Add gRPC request/response size metrics (#14342)

🛠️ Bug fixes

... (truncated)

Sourced from io.opentelemetry.instrumentation:opentelemetry-instrumentation-bom's changelog.

Version 2.21.0 (2025-10-17)

⚠️ Breaking Changes

• Hadoop JMX metrics have been renamed to align with semantic conventions. If you are using Hadoop JMX metrics, you will need to update your dashboards and alerts. (#14411)
• Lettuce 5.1 instrumentation now aligns with other instrumentations and no longer sets the span status description. (#14886)

🚫 Deprecations

• The following Logback appender configuration properties have been renamed for clarity. The old property names have been deprecated and will be removed in a future release:
  • Java agent: otel.instrumentation.logback-appender.experimental.capture-logstash-attributes → otel.instrumentation.logback-appender.experimental.capture-logstash-marker-attributes
  • Spring Boot starterotel.instrumentation.logback-appender.experimental.capture-logstash-markers → otel.instrumentation.logback-appender.experimental.capture-logstash-marker-attributes
  • Logback appender configuration property: captureLogstashAttributes → captureLogstashMarkerAttributes
  • Logback appender API: setCaptureLogstashAttributes() → setCaptureLogstashMarkerAttributes() (#14959)

🌟 New javaagent instrumentation

• Add Helidon instrumentation (#13776)
• Add NATS instrumentation (#13999)
• OpenSearch Transport v3.0 Implementation (#14823)
• Add Kafka Connect API instrumentation (#14478)

🌟 New library instrumentation

• Add Helidon Instrumentation (#13776)
• Add NATS instrumentation (#13999)
• Failsafe 3.0 instrumentation introduced (#14057)

📈 Enhancements

• Add experimental sqlcommenter support for JDBC and R2DBC (#13714)
• Align Hadoop JMX metrics with semantic conventions (#14411)
• Introduce experimental API for operation attributes to be passed only to OperationListeners

... (truncated)

• 018b80b [release/v2.21.x] Prepare release 2.21.0 (#15041)
• 01e8e96 Allow re-running prepare release branch workflow (#15038)
• 82bf0cd Use temurin in spring boot smoke test images (#15033)
• 3649334 Update change log for upcoming release (#15000)
• 496fa64 Add release attestations (#15020)
• 397e621 Azure and c3p0 metadata updates (#15026)
• 1eeaac5 make nats indy-ready (#15008)
• cc2bedc add missing units to jmx metrics doc (#15007)
• 7536867 Disable container support in opensearch test containers (#15022)
• f31f574 make kubernetes-client indy-ready (#15012)
• Additional commits viewable in compare view

You can trigger Dependabot actions by commenting on this PR:

• @dependabot rebase will rebase this PR
• @dependabot recreate will recreate this PR, overwriting any edits that have been made to it
• @dependabot merge will merge this PR after your CI passes on it
• @dependabot squash and merge will squash and merge this PR after your CI passes on it
• @dependabot cancel merge will cancel a previously requested merge and block automerging
• @dependabot reopen will reopen this PR if it is closed
• @dependabot close will close this PR and stop Dependabot recreating it. You can achieve the same result by closing it manually
• @dependabot show <dependency name> ignore conditions will show all of the ignore conditions of the specified dependency
• @dependabot ignore this major version will close this PR and stop Dependabot creating any more for this major version (unless you reopen the PR or upgrade to it yourself)
• @dependabot ignore this minor version will close this PR and stop Dependabot creating any more for this minor version (unless you reopen the PR or upgrade to it yourself)
• @dependabot ignore this dependency will close this PR and stop Dependabot creating any more for this dependency (unless you reopen the PR or upgrade to it yourself)