4.3. Jaeger 分散トレースの使用

手順

1. 以下を含む Jaeger カスタムリソース (CR) を作成して適用します。

   Jaeger CR

   apiVersion: jaegertracing.io/v1
   kind: Jaeger
   metadata:
     name: jaeger
     namespace: default

   Copy to Clipboard Toggle word wrap

2. KnativeServing CR を編集し、トレース用に YAML 設定を追加して、Knative Serving のトレースを有効にします。

   Serving の YAML のトレース例

   apiVersion: operator.knative.dev/v1beta1
   kind: KnativeServing
   metadata:
     name: knative-serving
     namespace: knative-serving
   spec:
     config:
       tracing:
         sample-rate: "0.1" 

   1

   
         backend: zipkin 

   2

   
         zipkin-endpoint: "http://jaeger-collector.default.svc.cluster.local:9411/api/v2/spans" 

   3

   
         debug: "false" 

   4

   Copy to Clipboard Toggle word wrap

   1

   sample-rate はサンプリングの可能性を定義します。sample-rate: "0.1" を使用すると、10 トレースの 1 つがサンプリングされます。

   2

   backend は zipkin に設定される必要があります。

   3

   zipkin-endpoint は jaeger-collector サービスエンドポイントを参照する必要があります。このエンドポイントを取得するには、Jaeger CR が適用される namespace を置き換えます。

   4

   デバッグは false に設定する必要があります。debug: "true" を設定してデバッグモードを有効にして、サンプリングをバイパスしてすべてのスパンがサーバーに送信されるようにします。

3. KnativeEventing CR を編集して、Knative Eventing のトレースを有効にします。

   Eventing の YAML のトレース例

   apiVersion: operator.knative.dev/v1beta1
   kind: KnativeEventing
   metadata:
     name: knative-eventing
     namespace: knative-eventing
   spec:
     config:
       tracing:
         sample-rate: "0.1" 

   1

   
         backend: zipkin 

   2

   
         zipkin-endpoint: "http://jaeger-collector.default.svc.cluster.local:9411/api/v2/spans" 

   3

   
         debug: "false" 

   4

   Copy to Clipboard Toggle word wrap

   1

   sample-rate はサンプリングの可能性を定義します。sample-rate: "0.1" を使用すると、10 トレースの 1 つがサンプリングされます。

   2

   backend を zipkin に設定します。

   3

   zipkin-endpoint を jaeger-collector サービスエンドポイントに指定する必要があります。このエンドポイントを取得するには、Jaeger CR が適用される namespace を置き換えます。

   4

   デバッグは false に設定する必要があります。debug: "true" を設定してデバッグモードを有効にして、サンプリングをバイパスしてすべてのスパンがサーバーに送信されるようにします。

1. 以下のコマンドを入力して jaeger ルートのホスト名を取得します。

   $ oc get route jaeger -n default

   Copy to Clipboard Toggle word wrap

   出力例

   NAME     HOST/PORT                         PATH   SERVICES       PORT    TERMINATION   WILDCARD
   jaeger   jaeger-default.apps.example.com          jaeger-query   <all>   reencrypt     None

   Copy to Clipboard Toggle word wrap

2. ブラウザーでエンドポイントアドレスを開き、コンソールを表示します。