第10章 分散トレーシング
クライアントは、OpenTracing 標準の Jaeger 実装に基づいて分散トレーシングを提供します。
10.1. 分散トレースの有効化
アプリケーションでトレースを有効にするには、以下の手順に従います。
手順
Jaeger クライアントの依存関係を POM ファイルに追加します。
Copy to Clipboard Copied! Toggle word wrap Toggle overflow <dependency> <groupId>io.jaegertracing</groupId> <artifactId>jaeger-client</artifactId> <version>${jaeger-version}</version> </dependency>
<dependency> <groupId>io.jaegertracing</groupId> <artifactId>jaeger-client</artifactId> <version>${jaeger-version}</version> </dependency>
${jaeger-version}
1.0.0 以降である必要があります。接続 URI に
jms.tracing
オプションを追加します。この値はopentracing
に設定します。例: トレースが有効になっている接続 URI
Copy to Clipboard Copied! Toggle word wrap Toggle overflow amqps://example.net?jms.tracing=opentracing
amqps://example.net?jms.tracing=opentracing
グローバルトレーサーを登録します。
例: グローバルトレーサーの登録
Copy to Clipboard Copied! Toggle word wrap Toggle overflow import io.jaegertracing.Configuration; import io.opentracing.Tracer; import io.opentracing.util.GlobalTracer; public class Example { public static void main(String[] args) { Tracer tracer = Configuration.fromEnv("<service-name>").getTracer(); GlobalTracer.registerIfAbsent(tracer); // ... } }
import io.jaegertracing.Configuration; import io.opentracing.Tracer; import io.opentracing.util.GlobalTracer; public class Example { public static void main(String[] args) { Tracer tracer = Configuration.fromEnv("<service-name>").getTracer(); GlobalTracer.registerIfAbsent(tracer); // ... } }
トレーシングのための環境を設定します。
例: トレーシング設定
Copy to Clipboard Copied! Toggle word wrap Toggle overflow export JAEGER_SAMPLER_TYPE=const export JAEGER_SAMPLER_PARAM=1 java -jar example.jar net.example.Example
$ export JAEGER_SAMPLER_TYPE=const $ export JAEGER_SAMPLER_PARAM=1 $ java -jar example.jar net.example.Example
ここで示された設定はデモ目的で使用されます。Jaeger の設定に関する詳細は、「Configuration via Environment and Jaeger Sampling」を参照してください。
アプリケーションをキャプチャーするトレースを表示するには、Jaeger Getting Started を使用して Jaeger インフラストラクチャーおよびコンソールを実行します。