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

2025-10-08T05:35:01Z

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

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

В следующем примере конфигурации показано, как настроить экземпляр '''Collector''' для обогащения данных '''OpenTelemetry''' сущностями хоста ЕдиногоАгента.

Обогащение используется для связывания данных '''OpenTelemetry''' с хостом ЕдиногоАгента и их корректной интеграции в топологическую модель. Например, при получении логов с разных хостов привязка сущности хоста к соответствующим данным логов позволяет выполнять задачи аналитики логов на уровне хоста.
{| class="wikitable"
|<u>Контейнерные среды</u>

Обогащение специфично для сред ЕдиногоАгента, <u>'''не''' использующих контейнеры</u>. Настройка обогащения для контейнеризированного '''Collector''' может привести к некорректным ассоциациям хостов и топологии.
|}

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

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

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

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

otlp:

protocols:

grpc:

endpoint: 0.0.0.0:4317

http:

endpoint: 0.0.0.0:4318

processors:

resourcedetection/astromkey:

detectors: [astromkey]

override: false

exporters:

otlphttp:

endpoint: ${env:DT_ENDPOINT}

headers:

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

service:

pipelines:

traces:

receivers: [otlp]

processors: [resourcedetection/astromkey]

exporters: [otlphttp]

metrics:

receivers: [otlp]

processors: [resourcedetection/astromkey]

exporters: [otlphttp]

logs:

receivers: [otlp]

processors: [resourcedetection/astromkey]

exporters: [otlphttp]
|}

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

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

Это сделано в основном для демонстрационных целей. Вы можете указать здесь любой другой допустимый получатель (например, <code>zipkin</code>).

=== Процессоры ===
В разделе <code>processors</code> мы указываем [https://github.com/open-telemetry/opentelemetry-collector-contrib/blob/v0.136.0/processor/resourcedetectionprocessor процессор <code>resourcedetection</code>] и настраиваем его с помощью [https://github.com/open-telemetry/opentelemetry-collector-contrib/blob/v0.136.0/processor/resourcedetectionprocessor/README.md#dynatrace детектора <code>astromkey</code>], специфичного для Ключ-АСТРОМ.

При такой конфигурации процессор детектора ресурсов попытается загрузить следующие два атрибута из файла обогащения ЕдиногоАгента :

* <code>dt.entity.host</code>
* <code>host.name</code>

Если детектор ресурсов успешно загрузит эти значения, он добавит их в качестве атрибутов ресурсов в запрос '''OTLP'''. Дополнительная настройка процессора не требуется.

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

Для этой цели мы устанавливаем следующие две переменные среды и ссылаемся на них в значениях конфигурации для <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> мы собираем объекты приемника, процессора и экспортера в сервисные контейнеры, которые будут выполнять следующие шаги:

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

Расширение с помощью ЕдиногоАгента - История изменений

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