13 октября 2026
ID 245497
Передача в KUMA событий с машин Windows
Для передачи событий с машин Windows в KUMA используются агент и коллектор KUMA. Передача данных выполняется следующим образом:
- Установленный на машине агент KUMA получает события Windows с помощью одного из коннекторов:
- WEC. Агент получает события, поступающие на хост по подписке (subscription), и журналы сервера.
- WMI. Агент подключается к удаленным серверам, указанным в конфигурации, и получает события.
- ETW. Агент использует для подключения к DNS-серверу имя сессии и провайдера, указанные в параметрах коннектора, и получает события.
- Агент без предварительной обработки передает события коллектору KUMA, указанному в точке назначения.
Можно настроить агент таким образом, чтобы разные журналы отправлялись в разные коллекторы.
- Коллектор принимает события от агента, выполняет полный цикл обработки события и отправляет обработанные события в точку назначения.
Об использовании агентов
Настроить получение событий с устройств Windows с помощью Агента KUMA (WEC) рекомендуется при использовании централизованного получения событий c хостов Windows с помощью технологии Windows Event Forwarding (WEF) (подробнее о Windows Event Forwarding см. в официальной документации Microsoft). Агент нужно установить на сервер, который выполняет сбор событий и который будет выполнять функции Windows Event Collector (WEC). Мы не рекомендуем устанавливать агенты KUMA на каждый конечный хост, с которого планируется получать события.
Настроить получение событий с помощью агента Агента KUMA (WMI) рекомендуется в следующих случаях:
- Отсутствует возможность использовать технологию WEF для реализации централизованного сбора событий, а также на сервере-источнике событий (например, агент KUMA) запрещено устанавливать стороннее программное обеспечение.
- Требуется выполнить сбор событий с небольшого количества хостов (не более 500 хостов для одного агента KUMA).
Агент ETW используется только для получения событий из журналов Windows DNS-серверов.
Для подключения журналов Windows в качестве источника событий рекомендуется использовать мастер Подключить источник. При использовании мастера в процессе создания коллектора с коннекторами типами WEC и WMI автоматически создаются агенты для приема событий Windows. Также ресурсы, необходимые для сбора событий Windows, можно создать вручную.
Создание и установка агента и коллектора KUMA
Создание и установка агента и коллектора для получения событий Windows состоит из следующих этапов:
- Создание набора ресурсов агента
Коннектор агента:
При создании агента на вкладке Подключение создайте или выберите коннектор типа WEC, WMI или ETW.
Если хотя бы одно название журнала Windows указано в коннекторе типа WEC или WMI с ошибкой или сервер WMI недоступен, агент будет получать события из всех перечисленных в коннекторе журналов Windows, кроме проблемного. При этом статус агента будет зеленый. Попытки получить события будут повторяться каждые 60 секунд, сообщения об ошибке будут добавляться в журнал сервиса.
Точка назначения агента:
Тип точки назначения агента зависит от используемого вами способа передачи данных:
nats-jetstream,tcp,http,diode,kafka,file.В качестве разделителя в точке назначения используйте значение
\0.Дополнительные параметры точки назначения агента (например, разделитель, сжатие и режим TLS) должны совпадать с дополнительными параметрами коннектора коллектора, с которым вы связываете агент.
- Создание сервиса агента в веб-интерфейсе KUMA
- Установка агента KUMA на машине Windows, с которой вы хотите получать события Windows
Перед установкой убедитесь, что компоненты системы имеют доступ к сети и откройте необходимые сетевые порты:
- Порт 7210, протокол TCP – от сервера с коллекторами к Ядру.
- Порт 7210, протокол TCP – от сервера агента к Ядру.
- Порт, указанный при создании коннектора в поле URL – от сервера агента к серверу с коллектором.
- Создание и установка коллектора KUMA
При создании набора ресурсов коллектора на шаге Транспорт создайте или выберите существующий коннектор, с помощью которого коллектор будет получать события от агента. Тип коннектора должен совпадать с типом точки назначения агента.
Дополнительные параметры коннектора, такие как разделитель, сжатие и режим TLS, должны совпадать с дополнительными параметрами точки назначения агента, с которой вы хотите связать агент.