13.3. JBoss EAP での OpenTelemetry トレース
JBoss EAP は OpenTelemetry トレースを提供し、ユーザーリクエストがアプリケーションのさまざまな部分を通過する際の進行状況を追跡するのに役立ちます。トレースを分析することで、アプリケーションのパフォーマンスを向上させ、可用性の問題をデバッグできます。
OpenTelemetry トレースは、次のコンポーネントで構成されています。
- Trace
- 要求がアプリケーションで実行する操作のコレクション。
- Span
- トレース内の単一の操作。要求、エラー、および期間 (RED) メトリックを提供し、スパンコンテキストを含みます。
- スパンコンテキスト
- 含まれているスパンが一部であるリクエストを表す一意の識別子のセット。
JBoss EAP は、Jakarta RESTful Web Services アプリケーションに対する REST 呼び出し、およびコンテナー管理の Jakarta RESTful Web Services クライアント呼び出しを自動的にトレースします。JBoss EAP は、REST 呼び出しを次のように暗黙的にトレースします。
受信要求ごとに:
- JBoss EAP は、要求からスパンコンテキストを抽出します。
- JBoss EAP は新しいスパンを開始し、要求が完了するとそれを閉じます。
送信要求ごとに:
- JBoss EAP は、スパンコンテキストを要求に挿入します。
- JBoss EAP は新しいスパンを開始し、要求が完了するとそれを閉じます。
暗黙的なトレースに加えて、詳細なトレースのために Tracer インスタンスをアプリケーションに挿入することにより、カスタムスパンを作成できます。