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

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

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

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

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

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

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

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

先决条件

• 已安装 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 部署，请根据网格拓扑选择前缀：

  • 对于单集群 Service Mesh，建议以前缀加集群名称结尾，例如 acp-cluster-1。
  • 对于多集群 Service Mesh，所有集群的追踪数据必须存储在同一索引系列中；建议以前缀加 meshID 结尾，例如 acp-mesh-1。在网格中的每个集群上运行安装操作步骤时，使用相同的 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

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
'

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 提供程序的 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 条目，或将 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 Build of OpenTelemetry v2 Operator 的说明，请参阅 Uninstalling Alauda Distributed Tracing。