Получение данных из StatsD

В следующем примере конфигурации показано, как настроить экземпляр Collector для приема данных из существующей настройки StatsD и импорта их как запроса OTLP в Ключ-АСТРОМ.

Предустановка

• Приложение, генерирующее сообщения StatsD
• Один из следующих дистрибутивов Collector с приемником StatsD , процессором преобразования и процессором фильтрации :
  • Collector Ключ-АСТРОМ
  • OpenTelemetry Contrib
  • Пользовательская версия Builder
• URL-адрес конечной точки API Ключ-АСТРОМ, на которую следует экспортировать данные.
• Токен API с соответствующей областью доступа (требуется только для SaaS и АктивногоШлюза)

Информацию о настройке Collector с использованием указанной ниже конфигурации см. в разделах Развертывание коллектора и Конфигурация коллектора.

Демо конфигурация

receivers:   statsd:     endpoint: 0.0.0.0:8125     timer_histogram_mapping:       - statsd_type: "histogram"         observer_type: "histogram"         histogram:           # max size for the auto-scaling exponential histogram OTLP metric           # see below for details           max_size: 100       - statsd_type: "timing"         observer_type: "histogram"         histogram:           max_size: 100       - statsd_type: "distribution"         observer_type: "histogram"         histogram:           max_size: 100 exporters:   otlphttp:     endpoint: ${env:DT_ENDPOINT}     headers:       Authorization: "Api-Token ${env:DT_API_TOKEN}" service:   pipelines:     metrics:       receivers: [statsd]       exporters: [otlphttp]

Компоненты

Для нашей конфигурации мы настраиваем следующие компоненты.

Приемники

В разделе receivers мы указываем приемник statsd, как активный компонент приемника для нашего экземпляра Collector. Мы настраиваем приемник на прослушивание всех сетевых интерфейсов на порте 8125, который обычно используется для StatsD.

Приёмник настроен на агрегацию сообщений гистограммы, таймера и распределения в экспоненциальные гистограммы, которые затем обрабатываются для загрузки в Ключ-АСТРОМ. Приёмник использует экспоненциальные гистограммы с автоматическим масштабированием, и мы выбрали максимальный размер 100. Это означает, что гистограмма будет изначально иметь очень точные границы контейнеров и автоматически перемасштабируется при получении точек данных, которые приведут к увеличению количества контейнеров более чем на 100.

Полный список параметров конфигурации и поддерживаемых типов метрик StatsD см. в документации приемника StatsD.

Экспортеры

В разделе exporters мы указываем экспортер otlphttp по умолчанию и настраиваем его с помощью URL-адреса нашего API Ключ-АСТРОМ и требуемого токена аутентификации.

Для этой цели мы устанавливаем следующие две переменные среды и ссылаемся на них в значениях конфигурации для endpoint и headers.

• DT_ENDPOINT содержит базовый URL-адрес конечной точки API astromkey (например, https://{your-environment-id}.live.astromkey.com/api/v2/otlp)
• DT_API_TOKEN содержит токен API

Сервисные контейнеры

В разделе service мы собираем наши объекты-получатели, процессоры и экспортеры в конвейер метрик, который принимает данные StatsD и передает их в Ключ-АСТРОМ.