DDTrace Extension Changelog
Introduction¶
This document records updates to the Java extension package used in DataKit for DDTrace Java instrumentation compatibility scenarios.
This extension is developed based on DataDog/dd-trace-java and follows the Apache License 2.0.
For legal files, checksums, and source code change details, see the TrueWatch Java Tracer Extension Notice.
Use this changelog to identify the version where an extension capability first appeared, changed behavior, or was fixed. It is not a complete configuration manual. For a safe rollout:
- Pin the exact extended-JAR version in the deployment manifest.
- Use this log to confirm the target capability's minimum version and later behavior changes.
- Return to the Java extension guide for configuration, data-safety boundaries, and verification.
- Complete compatibility tests in pre-production before a production upgrade.
Historical entries preserve their release-time meaning. A newer version does not necessarily retain every early experimental behavior.
-
Java
Changelog¶
v1.63.7-ext (2026/7/1)¶
update¶
- Add Spring WebMVC request body collection support for
text/x-gwt-rpc; whendd.trace.request.body.enabledis enabled, POST GWT RPC requests are written to therequest_bodyspan tag. - Decode request bodies with the request character encoding first, and fall back to UTF-8 when it is missing or invalid.
- When OTLP runtime metrics are not enabled, report
jvm.thread.countthrough DogStatsD, split byjvm.thread.daemon:true|falseandjvm.thread.state:<state>. - Add raw GC MXBean metrics
jvm.gc.collection_countandjvm.gc.collection_time, preserving the collector name as thegc:<collector name>tag. - Reuse JVM thread state bucket logic and add test coverage for GWT RPC request body collection, JVM thread state statistics, and GC StatsD reporting.
v1.63.6-ext (2026/6/29)¶
fix¶
- Fix the BES instrumentation root span loss issue.
- Support
request_bodytagging fortext/x-gwt-rpcrequests in Spring WebMVC filters, and add corresponding forked coverage.
v1.63.5-ext (2026/6/24)¶
update¶
- Enhance Spring RabbitMQ consumer trace and log correlation.
- Fix the missing business consumer span when Spring RabbitMQ consumes messages, so listener execution can expose
trace_id/span_idto logs. - Keep the RabbitMQ
basic.deliverlow-level AMQP span and add a Spring listener business processing span. - Add BES 11.0 application server instrumentation support.
v1.63.4-ext (2026/6/10)¶
new¶
- Add the
netty.client.streamspan to measure continuous SSE response body reads. - Keep the existing
netty.client.requestspan for the request-to-response-header phase. - Add the
stream.first_chunk.msandstream.chunk_countmetrics for first chunk latency and Netty content chunk count. - For
text/event-streamresponses, mark the stream span asinternaland use theSSE stream ...resource name.
v1.63.3-ext (2026/6/11)¶
new¶
- Add
DD_TRACE_PEER_HOSTNAME_FROM_CONFIG_ENABLED/trace.peer.hostname.from.config.enabled. - The option is disabled by default. When enabled, the client connection host is preferred as
peer.hostname. - Cover
Jedis,Lettuce 5,Redisson,Valkey,Vertx Redis Client.
v1.63.2-ext (2026/6/8)¶
fix¶
- Fix JMXFetch parsing for Java version strings such as
17-ea. - Add the
org.datadog.jmxfetch.util.JavaVersionversion parsing utility. - Support multiple
java.specification.versionandjava.versionformats.
v1.63.1-ext (2026/6/4)¶
new¶
- Add
DD_SERVICE_MAPPING_FILE/dd.service.mapping.file. - Support reading service mapping from an external file and merging it with inline
DD_SERVICE_MAPPINGconfiguration. - Add
supported-configurationsmetadata and related unit tests.
v1.63.0-ext (2026/6/3)¶
New¶
- Merge the latest code.
v1.60.4-ext (2026/4/27)¶
New¶
- Fix Redis
service_namedisplay issue.
v1.60.3-ext (2026/4/24)¶
New¶
- Improve JDBC support for Oracle.
v1.55.11-ext (2026/3/17)¶
New¶
- Lower the RocketMQ instrumentation minimum version from 4.8.0 to 4.5.0.
v1.55.10-ext (2026/2/1)¶
New¶
- Add
java-websocketinstrumentation
v1.55.7-ext (2025/12/30)¶
fix¶
- Fix
Rediscommand list type error.
v1.55.6-ext (2025/12/22)¶
fix¶
- RocketMQ scope limit error.
- Add Response Body whitelist config
v1.55.2-ext (2025/11/28)¶
fix¶
- fix:RocketMQ scope limit error.
- Merge latest branch v1.55.0
v1.53.7-ext (2025/11/28)¶
fix¶
- support apache Dubbo stream version 3.2
- add
rocketmq.consume.ignore
v1.53.1-ext (2025/9/24)¶
fix¶
- Merge DataDog DDTrace Tag: v1.53.0.
v1.47.6-ext (2025/6/4)¶
fix¶
- How to enhance the methods in custom Package and Class by using command to enable function
v1.47.5-ext (2025/5/22)¶
fix¶
- Fix: Pulsar consumer bug.
- Fix: Resource catalog bug.
v1.47.4-ext (2025/5/14)¶
fix¶
- Attach to trace methods
v1.47.1-ext (2025/4/17)¶
fix¶
- Fix the problem that Dubbo Response does not take effect.
- Merge DDTrace Tag: v1.47.1.
v1.42.8-ext¶
fix¶
- Fix Response Body: Add config"dd.trace.response.body.blacklist.urls".
v1.42.7-ext¶
fix¶
- Fix Response Body ENV Bug
- Merge DDTrace tag v1.42.1 version.
v1.36.1-ext¶
fix¶
- Merge DataDog Java Agent tag 1.36.0.
- Add
dd-ext-versiontag. - Using
mybatis plus, the SQL statements executed by the batch class are not recorded as span information.
v1.34.2-ext¶
fix¶
- Due to excessive memory usage, it has been decided to remove the add response body feature.
v1.34.0-ext¶
new¶
- Merge DataDog v1.34.0
v1.30.5-ext v1.30.6-ext¶
fix¶
- Fixed
trace_idextraction problem underW3Cprotocol. - Fix
Pulsar OOMissue. Lettuce5obtainspeer_ipin cluster mode.
v1.30.4-ext (2024/4/25)¶
fix¶
- Solve the problem that the link cannot be interrupted due to continuous delivery of
Dubboservice. - Solve the problem of
Pulsarnot releasing memory.
v1.30.2-ext (2024/4/3)¶
fix¶
- Redis SDK
Lettucesupports viewingCommandparameters.
v1.30.1-ext (2024/2/6)¶
new¶
- Merge DDTrace tag 1.30.0.
- To add HTTP Response Body information in the trace data, the command to enable it is
v1.25.2-ext (2024/1/10)¶
new¶
- By using the environment
dd.trace.headers.enabled=true, theheaderinformation can be placed in thespantagservlet_request_header.
v1.21.1-ext (2023/11/1)¶
fix¶
- Add Apache Pulsar consumer batch instructions.
v1.21.0-ext (2023/10/24)¶
fix¶
- Merge DDTrace tag v1.21.0.
v1.20.3-ext (2023/10/13)¶
add¶
- Add
xxl-job2.2 version.
v1.20.2-ext (2023/9/25)¶
add¶
- Add Apache Pulsar instructions.
v1.20.1-ext (2023/9/8)¶
fix¶
- Merge DDTrace tag v1.20.1 and release new version.
v1.17.4-ext (2023/7/27)¶
fix¶
- Fix RocketMQ send span bug.
v1.17.2-ext v1.17.3-ext (2023/7/20)¶
fix¶
- Fix bug for Redis not has Spans.
- Delete Info logging of Dubbo.
- Add 4 个 JVM metric:
jvm.total_thread_count,jvm.peak_thread_count,jvm.daemon_thread_count,jvm.gc.code_cache.used.
v1.17.1-ext (2023/7/11)¶
fix¶
- RocketMQ returns a value when sending an asynchronous message, which can cause an NPE.
- RocketMQ will replace the message itself cache span with local cache, and users no longer need to turn off the traceContext function.
v1.17.0-ext (2023/7/7)¶
fix¶
- Merge Datadog v1.17.0.
v1.15.4-ext (2023/6/12)¶
new¶
- Merge Datadog v1.15.3 tag
- Support PowerJob.
v1.14.0-ext (2023/5/18)¶
fix¶
- Merge Datadog v1.14.0 version.
- Support
trace-128-bit-id.
v1.12.1-ext (2023/5/11)¶
fix¶
- Supported MongoDB obfuscation.
- Supported DM8.
v1.12.0 (2023/4/20)¶
fix¶
- Merge ddtrace tag:1.12.0.
- Support
DangDang Dubbox. - Solve the confusion between jax-rs and Dubbo traces.
- Solve the problem that the order of Dubbo trace topology map is wrong bug.
- Solve the conflict between RocketMQ and customer-defined trace data bug.
- Modify RocketMQ resource name.
v1.10.2 (2023/4/10)¶
fix¶
- merge ddtrace tag:1.10.
- Fix Dubbo probe does not support @ DubboReference nesting.
- Fixed the issue of failed retrieval of RocketMQ link custom context.
v1.8.0,v1.8.1,v1.8.3(2023/2/27)¶
new¶
- merge ddtrace 1.8.0 version.
- add
Get the input parameter information of a specific function.
v1.4.1(2023/2/27)¶
new¶
- Add support for Alibaba Cloud RocketMQ 4.0 series.
v1.4.0(2023/1/12)¶
new¶
- Merge latest ddtrace latest branch v1.4.0.
v1.3.2(2023/1/12)¶
new¶
- Add redis view parameter.
- Modify
dd-java-agentdefault port is 9529. - Alibaba Cloud RocketMQ bug.
v1.3.0(2022/12/28)¶
new¶
- Merge latest DataDog latest branch v1.3.0.
- Add log patten support.
- Add hsf framework support.
- Added axis1.4 support.
- Add support for Alibaba Cloud RocketMQ 5.0.
v1.0.1(2022/12/23)¶
new¶
- Merge latest DataDog latest branch v1.0.1.
- Merge attach custom content.
v0.113.0-attach(2022/11/16)¶
new¶
- The desensitization function adds SQL placeholder (
?) agent support.
0.113.0(2022-10-25)¶
Function adjustment instructions¶
- Based on the 0.113.0 tag, merge the previous code
- Fix thrift
TMultipexedProtocolmodel support
0.108.1(2022-10-14)¶
Merge DataDog v0.108.1 version, compile while retaining 0.108.1
Description of function adjustments.¶
- add thrift instrumentation(thrift version >=0.9.3)
0.108.1(2022-09-06)¶
Merge DataDog v0.108.1 and compile it.
0.108.1¶
- add
xxl_jobagent (xxl_jobversion >= 2.3.0)
0.107.0-ext((2022-08-30))¶
Merge DataDog 107 version, compile.
0.105.0-ext(2022-08-23)¶
new¶
- add RocketMq agent, supported version(not lower than 4.8.0)。
- add Dubbo agent, supported version(not lower than2.7.0)。
- add SQL obfuscation:After opening, add the original SQL statement to the link to facilitate troubleshooting, and add configuration parameters when starting the Agent:
-Ddd.jdbc.sql.obfuscation=true