Отправка OpenTelemetry в ClickStack с помощью Odigos

Odigos — это плоскость управления для инструментирования в Kubernetes и виртуальных машинах, который инструментирует приложения на уровне ядра с помощью eBPF. Поскольку сбор выполняется в ядре, накладные расходы для приложения остаются низкими, а уровень наблюдаемости — высоким. Вы получаете OpenTelemetry-трассировки, метрики, журналы и профили production-уровня без развертывания новых агентов в прикладном коде и без необходимости ждать обновления библиотек во всех сервисах.

Именно слой eBPF делает возможной глубокую и согласованную телеметрию в большом масштабе. Odigos может автоматически включать и отключать более глубокое инструментирование, когда это нужно, чтобы упростить отладку и устранение неполадок:

• Контекст на уровне кода — атрибуты, связанные с функциями и поведением во время выполнения
• HTTP-трафик — запросы и ответы между вашими сервисами
• Системы обмена сообщениями — полезная нагрузка и сообщения из Kafka и похожих брокеров
• Подробная информация об ошибках — трассировки стека при сбоях
• Пользовательское инструментирование — расширяйте охват там, где заканчивается автоинструментирование, без изменений кода и перезапусков

За кулисами Odigos создает и управляет полноценным конвейером OpenTelemetry для вашего кластера: коллекторами, которые масштабируются вместе с нагрузкой, маршрутизацией в выбранные вами backend-системы и логикой конвейера, которой вы управляете через интерфейс. Задайте сэмплирование для управления объемом, маскирование PII, чтобы конфиденциальные данные не попадали в экспорт, и правила OTTL, чтобы фильтровать, преобразовывать или обогащать телеметрию до того, как она покинет кластер.

Развертывание OpenTelemetry в большом количестве сервисов часто требует много времени и дает лишь поверхностное представление о работе приложений. Odigos выполняет eBPF-инструментирование для получения более глубокой телеметрии и управляет работой коллектора в Kubernetes; ClickStack предоставляет хранилище на базе ClickHouse и интерфейс HyperDX для запросов к телеметрии в больших масштабах.

• ClickStack установлен и доступен из вашего кластера Kubernetes. См. Начало работы с ClickStack с открытым исходным кодом или Начало работы с Управляемым ClickStack.
• Конечная точка OTLP HTTP ClickStack (порт 4318) и значение для аутентификации, которое Odigos будет передавать в заголовке Authorization. Для ClickStack с открытым исходным кодом это ключ API для ингестии ClickStack из Team Settings → API Keys в интерфейсе HyperDX. Для Управляемого ClickStack это OTLP_AUTH_TOKEN, который вы задаёте при запуске собственного автономного коллектора ClickStack.
• Кластер Kubernetes (узлы Linux с ядром 4.18 или новее для инструментирования с помощью eBPF)
• Helm, kubectl и учетные данные кластера для установки в пространство имен odigos-system
• Токен Odigos Enterprise для локального развертывания — для получения доступа свяжитесь с командой Odigos

export ODIGOS_ONPREM_TOKEN="<your-enterprise-token>"

helm repo add odigos https://odigos-io.github.io/odigos/
helm repo update

helm upgrade --install odigos odigos/odigos \
  --namespace odigos-system \
  --create-namespace \
  --set onPremToken=$ODIGOS_ONPREM_TOKEN

kubectl get pods -n odigos-system

kubectl port-forward svc/ui -n odigos-system 3000:3000

Если вы экспортируете данные напрямую в ClickHouse с помощью нативного пункта назначения ClickHouse в Odigos (а не через OTLP HTTP в ClickStack), включите нормализатор логов HyperDX (HYPERDX_LOG_NORMALIZER: true). Он разбирает JSON в теле логов и нормализует атрибуты, чтобы упростить выполнение запросов в интерфейсе ClickStack.

Если ClickHouse доступен напрямую из вашего кластера, вместо OTLP HTTP можно использовать нативный пункт назначения ClickHouse в Odigos. Настройте конечную точку ClickHouse, имя базы данных и параметры схемы в интерфейсе или с помощью manifest — см. пункт назначения ClickHouse в Odigos.

• Схема для production: Установите CLICKHOUSE_CREATE_SCHEME в false и примените собственный DDL.
• TLS / аутентификация: Используйте CLICKHOUSE_TLS_ENABLED, CLICKHOUSE_USERNAME и Secret Kubernetes для пароля.

OTLP HTTP (ClickStack)

apiVersion: odigos.io/v1alpha1
kind: Destination
metadata:
  name: clickstack
  namespace: odigos-system
spec:
  type: otlphttp
  destinationName: otlphttp
  signals:
    - TRACES
    - METRICS
    - LOGS
  data:
    OTLP_HTTP_ENDPOINT: 'http://clickstack.example.com:4318'
    # Ключ API для ингестии ClickStack с открытым исходным кодом или OTLP_AUTH_TOKEN для Управляемого ClickStack
    OTLP_HTTP_HEADERS: 'Authorization:<YOUR_AUTHORIZATION_VALUE>'

ClickHouse (напрямую)

apiVersion: odigos.io/v1alpha1
kind: Destination
metadata:
  name: clickhouse
  namespace: odigos-system
spec:
  type: clickhouse
  destinationName: clickhouse
  signals:
    - TRACES
    - METRICS
    - LOGS
  data:
    CLICKHOUSE_ENDPOINT: 'http://clickstack.example.com:8123'
    CLICKHOUSE_DATABASE_NAME: 'otel'
    CLICKHOUSE_CREATE_SCHEME: 'true'

Примените манифест:

kubectl apply -f destination.yaml

Odigos VM Agent инструментирует процессы Linux, сервисы systemd и/или контейнеры Docker с помощью eBPF. Данные телеметрии экспортируются в те же пункты назначения, что и в кластерном Odigos, включая ClickStack через OTLP HTTP.

VM Agent является частью Odigos Pro. Сведения о настройке, источниках и конфигурации пунктов назначения см. в обзоре VM Agent.

Odigos Central — это централизованная плоскость управления для работы с инструментированием, пунктами назначения и конфигурацией конвейера в нескольких кластерах Kubernetes из одного интерфейса, а не через отдельную настройку каждого кластера.

Odigos Central доступен в Odigos Enterprise. См. обзор Central, чтобы узнать о многокластерном управлении, SSO и унифицированных правилах сэмплирования.

• Изучайте трассировки между инструментированными сервисами в ClickStack
• Создавайте панели мониторинга для метрик, экспортируемых Odigos
• Настройте схему ClickHouse и TTL с учетом ваших требований к хранению данных и шаблонов запросов

• Установка Odigos Enterprise
• ClickHouse как пункт назначения в Odigos
• Обзор Odigos VM Agent
• Обзор Odigos Central
• Хватит гадать в продакшене: полномасштабная трассировка без потери данных с ClickHouse и Odigos
• Начало работы с ClickStack с открытым исходным кодом