IKuznetsov в 15:59, 11 декабря 2025

2025-12-11T15:59:35Z

← Предыдущая версия		Версия от 15:59, 11 декабря 2025
Строка 78:		Строка 78:
	Для этой цели мы устанавливаем следующие две переменные среды и ссылаемся на них в значениях конфигурации для <code>endpoint</code> и <code>Authorization</code>.		Для этой цели мы устанавливаем следующие две переменные среды и ссылаемся на них в значениях конфигурации для <code>endpoint</code> и <code>Authorization</code>.

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

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

2025-10-08T20:37:41Z

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

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

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

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

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

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

== Конфигурация Collector ==
{| class="wikitable"
|receivers:

netflow:

hostname: "0.0.0.0"

scheme: netflow

port: 2055

sockets: 2

workers: 4

processors:

batch:

send_batch_size: 30

timeout: 30s

exporters:

otlphttp:

endpoint: ${env:DT_ENDPOINT}

headers:

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

service:

pipelines:

logs:

receivers: [netflow]

processors: [batch]

exporters: [otlphttp]
|}
Проверьте документацию по [https://github.com/open-telemetry/opentelemetry-collector-contrib/tree/v0.136.0/receiver/netflowreceiver#netflow-receiver приемнику NetFlow] на предмет доступных вариантов конфигурации.

Мы рекомендуем установить параметр <code>sockets</code> равным количеству ядер ЦП, доступных на экземпляре '''Collector''', а этот параметр <code>workers</code> — равным удвоенному количеству сокетов. Такая конфигурация позволяет '''Collector''' обрабатывать несколько входящих пакетов '''NetFlow''' одновременно, что повышает производительность.

Для очень больших объемов данных следует распараллелить конфигурацию между несколькими экземплярами '''Collector'''.

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

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

=== Процессоры ===
В разделе <code>processors</code> «Укажите процессор <code>batch</code>», который объединяет входящие пакеты '''NetFlow''' перед отправкой в Ключ-АСТРОМ. Это полезно для оптимизации производительности и сокращения количества отправляемых запросов.

=== Экспортеры ===
В разделе <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 Dynatrace (например, <code><nowiki>https://{your-environment-id}.live.dynatrace.com/api/v2/otlp</nowiki></code>)
* <code>DT_API_TOKEN</code> содержит токен API

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

== Визуализация данных ==
Записи логов будут доступны в Ключ-АСТРОМ с полями, задокументированными в [https://github.com/open-telemetry/opentelemetry-collector-contrib/tree/v0.136.0/receiver/netflowreceiver#data-format документации приемника].

=== Примеры DQL-запросов ===

* Извлеките все логи '''NetFlow''' и просуммируйте байты и пакеты по адресам источника и назначения:

{| class="wikitable"
|fetch logs

<nowiki>|</nowiki> filter otel.scope.name == "otelcol/netflowreceiver"

<nowiki>|</nowiki> summarize {bytes=sum(toDouble(flow.io.bytes)), packets=sum(toDouble(flow.io.packets))}, by: {source = source.address, destination = destination.address}

<nowiki>|</nowiki> fieldsAdd bytes_relative=bytes

<nowiki>|</nowiki> fieldsAdd packets_relative=packets

<nowiki>|</nowiki> sort bytes desc
|}
[[Файл:Image4074.png|граница]]

* Выберите часто используемые порты:

{| class="wikitable"
|fetch logs

<nowiki>|</nowiki> filter otel.scope.name == "otelcol/netflowreceiver"

<nowiki>|</nowiki> summarize {bytes=sum(toDouble(flow.io.bytes))}, by: {port = destination.port}

<nowiki>|</nowiki> sort bytes desc

<nowiki>|</nowiki> limit 10
|}
[[Файл:Image4075.png|граница]]

Прием пакетов NetFlow - История изменений

IKuznetsov в 15:59, 11 декабря 2025

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