IKuznetsov: Новая страница: « = Приём записей NetFlow в Ключ-АСТРОМ = Сетевая наблюдаемость обеспечивает необходимую видимость для понимания того, как приложения взаимодействуют с базовой сетью. Она позволяет командам более эффективно выявлять и устранять проблемы, начиная с монитор...»

2026-09-21T13:32:25Z

Новая страница: « = Приём записей NetFlow в Ключ-АСТРОМ = Сетевая наблюдаемость обеспечивает необходимую видимость для понимания того, как приложения взаимодействуют с базовой сетью. Она позволяет командам более эффективно выявлять и устранять проблемы, начиная с монитор...»

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

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

Это руководство показывает, как принимать записи '''NetFlow''' в '''Ключ-АСТРОМ''', настроив коллектор и используя '''Дашборды''' и '''Notebooks''' для анализа данных о потоках.

== Зачем мониторить сетевой поток с помощью Ключ-АСТРОМ? ==
Приём сетевых потоков в '''Ключ-АСТРОМ''' немедленно помещает эти данные в контекст. Данные, содержащиеся в сетевых потоках, дополняют поддерживаемые сетевые сценарии, связывая объём и направления потока с устройствами и интерфейсами. Данные сетевых потоков можно сравнивать с данными процесс-процесс, чтобы помочь решить проблемы приложений, вызванные сетью.

== Как Ключ-АСТРОМ как платформа поддерживает приём NetFlow? ==
'''Ключ-АСТРОМ''' поддерживает такие протоколы сетевых потоков, как '''NetFlow''', '''sFlow''' и '''IPFIX''', через полностью поддерживаемую версию '''OpenTelemetry Collector'''. Выделенный приёмник сетевых потоков обеспечивает бесшовный приём данных о потоках в платформу '''Ключ-АСТРОМ''' для анализа и визуализации.

== Предварительные требования ==

* Дистрибутив '''Ключ-АСТРОМ Collector''' с приёмником '''NetFlow'''.
* '''URL''' конечной точки API '''Ключ-АСТРОМ''', в которую должны экспортироваться данные.
* Токен платформы с областями <code>openpipeline:logs:ingest</code> и <code>openpipeline:metrics:ingest</code>, или классический токен доступа с областями '''Приём логов''' (<code>logs.ingest</code>) и '''Приём метрик''' (<code>metrics.ingest</code>).

== Шаги ==
В этом примере мы развёртываем с помощью '''Docker''', чтобы упростить демонстрацию. Для производственных сценариев мы рекомендуем развёртывание в качестве шлюза на кластере '''Kubernetes'''.

Чтобы настроить экземпляр '''Ключ-АСТРОМ Collector''', создайте файл <code>otel-collector-config.yaml</code> и добавьте следующую конфигурацию:

=== Токен платформы ===
<pre>
receivers:
netflow:
scheme: netflow
port: 2055
sockets: 16
workers: 32
netflow/sflow:
scheme: sflow
port: 6343
sockets: 16
workers: 32

exporters:
otlp_http:
endpoint: "${env:DT_ENDPOINT}"
headers:
Authorization: "Bearer ${env:DT_PLATFORM_TOKEN}"
sending_queue:
batch:
min_size: 1800
max_size: 2000
flush_timeout: 60s

service:
pipelines:
logs:
receivers: [netflow, netflow/sflow]
processors: [batch]
exporters: [otlp_http]
telemetry:
logs:
level: debug
</pre>Требуемые области: <code>openpipeline:logs:ingest</code> и <code>openpipeline:metrics:ingest</code>.

=== Классический токен доступа ===
<pre>
receivers:
netflow:
scheme: netflow
port: 2055
sockets: 16
workers: 32
netflow/sflow:
scheme: sflow
port: 6343
sockets: 16
workers: 32

exporters:
otlp_http:
endpoint: "${env:DT_ENDPOINT}"
headers:
Authorization: "Api-Token ${env:DT_API_TOKEN}"
sending_queue:
batch:
min_size: 1800
max_size: 2000
flush_timeout: 60s

service:
pipelines:
logs:
receivers: [netflow, netflow/sflow]
processors: [batch]
exporters: [otlp_http]
telemetry:
logs:
level: debug
</pre>Проверьте документацию приёмника '''NetFlow''' для доступных параметров конфигурации.

Создайте файл <code>.env</code>, чтобы добавить переменные <code>DT_ENDPOINT</code> и либо <code>DT_PLATFORM_TOKEN</code>, либо <code>DT_API_TOKEN</code>.

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

Одна переменная токена, в зависимости от используемого типа токена:

* '''Токен платформы''': <code>DT_PLATFORM_TOKEN</code> содержит ваш токен платформы с областями <code>openpipeline:logs:ingest</code> и <code>openpipeline:metrics:ingest</code>.
* '''Классический токен доступа''': <code>DT_API_TOKEN</code> содержит ваш классический токен доступа с областями '''Приём логов''' (<code>logs.ingest</code>) и '''Приём метрик''' (<code>metrics.ingest</code>).

Убедитесь, что ваш файл <code>.env</code> должным образом защищён и не доступен неавторизованным лицам, так как он содержит конфиденциальную информацию.

=== Создание токена аутентификации ===
Для аутентификации создайте один из следующих:

'''Токен платформы:'''

# Перейдите в раздел '''Мои токены платформы'''.
# Создайте токен платформы с требуемой областью (указана ниже).

'''Классический токен доступа:'''

# Перейдите в раздел '''Токены доступа'''.
# Выберите '''Создать новый токен'''.
# Введите имя вашего токена.
# Выберите требуемые области, перечисленные ниже.
# Выберите '''Создать токен'''.
# Скопируйте созданный токен. Сохраните его в безопасном месте — вы можете получить к нему доступ только один раз.

'''Требуемые области:'''

* '''Токен платформы''': <code>openpipeline:logs:ingest</code>
* '''Классический токен доступа''': '''Приём логов''' (<code>logs.ingest</code>)

Запустите образ Collector в '''Docker''' с помощью следующей команды:<pre>
docker run -p 2055:2055 --env-file ./.dt_token.env -v $(pwd)/otel-collector-config.yaml:/etc/otelcol/otel-collector-config.yaml ghcr.io/astromkey/astromkey-otel-collector/astromkey-otel-collector:0.33.0 --config=/etc/otelcol/otel-collector-config.yaml
</pre>После завершения процесса вы можете начать запуск и обработку данных.

Если вы хотите, чтобы процесс работал в фоновом режиме, вы можете завершить его и запустить снова с опцией <code>-d</code>.

Направьте ваши сетевые устройства на отправку записей '''NetFlow''' в Collector.

Конфигурация сетевого устройства зависит от поставщика. Она должна указывать '''IP'''-адрес конечной точки '''Ключ-АСТРОМ''' и соответствующий '''UDP'''-порт.

== Визуализация и анализ данных ==

=== Анализ логов ===
Данные '''NetFlow''' принимаются как записи логов, которые можно запрашивать и визуализировать с помощью '''DQL'''. Вы можете использовать раздел '''Логи''', чтобы искать логи контейнеров, захваченные '''ЕдиныйАгент''' для Collector.

Аналогично, раздел '''Логи''' может помочь вам увидеть, что трафик действительно проходит.

=== Дашборды ===
Раздел '''Дашборды''' предоставляет готовый дашборд '''Обзор NetFlow''' в качестве точки входа для изучения и визуализации данных '''NetFlow'''. Он включает предварительно настроенные графики и метрики для анализа сетевого трафика, такие как топовые источники, назначения, разговоры и использование портов.

Дашборд можно использовать как основу для дальнейшей настройки. Вы также можете создавать пользовательские дашборды для визуализации данных '''NetFlow''', используя различные типы графиков.

=== Notebooks ===
'''Notebooks''' позволяет выполнять запросы и визуализировать данные '''NetFlow''' в интерактивном режиме. Вы можете открыть новый ноутбук из раздела '''Логи''', перейдя в '''Открыть с помощью''' и выбрав '''Notebooks'''.

=== Пример запроса DQL ===
Используя этот запрос '''DQL''', вы можете получить сводку байтов по '''IP'''-адресу и порту назначения:<pre>
fetch logs
| filter matchesValue(flow.type, "netflow_v9")
| summarize {totalBytes= sum(toLong(flow.io.bytes)),totalPackets=sum(toLong(flow.io.packets))}, by: {destination.address,destination.port}
| sort totalBytes desc
| limit 10
</pre>

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