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

Архитектура

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

Excubius работает как небольшой набор контейнеров на одном сервере Linux под вашим управлением. Сборщик, работающий только для чтения, и инструменты мониторинга, которые у вас уже есть, передают данные в единый конвейер. Конвейер превращает все данные в ресурсы, состояния и оповещения, сохраняет их в одной базе данных и передает веб-приложению, в Slack, в Jira и на общедоступную страницу состояния. В этой статье описаны все компоненты, путь от измерения до оповещения, устройство сервера и место хранения каждого типа данных.

Компоненты и связи между ними​

КомпонентНазначение
СборщикВыполняет проверки из каталога для ваших систем: T-SQL для SQL Server, HTTP и DNS для конечных точек, сертификатов и доменов, API Azure и Microsoft Graph, а также поиск в Wazuh. Работа с Windows через WinRM и с Linux через SSH находится на экспериментальной стадии. Сборщик также опрашивает ваши инструменты. Он подключается с учетными данными без прав на запись и хранит результаты в буфере, пока сервер занят или перезапускается
ИсточникиNew Relic, NinjaOne и Azure Monitor; данные каждого источника считываются опросом, через веб-перехватчик или обоими способами. Их данные попадают в тот же конвейер, что и результаты сборщика, поэтому их оповещения приходят в те же входящие оповещения и в те же каналы
НормализаторПриводит любые входные данные к одной из трех форм: ресурс, результат проверки или оповещение. Ресурсы из разных источников сопоставляются по идентификаторам, например по идентификатору ресурса Azure, имени узла и полному доменному имени (FQDN), поэтому один сервер, который видят три инструмента, — это один ресурс
Механизм оповещенийСравнивает каждый результат с действующими пороговыми значениями; открывает, повышает и разрешает оповещения; устраняет дубликаты; группирует оповещения по первопричине; задерживает уведомления, пока они отключены или идет окно обслуживания; определяет состояние каждого ресурса
База данныхPostgreSQL 16 с TimescaleDB хранит все: конфигурацию, ресурсы, метрики, оповещения с их хронологией, замечания и журнал аудита
API и веб-приложениеAPI обслуживает веб-приложение и проверяет каждый запрос по вашей роли в сущности, к которой он относится. Веб-приложение работает в любом современном браузере и устанавливается на телефон или планшет. Общедоступная страница состояния строится только из того, что администраторы решили опубликовать
УведомленияСообщения Slack отправляются сразу после сохранения результатов, а фоновая обработка каждые 15 секунд отправляет то, что пришлось отложить. Медленная работа или недоступность Slack никогда не задерживает мониторинг. Задачи Jira создаются по запросу и отслеживаются до завершения

Как измерение становится оповещением​

  1. Сборщик выполняет проверку в назначенное время и отправляет результат в API по внутренней сети сервера. Источник вместо этого передает данные через опрос или веб-перехватчик.
  2. Сначала результат сохраняется, поэтому при сбое на следующем шаге ничего не теряется. Его значения записываются в историю метрик.
  3. Механизм оповещений сравнивает значение с действующими пороговыми значениями этой проверки для этого ресурса. Если условие выполняется в течение всего интервала for, механизм открывает оповещение или обновляет уже открытое оповещение для того же условия.
  4. Состояние ресурса пересчитывается, и веб-приложение показывает его при следующем обновлении.
  5. Этап уведомлений определяет, стоит ли изменение сообщения, находит каналы по дереву сущностей и записывает каждое сообщение в хронологию оповещения.

Шаги 3–5 подробно описаны в статье Оповещения и уведомления, а источник действующих пороговых значений — в статье Пороговые значения и базовые уровни.

Один сервер, шесть контейнеров​

Все компоненты работают на одном сервере x86_64 с Rocky Linux 9 или 10 либо с другой системой семейства Red Hat Enterprise Linux. Минимальные требования: 2 виртуальных ЦП, 4 ГиБ памяти и 20 ГиБ свободного места на диске. Контейнеры работают без прав root в Podman от имени учетной записи службы (по умолчанию excubius) и запускаются вместе с сервером. Исходного кода на сервере нет: выпуск — это набор образов контейнеров и пакет развертывания, которые устанавливает и обновляет программа установки.

КонтейнерРоль
proxyЕдинственный контейнер с открытыми портами 80 и 443. Он завершает TLS, направляет запросы в веб-приложение или API и ограничивает частоту веб-перехватчиков
frontendОбслуживает веб-приложение
backendAPI, нормализатор, механизм оповещений, уведомления, Jira и общедоступная страница состояния
collectorСборщик и опрос источников. Контейнер не открывает портов и получает только собственный токен и параметры, но никогда не получает пароль базы данных или ключ шифрования сохраненных секретов
certsВыпускает и продлевает сертификат TLS: Let's Encrypt, самозаверяющий или ваш собственный
dbPostgreSQL 16 с TimescaleDB

Сборщик обращается к API только по внутренней сети сервера: прокси отклоняет маршруты сборщика при обращении извне. Для исходящих подключений серверу нужен доступ по HTTPS к Slack, Jira и API ваших источников. Модуль обновлений также считывает общедоступные каналы со сборками и бюллетенями, а если сервер не может до них достучаться, использует копии, поставляемые с выпуском. В Azure назначьте управляемому удостоверению сервера роли только для чтения, например Reader и Monitoring Reader, чтобы сборщик считывал данные Azure без сохраненного секрета.

подсказка

Настройте внешний монитор доступности на адрес https://<your host>/heartbeat. Пока сервер работает, адрес возвращает ok, поэтому вы узнаете, если сам Excubius перестанет работать.

Где что хранится​

ДанныеГдеКак долго
Сущности, ресурсы, проверки, пороговые значения, пользователи и ролиБаза данныхПока вы их не измените
МетрикиБаза данных, в гипертаблице TimescaleDB90 дней
Оповещения, замечания, их хронология, отметки о просмотре и назначенияБаза данныхХранятся как история
Полезные данные веб-перехватчиков от источниковБаза данных30 дней
История оценки безопасностиБаза данныхОдин снимок в час в течение 14 дней, затем один в день в течение 400 дней
Журнал аудитаБаза данныхХранится
Учетные данные и секреты источниковБаза данных, в зашифрованном виде; ключ хранится только в файле конфигурации сервераПока вы их не замените или не удалите
Конфигурация сервера: пароль базы данных, секрет для подписи сеансов, ключ шифрования, токен сборщикаФайл .env в каталоге установки (по умолчанию /opt/excubius)Создается программой установки один раз
Сертификат TLSТом контейнера certsПродлевается автоматически, когда до истечения срока остается 30 дней или меньше
Резервные копии базы данныхПапка backups в каталоге установки: дамп каждый день в 02:30 по времени сервераПоследние 14 дампов

Секреты доступны только для записи: после сохранения никто не может прочитать их обратно ни в веб-приложении, ни через API. Дамп базы данных сам по себе не раскрывает ни одного секрета, потому что ключа в базе данных нет. По той же причине храните копию файла .env вместе с резервными копиями, иначе после восстановления базы данных сохраненные секреты придется ввести заново. Копируйте ежедневные резервные копии за пределы сервера в рамках обычного резервного копирования сервера; восстановление описано в статье Обновление, резервное копирование и восстановление.

Только для чтения по своей архитектуре​

Excubius обнаруживает, объясняет и предлагает, но никогда не изменяет отслеживаемую систему.

  • Имена входа для мониторинга и учетные данные API создаются без прав на запись и установку. Имени входа SQL Server никогда не нужна роль sysadmin.
  • Замечания безопасности и бюллетени обновлений содержат предлагаемое действие в виде текста, которое человек выполняет в окне изменений. Ничего не выполняется и ничего не устанавливается.
  • В New Relic, NinjaOne, Azure, Microsoft Entra ID и Wazuh ничего не записывается.
  • Удаление ресурса в Excubius удаляет его проверки, метрики и оповещения только в Excubius. Отслеживаемая система не затрагивается.

Если что-то выходит из строя​

СбойЧто делает Excubius
API источника недоступенИсточник помечается как устаревший и показывает ошибку. Неудачный опрос ничего не разрешает, и никакие оповещения не создаются на пустом месте
Сборщик не может подключиться к ресурсуПосле трех ошибок подключения, входа или времени ожидания подряд ресурс переходит в состояние Критическое с одним оповещением Cannot reach, а остальные оповещения ресурса ждут за ним
API или база данных ненадолго недоступныСборщик сохраняет результаты и отправляет их позже. Результат, отправленный дважды, сохраняется один раз
Slack недоступенМониторинг продолжается. Неотправленное сообщение записывается в оповещение и отправляется повторно, всего три попытки
Сервер Excubius не работаетВеб-перехватчики, отправленные за это время, теряются. Источники в гибридном режиме получают их при следующей сверке