Hacktoberfest 2026：メンテナが10月に向けて印を付けた、オープンで初心者向けの issue。 Hacktoberfest の issue を見る

WebSocket locally initiated spans ignore single-trace configuration

オープン
  • 何か問題がありますか？
#12,390 コメント 0 件 リアクション 0 件 担当者 0 名 GitHub で見る

メンテナーはふだん 2 日以内に返信

まだ誰も着手していません。

評価

難易度
3/5
見積もり時間
1〜2日
初心者へのやさしさ
75/100
issue の種類
バグ
明瞭さ
明確に書かれている
活発さ
活発
技術スタック
java
領域
observability

調査の方向性

WebsocketDecorator.onFrameStart から開始し、traceStarter と useDedicatedTraces の分岐がローカルで開始された操作の span コンテキストをどのように選択するかを追跡します。DD_TRACE_WEBSOCKET_MESSAGES_SEPARATE_TRACES=false を指定して Jakarta WebSocket のケースを再現し、websocket.send と websocket.close がハンドシェイクの trace を共有することを確認します。その一方で、デフォルトの true の動作は変更されないことも確認します。

索引モデルが issue の本文から書いたものです。

説明

Tracer Version(s)

1.65.1 and current master (a1b6599a5f9f8d803cfac89fa1c3befe41b8c33f)

Java Version(s)

Oracle JDK 21.0.3

JVM Vendor

Oracle JDK

Bug Report

When DD_TRACE_WEBSOCKET_MESSAGES_SEPARATE_TRACES=false, received messages and peer-initiated close spans use the handshake span context, but locally initiated websocket.send and websocket.close spans still use the currently active context.

If there is no active span when Session.close() or RemoteEndpoint.send*() is called, those spans become roots of new traces. If another business span is active, they join that trace instead. In both cases they have a different trace ID from the WebSocket handshake.

This behavior comes from WebsocketDecorator.onFrameStart: the useDedicatedTraces setting is only checked when traceStarter is true. The traceStarter == false branch always calls startSpan(..., operationName) without the handshake context.

This was reproduced with Jakarta WebSocket and Tyrus 2.2.0, but the behavior is in the shared WebSocket decorator and is not Tyrus-specific.

The current result for one short-lived connection is:

websocket.open     trace=A
websocket.receive  trace=A
websocket.send     trace=B
websocket.close    trace=C
Expected Behavior

The Java configuration documentation says that setting DD_TRACE_WEBSOCKET_MESSAGES_SEPARATE_TRACES=false causes all spans captured during the session to be in the same trace. Locally initiated send and close spans should therefore use the handshake trace as well:

websocket.open     trace=A
websocket.receive  trace=A
websocket.send     trace=A
websocket.close    trace=A

When the setting remains at its default value of true, the existing behavior of outgoing operations following the current trace and linking to the handshake should remain unchanged.

Documentation: https://docs.datadoghq.com/tracing/trace_collection/library_config/java/#websocket_messages

Reproduction Code
Session session = client.connectToServer(endpoint, config, uri);
session.getBasicRemote().sendText("hello");
session.close(new CloseReason(CloseReason.CloseCodes.NORMAL_CLOSURE, "done"));

Run without an active application span around sendText and close, with:

DD_TRACE_WEBSOCKET_MESSAGES_SEPARATE_TRACES=false
DD_TRACE_WEBSOCKET_MESSAGES_ENABLED=true

Compare the trace IDs of the handshake, receive, send, and close spans.

主要言語
Java
スター
736
フォーク
364
平均マージ
3日 13時間
マージ済み PR（30日）
213

環境構築

はじめの一歩

  1. issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
  2. 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
  3. リポジトリをフォークし、ブランチを切って変更します。
  4. issue 番号を参照したプルリクエストを送ります。

DataDog/dd-trace-java のほかの issue

DataDog/dd-trace-java の issue をすべて見る

似ている issue

Java の issue をもっと見る

新しい issue をメールで受け取る

初心者向けの GitHub issue を短くまとめたダイジェスト。