Draft release notes (#19040)

Co-authored-by: otelbot <197425009+otelbot@users.noreply.github.com>
Co-authored-by: Trask Stalnaker <trask.stalnaker@gmail.com>

Author: otelbot[bot]

CHANGELOG.md

@@ -4,8 +4,155 @@
 
 ### ⚠️ Breaking changes to non-stable APIs
 
-- Changed the return type for `JmxTelemetry.start(...)` APIs.
+- Change the return type for `JmxTelemetry.start(...)` APIs.
   ([#18782](https://github.com/open-telemetry/opentelemetry-java-instrumentation/pull/18782))
+- Experimental runtime package telemetry now emits `package.checksum_algorithm=SHA-256` and
+  64-character `package.checksum` values instead of SHA1 checksums.
+  ([#18846](https://github.com/open-telemetry/opentelemetry-java-instrumentation/pull/18846))
+
+### 🚫 Deprecations
+
+- Rename the common logging context keys to `otel.instrumentation.common.logging.trace-id-key`,
+  `otel.instrumentation.common.logging.span-id-key`, and
+  `otel.instrumentation.common.logging.trace-flags-key`, while keeping the old property names
+  deprecated.
+  ([#18851](https://github.com/open-telemetry/opentelemetry-java-instrumentation/pull/18851))
+- Rename the `kafka-broker` and `kafka-connect` JMX target systems to
+  `experimental-kafka-broker` and `experimental-kafka-connect`; the old names still work for now
+  and log a warning.
+  ([#18971](https://github.com/open-telemetry/opentelemetry-java-instrumentation/pull/18971))
+
+### 🌟 New javaagent instrumentation
+
+- Add SOFARPC 5.4 instrumentation that emits RPC client and server spans and metrics.
+  ([#15589](https://github.com/open-telemetry/opentelemetry-java-instrumentation/pull/15589))
+- Add Javaagent instrumentation for HBase client 2.0.0 through 2.5.0.
+  ([#18253](https://github.com/open-telemetry/opentelemetry-java-instrumentation/pull/18253))
+
+### 📈 Enhancements
+
+- Add opt-in support for emitting HTTP request exceptions as log signals with
+  `otel.semconv.exception.signal.preview=logs`.
+  ([#16259](https://github.com/open-telemetry/opentelemetry-java-instrumentation/pull/16259))
+- Add `opentelemetry-api-1.63` Javaagent instrumentation for OpenTelemetry API 1.63 and
+  `opentelemetry-api-incubator` 1.63.
+  ([#18911](https://github.com/open-telemetry/opentelemetry-java-instrumentation/pull/18911))
+- Add `otel.semconv-stability.v3-preview` as a fallback for the declarative `v3_preview` semconv
+  stability setting.
+  ([#18936](https://github.com/open-telemetry/opentelemetry-java-instrumentation/pull/18936))
+- Update the experimental stable database semantic-convention opt-in
+  (`otel.semconv-stability.opt-in=database`) across database instrumentations, including span names
+  and `db.*` attributes.
+  ([#18808](https://github.com/open-telemetry/opentelemetry-java-instrumentation/pull/18808),
+  [#18853](https://github.com/open-telemetry/opentelemetry-java-instrumentation/pull/18853),
+  [#18920](https://github.com/open-telemetry/opentelemetry-java-instrumentation/pull/18920),
+  [#18922](https://github.com/open-telemetry/opentelemetry-java-instrumentation/pull/18922),
+  [#18926](https://github.com/open-telemetry/opentelemetry-java-instrumentation/pull/18926),
+  [#18930](https://github.com/open-telemetry/opentelemetry-java-instrumentation/pull/18930),
+  [#18970](https://github.com/open-telemetry/opentelemetry-java-instrumentation/pull/18970),
+  [#18979](https://github.com/open-telemetry/opentelemetry-java-instrumentation/pull/18979),
+  [#18980](https://github.com/open-telemetry/opentelemetry-java-instrumentation/pull/18980),
+  [#18984](https://github.com/open-telemetry/opentelemetry-java-instrumentation/pull/18984),
+  [#18985](https://github.com/open-telemetry/opentelemetry-java-instrumentation/pull/18985),
+  [#18986](https://github.com/open-telemetry/opentelemetry-java-instrumentation/pull/18986),
+  [#18987](https://github.com/open-telemetry/opentelemetry-java-instrumentation/pull/18987),
+  [#18989](https://github.com/open-telemetry/opentelemetry-java-instrumentation/pull/18989),
+  [#18990](https://github.com/open-telemetry/opentelemetry-java-instrumentation/pull/18990),
+  [#18992](https://github.com/open-telemetry/opentelemetry-java-instrumentation/pull/18992),
+  [#18993](https://github.com/open-telemetry/opentelemetry-java-instrumentation/pull/18993),
+  [#19004](https://github.com/open-telemetry/opentelemetry-java-instrumentation/pull/19004),
+  [#19005](https://github.com/open-telemetry/opentelemetry-java-instrumentation/pull/19005))
+- Capture query text and parameterization for Cassandra batch statements.
+  ([#18964](https://github.com/open-telemetry/opentelemetry-java-instrumentation/pull/18964))
+- Keep `opentelemetry-api` and `opentelemetry-instrumentation-annotations` enabled under
+  `otel.instrumentation.common.v3-preview` even when `default-enabled=false`.
+  ([#18792](https://github.com/open-telemetry/opentelemetry-java-instrumentation/pull/18792))
+- When `otel.instrumentation.common.v3-preview` is enabled, affected instrumentations emit `user.*`
+  identity attributes instead of `enduser.*` ones.
+  ([#18795](https://github.com/open-telemetry/opentelemetry-java-instrumentation/pull/18795))
+- Disable Kafka client metrics by default when `otel.instrumentation.common.v3-preview=true`.
+  ([#18828](https://github.com/open-telemetry/opentelemetry-java-instrumentation/pull/18828))
+- Recognize Amazon Aurora DSQL and AWS wrapper JDBC URL prefixes when parsing JDBC connection
+  metadata.
+  ([#18831](https://github.com/open-telemetry/opentelemetry-java-instrumentation/pull/18831))
+- Set instrumentation versions on emitted Meter scopes.
+  ([#18866](https://github.com/open-telemetry/opentelemetry-java-instrumentation/pull/18866))
+- Run `@WithSpan` instrumentation after other instrumentations so other advice can attach
+  attributes to the active span.
+  ([#18874](https://github.com/open-telemetry/opentelemetry-java-instrumentation/pull/18874))
+- Emit database client failures as `db.client.operation.exception` logs when
+  `otel.semconv.exception.signal.preview` is enabled.
+  ([#18889](https://github.com/open-telemetry/opentelemetry-java-instrumentation/pull/18889))
+- Emit RPC exceptions as log records when `otel.semconv.exception.signal.preview=logs` is enabled.
+  ([#18890](https://github.com/open-telemetry/opentelemetry-java-instrumentation/pull/18890))
+- Emit messaging exceptions as log records under `otel.semconv.exception.signal.preview`.
+  ([#18891](https://github.com/open-telemetry/opentelemetry-java-instrumentation/pull/18891))
+- Emit `faas.invocation.exception` log records for FaaS exceptions when
+  `otel.semconv.exception.signal.preview=logs` is enabled.
+  ([#18892](https://github.com/open-telemetry/opentelemetry-java-instrumentation/pull/18892))
+- Emit `gen_ai.client.operation.exception` logs for OpenAI chat and embeddings failures when
+  `otel.semconv.exception.signal.preview=logs` is enabled.
+  ([#18893](https://github.com/open-telemetry/opentelemetry-java-instrumentation/pull/18893))
+- Emit AWS SDK request failures as `rpc.client.call.exception` log records when
+  `otel.semconv.exception.signal.preview=logs` is enabled.
+  ([#18894](https://github.com/open-telemetry/opentelemetry-java-instrumentation/pull/18894))
+- Declarative configuration now supports per-domain semantic-convention selection using
+  `semconv.version`, `semconv.experimental`, and `semconv.dual_emit` settings.
+  ([#18908](https://github.com/open-telemetry/opentelemetry-java-instrumentation/pull/18908))
+- When `otel.instrumentation.common.v3-preview` is enabled, use
+  `otel.semconv-stability.preview` instead of `otel.semconv-stability.opt-in` to opt in to the
+  nonstable `service.peer` and `rpc` semantic conventions.
+  ([#18914](https://github.com/open-telemetry/opentelemetry-java-instrumentation/pull/18914))
+- Disable Kotlin coroutines `@WithSpan` instrumentation by default when
+  `otel.instrumentation.common.v3-preview=true`.
+  ([#18919](https://github.com/open-telemetry/opentelemetry-java-instrumentation/pull/18919))
+- Use the summary-aware path in `SqlQueryAnalyzer.analyze()` when
+  `otel.instrumentation.common.v3-preview` is enabled.
+  ([#18921](https://github.com/open-telemetry/opentelemetry-java-instrumentation/pull/18921))
+- When `otel.instrumentation.common.v3-preview` is enabled, deprecated JDBC/db sanitization config
+  names are ignored in favor of `db.query_sanitization.enabled`.
+  ([#18934](https://github.com/open-telemetry/opentelemetry-java-instrumentation/pull/18934))
+- Include `jvm.gc.cause` on GC duration metrics when
+  `otel.instrumentation.common.v3-preview` is enabled.
+  ([#18967](https://github.com/open-telemetry/opentelemetry-java-instrumentation/pull/18967))
+- Emit duration metrics for JDBC transaction operations `COMMIT` and `ROLLBACK`.
+  ([#19003](https://github.com/open-telemetry/opentelemetry-java-instrumentation/pull/19003))
+- Use a generated `InstrumentationVersion` class in OkHttp 3.0 instead of reading embedded
+  version properties, avoiding Android StrictMode disk-read violations.
+  ([#19006](https://github.com/open-telemetry/opentelemetry-java-instrumentation/pull/19006))
+- Add thread details span attributes for declarative Spring starter configuration when
+  `distribution.spring_starter.thread_details_enabled` is set.
+  ([#19008](https://github.com/open-telemetry/opentelemetry-java-instrumentation/pull/19008))
+
+### 🛠️ Bug fixes
+
+- Preserve the current context for Redisson command execution futures so async operations continue
+  the active trace.
+  ([#18701](https://github.com/open-telemetry/opentelemetry-java-instrumentation/pull/18701))
+- Stop the Pulsar agent from creating duplicate receive spans for multi-topic consumers.
+  ([#18771](https://github.com/open-telemetry/opentelemetry-java-instrumentation/pull/18771))
+- Fix a hang in Ktor client streaming requests so spans end promptly with Ktor 3.5.0.
+  ([#18781](https://github.com/open-telemetry/opentelemetry-java-instrumentation/pull/18781))
+- Fix a `Bedrock` `converseStream` `NullPointerException` when a tool call has empty arguments.
+  ([#18783](https://github.com/open-telemetry/opentelemetry-java-instrumentation/pull/18783))
+- Capture the Pulsar message ID earlier so producer spans can record it reliably.
+  ([#18803](https://github.com/open-telemetry/opentelemetry-java-instrumentation/pull/18803))
+- Fix SQLite JDBC statement and prepared-statement instrumentation so SQLite connections produce
+  SQL spans and parameter capture.
+  ([#18885](https://github.com/open-telemetry/opentelemetry-java-instrumentation/pull/18885))
+- Fix Logback MDC declarative configuration keys so `otel.instrumentation/development.java.*`
+  settings apply correctly.
+  ([#18924](https://github.com/open-telemetry/opentelemetry-java-instrumentation/pull/18924))
+- Fix SQL password sanitization for mixed-case DDL targets like `create table` and `alter table`.
+  ([#18927](https://github.com/open-telemetry/opentelemetry-java-instrumentation/pull/18927))
+- Logs emitted through async Log4j loggers now keep the application thread's OpenTelemetry `Context`
+  instead of falling back to span-only recovery.
+  ([#18937](https://github.com/open-telemetry/opentelemetry-java-instrumentation/pull/18937))
+- Avoid instrumentation errors when loading `redis.clients.jedis.Jedis`, `BinaryJedis`, and
+  `UnifiedJedis`.
+  ([#19000](https://github.com/open-telemetry/opentelemetry-java-instrumentation/pull/19000))
+- Run OpenSearch async callbacks with the request's parent context.
+  ([#19027](https://github.com/open-telemetry/opentelemetry-java-instrumentation/pull/19027))
 
 ## Version 2.28.1 (2026-05-20)