第3章 分散トレースと Service Mesh

手順

1. Red Hat OpenShift distributed tracing data collection Operator に移動し、istio-system namespace に OpenTelemetryCollector リソースをインストールします。

   istio-system namespace の OpenTelemetry Collector の例

   kind: OpenTelemetryCollector
   apiVersion: opentelemetry.io/v1beta1
   metadata:
     name: otel
     namespace: istio-system
   spec:
     observability:
       metrics: {}
     deploymentUpdateStrategy: {}
     config:
       exporters:
         otlp:
           endpoint: 'tempo-sample-distributor.tempo.svc.cluster.local:4317'
           tls:
             insecure: true
       receivers:
         otlp:
           protocols:
             grpc:
               endpoint: '0.0.0.0:4317'
             http: {}
       service:
         pipelines:
           traces:
             exporters:
               - otlp
             receivers:
               - otlp

2. トレースを有効にするように Red Hat OpenShift Service Mesh を設定し、meshConfig で分散トレースデータ収集プロバイダーを定義します。

   トレースプロバイダーの有効化および定義の例

   apiVersion: sailoperator.io/v1alpha1
   kind: Istio
   metadata:
   #  ...
     name: default
   spec:
     namespace: istio-system
   #  ...
     values:
       meshConfig:
         enableTracing: true
         extensionProviders:
         - name: otel
           opentelemetry:
             port: 4317
             service: otel-collector.istio-system.svc.cluster.local 1

   1

   service フィールドは、istio-system namespace の OpenTelemetry コレクターサービスです。

3. Istio Telemetry リソースを作成し、spec.values.meshConfig.ExtensionProviders で定義されたトレーサーを有効にします。

   Istio Telemetry リソースの例

   apiVersion: telemetry.istio.io/v1
   kind: Telemetry
   metadata:
     name: otel-demo
     namespace: istio-system
   spec:
     tracing:
       - providers:
           - name: otel
         randomSamplingPercentage: 100

   注記

   トレースが表示されることを確認したら、randomSamplingPercentage 値を減らすか、default に設定してリクエストの数を減らします。

4. 次のコマンドを実行して、info namespace を作成します。

   $ oc create ns info

5. 使用している更新ストラテジーに応じて、適切なコマンドを実行して namespace でサイドカーインジェクションを有効にします。

   1. InPlace 更新ストラテジーを使用している場合は、次のコマンドを実行します。

      $ oc label namespace curl istio-injection=enabled

   2. RevisionBased 更新ストラテジーを使用している場合は、次のコマンドを実行します。

      1. 次のコマンドを実行してリビジョン名を表示します。

         $ oc get istiorevisions.sailoperator.io

         出力例

         NAME              TYPE    READY   STATUS    IN USE   VERSION   AGE
         default-v1-23-0   Local   True    Healthy   True     v1.23.0   3m33s

      2. 次のコマンドを実行して、namespace にリビジョン名のラベルを付け、サイドカーインジェクションを有効にします。

         $ oc label namespace curl istio.io/rev=default-v1-23-0

6. 次のコマンドを実行して、bookinfo namespace に info アプリケーションをデプロイします。

   $ oc apply -f https://raw.githubusercontent.com/istio/istio/release-1.23/samples/info/platform/kube/bookinfo.yaml -n bookinfo

7. トレースを生成するために、productpage Pod へのトラフィックを生成します。

   $ oc exec -it -n info deployments/productpage-v1 -c istio-proxy -- curl localhost:9080/productpage

8. 次のコマンドを実行してインテグレーションを検証し、UI でトレースを確認します。

   $ oc get routes -n tempo tempo-sample-query-frontend

   注記

   Jaeger UI の OpenShift ルートは、Tempo namespace に作成する必要があります。tempo-sample-query-frontend サービス用に手動で作成するか、.spec.template.queryFrontend.jaegerQuery.ingress.type: route を使用して Tempo カスタムリソースを更新できます。