#使用 Service Mesh 配置分布式追踪平台

Alauda Service Mesh 支持通过与以下组件集成来实现分布式追踪：

• Alauda Build of Jaeger v2：基于开源 Jaeger 项目的定制发行版。它为跨复杂分布式系统的请求提供端到端可见性。在 v2 中，Jaeger 实例以 OpenTelemetryCollector 自定义资源的形式部署，由 Alauda Build of OpenTelemetry v2 Operator 管理。

• Alauda Build of OpenTelemetry v2：基于 OpenTelemetry 项目，此 Operator 管理 Jaeger v2 实例和作为其前端的 OpenTelemetry Collector 的生命周期。

OpenTelemetry Collector 充当遥测信号的中间层。它支持多种数据格式，并提供用于处理遥测数据以及将其导出到 Jaeger 等后端的标准化管道。

#使用 Service Mesh 配置分布式追踪数据收集

您可以将 Alauda Service Mesh 与 Alauda Distributed Tracing 集成：部署 Jaeger v2 实例和 OpenTelemetry Collector，然后配置 Istio 通过它们导出追踪数据。

Jaeger v2 实例和 OpenTelemetry Collector 并非 Service Mesh 专用组件：一对 Jaeger v2 和 OpenTelemetry Collector（默认部署在 jaeger-system 命名空间中）可以同时为 Service Mesh 和集群中的其他工作负载提供服务。本节仅介绍 Service Mesh 特定的配置；有关底层安装步骤，请参阅 Alauda Distributed Tracing 文档。

前提条件

• 目标集群已安装 Alauda Container Platform Distributed Tracing（之前称为 Alauda Build of Jaeger v2）集群插件。请参阅 安装 Alauda Build of Jaeger v2 集群插件。该插件会将追踪组件的容器镜像发布到平台的 registry，并将其地址记录在 cpaas-system 中的 jaeger-cluster-plugin-manifest ConfigMap 内，以下步骤将读取这些地址。

• 已安装 Alauda Container Platform Application Observability（之前称为 Alauda Build of OpenTelemetry v2）Operator。请参阅 安装 Alauda Build of OpenTelemetry v2 Operator。

• 已部署 Jaeger v2 实例。请参阅 使用 Elasticsearch 部署 Alauda Build of Jaeger v2 或 使用 OpenSearch 部署 Alauda Build of Jaeger v2。

  INFO

  安装操作步骤中引用的 JAEGER_ES_INDEX_PREFIX 变量控制用于存储追踪数据的 Elasticsearch 索引前缀。默认值 acp-${CLUSTER_NAME} 适用于单集群部署。对于 service mesh 部署，请根据 mesh 的拓扑选择前缀：

  • 对于单集群 service mesh，建议以前缀加集群名称结尾，例如 acp-cluster-1。
  • 对于多集群 service mesh，所有集群的追踪数据必须存储在同一索引系列中；建议以前缀加 meshID 结尾，例如 acp-mesh-1。在 mesh 中的每个集群上运行安装操作步骤时使用相同的 JAEGER_ES_INDEX_PREFIX，以便 Jaeger UI 能够关联跨集群的 span。

• 已部署 OpenTelemetry Collector。请参阅 部署 OpenTelemetry Collector。

• 已创建 Istio 实例。

• 已创建 Istio CNI 实例。

操作步骤

kubectl label namespace jaeger-system istio-discovery=enabled

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.jaeger-system.svc.cluster.local
      serviceSettings:
      - hosts:
        - otel-collector.jaeger-system.svc.cluster.local
        settings:
          clusterLocal: true

kubectl patch istio default --type=merge -p '
spec:
  values:
    meshConfig:
      enableTracing: true
      extensionProviders:
      - name: otel
        opentelemetry:
          port: 4317
          service: otel-collector.jaeger-system.svc.cluster.local
      serviceSettings:
      - hosts:
        - otel-collector.jaeger-system.svc.cluster.local
        settings:
          clusterLocal: true
'

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

kubectl -n istio-system patch telemetry asm-default --type=merge -p '
spec:
  tracing:
    - providers:
        - name: otel
      randomSamplingPercentage: 100
'

#卸载分布式追踪

如果不再需要与 Service Mesh 集成的分布式追踪，请按以下顺序移除配置。

#移除 Service Mesh 追踪配置

在移除底层组件之前，将 mesh 与 OpenTelemetry Collector 分离，以便 Istio 停止发送 span。

1. 编辑 Telemetry 资源，并移除引用 otel provider 的 tracing providers 条目：

   kubectl -n istio-system edit telemetry asm-default

   或者，使用 kubectl patch 以非交互方式移除 tracing 配置：

   kubectl -n istio-system patch telemetry asm-default --type=json -p='[{"op": "remove", "path": "/spec/tracing"}]'

2. 编辑 Istio 资源，并移除名为 otel 的 meshConfig.extensionProviders 条目以及针对 Collector 主机的 meshConfig.serviceSettings 条目，或者将 meshConfig.enableTracing 设置为 false：

   kubectl edit istio default

   或者，使用 kubectl patch 以非交互方式将 meshConfig.enableTracing 设置为 false：

   kubectl patch istio default --type=merge -p='{"spec":{"values":{"meshConfig":{"enableTracing":false}}}}'

#卸载 OpenTelemetry Collector 和 Jaeger v2

如果集群中的其他工作负载仍依赖 OpenTelemetry Collector 或 Jaeger v2 实例，请跳过此步骤。

有关删除 OpenTelemetry Collector 实例、Jaeger v2 实例以及（可选）Alauda Container Platform Application Observability（之前称为 Alauda Build of OpenTelemetry v2）Operator 的操作说明，请参阅 Uninstalling Alauda Distributed Tracing。