Розгортання OBI в Kubernetes за допомогою Helm

Вміст:

• Розгортання OBI з Helm
• Налаштування OBI
• Налаштування метаданих OBI
• Надання секретів для конфігурації Helm

Розгортання OBI з Helm

Спочатку потрібно додати репозиторій OpenTelemetry до Helm:

helm repo add open-telemetry https://open-telemetry.github.io/opentelemetry-helm-charts

Наступна команда розгортає DaemonSet OBI зі стандартною конфігурацією в просторі obi:

helm install obi -n obi --create-namespace open-telemetry/opentelemetry-ebpf-instrumentation

Стандартна конфігурація OBI:

• експортує метрики як метрики Prometheus на HTTP-порті Pod 9090, шлях /metrics.
• намагається інструментувати всі застосунки у вашому кластері.
• надає лише метрики на рівні застосунків і стандартно виключає network-level metrics
• конфігурує OBI для додавання метаданих Kubernetes до метрик, наприклад k8s.namespace.name або k8s.pod.name

Налаштування OBI

Ви можете перевизначити стандартну конфігурацію OBI. Наприклад, щоб експортувати метрики та/або відрізки як OpenTelemetry замість Prometheus або обмежити кількість сервісів для інструментування.

Ви можете перевизначити стандартні параметри конфігурації OBI своїми значеннями.

Наприклад, створіть файл helm-obi.yml з власною конфігурацією:

config:
  data:
    # Вміст фактичного файлу конфігурації OBI
    discovery:
      instrument:
        - k8s_namespace: demo
        - k8s_namespace: blog
    routes:
      unmatched: heuristic

Розділ config.data містить файл конфігурації OBI, описаний у документації параметрів конфігурації OBI.

Потім передайте перевизначену конфігурацію команді helm за допомогою прапорця -f. Наприклад:

helm install obi open-telemetry/opentelemetry-ebpf-instrumentation -f helm-obi.yml

або, якщо чарт OBI був раніше розгорнутий:

helm upgrade obi open-telemetry/opentelemetry-ebpf-instrumentation -f helm-obi.yml

Налаштування метаданих OBI

Якщо OBI експортує дані за допомогою експортера Prometheus, вам, можливо, потрібно буде перевизначити анотації Pod OBI, щоб він був доступний для вашого скрепера Prometheus. Ви можете додати наступний розділ до прикладу файлу helm-obi.yml:

podAnnotations:
  prometheus.io/scrape: 'true'
  prometheus.io/path: '/metrics'
  prometheus.io/port: '9090'

Аналогічно, чарт Helm дозволяє перевизначати імена, мітки та анотації для кількох ресурсів, залучених до розгортання OBI, таких як облікові записи сервісів, кластерні ролі, контексти безпеки тощо. Документація Helm чарту OBI описує різноманітні параметри конфігурації.

Надавання секретів для конфігурації Helm

Якщо ви безпосередньо надсилаєте метрики та/або відрізки до вашого бекенду спостереження через точку доступу OpenTelemetry, вам, можливо, потрібно буде надати облікові дані через змінну середовища OTEL_EXPORTER_OTLP_HEADERS.

Рекомендований спосіб — зберігати таке значення в Kubernetes Secret, а потім вказати змінну середовища, що посилається на нього, у конфігурації Helm.

Наприклад, розгорніть наступний секрет:

apiVersion: v1
kind: Secret
metadata:
  name: obi-secret
type: Opaque
stringData:
  otlp-headers: 'Authorization=Basic ....'

Потім зверніться до нього з файлу helm-config.yml через розділ envValueFrom:

env:
  OTEL_EXPORTER_OTLP_ENDPOINT: '<...your OTLP endpoint URL...>'
envValueFrom:
  OTEL_EXPORTER_OTLP_HEADERS:
    secretKeyRef:
      key: otlp-headers
      name: obi-secret