8.4. トレーシング

手順

1. OpenTelemetryCollector カスタムリソース (CR) を作成します。

   OpenTelemetryCollector CR の例

   apiVersion: opentelemetry.io/v1alpha1
   kind: OpenTelemetryCollector
   metadata:
     name: cluster-collector
     namespace: <namespace>
   spec:
     mode: deployment
     config: |
       receivers:
         zipkin:
       processors:
       exporters:
         jaeger:
           endpoint: jaeger-all-in-one-inmemory-collector-headless.tracing-system.svc:14250
           tls:
             ca_file: "/var/run/secrets/kubernetes.io/serviceaccount/service-ca.crt"
         logging:
       service:
         pipelines:
           traces:
             receivers: [zipkin]
             processors: []
             exporters: [jaeger, logging]

   Copy to Clipboard Toggle word wrap

2. Red Hat 分散トレースがインストールされているネームスペースで 2 つの Pod が実行されていることを確認します。

   $ oc get pods -n <namespace>

   Copy to Clipboard Toggle word wrap

   出力例

   NAME                                          READY   STATUS    RESTARTS   AGE
   cluster-collector-collector-85c766b5c-b5g99   1/1     Running   0          5m56s
   jaeger-all-in-one-inmemory-ccbc9df4b-ndkl5    2/2     Running   0          15m

   Copy to Clipboard Toggle word wrap

3. 次のヘッドレスサービスが作成されていることを確認します。

   $ oc get svc -n <namespace> | grep headless

   Copy to Clipboard Toggle word wrap

   出力例

   cluster-collector-collector-headless            ClusterIP   None             <none>        9411/TCP                                 7m28s
   jaeger-all-in-one-inmemory-collector-headless   ClusterIP   None             <none>        9411/TCP,14250/TCP,14267/TCP,14268/TCP   16m

   Copy to Clipboard Toggle word wrap

   これらのサービスは、Jaeger、Knative Serving、および Knative Eventing を設定するのに使用されます。Jaeger サービスの名前は異なる場合があります。

4. OpenShift Serverless Operator のインストールのドキュメントに従って、OpenShift Serverless Operator をインストールします。

5. 以下の KnativeServing CR を作成して Knative Serving をインストールします。

   KnativeServing CR の例

   apiVersion: operator.knative.dev/v1beta1
   kind: KnativeServing
   metadata:
       name: knative-serving
       namespace: knative-serving
   spec:
     config:
       tracing:
         backend: "zipkin"
         zipkin-endpoint: "http://cluster-collector-collector-headless.tracing-system.svc:9411/api/v2/spans"
         debug: "false"
         sample-rate: "0.1" 

   1

   Copy to Clipboard Toggle word wrap

   1

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

6. 次の KnativeEventing CR を作成して、Knative Eventing をインストールします。

   KnativeEventing CR の例

   apiVersion: operator.knative.dev/v1beta1
   kind: KnativeEventing
   metadata:
       name: knative-eventing
       namespace: knative-eventing
   spec:
     config:
       tracing:
         backend: "zipkin"
         zipkin-endpoint: "http://cluster-collector-collector-headless.tracing-system.svc:9411/api/v2/spans"
         debug: "false"
         sample-rate: "0.1" 

   1

   Copy to Clipboard Toggle word wrap

   1

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

7. Knative サービスを作成します。

   サービスの例

   apiVersion: serving.knative.dev/v1
   kind: Service
   metadata:
     name: helloworld-go
   spec:
     template:
       metadata:
         labels:
           app: helloworld-go
         annotations:
           autoscaling.knative.dev/minScale: "1"
           autoscaling.knative.dev/target: "1"
       spec:
         containers:
         - image: quay.io/openshift-knative/helloworld:v1.2
           imagePullPolicy: Always
           resources:
             requests:
               cpu: "200m"
           env:
           - name: TARGET
             value: "Go Sample v1"

   Copy to Clipboard Toggle word wrap

8. サービスにいくつかのリクエストを行います。

   HTTPS 要求の例

   $ curl https://helloworld-go.example.com

   Copy to Clipboard Toggle word wrap

9. Jaeger Web コンソールの URL を取得します。

   コマンドの例

   $ oc get route jaeger-all-in-one-inmemory  -o jsonpath='{.spec.host}' -n <namespace>

   Copy to Clipboard Toggle word wrap

   Jaeger コンソールを使用してトレースを検証できるようになりました。

手順

1. 以下を含む Jaeger カスタムリソース YAML ファイルを作成し、これを適用します。

   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. ブラウザーでエンドポイントアドレスを開き、コンソールを表示します。