Перейти к основному содержимому
Версия: 0.4 · текущая

Как работает сборщик

КонцепцияПроверено 11 октября 2026 г.
Область применения:Excubius 0.4Роли: Администратор сущности, Установщик (администратор Linux)
ПланыFree · Core · Pro · EnterpriseРазвертываниеСамостоятельное размещение

Сборщик — это часть Excubius, которая подключается к вашим системам. Он выполняет проверки из каталога через подключения только для чтения, считывает данные из добавленных вами источников и отправляет необработанные результаты в API, который оценивает их, создает оповещения и отправляет уведомления. В этой статье объясняется, как работает сборщик, какие транспорты он использует, что нужно каждому модулю, какие сетевые пути нужно открыть и чего сборщик никогда не делает.

Как выполняется проверка​

  1. Каждые 30 секунд сборщик запрашивает у API, что нужно выполнить: определения проверок из каталога, ресурсы, на которые они нацелены, и используемые ими учетные данные. Если ничего не изменилось, ответ пуст и почти ничего не стоит.
  2. Сборщик выполняет каждую проверку с ее интервалом через транспорт, указанный в каталоге, например T-SQL для экземпляра SQL Server или HTTP для веб-адреса.
  3. Сборщик отправляет необработанные результаты в API пакетами. API сравнивает их с действующими пороговыми значениями, открывает и разрешает оповещения и уведомляет нужные каналы.
  4. Каждые 10 секунд сборщик получает разовые задания, например Test connection, Discover, а также Test и Sync now для источника. Каждые 60 секунд он отправляет пульс, который отображается в зоне Sources панели мониторинга Overview.

Сборщик работает внутри сервера Excubius рядом с API. Он получает только собственный токен и параметры; он никогда не видит пароль базы данных или ключ, которым шифруются хранимые секреты. Учетные данные поступают к нему по внутренней сети, хранятся в памяти и никогда не записываются в журналы.

Транспорты​

Транспорт — это способ, которым сборщик взаимодействует с системами одного вида. Каждый транспорт только читает данные.

ТранспортК чему подключаетсяПортВид учетных данныхСостояние
T-SQL (Microsoft ODBC Driver 18)Экземпляры SQL Server, группы доступности, связанные серверы, журнал выполнения Reporting Services1433 или порт экземпляра; UDP 1434 для именованных экземпляров без фиксированного портаИмя входа SQLПоддерживается
HTTP(S)Веб-адреса, порталы Reporting Services, сертификаты TLS, сроки регистрации доменов (RDAP)443, 80Нет, учетная запись Windows (NTLM), пользователь и пароль HTTP, токен BearerПоддерживается
DNSРазрешение имен конечных точек и прослушивателей групп доступности с помощью сопоставителя сервера53НетПоддерживается
Azure Resource GraphПроверки состояния облака, оценки Defender for Cloud, Azure Update Manager, Service Health443Управляемое удостоверение сервера или субъект-служба AzureПоддерживается
Microsoft GraphПроверки удостоверений Entra ID443Управляемое удостоверение сервера или субъект-служба AzureПоддерживается
WazuhИндексатор Wazuh и, при необходимости, API диспетчераЗаданные вами URL-адресаПользователь и пароль HTTPПоддерживается, когда Wazuh включен
WinRMПроверки узлов Windows, проверки Active Directory5986 (HTTPS)Учетная запись WindowsЭкспериментально
SSHПроверки узлов Linux22 или ssh_port узлаКлюч SSH, пароль SSHЭкспериментально
PostgreSQLПроверки модуля PostgreSQL5432Имя входа SQLПока недоступно: проверки добавляются, но остаются в состоянии Неизвестно
внимание

Транспорты WinRM и SSH существуют, и их проверки добавляются к узлам Windows и Linux, но они еще не проверены на реальных узлах. Для таких узлов используйте NinjaOne, New Relic или Azure Monitor в качестве источника, пока в одном из выпусков эти транспорты не будут отмечены как поддерживаемые.

Источники тоже считывает сборщик по HTTPS (443), и для каждого из них есть собственный адаптер: New Relic через NerdGraph, NinjaOne через общедоступный API, а Azure Monitor через Azure Resource Manager, Resource Graph, Azure Monitor, Data Factory, Key Vault и Microsoft Graph. См. статью Источники.

По умолчанию сборщик предлагает все транспорты, библиотеки которых есть в его образе. EXCUBIUS_COLLECTOR_TRANSPORTS сужает этот список; см. статью Переменные среды.

Что нужно каждому модулю​

МодульИсточник данныхЧто вы предоставляете
SQL Server, группы доступности, безопасность SQL ServerT-SQLИмя входа SQL только для чтения на каждом экземпляре и каждой реплике
WindowsWinRM (экспериментально) или New Relic и NinjaOneУчетная запись Windows в трех локальных группах с правами чтения или источник
LinuxSSH (экспериментально) или New Relic и NinjaOneПользователь без прав root с ключом или источник
PostgreSQLСобственный сбор пока недоступен; гибкие серверы Azure через Azure MonitorРоль с pg_monitor, подготовленная к появлению сбора
Azure, Azure Data FactoryИсточник Azure MonitorReader и Monitoring Reader, а также роль Data Factory только для чтения
Синтетические проверкиHTTP, DNS, T-SQLУчетные данные только для защищенных конечных точек и серверов отчетов
Сроки действияAzure Monitor, HTTP (RDAP), T-SQL, WinRMРазрешения на чтение для Key Vault и Microsoft Graph
ОбновленияКаналы поставщиков, которые считывает API, а также проверки инвентаризацииИсходящий доступ по HTTPS с сервера к каналам
Безопасность удостоверенийMicrosoft Graph, WinRMРазрешения приложения Graph только для чтения
Безопасность облакаResource Graph, Defender for Cloud, WazuhReader и Security Reader; пользователь Wazuh только для чтения
New Relic, NinjaOneСоответствующий источникКлюч или клиент API только для чтения

Все разрешения в одном месте: Разрешения.

Сетевые пути​

Каждое подключение начинается на сервере Excubius. К сборщику ничто не подключается.

КудаПортДля чего
Каждый экземпляр SQL Server, реплика, имя прослушивателя и IP-адрес прослушивателяПорт SQL, по умолчанию 1433Модули SQL Server, группы доступности, синтетические циклы обращения к SQL
Именованные экземпляры без фиксированного портаUDP 1434Обозреватель SQL Server (SQL Server Browser)
Веб-адреса и порталы Reporting Services443, 80Синтетические проверки, сертификаты TLS
DNS-сопоставитель сервера53Проверки разрешения имен
data.iana.org и серверы RDAP регистратур443Сроки регистрации доменов
Узлы Windows5986WinRM (экспериментально)
Узлы Linux22SSH (экспериментально)
management.azure.com, graph.microsoft.com, ваши хранилища ключей (*.vault.azure.net) и login.microsoftonline.com, если вы используете субъект-службу443Источник Azure Monitor, проверки состояния Azure и удостоверений
api.newrelic.com или api.eu.newrelic.com443Источник New Relic
app.ninjarmm.com или eu., oc. либо ca.ninjarmm.com443Источник NinjaOne
Индексатор и диспетчер WazuhИх портыWazuh

Каналы обновлений загружает API, а не сборщик, и со Slack и Jira тоже взаимодействует API; см. статью Переменные среды. Веб-перехватчики от источников поступают на публичный адрес сервера через порт 443 и передаются API, но никогда не сборщику.

Ограничения и время ожидания​

ОграничениеЗначение
Одновременно выполняемые проверкиВсего 32; по транспортам: T-SQL 8, HTTP и DNS 16, SSH 8, WinRM 4, Resource Graph 4, Defender, Microsoft Graph и Wazuh 2
Время ожидания входа SQL Server · время ожидания запроса10 с · 30 с (параметры каталога timeout_seconds, query_timeout_seconds)
Строк, считываемых за один запрос1000
Максимальная длительность одной проверки120 с
Результаты, хранимые, пока API недоступен10 000; первыми удаляются самые старые

Сеансы SQL Server используют имя приложения monitoring-collector, поэтому администраторы баз данных могут распознать их в sys.dm_exec_sessions.

Чего сборщик никогда не делает​

Сборщик работает только в режиме чтения как по способу подготовки, так и по коду. Он никогда ничего не устанавливает, не обновляет, не перезапускает и не останавливает, никогда не записывает данные, реестр или конфигурацию, никогда не завершает сеансы и никогда не выполняет исправления. Проверка, которой потребовалась бы запись, отклоняется при рассмотрении для каталога.

Что сборщик отправляет:

  • SQL Server: SELECT к динамическим административным представлениям, представлениям каталога, таблицам резервного копирования и заданий в msdb и к ExecutionLog3 сервера отчетов; sys.sp_readerrorlog в табличную переменную; sp_testlinkedserver для связанных серверов.
  • HTTP: только GET и HEAD.
  • Azure и Wazuh: операции чтения, а также несколько запросов POST, которые являются запросами на выборку, например запрос Resource Graph, запрос запусков Data Factory или _search в Wazuh. Все остальное отклоняется в коде.
  • WinRM и SSH: команды PowerShell и оболочки, записанные в каталоге, которые только читают данные.

Точный запрос каждой проверки приведен в каталоге и в API по адресу GET /api/v1/catalog/checks/{id}.

Агенты для дополнительных источников​

Excubius ничего не устанавливает в отслеживаемых системах. Агенты дополнительных источников, например Wazuh, развертываются вашими собственными средствами, например NinjaOne или вашей системой управления конфигурацией.

Дальнейшие действия​