Архитектура
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 создаются по запросу и отслеживаются до завершения |
Как измерение становится оповещением
- Сборщик выполняет проверку в назначенное время и отправляет результат в API по внутренней сети сервера. Источник вместо этого передает данные через опрос или веб-перехватчик.
- Сначала результат сохраняется, поэтому при сбое на следующем шаге ничего не теряется. Его значения записываются в историю метрик.
- Механизм оповещений сравнивает значение с действующими пороговыми значениями этой проверки для этого ресурса. Если условие выполняется в течение всего интервала
for, механизм открывает оповещение или обновляет уже открытое оповещение для того же условия. - Состояние ресурса пересчитывается, и веб-приложение показывает его при следующем обновлении.
- Этап уведомлений определяет, стоит ли изменение сообщения, находит каналы по дереву сущностей и записывает каждое сообщение в хронологию оповещения.
Шаги 3–5 подробно описаны в статье Оповещения и уведомления, а источник действующих пороговых значений — в статье Пороговые значения и базовые уровни.
Один сервер, шесть контейнеров
Все компоненты работают на одном сервере x86_64 с Rocky Linux 9 или 10 либо с другой системой семейства Red Hat Enterprise Linux. Минимальные требования: 2 виртуальных ЦП, 4 ГиБ памяти и 20 ГиБ свободного места на диске. Контейнеры работают без прав root в Podman от имени учетной записи службы (по умолчанию excubius) и запускаются вместе с сервером. Исходного кода на сервере нет: выпуск — это набор образов контейнеров и пакет развертывания, которые устанавливает и обновляет программа установки.
| Контейнер | Роль |
|---|---|
proxy | Единственный контейнер с открытыми портами 80 и 443. Он завершает TLS, направляет запросы в веб-приложение или API и ограничивает частоту веб-перехватчиков |
frontend | Обслуживает веб-приложение |
backend | API, нормализатор, механизм оповещений, уведомления, Jira и общедоступная страница состояния |
collector | Сборщик и опрос источников. Контейнер не открывает портов и получает только собственный токен и параметры, но никогда не получает пароль базы данных или ключ шифрования сохраненных секретов |
certs | Выпускает и продлевает сертификат TLS: Let's Encrypt, самозаверяющий или ваш собственный |
db | PostgreSQL 16 с TimescaleDB |
Сборщик обращается к API только по внутренней сети сервера: прокси отклоняет маршруты сборщика при обращении извне. Для исходящих подключений серверу нужен доступ по HTTPS к Slack, Jira и API ваших источников. Модуль обновлений также считывает общедоступные каналы со сборками и бюллетенями, а если сервер не может до них достучаться, использует копии, поставляемые с выпуском. В Azure назначьте управляемому удостоверению сервера роли только для чтения, например Reader и Monitoring Reader, чтобы сборщик считывал данные Azure без сохраненного секрета.
Настройте внешний монитор доступности на адрес https://<your host>/heartbeat. Пока сервер работает, адрес возвращает ok, поэтому вы узнаете, если сам Excubius перестанет работать.
Где что хранится
| Данные | Где | Как долго |
|---|---|---|
| Сущности, ресурсы, проверки, пороговые значения, пользователи и роли | База данных | Пока вы их не измените |
| Метрики | База данных, в гипертаблице TimescaleDB | 90 дней |
| Оповещения, замечания, их хронология, отметки о просмотре и назначения | База данных | Хранятся как история |
| Полезные данные веб-перехватчиков от источников | База данных | 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 не работает | Веб-перехватчики, отправленные за это время, теряются. Источники в гибридном режиме получают их при следующей сверке |