Создание и использование агентов KUMA
Скопировано

13 октября 2026

ID 217720

Создание и использование агентов KUMA

Агенты KUMA – это сервисы, которые используются для пересылки необработанных событий с серверов и рабочих станций в точки назначения KUMA.

Типы агентов:

  • wmi – используются для получения данных с удаленных устройств Windows с помощью Windows Management Instrumentation. Устанавливается на устройства Windows.
  • wec – используются для получения журналов Windows с локального устройства с помощью Windows Event Collector. Устанавливается на устройства Windows.
  • tcp – используются для получения данных по протоколу TCP. Устанавливается на устройства Linux и Windows.
  • udp – используются для получения данных по протоколу UDP. Устанавливается на устройства Linux и Windows.
  • nats-jetstream – используются для коммуникации через NATS. Устанавливается на устройства Linux и Windows.
  • kafka – используются для коммуникации с помощью kafka. Устанавливается на устройства Linux и Windows.
  • http – используются для связи по протоколу HTTP. Устанавливается на устройства Linux и Windows.
  • file – используются для получения данных из файла. Устанавливается на устройства Linux и Windows.
  • ftp – используются для получения данных по протоколу File Transfer Protocol. Устанавливается на устройства Linux и Windows.
  • nfs – используются для получения данных по протоколу Network File System. Устанавливается на устройства Linux и Windows.
  • snmp – используются для получения данных с помощью Simple Network Management Protocol. Устанавливается на устройства Linux и Windows.
  • diode – используются вместе с диодами данных для получения событий из изолированных сегментов сети. Устанавливается на устройства Linux и Windows.
  • etw – используются для получения данных Event Tracing for Windows. Устанавливается на устройства Windows.

Создание агента состоит из следующих этапов:

  1. Создание набора ресурсов агента в веб-интерфейсе
  2. Создание сервиса агента в веб-интерфейсе
  3. Установка серверной части агента на устройстве, с которого требуется передавать события

Агенты KUMA для устройств Windows можно создать следующим образом:

  • Создать вручную путем создания набора ресурсов агента и создания сервиса агента в веб-интерфейсе KUMA.
  • Создать автоматически при создании коллектора с типом транспорта wmi, wec или etw. Набор ресурсов и сервис таких агентов создаются в мастере установки коллектора, однако их все равно требуется установить на устройстве, с которого требуется передать события. В созданном вручную агенте коннектор с типом etw следует использовать только в одном подключении. Если вы настроите несколько подключений в созданном вручную агенте etw, статус агента etw будет зеленым, но события не будут передаваться и в журнале агента etw будет ошибка.

На одном устройстве может быть установлено несколько агентов, при этом все агенты должны быть одной версии.

Если на устройстве, где вы планируете создать агент, уже есть установленный агент более старой версии, требуется сначала остановить установленный агент (удалить агент с устройства Windows или перезапустить сервис агента для Linux), а затем можно создавать новый агент. При этом если установлены агенты той же версии, что и планируется создать, остановка агентов не требуется.

При создании и запуске агента версии 3.0.1 и более поздних версий требуется принять условия Лицензионного соглашения.

В конфигурации, где сервисы Ядра KUMA объединены в кластер Raft, все операции управления агентами (например, перезапуск) следует выполнять с того хоста, к которому агент подключен в текущий момент. Агент подключается к первому доступному Ядру KUMA из списка хостов, указанного в его конфигурации. Поэтому перед выполнением операции необходимо определить, к какому Ядру KUMA подключен агент, и выполнять операцию с соответствующего хоста. Например, если в конфигурации агента хосты перечислены в порядке 3, 2, 1, а хост 3 недоступен, агент подключится к Ядру KUMA на хосте 2. В этом случае все операции управления агентом необходимо выполнять с хоста 2.

Вам помогла эта статья?
Что нам нужно улучшить?
Спасибо за ваш отзыв, вы помогаете нам становиться лучше!
Спасибо за ваш отзыв, вы помогаете нам становиться лучше!