fix(kafka): [Queue Instrumentation 31] Write enqueued-time header as plain decimal

[adinauer]

PR Stack (Queue Instrumentation)

• feat(core): Queue Instrumentation #5249
• feat(core): [Queue Instrumentation 1] Add enableQueueTracing option and messaging span data conventions #5250
• feat(samples): [Queue Instrumentation 2] Add Kafka to Spring Boot 3 sample app #5253
• feat(spring-jakarta): [Queue Instrumentation 3] Add Kafka producer instrumentation #5254
• feat(spring-jakarta): [Queue Instrumentation 4] Add Kafka consumer instrumentation #5255
• feat(spring-boot-jakarta): [Queue Instrumentation 5] Add Kafka queue auto-configuration #5259
• test(samples): [Queue Instrumentation 6] Add Kafka queue system tests #5260
• feat(samples): [Queue Instrumentation 7] Add Kafka to Spring Boot 3 OTel sample apps #5265
• fix(spring-boot-jakarta): [Queue Instrumentation 8] Disable Sentry Kafka spans when OTel is active #5274
• fix(spring-jakarta): [Queue Instrumentation 9] Clean up stale ThreadLocal context in Kafka consumer interceptor #5279
• fix(spring-jakarta): [Queue Instrumentation 10] Fork root scopes and skip when OTel is active in Kafka consumer #5280
• fix(spring-jakarta): [Queue Instrumentation 11] Guard entire span lifecycle in Kafka producer interceptor #5281
• fix(spring-jakarta): [Queue Instrumentation 12] Add Kafka retry count attribute #5282
• fix(spring-jakarta): [Queue Instrumentation 13] Align enqueue time with Python #5283
• ref(kafka): [Queue Instrumentation 14] Extract sentry-kafka module #5288
• feat(samples): [Queue Instrumentation 15] Add opt-in Kafka console e2e coverage #5289
• fix(test): [Queue Instrumentation 16] Enable Kafka profile in system runner #5291
• feat(kafka): [Queue Instrumentation 17] Add manual consumer tracing helper #5312
• ref(samples): [Queue Instrumentation 18] Move Kafka sources into queues.kafka package #5313
• ref(samples): [Queue Instrumentation 19] Drop Kafka auto-config exclude from Spring Boot samples #5314
• ref(kafka): [Queue Instrumentation 20] Log Kafka instrumentation failures #5315
• fix(kafka): [Queue Instrumentation 21] Preserve third-party baggage on Kafka producer records #5316
• test(spring-boot-jakarta): [Queue Instrumentation 22] Cover spring-kafka class-absence gate #5318
• fix(spring-jakarta): [Queue Instrumentation 23] Install Kafka context before trace setup #5319
• fix(kafka): [Queue Instrumentation 24] Read all baggage headers on consumers #5320
• fix(kafka): [Queue Instrumentation 25] Finish producer spans on failures #5321
• fix(kafka): [Queue Instrumentation 26] Mark producer interceptor experimental #5322
• fix(spring-jakarta): [Queue Instrumentation 27] Delegate Kafka record thread-state hooks #5323
• test(samples): [Queue Instrumentation 28] Cover OTel Jakarta Kafka coexistence in CI #5324
• fix(spring-jakarta): [Queue Instrumentation 29] Set body_size on Spring Kafka consumer transaction #5325
• test(spring-jakarta): [Queue Instrumentation 30] Cover Kafka record interceptor lifecycle edge cases #5327
• fix(kafka): [Queue Instrumentation 31] Write enqueued-time header as plain decimal #5328
• test(spring-boot-jakarta): [Queue Instrumentation 32] Filter OTel in Kafka auto-config negative tests #5330

---

📜 Description

Fix the sentry-task-enqueued-time Kafka header being serialized in scientific notation (e.g. 1.776933649613E9). The producer interceptor was writing the value via String.valueOf(double), which switches to scientific notation once |d| >= 10^7 — and epoch seconds are always ~1.77 × 10^9.

Route the value through DateUtils.doubleToBigDecimal(...).toString() — the same helper already used to serialize epoch-seconds timestamps in SentryTransaction, SentrySpan, SentryLogEvent, SentryMetricsEvent, ProfileChunk, etc. At the pinned scale of 6, BigDecimal.toString() produces plain decimal form (1776938295.692000) for every realistic epoch-seconds magnitude.

Addresses review7.md finding R7-F017 — the only remaining open review comment across the Queue Instrumentation stack (1–30).

💡 Motivation and Context

PR #5283 ("Align enqueue time with Python") was meant to make the Java Kafka queue instrumentation interoperable with other Sentry SDKs by switching the header payload to epoch seconds. However, the format it actually shipped — Java's default double toString — uses scientific notation for all realistic timestamps, which:

• Python's sentry_sdk (and Ruby, PHP, .NET) Celery consumers parse the header with plain-decimal expectations, so they would fail to parse Java-produced headers.
• The Java consumer (SentryKafkaConsumerTracing.receiveLatency) uses Double.parseDouble, which accepts both plain and scientific forms — so internal round-trips pass and none of the existing tests caught the bug.

This PR closes the gap without a core API change by reusing the canonical DateUtils.doubleToBigDecimal helper.

💚 How did you test it?

• Added regression assertions in SentryKafkaProducerInterceptorTest."creates queue publish span and injects headers" that:
  • reject scientific notation ('E'/'e' characters),
  • pin the plain-decimal format via ^\d+\.\d{6}$,
  • round-trip via toDouble().
• ./gradlew :sentry-kafka:test — all 7 producer-interceptor tests pass.
• ./gradlew :sentry-spring-jakarta:test --tests="*Kafka*" — green.
• ./gradlew spotlessApply apiDump — clean, no API surface changes.

📝 Checklist

• I added GH Issue ID & Linear ID
• I added tests to verify the changes.
• No new PII added or SDK only sends newly added PII if sendDefaultPII is enabled.
• I updated the docs if needed.
• I updated the wizard if needed.
• Review from the native team if needed.
• No breaking change or entry added to the changelog.
• No breaking change for hybrid SDKs or communicated to hybrid SDKs.

🔮 Next steps

Port the same fix to the Spring Boot 4 and Spring Boot 2 Kafka interceptors once those stack PRs land.

⚠️ Merge this PR using a merge commit (not squash). Only the collection branch is squash-merged into main.

[sentry]

📲 Install Builds

Android

🔗 App Name	App ID	Version	Configuration
SDK Size	io.sentry.tests.size	8.37.1 (1)	release

⚙️ sentry-android Build Distribution Settings