#Настройка платформы распределённого трассирования с Service Mesh (устарело)

Alauda Service Mesh поддерживает распределённое трассирование посредством интеграции со следующими компонентами:

• Alauda Build of Jaeger: настраиваемая дистрибуция, основанная на проекте с открытым исходным кодом Jaeger. Она обеспечивает сквозную видимость запросов в сложных распределённых системах.

• Alauda Build of OpenTelemetry: на основе проекта OpenTelemetry. Этот компонент упрощает сбор телеметрических данных по метрикам, логам и трассировкам за счёт управления OpenTelemetry Collector и инструментированием рабочих нагрузок.

OpenTelemetry Collector выступает в роли промежуточного звена для телеметрических сигналов. Он поддерживает несколько форматов данных и предоставляет стандартизированный конвейер для обработки и экспорта телеметрии в такие backend-системы, как Jaeger.

#Настройка сбора данных распределённого трассирования с Service Mesh

Вы можете интегрировать Alauda Service Mesh с OpenTelemetry, чтобы инструментировать, генерировать, собирать и экспортировать трассы, метрики и логи OpenTelemetry для анализа и понимания производительности и поведения вашего ПО.

Предварительные требования

• Alauda Build of Jaeger is installed.
• Alauda Build of OpenTelemetry is installed.
• Создан экземпляр 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 перестал отправлять спаны в устаревший коллектор.

1. Отредактируйте ресурс Telemetry и удалите запись провайдера tracing, которая ссылается на провайдера otel:

   kubectl -n istio-system edit telemetry asm-default

   В качестве альтернативы можно удалить конфигурацию tracing в неинтерактивном режиме с помощью kubectl patch:

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

2. Отредактируйте ресурс Istio и удалите запись meshConfig.extensionProviders с именем otel либо установите meshConfig.enableTracing в false:

   kubectl edit istio default

   В качестве альтернативы можно задать meshConfig.enableTracing значение false в неинтерактивном режиме с помощью kubectl patch:

   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

Пропустите этот шаг, если другие рабочие нагрузки в кластере по-прежнему зависят от Operator Alauda Build of OpenTelemetry.

Вы можете удалить Operator, используя представление Administrator в Web Console.

Шаги

• В разделе Marketplace → OperatorHub → используйте поле поиска, чтобы найти Alauda build of OpenTelemetry.
• Щёлкните заголовок Alauda build of OpenTelemetry, чтобы открыть его сведения.
• На странице сведений Alauda build of OpenTelemetry нажмите кнопку Uninstall в правом верхнем углу.
• В окне Uninstall "opentelemetry-operator"? нажмите Uninstall.

#Удаление экземпляра Jaeger

Войдите в кластер, где установлена интеграция, и удалите экземпляр Jaeger и связанные с ним ресурсы. Приведённые ниже имена ресурсов соответствуют значениям по умолчанию, создаваемым install-jaeger.sh с --target-namespace='istio-system'; скорректируйте их, если при установке вы использовали другое значение --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

Пропустите этот шаг, если другие рабочие нагрузки в кластере по-прежнему зависят от Operator Alauda build of Jaeger.

Вы можете удалить Operator, используя представление Administrator в Web Console.

Шаги

• В разделе Marketplace → OperatorHub → используйте поле поиска, чтобы найти Alauda build of Jaeger.
• Щёлкните заголовок Alauda build of Jaeger, чтобы открыть его сведения.
• На странице сведений Alauda build of Jaeger нажмите кнопку Uninstall в правом верхнем углу.
• В окне Uninstall "jaeger-operator"? нажмите Uninstall.