D/ DOBBYDEV DOCS

BLACKHOLE / DOCUMENTATION

Документация Blackhole

Понятные инструкции по настройке, работе и обслуживанию системы.

Руководство / 19

Мониторинг компонентов узла

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

Как открыть мониторинг

  1. Откройте «Инфраструктура → Узлы кластера» и выберите нужный узел.
  2. Нажмите «Компоненты этого узла», затем название службы в таблице. Откроется подробный мониторинг выбранного контейнера.
  3. Для нового снимка нажмите «Обновить показания». Список находится по /ui/nodes/{node-id}/components, подробности — по /ui/nodes/{node-id}/components/{component-id}. Идентификаторы берутся из настроенного оператором списка; произвольный URL агента вводить нельзя.

Экран списка компонентов

Обезличенный пример таблицы состояний почтовой службы и LumosLink
Актуальная таблица компонентов, снятая 8 октября 2026 года. Службы, состояния и значения искусственные и не показывают рабочую установку.

Состояние и healthcheck

Таблица показывает подтверждённые контейнеры: название службы, состояние Docker, результат healthcheck, версию ПО и релиз Blackhole. Нажмите название для открытия ресурсов и подробностей образа. Службы, наличие которых не удалось проверить, вынесены в отдельную таблицу; подтверждённо отсутствующие компоненты — в свёрнутый каталог. «Запущен» означает состояние процесса контейнера. «Проверка пройдена» — успешный healthcheck этого контейнера, но не доказательство доставки почты или готовности резерва. «Ошибка healthcheck» требует проверки службы, даже если она запущена. «Healthcheck не настроен» не считается успешной проверкой.

Разрешённый список и ненастроенный агент

Отображаются только компоненты, разрешённые оператором для выбранного узла. Пустой список не доказывает отсутствие других контейнеров на хосте. «Наблюдение за компонентами не настроено» означает, что мониторинг хоста доступен, но отдельное чтение компонентов ещё не включено. Автоматическое обнаружение всех контейнеров не выполняется.

Экран ресурсов отдельной службы

Обезличенный мониторинг контейнера: состояние, CPU, память, процессы, сеть, диск и идентичность образа
Метрики, время и идентификаторы искусственные. Пример различает измеренный ноль, отсутствие данных и неизвестную версию; он не показывает состояние рабочей установки.

Как читать показатели ресурсов

  1. CPU: 100% соответствует одному ядру; на нескольких ядрах значение может превышать 100%.
  2. Память / лимит Docker: использование включает файловый кэш. Лимит относится к контейнеру, а не к квоте почтового ящика.
  3. Процессы и потоки: счётчик PIDs текущего контейнера.
  4. Сеть: принято / отправлено — накопленные байты, не текущая скорость передачи.
  5. Диск: прочитано / записано — блочный ввод-вывод, не размер писем и не свободное место.
  6. «Нет данных» не равно нулю: источник не предоставил измерение. Измеренный ноль отображается как ноль. У остановленного контейнера либо при неподтверждённой идентичности ресурсы могут не отображаться.

Версии и идентичность образа

«Неизвестна» означает отсутствие нужной метки. Версия не подставляется из тега или соседнего контейнера. В подробностях отдельно показаны версия ПО, релиз Blackhole, версия OCI, revision, ID образа и платформа. Это метки конкретного наблюдаемого образа, а не проверка версии работающего бинарника или совместимости обновления. ID образа не является digest манифеста реестра.

Свежесть и замена контейнера

Время наблюдения указано в UTC. Консоль проверяет пятисекундный срок свежести перед показом; статистика Docker могла быть измерена до 30 секунд до наблюдения. Открытая страница остаётся снимком на момент запроса, а не постоянно обновляемой историей. Нажмите «Обновить показания» для нового измерения. Метрики привязаны одновременно к полным ID контейнера и образа: после замены контейнера показатели не объединяются со старой карточкой, а просроченный ответ не получает новое время измерения.

Если наблюдение недоступно

Обновите показания. Если ошибка сохраняется, оператору следует проверить доступность доверенного агента, TLS-настройки и разрешённый список служб. Недоступность агента сама по себе не доказывает остановку всех почтовых сервисов. Не подставляйте нули и не ослабляйте проверку сертификатов для обхода ошибки.

Права и границы мониторинга

Просмотр требует глобального security.configuration.read: системный администратор и куратор ИБ с соответствующим правом могут читать сведения. Администратор отдельного почтового домена этого доступа автоматически не получает. Страница не раскрывает секреты, окружение, журналы, Docker socket или содержимое томов. Установка, перезапуск и переключение роли здесь недоступны. Успешный healthcheck не подтверждает репликацию данных, актуальную резервную копию или готовность резервного узла принять запись.

Обезличенные иллюстрации

Скриншоты сделаны в браузере 8 октября 2026 года из принятых шаблонов интерфейса 6.0.0-rc.12 на искусственных данных документации. Названия, учётные записи, идентификаторы и значения метрик вымышлены. Предпросмотр не имел рабочей сессии и не обращался к агентам или базе; это не проверка входа в рабочую админку.