#Debug Exporter

Debug Exporter — это специализированный экспортер для отладки, который выводит собранные телеметрические данные в стандартный вывод (stdout), позволяя напрямую просматривать содержимое данных, полученных и обработанных Collector.

#Overview

Debug Exporter в первую очередь используется в следующих сценариях:

• Проверка, правильно ли Collector получает телеметрические данные
• Проверка соответствия формата и содержимого данных ожиданиям
• Отладка проблем в конвейере обработки данных
• Быстрый просмотр данных в средах разработки и тестирования

#Configuring Debug Exporter

Вы можете настроить Debug Exporter в пользовательском ресурсе OpenTelemetryCollector:

config:
  exporters:
    debug:
      verbosity: detailed
  service:
    pipelines:
      traces:
        exporters: [debug]
      metrics:
        exporters: [debug]
      logs:
        exporters: [debug]

Параметры конфигурации

• verbosity: уровень детализации вывода, варианты:
  • basic: базовая информация (по умолчанию)
  • normal: стандартная информация
  • detailed: подробная информация, включая полное содержимое данных

#Viewing exported data

После настройки Debug Exporter экспортированные данные появляются в логах пода Collector. Просмотреть их можно с помощью следующей команды:

kubectl logs <collector-pod-name> -n <namespace> -f

Пример вывода

2025-04-17T10:40:44.559+0200    info    Traces  {"otelcol.component.id": "debug/basic", "otelcol.component.kind": "Exporter", "otelcol.signal": "traces", "resource spans": 1, "spans": 2}

#Using Debug Exporter with other exporters

Debug Exporter можно использовать одновременно с другими экспортерами, что позволяет отправлять данные в бекенд-системы и одновременно просматривать содержимое данных в логах:

config:
  exporters:
    debug:
      verbosity: detailed
    otlp:
      endpoint: jaeger-collector:4317
      tls:
        insecure: true
  service:
    pipelines:
      traces:
        receivers: [otlp]
        processors: [batch]
        exporters: [debug, otlp]

В этой конфигурации данные трассировки отправляются как в Debug Exporter, так и в OTLP экспортер.