第 3 章 分布式追踪和 Service Mesh

流程

1. 进入到 Red Hat OpenShift distributed tracing 数据收集 Operator，并在 istio-system 命名空间中安装 OpenTelemetryCollector 资源：

   istio-system 命名空间中的 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 命名空间中的 OpenTelemetry 收集器服务。

3. 创建一个 Istio Telemetry 资源来启用 spec.values.meshConfig.ExtensionProviders 中定义的 tracer：

   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

   注意

   验证您可以看到 trace 后，请降低 randomSamplingPercentage 值或将其设置为 default 以减少请求数量。

4. 运行以下命令来创建 info 命名空间：

   $ oc create ns info

   Copy to Clipboard Toggle word wrap

5. 根据您使用的更新策略，运行适当的命令在命名空间中启用 sidecar 注入：

   1. 如果您使用 InPlace 更新策略，请运行以下命令：

      $ oc label namespace curl istio-injection=enabled

      Copy to Clipboard Toggle word wrap

   2. 如果使用 RevisionBased update 策略，请运行以下命令：

      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. 运行以下命令，使用修订名称标记命名空间以启用 sidecar 注入：

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

         Copy to Clipboard Toggle word wrap

6. 运行以下命令，在 bookinfo 命名空间中部署 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 的流量来生成 trace：

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

   Copy to Clipboard Toggle word wrap

8. 运行以下命令，在 UI 中看到 trace 来验证集成：

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

   Copy to Clipboard Toggle word wrap
   注意

   Jaeger UI 的 OpenShift 路由必须在 Tempo 命名空间中创建。您可以为 tempo-sample-query-frontend 服务手动创建它，或使用 .spec.template.queryFrontend.jaegerQuery.ingress.type: route 来更新 Tempo 自定义资源。