Sourced from io.opentelemetry.javaagent:opentelemetry-javaagent's releases.

Version 2.22.0

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

• AWS SDK 2.x attributes updated to align with semantic conventions (#15028) - The following attributes have been renamed: - aws.bucket.name (S3) → aws.s3.bucket - aws.queue.url (SQS) → aws.sqs.queue.url - aws.stream.name (Kinesis) → aws.kinesis.stream_name - aws.table.name (DynamoDB) → aws.dynamodb.table_names - aws.dynamodb.provisioned_throughput.read_capacity_units → aws.dynamodb.provisioned_read_capacity (type changed from long to double) - aws.dynamodb.provisioned_throughput.write_capacity_units → aws.dynamodb.provisioned_write_capacity (type changed from long to double) - aws.dynamodb.exclusive_start_table_name → aws.dynamodb.exclusive_start_table - aws.dynamodb.projection_expression → aws.dynamodb.projection - aws.dynamodb.scan_index_forward → aws.dynamodb.scan_forward - The following attribute types have changed: - aws.dynamodb.table_names: string → string[] - aws.dynamodb.consumed_capacity: string → string[] - aws.dynamodb.global_secondary_indexes: string → string[] - aws.dynamodb.local_secondary_indexes: string → string[] - aws.dynamodb.consistent_read: string → boolean - aws.dynamodb.table_count: string → long - aws.dynamodb.limit: string → long - aws.dynamodb.attributes_to_get: string → string[] - aws.dynamodb.segment: string → long - aws.dynamodb.total_segments: string → long - aws.dynamodb.count: string → long - aws.dynamodb.scanned_count: string → long - The following attributes are no longer emitted by default but can be enabled with otel.instrumentation.aws-sdk.experimental-span-attributes=true: - aws.queue.name (SQS) - aws.lambda.function.name (Lambda) - aws.lambda.function.arn (Lambda)
• JDBC library data source instrumentation now disabled by default (#15074)
• JMX state metrics unit changed from empty string to 1 to align with semantic conventions (#15093)
• AWS SDK 1.x attributes updated to align with semantic conventions (#15094) - Only affects users with otel.instrumentation.aws-sdk.experimental-span-attributes=true - The following attributes have been renamed and are now emitted by default (no experimental flag required): - aws.bucket.name (S3) → aws.s3.bucket - aws.queue.url (SQS) → aws.sqs.queue.url - aws.stream.name (Kinesis) → aws.kinesis.stream_name - aws.table.name (DynamoDB) → aws.dynamodb.table_names
• Finatra controller spans now disabled by default to match other controller spans (#15118)
• Netty HTTP request wrapper class renamed from HttpRequestAndChannel to NettyRequest (#15247)
• JSP compile spans now disabled by default to match other view spans (#15261)

🚫 Deprecations

• TracingConsumerInterceptor and TracingProducerInterceptor deprecated in favor of new configurable interceptors (#14929)
• Various builder methods updated to use UnaryOperator instead of Function<X, X> (#15101)
• DbClientCommonAttributesGetter deprecated in favor of DbClientAttributesGetter (#15139)

🌟 New javaagent instrumentation

• Add JFinal instrumentation (#15216)

📈 Enhancements

• Avoid Unsafe usage on Java 23+ (#14855, #15091)
• Update Azure SDK instrumentation so az.namespace can be used for sampling (#15068)
• Spring Boot Starter: Add cache to reduce environment variable lookups (#15132)
• HTTP instrumentations now emit semantic convention schema URL (#15144)
• Added instrumentation support for AsyncHttpClient version 1.8 (#15195)
• Instrumenter customizer now receives instrumentation type (#15227)
• Added support for Spring Framework 7.0 (#15287, #15299, #15301, #15304, #15311, #15362, #15371)
• Added span status customizer to incubating InstrumenterCustomizer API (#15288)
• Added configuration options for sqlcommenter (#15169)
• GraphQL instrumentation now records data fetcher errors (#15289)
• Add http client url template customizer (#15217)
• Introduce idiomatic JmxTelemetry API for JMX metrics library (#15220)
• Add instrumentation for OpenTelemetry API incubator's ExtendedOpenTelemetry (#15178)

🛠️ Bug fixes

• Fix missing peer.service in Netty HTTP spans (#14963)
• Fix Couchbase span kind to be CLIENT instead of INTERNAL (#14995)
• Link attributes are now bridged to the Java agent when using OpenTelemetry API (#15143)
• Potential race condition in JFR runtime metrics initialization fixed (#15231)
• Regression fixed related to context propagation when using Spring @EnableAsync (#15249)
• Declarative configuration now uses snake_case for distro resource provider attribute name (#15260)
• Logback appender fixed to capture Logstash StructuredArguments.entries() (#15341)

... (truncated)

Sourced from io.opentelemetry.javaagent:opentelemetry-javaagent's changelog.

Version 2.22.0 (2025-11-20)

⚠️ Breaking Changes

• AWS SDK 2.x attributes updated to align with semantic conventions (#15028)
  • The following attributes have been renamed:
    • aws.bucket.name (S3) → aws.s3.bucket
    • aws.queue.url (SQS) → aws.sqs.queue.url
    • aws.stream.name (Kinesis) → aws.kinesis.stream_name
    • aws.table.name (DynamoDB) → aws.dynamodb.table_names
    • aws.dynamodb.provisioned_throughput.read_capacity_units → aws.dynamodb.provisioned_read_capacity (type changed from long to double)
    • aws.dynamodb.provisioned_throughput.write_capacity_units → aws.dynamodb.provisioned_write_capacity (type changed from long to double)
    • aws.dynamodb.exclusive_start_table_name → aws.dynamodb.exclusive_start_table
    • aws.dynamodb.projection_expression → aws.dynamodb.projection
    • aws.dynamodb.scan_index_forward → aws.dynamodb.scan_forward
  • The following attribute types have changed:
    • aws.dynamodb.table_names: string → string[]
    • aws.dynamodb.consumed_capacity: string → string[]
    • aws.dynamodb.global_secondary_indexes: string → string[]
    • aws.dynamodb.local_secondary_indexes: string → string[]
    • aws.dynamodb.consistent_read: string → boolean
    • aws.dynamodb.table_count: string → long
    • aws.dynamodb.limit: string → long
    • aws.dynamodb.attributes_to_get: string → string[]
    • aws.dynamodb.segment: string → long
    • aws.dynamodb.total_segments: string → long
    • aws.dynamodb.count: string → long
    • aws.dynamodb.scanned_count: string → long
  • The following attributes are no longer emitted by default but can be enabled with otel.instrumentation.aws-sdk.experimental-span-attributes=true:
    • aws.queue.name (SQS)
    • aws.lambda.function.name (Lambda)
    • aws.lambda.function.arn (Lambda)
• JDBC library data source instrumentation now disabled by default (#15074)
• JMX state metrics unit changed from empty string to 1 to align with semantic conventions (#15093)
• AWS SDK 1.x attributes updated to align with semantic conventions (#15094)
  • Only affects users with otel.instrumentation.aws-sdk.experimental-span-attributes=true
  • The following attributes have been renamed and are now emitted by default (no experimental flag required):
    • aws.bucket.name (S3) → aws.s3.bucket
    • aws.queue.url (SQS) → aws.sqs.queue.url
    • aws.stream.name (Kinesis) → aws.kinesis.stream_name
    • aws.table.name (DynamoDB) → aws.dynamodb.table_names
• Finatra controller spans now disabled by default to match other controller spans (#15118)
• Netty HTTP request wrapper class renamed from HttpRequestAndChannel to NettyRequest (#15247)

... (truncated)

• a5c7d88 [release/v2.22.x] Another release workflow fix (#15397)
• 9b28104 [release/v2.22.x] Fix release workflow (#15392)
• 4a3e9d3 [release/v2.22.x] Prepare release 2.22.0 (#15386)
• 93575b8 Update change log for upcoming release (#15316)
• e02b572 Remove misspell workflow (#15353)
• a54ba95 fix(deps): update quarkus packages to v3.30.0 (#15383)
• 5e38413 Instrument extended open telemetry (#15178)
• be7d07c jmx idiomatic library API - part 1 (#15220)
• 545f3b4 Remove the need to bump class version when indy advice is used (#15258)
• efef43a Remove bridged Kafka metrics from metadata (#15342)
• 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)