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]

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

   $ oc get pods -n <namespace>

   出力例

   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

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

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

   出力例

   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

   これらのサービスは、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

   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

   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"

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

   HTTPS 要求の例

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

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

   コマンドの例

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

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

手順

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

   Jaeger CR

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

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

   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

   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

   出力例

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

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