IKuznetsov: Новая страница: «В следующем примере конфигурации показано, как настроить экземпляр '''Collector''' для приема...»

2025-10-08T19:58:56Z

Новая страница: «В следующем примере конфигурации показано, как настроить экземпляр '''Collector''' для приема...»

Новая страница

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

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

* Приложение, генерирующее [https://github.com/statsd/statsd/blob/master/docs/metric_types.md сообщения StatsD]
* Один из следующих дистрибутивов '''Collector''' с [https://github.com/open-telemetry/opentelemetry-collector-contrib/tree/v0.136.0/receiver/statsdreceiver приемником StatsD] , [https://github.com/open-telemetry/opentelemetry-collector-contrib/tree/v0.136.0/processor/transformprocessor процессором преобразования] и [https://github.com/open-telemetry/opentelemetry-collector-contrib/tree/v0.136.0/processor/filterprocessor процессором фильтрации] :
** [[Collector Ключ-АСТРОМ|'''Collector''' Ключ-АСТРОМ]]
** [[Collector Ключ-АСТРОМ|OpenTelemetry Contrib]]
** [[Collector Ключ-АСТРОМ|Пользовательская версия Builder]]
* [[Экспорт с помощью OTLP|URL-адрес конечной точки API Ключ-АСТРОМ]], на которую следует экспортировать данные.
* [[Экспорт с помощью OTLP|Токен API]] с соответствующей областью доступа (требуется только для '''SaaS''' и АктивногоШлюза)

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

== Демо конфигурация ==
{| class="wikitable"
|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]
|}

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

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

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

Полный список параметров конфигурации и поддерживаемых типов метрик '''StatsD''' см. в [https://github.com/open-telemetry/opentelemetry-collector-contrib/blob/v0.136.0/receiver/statsdreceiver/README.md документации приемника StatsD].

=== Экспортеры ===
В разделе <code>exporters</code> мы указываем [https://github.com/open-telemetry/opentelemetry-collector/tree/v0.136.0/exporter/otlphttpexporter экспортер <code>otlphttp</code>] по умолчанию и настраиваем его с помощью URL-адреса нашего API Ключ-АСТРОМ и требуемого токена аутентификации.

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

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

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

Получение данных из StatsD - История изменений

IKuznetsov: Новая страница: «В следующем примере конфигурации показано, как настроить экземпляр '''Collector''' для приема...»