업데이트 이력¶
1.22.2(2026/11/10)¶
새로운 기능¶
- 선택적 테일 샘플링 spill을 추가했습니다. 메모리 예산이 부족할 때 결정 대기 중인 그룹을 디스크로 전환하며, 리소스 제한, 사용량 및 오류 메트릭과 Sinker의 포인트 레이블 기준 분기를 지원합니다(!234, !235)
- spill 설정, 용량 산정, Kubernetes 스토리지 배포 및 문제 해결 가이드를 추가했습니다(!236)
문제 수정¶
- 구버전 raw 테일 샘플링에서 소형 패킷을 추가 압축한 뒤 수신은 성공했지만 다운스트림으로 전달되지 않을 수 있는 문제를 수정했습니다(!235)
- 테일 샘플링 spill의 다중 대상 분기에서 실패한 대상의 지속적인 재시도가 같은 그룹의 다른 대상을 차단하는 문제를 수정했습니다. 성공한 대상에는 중복 전송하지 않습니다(#138)
1.22.1(2026/11/10)¶
새로운 기능¶
- 테일 샘플링 단계 소요 시간, 전송 대기 바이트 및 예산, 압축 전후 바이트량 메트릭을 추가했습니다(#135)
기능 개선¶
- 테일 샘플링 배치 전송과 버퍼 재사용을 개선하여 압축 해제, 배치 구성 및 전송 과정에서의 중복 할당과 복사를 줄였습니다(#133)
- HTTP 액세스 로그를 비활성화했을 때의 요청 처리 오버헤드를 낮췄으며,
gin_log: ""설정에 적용됩니다(#133)
호환성 안내¶
- 테일 샘플링 직접 전송 및 Sinker 분기의 다운스트림 요청 기본 압축이 gzip에서 zstd로 변경되었으며, 자동 협상이나 폴백은 수행하지 않습니다. 업그레이드 전에 모든 다운스트림 KodoX Point Worker가 zstd를 지원하는지 확인해야 합니다. 캐시 재생 시에는 원본 인코딩과 요청 본문을 유지합니다(#133)
1.22.0(2026/11/09)¶
문제 수정¶
- Go를 1.26.10으로 업그레이드하고 crypto/x509 인증서 신뢰 보안 문제를 수정했습니다(CVE-2026-111943 / GO-2026-6809)(#130)
기능 개선¶
- tracing 테일 샘플링에서 동일한 trace의 여러 샤드를 처리할 때의 성능을 개선했습니다(#129)
호환성 안내¶
- 메인 이미지의 기본 시스템을 Ubuntu 22.04에서 24.04로 업그레이드했으며, linux/amd64와 linux/arm64를 지원합니다(#131)
1.21.0(2026/10/14)¶
새로운 기능¶
- OpenLineage 데이터 수집, gzip 전송 및 Sinker 분기를 지원합니다(#112, #122)
- OCSF 수신 인터페이스를 추가하여 배치 데이터를 지원하고
ocsf로그 인덱스에 기록합니다(#120)
문제 수정¶
- 잘못된 집계 파라미터로 인해 프로세스가 비정상 종료될 수 있는 문제를 수정했습니다(#117)
- 중단된 업로드가 장기간 동시성 슬롯을 점유하는 문제와 프록시 응답 상태 코드가 올바르지 않은 문제를 수정했습니다(#118)
기능 개선¶
- HTTP 타임아웃 제어를 보완하여 중단된 요청이 장기간 리소스를 점유하지 않도록 했습니다(#118)
- 로그 token 마스킹을 통일하여 앞 8자리와 뒤 4자리를 유지하고, 짧은 token은 전부 숨깁니다(#121)
호환성 안내¶
- 다운스트림 4xx는 원래 상태 코드를 유지하고, 오류 본문 파싱에 실패하면
{}를 반환하며 더 이상500으로 변경하지 않습니다(#124)
1.20.0(2026/09/10)¶
새로운 기능¶
- Body를 읽기 전에 적용되는 HTTP 동시성 제한을 추가하고
kodo_queue.workers(DW_KODO_QUEUE_WORKERS, 기본값256)를 재사용합니다. 한도에 도달하면 최대128개의 요청을 추가로 대기시키며, 최대 대기 시간은1s입니다. Kodo 디스패치 큐를 비활성화해도 이 제한은 적용되며, Body가 없는 요청은 집계되지 않습니다(#115) - 처리 중인 요청 수, 대기 수, 수락 결과 및 대기 시간을 관찰할 수 있도록
dataway_http_concurrency_in_flight,dataway_http_concurrency_waiting,dataway_http_concurrency_requests_total및dataway_http_concurrency_wait_seconds메트릭을 추가했습니다(#115)
문제 수정¶
- 업스트림은 성공했지만 응답 본문이 비어 있을 때
/api/public/ingestion이 Langfuse SDK 4.x와 호환되지 않는 문제를 수정했습니다. 요청 배치의 이벤트 ID를 기준으로successes/errorsJSON을 반환하고, 업스트림에 이미 존재하는 JSON 응답 내용은 유지합니다(#116)
호환성 안내¶
- HTTP 동시성 대기 큐가 가득 차거나 대기 시간이 초과되면 등록된 DK 호환 인터페이스는
503을, 다른 인터페이스는429를 반환하며 모두Retry-After: 1을 포함합니다. 이렇게 거부된 요청은 디스크 캐시에 기록되지 않습니다(#115) - HTTP/1.x 요청이 동시성 제한으로 거부되면 남은 Body 읽기를终止하고 응답 반환 후 연결을 닫아, 완료되지 않은 업로드를 기다리지 않도록 했습니다. 클라이언트가 재시도할 때는 새 연결을建立해야 합니다(#115)
1.19.0(2026/08/27)¶
새로운 기능¶
/v2/tail_samplingzstd 보고 인터페이스를 추가했으며, Datakit 2.10이/v1/tail_sampling을 통해 전송하는 압축 협상 header가 없는 zstd packet과 호환됩니다(#110)- 테일 샘플링 보존 데이터에 제한된 배치 전송과 실패 재시도를 추가하고, 메모리 초과 시 디스크 기록을 비동기 처리로 변경했으며, 재시작 복구와 종료 마무리 메커니즘을 보완했습니다(#110)
기능 개선¶
- 테일 샘플링이 압축 해제 후
trace_id를 추출하고 predicate를 보정 계산하며, 다운스트림으로 배치 전송할 때 gzip으로 압축하여 요청 횟수와 전송 오버헤드를 줄였습니다(#110) - 테일 샘플링 큐 제출 결과, 대기 시간, 디스크 깊이 및 배치 처리 상태 등 런타임 메트릭의 기록 범위를 보완했습니다(#110)
보안 및 관측 가능성¶
- 메트릭의 token 레이블을
redacted로 고정하고 더 이상 원본 token 조각을 유지하지 않아 자격 증명 유출과 고카디널리티 시계열을 방지합니다(#90) - 집계, 테일 샘플링 및 다중 백엔드 전달 오류를 마스킹하여 더 이상 백엔드 URL, 응답 내용 또는 인증 정보를 노출하지 않습니다(#90)
1.18.0(2026/08/12)¶
기능 개선¶
- 테일 샘플링의
trace_id추출 경로를 개선하여RawGroupId를 사용할 수 있을 때 payload를 중복 순회하지 않도록 했으며, 샘플링 동작은 그대로 유지합니다(#108) cliutils를 업그레이드하여 디스크 캐시를 열면 용량 메트릭이 자동으로 초기화되도록 했으며, 종료 및 파일 잠금 해제 동작을 보완했습니다(#111)
문제 수정¶
- Aggregate와 Tail Sampling 특수 API의 token 검증 및 전달 방식을 통일했습니다(#88)
- token, 쓰기 라우팅 및 main/headless 모드별로 무효 token 네거티브 캐시를 격리하여 시나리오 간 잘못된 차단을 방지했습니다(#106)
- 실패 캐시와 테일 샘플링 디스크 폴백 경로의 동시 접근 문제를 수정하여 디스크 큐 초기화, 읽기 및 종료 중 발생하는 데이터 경쟁을 방지했습니다(#111)
- pprof와 Prometheus HTTP mux를 분리했습니다. pprof는 기본적으로 비활성화되며, 활성화 시 loopback에서만 수신하도록 허용하고 진단 요청의 시간과 동시성을 제한합니다(#89)
- 요청 전달, 캐시 재생, 집계, 테일 샘플링 및 Sinker 로그에 포함된 token, 자격 증명, 전역 태그와 규칙 내용을 마스킹했습니다(#104)
- 시스템 워크스페이스 URL 판정을 수정하고, 일반 모드와 계단식 모드에서의 token 주입 회귀 검증을 보완했습니다(#104)
- 메인 HTTP Server의 요청 헤더 타임아웃, Gin mode, IP 블랙리스트 설정 예시 및 API wrapper 오류 처리를 수정했습니다(#104)
보안 및 관측 가능성¶
- CI에서 사용하는 Go와 golangci-lint 다운로드 패키지를 고정하고 아키텍처별로 SHA-256을 검증했으며, 원격 설치 스크립트를 직접 실행하는 경로를 제거했습니다(#101)
- DataWay 기본 대시보드를 업데이트하여 큐, 테일 샘플링, Sinker 캐시 및 런타임 모니터링을 보완했습니다(#85)
1.17.0(2026/07/14)¶
새로운 기능¶
- OTLP HTTP/protobuf 인터페이스를 추가했습니다:
/otel/v1/traces,/otel/v1/metrics및/otel/v1/logs(#81) - OTLP 요청에서 query
token,X-Token및 Bearer token을 지원하며, Kodo 큐와 디스크 캐시에 연결됩니다(#81) - OTLP 요청에서 Kodo의 상태 코드, body 및 필요한 header를 그대로 전달할 수 있습니다(#81)
기능 개선¶
- 집계와 테일 샘플링의 Sinker 분기를 개선하여 개별 그룹 전송 실패가 다른 그룹에 영향을 주지 않도록 했습니다(#71)
- 무효 token 네거티브 캐시가 조건에 해당하는 쓰기 요청에만 적용되도록 했습니다(#77)
- 집계의 메모리 사용량과 동시성 안정성을 개선했습니다
- 테일 샘플링 적체 처리를 개선하여 메모리 큐가 가득 찼을 때 디스크에 임시 저장할 수 있습니다
- 디스크 캐시 이상 상황에서의 안정성을 향상했습니다
문제 수정¶
- Sinker 규칙 캐시의 경쟁 상태와 용량 문제를 수정했습니다(#93)
관측 가능성¶
- 파일 디스크립터 메트릭
dataway_open_files_by_type및 TCP 메트릭dataway_tcp_connections를 추가했습니다 - 테일 샘플링, 전송 큐, worker 및 디스크 임시 저장 메트릭을 추가했습니다
1.16.1(2026/07/09)¶
문제 수정¶
/v1/write/rum이 빈 body를 거부하고400과dataway.emptyBody를 반환합니다. 비어 있지 않은 body는 그대로 전달됩니다(#82)- Kodo 큐가 가득 차면 캐시 가능한 요청을 디스크에 기록합니다. 캐시를 사용할 수 없으면
503을 반환합니다(#83) - 쓰기에 성공한 경우에만 "캐시됨"을 반환하며, 캐시 실패 사유 기록을 보완했습니다(#83)
1.16.0(2026/07/02)¶
새로운 기능¶
- IPv6 및 듀얼 스택 배포 지원을 추가했으며, IP 화이트리스트는 IPv4, IPv6 및 CIDR을 지원합니다(#79)
bind_ipv6/DW_BIND_IPV6및trusted_proxies/DW_TRUSTED_PROXIES설정을 추가했습니다(#78, #79)
기능 개선¶
- Kodo 성공 응답이 비어 있을 때 더 이상 빈 body와
Content-Type을 반환하지 않습니다(#78) Origin이 있는 요청에만 CORS header를 반환하고, 전달 응답에X-Content-Type-Options: nosniff를 추가했습니다(#78)
1.15.0(2026/05/27)¶
새로운 기능¶
- 쓰기, 업로드 및 Firehose 요청을 처리하는 Kodo 유한 큐를 추가했습니다
- 큐는 기본적으로 활성화되며
DW_KODO_QUEUE_*환경 변수를 지원합니다 - 큐가 가득 차면 캐시 가능한 요청을 캐시합니다. 캐시를 사용할 수 없으면
503을 반환합니다 - 무효 token 네거티브 캐시를 추가하여
DW_TOKEN_NEGATIVE_CACHE_*환경 변수를 지원합니다 - 네거티브 캐시의 기본 TTL은
5m이며 최대1000개의 token을 저장합니다
기능 개선¶
- 집계 인터페이스에 token 및 payload 검증을 추가했습니다
- 집계 전송을 백그라운드 큐로 변경하고 3회 재시도를 지원하며
Content-MD5를 추가했습니다 - 집계 proxy가 리버스 프록시를 재사용하도록 하고 관련 설정을 검증합니다
- 캐시 재생 시 현재
remote_host를 사용하며, 기본 정리 간격을1s로 변경했습니다 - Sinker 문서를 업데이트했습니다. DataKit 2.0.0부터 non-point 쓰기 API에는 일반적으로
__dataway_api규칙이 필요하지 않습니다
관측 가능성¶
- Kodo 큐 관련 메트릭을 추가했습니다:
dataway_kodo_queue_wait_seconds,dataway_kodo_queue_depth,dataway_kodo_queue_bytes,dataway_kodo_queue_enqueued_total,dataway_kodo_queue_full_total,dataway_kodo_queue_dispatch_total - 무효 token 네거티브 캐시 메트릭을 추가했습니다:
dataway_token_negative_cache_added_total,dataway_token_negative_cache_blocked_total - 집계/테일 샘플링 관련 메트릭을 추가했습니다:
dataway_http_api_body_size_bytes_total,dataway_http_aggr_point_total,dataway_http_tail_sampling_trace_total,dataway_http_tail_sampling_span_total,dataway_http_tail_sampling_packet_send_total - 디스크 캐시 잠금 경쟁 메트릭을 추가했습니다:
diskcache_lock_wait_seconds,diskcache_lock_contention_total - Sinker 시나리오에서 지연 메트릭의
sinked레이블을 수정했습니다
1.14.0(2026/04/17)¶
- 세션 리플레이 image 처리 인터페이스를 추가했습니다
1.13.0(2026/04/10)¶
- DataWay 바이패스 집계 및 샘플링 지원을 추가했습니다(#67)
1.12.3(2026/03/26)¶
- 분기 header의 비정상 값으로 인해 HTTP 표준을 위반하는 문제를 해결하기 위해 v2 Sinker header 형식을 추가했습니다(#68)
1.12.2(2026/03/17)¶
- DataWay 이미지의 SSL 인증서를 업데이트하여 계단식 환경에서 Openaway SSL 인증서를 인식하지 못하는 문제를 방지했습니다(#69)
1.12.1(2025/12/25)¶
- 1.12.0 버전에서 Sinker 분기가 요청을 복사하지 못하는 문제를 수정했습니다(#66)
1.12.0(2025/12/19)¶
새로운 기능¶
-
Sinker 캐시 메커니즘을 개선했습니다(#34)
- 새로운 sinker 캐시 메커니즘은 전체 요청 특성을 그대로 캐시하지 않고 요청의 해시 특성(16 byte)으로 캐시하며, 두 갈래 해시를 통해 해시 충돌을 최대한 방지합니다. 이론적인 해시 충돌 확률은 n/2^128이며, n은 캐시된 key의 개수입니다
- Sinker 캐시에 TTL 메커니즘과 capacity 메커니즘을 추가하여 메모리 사용량을 추가로 제한합니다. TTL 메커니즘은 비활성 캐시를 정리하고, capacity 메커니즘은 캐시의 key 개수가 지정된 한도를 넘지 않도록 보장합니다. 또한 TTL과 capacity 제한으로 위의 해시 충돌 확률이 더욱 낮아집니다
-
DataWay HTTP header 반환을 최적화하는 설정을 추가하여 DataWay 공인망 트래픽을 줄였습니다(#65)
1.11.2(2025/11/25)¶
- Kodo로 전달하는 DataWay의 HTTP 요청을 개선했습니다(#64)
1.11.1(2025/11/15)¶
__internal__token이 유효하지 않은 문제를 수정했습니다(#63)
1.11.0(2025/11/12)¶
새로운 기능¶
- DataWay 기본 이미지를 Ubuntu 22.04로 업그레이드했습니다(#62)
- DataWay가 무효 트래픽을 차단하도록 지원합니다(#61)
문제 수정¶
- 세션 리플레이 및 profile 분기에서 데이터를 다른 워크스페이스로 복사하지 못하는 문제를 수정했습니다(#59)
1.10.0(2025/09/03)¶
새로운 기능¶
- Langfuse 데이터 수집 기능을 추가했습니다(#57)
1.9.0(2025/04/25)¶
새로운 기능¶
- DataWay가 데이터 업로드类 요청에
X-Pkg-Id를 추가하여 데이터 추적을 지원합니다(#53) - 프로그램 로그를 보완하여 더 많은 Kodo 오류 코드가 DataKit으로 전달됩니다(#52)
- API 자체 pull 환경 변수를 추가했습니다(#55)
- 디스크 캐시 코드를 업데이트하여 일부 상황에서 발생하는
invalid argument오류를 추적할 수 있도록 했습니다(#56)
1.8.0(2025/02/19)¶
새로운 기능¶
- DataWay의 Sinker 모드가 활성화된 상태에서 클라이언트(예: DataKit/Function)가 보내는 데이터 보고 요청을 동시에 처리할 수 있도록 지원합니다(#50)
1.7.0(2024/12/18)¶
새로운 기능¶
- AWS Firehose 수집 엔드포인트를 추가했습니다(#47)
X-Token을 통해 token을 전달할 수 있습니다(#43)
기능 개선¶
- 내부 회수의 기본 파라미터를 조정하여 메모리 사용을 최적화했습니다(#49)
- Kubernetes 배포의 기본 yaml을 개선하고 cache 디스크 마운트 설정을 조정했습니다(#48)
- 일부 내부 메트릭을 조정 및 추가하고 DataWay 기본 뷰를 업데이트했습니다
1.6.2(2024/12/03)¶
기능 개선¶
- HTTP 계층의 연결 설정 항목을 추가했습니다(#46)
1.6.1(2024/11/19)¶
기능 개선¶
- 404 페이지를 비활성화하는 옵션을 추가했습니다(#44)
1.6.0(2024/09/19)¶
기능 개선¶
- 디스크 캐시 관련 환경 변수 설정을 개선했습니다
- 자체 메트릭 노출을 늘리고 HTTP 전달 계층의 메모리 사용을 일부 최적화했습니다(#39)
- DataWay가 자체 SNI를 설정할 수 있도록 지원합니다(#42)
- DataKit이 비교적 정확한 Unix 타임스탬프를 얻을 수 있도록 시간 동기화 인터페이스를 추가했습니다(#40)
- Sinker:
1.5.0(2024/07/05)¶
기능 개선¶
- 설치 스크립트를 개선했습니다(#33)
호환성 조정¶
- 새 버전에서는 호스트 설치 모드에서 Sinker 설정을 직접 지원하는 기능이 제거되었습니다. 이 기능은 추후 새로운 방식으로 지원될 예정입니다.
1.4.1(2024/06/19)¶
- Kubernetes 설치 모드에서
DW_ENABLE_TLS가 누락되는 문제를 수정했습니다 - 빌드 이미지 주소를 변경했습니다
1.4.0(2024/05/15)¶
- DataKit 계량 인터페이스를 추가했습니다(#29)
- cache에서 데이터가 유실될 수 있는 문제를 수정했습니다(#31)
- DataWay 측에서 HTTP TLS 인증서를 직접 설정할 수 있습니다(#32)
- 메트릭 노출을 늘렸습니다
1.3.9(2024/03/28)¶
- Sink가 요청을 폐기할 때 문제 해결을 용이하게 하기 위해 HTTP
406 Not Acceptable오류를 반환하도록 추가했습니다(#82)
1.3.8(2024/01/24)¶
- 메트릭 노출을 늘렸습니다
- Sinker 규칙 매칭 성능을 대폭 향상했습니다(#26)
1.3.7(2023/12/14)¶
- 메트릭 노출을 늘렸습니다
- 디스크 캐시 정리 정책을 개선하여 최대한 빠르게 소비하는 원칙을 적용했습니다:
- 저장 한도 초과로 인해 데이터가 능동적으로 폐기되는 것을 방지합니다
- 동시에 캐시된 데이터를 최대한 빠르게 전송합니다
- 대형 요청 폐기 관련 관측 가능성을 추가했습니다(메트릭/로그)
- DataWay 자체 POD yaml을 조정하여 메트릭과 로그 수집을 보완했습니다
1.3.6(2023/10/24)¶
- DataWay
sink관리 명령을 추가했습니다
1.3.5(2023/09/13)¶
- Kubernetes에서 환경 변수 주입을 통해 DataWay를 설치할 수 있습니다
- dataway.yaml을 새로 릴리스했습니다
1.3.4(2023/09/01)¶
- Golang을 1.9로 업그레이드했습니다
- inner token에 데이터가 없는 문제를 수정했습니다
- 기본 설정에서 다음 설정을 조정했습니다:
- 기본 API 속도 제한을 100K로 상향했습니다
- 기본 최대 Body를 64MB로 상향했습니다
- HTTP 타임아웃 설정(DataWay에서 센터로)을 추가하고 기본값을 30s로 설정했습니다
- TLS 509 오류를 무시하는 설정을 추가했습니다
1.3.3(2023/09/01)¶
- 이미지 패키징 시
curl문제를 수정했습니다
1.3.2(2023/08/30)¶
- 이미지에
curl명령을 추가하여 자체 메트릭을 확인할 수 있도록 했습니다
1.3.1(2023/08/28)¶
- URL에 대한 Sinker 기능을 추가했습니다
1.3.0(2023/08/24)¶
- DataWay 전체 구현을 재구성하고 Sinker 기능을 추가했습니다
1.2.12(2023/08/28)¶
- CI 릴리스 프로세스를 재구성하여 install 스크립트의 이중 릴리스를 구현했습니다
1.2.8(2022/09/18)¶
-
/v1/wirte 인터페이스 업데이트:
- 중복된 /v1/write/xxx API를 제거하고 /v1/write/:category 인터페이스를 추가했습니다
- 데이터 쓰기 시 더 이상 라인 프로토콜 디코딩을 수행하지 않지만, 서명을 위해 Body 읽기는 계속 수행합니다
-
디스크 캐시:
- 캐시 정리 과정에서 센터 전송에 실패하면 소비 일시 중지 정책을 적용하여, 현재 캐시된 요청이 성공적으로 전송된 후에만 다음 캐시를 정리합니다
- pbcache proto 파일을 업데이트했습니다