第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

   Copy to Clipboard Toggle word wrap

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

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

   apiVersion: sailoperator.io/v1
   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

   Copy to Clipboard Toggle word wrap

   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

   Copy to Clipboard Toggle word wrap

   注記

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

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

   $ oc create ns info

   Copy to Clipboard Toggle word wrap

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

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

      $ oc label namespace curl istio-injection=enabled

      Copy to Clipboard Toggle word wrap

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

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

         $ oc get istiorevisions.sailoperator.io

         Copy to Clipboard Toggle word wrap

         出力例

         NAME      TYPE    READY   STATUS    IN USE   VERSION   AGE
         default   Local   True    Healthy   True     v1.24.3   3m33s

         Copy to Clipboard Toggle word wrap

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

         $ oc label namespace curl istio.io/rev=default

         Copy to Clipboard Toggle word wrap

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

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

   Copy to Clipboard Toggle word wrap

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

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

   Copy to Clipboard Toggle word wrap

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

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

   Copy to Clipboard Toggle word wrap
   注記

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