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

2025-10-08T21:19:10Z

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

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

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

== Ограничения ==

=== Требования B3 ===
Обратите внимание на требования B3, чтобы избежать потери сегментов из-за общих и дублирующихся идентификаторов сегментов. Подробнее см. в [https://opentelemetry.io/docs/specs/otel/context/api-propagators/#b3-requirements спецификации распространителя].

Например, если вы используете [https://cloud.spring.io/spring-cloud-sleuth/2.1.x/multi/multi__propagation.html#_extracting_a_propagated_context Spring Code Sleuth], вы можете использовать следующий параметр конфигурации для отключения общего доступа к диапазону:
{| class="wikitable"
|spring:

sleuth:

supports-join: false
|}

=== Маршрутизация с одним Collector ===
Обязательно направляйте все связанные пакеты '''Zipkin/B3''' через один и тот же экземпляр '''Collector''', чтобы гарантировать полное загрузку. Если вы загружаете некоторые пакеты только с помощью ЕдиногоАгента, они могут быть неправильно связаны и не отображаться как подключенные к вашим пакетам '''Zipkin'''.

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

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

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

== Демо конфигурация ==
{| class="wikitable"
|receivers:
zipkin:

exporters:

otlphttp:

endpoint: ${env:DT_ENDPOINT}

headers:

Authorization: "Api-Token ${env:DT_API_TOKEN}"

service:

pipelines:

traces:

receivers: [zipkin]

processors: []

exporters: [otlphttp]
|}

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

=== Приемники ===
В разделе <code>receivers</code> мы указываем приемник <code>zipkin</code>, как активный компонент приемника для нашего экземпляра '''Collector'''.

Приемник '''Zipkin''' можно настроить с помощью еще [https://github.com/open-telemetry/opentelemetry-collector-contrib/tree/v0.136.0/receiver/zipkinreceiver нескольких атрибутов] , которые в нашем примере мы оставим со значениями по умолчанию.

=== Экспортеры ===
В разделе <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>Authorization</code>.

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

=== Сервисные контейнеры ===
В разделе <code>service</code> мы в конечном итоге собираем наши объекты приемника и экспортера в контейнер трассировок, который будет обрабатывать наше преобразование '''Zipkin''' в '''OTLP'''.

Прием данных из Zipkin - История изменений

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