#使用 Service Mesh 配置分布式追踪平台（已弃用）

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

• Alauda Build of Jaeger：基于开源 Jaeger 项目的定制发行版。它可提供复杂分布式系统中请求的端到端可见性。

• Alauda Build of OpenTelemetry：基于 OpenTelemetry 项目，该组件通过管理 OpenTelemetry Collector 和工作负载插桩，简化跨指标、日志和追踪的数据采集。

OpenTelemetry Collector 充当遥测信号的中介。它支持多种数据格式，并提供标准化流水线，用于处理和导出遥测数据到诸如 Jaeger 等后端。

#配置与 Service Mesh 集成的分布式追踪数据采集

您可以将 Alauda Service Mesh 与 OpenTelemetry 集成，以对 OpenTelemetry traces、metrics 和 logs 进行插桩、生成、收集和导出，从而分析并了解软件的性能和行为。

前提条件

• 已安装 Alauda Build of Jaeger。
• 已安装 Alauda Build of OpenTelemetry。
• 已创建一个 Istio 实例。
• 已创建一个 Istio CNI 实例。

操作步骤

kubectl label namespace istio-system cpaas.io/project=cpaas-system --overwrite

./install-jaeger.sh \
  --es-url='https://xxx' \
  --es-user-base64='xxx' \
  --es-pass-base64='xxx' \
  --target-namespace='istio-system' \
  --jaeger-basepath-suffix='/istio/jaeger' \
  --jaeger-es-index-prefix='istio-tracing-xxx'

apiVersion: opentelemetry.io/v1beta1
kind: OpenTelemetryCollector
metadata:
  name: otel
  namespace: istio-system
spec:
  observability:
    metrics: {}
  deploymentUpdateStrategy: {}
  config:
    processors:
      batch: {}
    exporters:
      debug: {}
      otlp:
        endpoint: 'dns:///jaeger-prod-collector-headless.istio-system:4317'
        balancer_name: round_robin
        tls:
          insecure: true
    receivers:
      otlp:
        protocols:
          grpc:
            endpoint: '0.0.0.0:4317'
    service:
      pipelines:
        traces:
          exporters:
            - debug
            - otlp
          processors:
            - batch
          receivers:
            - otlp

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

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

#卸载分布式追踪

如果您不再需要 Alauda Build of OpenTelemetry 和 Alauda build of Jaeger 与 Service Mesh 的集成，请按照以下步骤将其移除。

#移除 Service Mesh 追踪配置

在删除底层组件之前，请先移除 mesh 侧的追踪配置，以便 Istio 停止向旧版 collector 发送 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 条目，或者将 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 实例

登录到安装了该集成的集群，并删除 OpenTelemetryCollector 实例：

kubectl -n istio-system delete opentelemetrycollector otel

#卸载 Alauda Build of OpenTelemetry Operator

如果集群中的其他工作负载仍依赖 Alauda Build of OpenTelemetry Operator，请跳过此步骤。

您可以在 Web Console 中使用 管理员 视图卸载该 Operator。

操作步骤

• 依次进入 Marketplace → OperatorHub → 使用 搜索框 搜索 Alauda build of OpenTelemetry。
• 单击 Alauda build of OpenTelemetry 标题进入其详情。
• 在 Alauda build of OpenTelemetry 详情页右上角，单击 Uninstall 按钮。
• 在 Uninstall "opentelemetry-operator"? 窗口中，单击 Uninstall。

#删除 Jaeger 实例

登录到安装了该集成的集群，并删除 Jaeger 实例及其支持资源。下面的资源名称与在 --target-namespace='istio-system' 下运行 install-jaeger.sh 时生成的默认值一致；如果安装时使用了不同的 --jaeger-instance-name，请相应调整。

kubectl -n istio-system delete ingress      jaeger-prod-query         --ignore-not-found
kubectl -n istio-system delete podmonitor   jaeger-prod-monitor       --ignore-not-found
kubectl -n istio-system delete jaeger       jaeger-prod               --ignore-not-found
kubectl -n istio-system delete rolebinding  jaeger-prod-rb            --ignore-not-found
kubectl -n istio-system delete role         jaeger-prod-role          --ignore-not-found
kubectl -n istio-system delete sa           jaeger-prod-sa            --ignore-not-found
kubectl -n istio-system delete secret       jaeger-prod-oauth2-proxy  --ignore-not-found
kubectl -n istio-system delete secret       jaeger-prod-es-basic-auth --ignore-not-found
kubectl -n istio-system delete configmap    jaeger-prod-oauth2-proxy  --ignore-not-found

#卸载 Alauda build of Jaeger Operator

如果集群中的其他工作负载仍依赖 Alauda build of Jaeger Operator，请跳过此步骤。

您可以在 Web Console 中使用 管理员 视图卸载该 Operator。

操作步骤

• 依次进入 Marketplace → OperatorHub → 使用 搜索框 搜索 Alauda build of Jaeger。
• 单击 Alauda build of Jaeger 标题进入其详情。
• 在 Alauda build of Jaeger 详情页右上角，单击 Uninstall 按钮。
• 在 Uninstall "jaeger-operator"? 窗口中，单击 Uninstall。