DDTrace Java 확장 업데이트 로그

소개¶

이 문서에서는 DDTrace Java 프로브 액세스 시나리오와의 호환성을 위해 DataKit에 있는 Java 확장 패키지의 업데이트된 콘텐츠를 기록합니다. 이 확장은 DataDog/dd-trace-java를 기반으로 개발되었으며 Apache License 2.0를 따릅니다. 법적 문서, 체크섬 및 소스 코드 변경 정보는 Guance Java 추적기 확장 선언를 참조하세요.

이 로그는 확장 기능이 처음 나타난 버전, 동작 변경 또는 수정 사항을 확인하는 데 사용됩니다. 완전한 구성 매뉴얼은 아닙니다. 접속 시 다음 순서를 따르시기 바랍니다.

1. 배포 매니페스트에 사용된 실제 확장 JAR 버전을 고정합니다.
2. 이 로그에서 대상 기능의 최소 버전과 후속 동작 변경 사항을 식별합니다.
3. 구성, 데이터 보안 경계 및 확인 단계를 보려면 Java 확장 설명로 돌아갑니다.
4. 프로덕션 환경을 업그레이드하기 전에 시험판 환경에서 호환성 테스트를 완료하세요.

기록 항목은 당시의 릴리스 의미를 유지합니다. 최신 버전은 모든 초기 실험적 동작을 유지한다고 보장되지 않습니다.

업데이트 내역¶

v1.65.7-ext (2026/9/17)¶

업데이트¶

• 비동기 스레드 프레임워크에서 생성된 항목 span를 필터링하는 데 사용되는 async_entry=true span 태그를 추가했습니다.
• ddtrace 및 SkyWalking의 K6 스트레스 테스트 보고서가 추가되었습니다.

v1.65.6-ext (2026/9/14)¶

수정¶

• Netty SSE의 첫 번째 비어 있지 않은 텍스트 블록 시간 소모 및 조각화 통계를 수정했습니다.

v1.65.5-ext (2026/9/10)¶

수정¶

• 구성된 도메인 이름을 사용하여 Redis 클러스터 span 이름을 지정할 때 실제 노드 IP로 대체되는 문제를 수정했습니다.

v1.65.4-ext (2026/9/4)¶

업데이트¶

• Tyrus 2.x WebSocket 클라이언트 핸드셰이크 트레이스 지원이 추가되었습니다.
• WebSocket 메시지에 대한 독립 트레이스를 닫은 후 아웃바운드 보내기 및 활성 닫기 span의 트레이스 소유권 문제를 수정했습니다.

v1.65.3-ext (2026/8/28)¶

수정¶

• Datadog HTTP 전파 형식의 128비트 추적 ID 호환성 문제를 수정합니다.

v1.65.2-ext (2026/8/28)¶

업데이트¶

• Spring RabbitMQ 배치 메시지 소비 및 로그 상관관계를 지원합니다.
• 선택적 CXF 호출자 백업 트레이스를 추가했습니다.

v1.65.0-ext (2026/8/7)¶

업데이트¶

• DataDog dd-trace-java v1.65.0을 병합하고 GuanceCloud 사용자 정의 기능을 추가합니다.
• HTTP 헤더/본문 수집, GWT RPC, JVM 메트릭, Netty SSE, BES 및 Nacos에 대한 지원이 추가되었습니다.

v1.63.7-ext (2026/7/1)¶

업데이트¶

• GWT RPC 요청 본문 태그 수집을 지원합니다.
• JVM 스레드 상태 및 원시 GC StatsD 측정항목이 추가되었습니다.

v1.63.6-ext (2026/6/29)¶

수정¶

• BES 프로브 루트 span 누락 문제가 해결되었습니다.

v1.63.5-ext (2026/6/24)¶

업데이트¶

• Spring RabbitMQ 소비 트레이스 및 로그 상관관계를 강화합니다.
• BES 11.0 애플리케이션 서버 프로브 지원이 추가되었습니다.

v1.63.4-ext (2026/6/10)¶

추가¶

• Netty Client SSE 응답 스트림 span와 첫 번째 패킷 지연 및 조각 번호 메트릭를 추가했습니다.

v1.63.3-ext (2026/6/11)¶

추가¶

• Redis 클라이언트 연결 구성에서 peer.hostname를 얻기 위한 선택적 구성이 추가되었습니다.

v1.63.2-ext (2026/6/8)¶

수정¶

• 17-ea와 같은 Java 버전 문자열의 JMXFetch 인식 문제를 수정했습니다.

v1.63.1-ext (2026/6/4)¶

추가¶

• 외부 파일에서 서비스 매핑 읽기 및 병합을 지원하는 DD_SERVICE_MAPPING_FILE가 추가되었습니다.

v1.63.0-ext (2026/6/3)¶

추가¶

• 최신 코드를 병합하세요.

v1.60.4-ext (2026/4/27)¶

수정¶

• service_name를 표시하는 Redis 문제를 수정합니다.

v1.60.3-ext (2026/4/24)¶

업데이트¶

• Oracle에 최적화된 JDBC 지원.

v1.55.11-ext (2026/3/17)¶

업데이트¶

• RocketMQ 프로브 최소 버전을 4.8.0에서 4.5.0으로 낮추었습니다.

v1.55.10-ext (2026/2/1)¶

추가¶

• java-websocket 프로브 지원이 추가되었습니다.

v1.55.7-ext (2025/12/30)¶

수정¶

• Redis 매개변수가 올바르게 표시되지 않는 문제를 수정했습니다.

v1.55.6-ext (2025/12/22)¶

수정¶

• RocketMQ 범위 제한 문제를 해결합니다.
• 응답 본문 화이트리스트 구성를 추가했습니다.

v1.55.5-ext (2025/12/15)¶

업데이트¶

• DataDog DDTrace v1.55.0을 병합하고 Dubbo, RocketMQ 및 Kingbase에 대한 메트릭 세트 및 지원을 업데이트합니다.

v1.55.2-ext (2025/11/28)¶

수정¶

• RocketMQ 범위 제한 문제를 수정하고 v1.55.0을 병합합니다.

v1.53.7-ext (2025/11/28)¶

업데이트¶

• Apache Dubbo 3.2 스트리밍 호출 및 rocketmq.consume.ignore를 지원합니다.

v1.53.1-ext (2025/9/24)¶

수정¶

• 마스터 브랜치 병합: 1.53.0

v1.47.6-ext (2025/6/4)¶

수정¶

• 사용자 정의 패키지 및 클래스의 메서드를 향상할 수 있습니다. 기능을 활성화하는 명령를 전달하는 방법

v1.47.5-ext (2025/5/22)¶

수정¶

• 수정됨: Pulsar 소비자 트레이스 다운 문제.
• 수정됨: 리소스 디렉터리 필드 문제가 누락되었습니다.

v1.47.4-ext (2025/5/14)¶

추가¶

• 메소드 수준 계측, 구성 및 활성화 기능.

v1.47.1-ext (2025/4/17)¶

수정¶

• Dubbo Response가 적용되지 않는 문제를 수정합니다.
• 최신 브랜치 v1.47.1 병합

v1.42.8-ext¶

수정¶

• 응답 본문 기능에 "dd.trace.response.body.blacklist.urls" 구성이 추가되었습니다.

v1.42.7-ext¶

수정¶

• Response Body 함수의 환경변수가 적용되지 않는 버그 수정
• 최신 DDTrace 태그 v1.42.1 버전 병합

v1.36.1-ext¶

수정¶

• 최신 DataDog Java Agent 분기 1.36.0 병합
• 빠른 버전 찾기를 용이하게 하려면 dd-ext-version 태그를 추가하세요.
• mybatis-plus batch 클래스에 의해 실행된 sql 문은 span 정보로 기록되지 않습니다.

v1.34.2-ext¶

수정¶

• 메모리를 너무 많이 차지하기 때문에 response_body 추가 기능을 제거하기로 결정했습니다.

v1.34.0-ext¶

업데이트¶

• 최신 v1.34.0 코드를 병합하세요.

v1.30.5-ext v1.30.6-ext¶

업데이트¶

• W3C 프로토콜에서 trace_id 추출 문제를 수정했습니다.
• Pulsar OOM 문제를 해결합니다.
• Lettuce5 클러스터 모드에서 peer_ip를 얻습니다.

v1.30.4-ext (2024/4/25)¶

업데이트¶

• Dubbo 서비스의 지속적인 제공으로 인해 발생하는 트레이스 실패 문제를 해결합니다.
• Pulsar가 메모리를 해제하지 않는 문제를 해결합니다.

v1.30.2-ext (2024/4/3)¶

업데이트¶

• Redis SDK Lettuce는 Command 매개변수 보기를 지원합니다.

v1.30.1-ext (2024/2/6)¶

업데이트¶

• 최신 DataDog Java Agent 분기 1.30.0을 병합합니다.
• 트레이스 데이터 명령을 사용하여 활성화에 HTTP 응답 본문 정보를 추가합니다.

v1.25.2-ext (2024/1/10)¶

업데이트¶

• 트레이스 데이터 명령을 사용하여 활성화에 HTTP 헤더 정보를 추가합니다.

v1.21.1-ext (2023/11/1)¶

업데이트¶

• Apache Pulsar 일괄 사용 지원이 추가되었습니다.

v1.21.0-ext (2023/10/24)¶

업데이트¶

• 최신 DDTrace 브랜치 v1.21.0을 병합하고 새 버전을 출시합니다.

v1.20.3-ext (2023/10/13)¶

추가¶

• 버전 2.2 프로브를 지원하기 위해 xxl-job을 추가했습니다.

v1.20.2-ext (2023/9/25)¶

추가¶

• Apache Pulsar 프로브 지원이 추가되었습니다.

v1.20.1-ext (2023/9/8)¶

업데이트¶

• 최신 DDTrace 브랜치 v1.20.1을 병합하고 새 버전을 출시합니다.

v1.17.4-ext (2023/7/27)¶

수정¶

• 높은 동시성에서 RocketMQ가 Span을 잃는 문제를 수정했습니다.

v1.17.2-ext v1.17.3-ext (2023/7/20)¶

수정¶

• Redis에 트레이스 정보가 없는 문제를 수정했습니다.
• Dubbo에서 다수의 디버그 로그를 제거합니다.
• 4개의 JVM 메트릭(jvm.total_thread_count, jvm.peak_thread_count, jvm.daemon_thread_count, jvm.gc.code_cache.used)가 추가되었습니다.

v1.17.1-ext (2023/7/11)¶

수정¶

• RocketMQ는 비동기 메시지를 보낼 때 값을 반환할 때 npe 예외를 발생시킵니다.
• RocketMQ는 메시지 자체를 사용하여 캐싱 span를 로컬 캐싱으로 대체하므로 사용자는 더 이상 TraceContext 기능을 끌 필요가 없습니다.

최적화¶

• 로그 출력 최적화

v1.17.0-ext (2023/7/7)¶

수정¶

• 최신 Datadog v1.17.0 버전 병합

v1.15.4-ext (2023/6/12)¶

수정¶

• 최신 Datadog v1.15.3 버전 병합
• 파워잡 지원

v1.14.0-ext (2023/5/18)¶

수정¶

• 최신 Datadog v1.14.0 버전 병합
• 트레이스 ID 128비트를 지원합니다.

v1.12.1-ext (2023/5/11)¶

수정¶

• MongoDB 둔감화를 지원합니다.
• Dameng 국내 데이터베이스를 지원합니다.

v1.12.0 (2023/4/20)¶

수정¶

• 최신 DDTrace 태그:1.12.0을 병합합니다.
• Dangdang Dubbox를 지원합니다.
• jax-rs와 Dubbo 트레이스 간의 혼동 문제를 해결합니다.
• Dubbo 트레이스 토폴로지 맵의 잘못된 순서 문제를 해결합니다.
• RocketMQ와 고객 정의 트레이스 간의 데이터 충돌 문제를 해결합니다.
• RocketMQ 리source 이름 문제를 해결합니다.

v1.10.2 (2023/4/10)¶

수정¶

• 최신 DDTrace 태그 병합: 1.10
• @DubboReference 중첩을 지원하지 않는 Dubbo 프로브를 수정했습니다.
• RocketMQ 트레이스 고객 정의 컨텍스트 획득 실패 문제 수정

v1.8.0，v1.8.1，v1.8.3(2023/2/27)¶

새로운 기능¶

• 최신 DDTrace 분기 병합
• 특정 함수의 입력 매개변수 정보를 가져오는 기능이 추가되었습니다.

v1.4.1(2023/2/27)¶

새로운 기능¶

• Alibaba Cloud RocketMQ 4.0 시리즈에 대한 지원이 추가되었습니다.

v1.4.0(2023/1/12)¶

새로운 기능¶

• 최신 DDTrace 최신 분기 v1.4.0 병합

v1.3.2(2023/1/12)¶

새로운 기능¶

• Redis 매개변수 보기 기능이 추가되었습니다.
• DDTrace-Java-Agent의 기본 포트를 9529로 수정합니다.
• Alibaba Cloud RocketMQ는 단일 종단 트레이스 문제를 해결합니다.

v1.3.0(2022/12/28)¶

새로운 기능¶

• 최신 DataDog 최신 브랜치 v1.3.0 병합
• 로그 패턴 지원 추가
• HSF 프레임워크 지원 추가
• Axis 1.4 지원 추가
• Alibaba Cloud RocketMQ 5.0 지원 추가

v1.0.1(2022/12/23)¶

새로운 기능¶

• 최신 DataDog 최신 브랜치 v1.0.1을 병합합니다.
• 사용자 정의 콘텐츠를 병합하여 첨부합니다.

v0.113.0-attach(2022/11/16)¶

새로운 기능¶

• 감도 줄이기 기능은 SQL 자리 표시자(?) 프로브 지원을 추가합니다.

0.113.0(2022-10-25)¶

기능 변경 안내¶

• 0.113.0 태그를 기준으로 이전 코드를 병합합니다.

• Fix Thrift TMultipexedProtocol 모델 지원

0.108.1(2022-10-14)¶

DataDog v0.108.1 버전을 병합하고 0.108.1을 유지하면서 컴파일합니다.

기능 변경 안내¶

• 중고품 계측 추가(중고품 버전 >=0.9.3 이상)

0.108.1(2022-09-06)¶

DataDog v0.108.1 버전을 병합하고 컴파일합니다.

기능 변경 안내¶

• xxl_job 프로브 추가(xxl_job 버전 >= 2.3.0)

0.107.0((2022-08-30))¶

DataDog 107 버전을 병합하고 컴파일합니다.

0.105.0(2022-08-23)¶

기능 변경 안내¶

• RocketMq 프로브 지원 버전을 추가합니다(4.8.0 이상).
• Dubbo 프로브 지원 버전이 추가되었습니다(2.7.0 이상).
• SQL 마스킹 기능 추가: 이 기능을 켜면 문제 해결을 용이하게 하기 위해 원래 SQL 문이 트레이스에 추가됩니다. 에이전트를 시작할 때 구성 매개변수 -Ddd.jdbc.sql.obfuscation=true를 추가하세요.