События мониторинга#

Spring Actuator предоставляет несколько сервисных API endpoints, которые используются для мониторинга состояния приложения.

В панели Spring Boot Admin (компонент ssd-cloud-admin) отображаются все отслеживаемые Java компоненты, которые зарегистрированы в сервисе обнаружения (Eureka).

Список всех приложений в ssd-cloud-admin

В верхней области страницы отображается общее состояние всех зарегистрированных компонентов:

  • Приложения: количество зарегистрированных компонентов

  • Экземпляры: целевое количество реплик компонентов (по умолчанию каждый компонент запускается в единичном экземпляре)

  • Статус: краткое описание общего состояния системы.

    • Все доступны: целевое количество экземпляров равно числу работоспособных.

    • В случае отказа некоторого количества экземпляров, в блоке Статус появится надпись Экземпляры недоступны и число недоступных экземпляров.

Когда сервисы функционируют в штатном режиме, они находятся в секции со статусом ОК и имеют зеленую индикацию.

Если сервисные endpoints возвращают информацию об ошибках или сервис не отправлял информацию о своем статусе в течение времени, превышающем ожидаемый период, то в списке приложений он отображается в секции со статусом DOWN. Также в верхней панели количество недоступных экземпляров принимает значение, отличное от нуля.

Недоступное приложение в списке

Для просмотра деталей отдельного компонента нажмите на иконку его статуса и в развернувшейся вкладке кликните на серую область:

Навигация в панель компонента

В результате происходит перемещение в панель мониторинга компонента, на ее главной странице отображается следующая информация:

  • Мониторинговые endpoints Spring Boot Actuator.

  • Версия запущенного артефакта (Информация - build):

    • group — идентификатор группы Maven артефакта (sber.platform.ssdp для всех артефактов сервисов OneWork);

    • artifact — идентификатор имени Maven артефакта (совпадает с именем соответствующего компонента OneWork);

    • version — идентификатор версии Maven артефакта;

    • swagger-uri — URI страницы для доступа к API компонента через Swagger UI;

    • name — полное версии Maven артефакта (составляется из значений group, artifact, version);

    • time — время сборки артефакта.

  • Метаданные экземпляра компонента:

    • startup — время запуска.

  • Процесс — описание процесса на целевом хосте.

  • Паузы сборщика мусора — обзор статистики задействования сборщика мусора в JVM.

  • Потребление ресурсов:

    • Потоки — статистика Java-потоков, задействованных при выполнении приложения;

    • Память: Heap — статистика потребления памяти для Java-объектов в куче JVM;

    • Память: Non heap — статистика потребления памяти, не используемой для размещения Java-объектов, в куче JVM (информация загрузчиков классов, стеки вызовов и т.д.).

Панель мониторинга

Всего боковое меню мониторинга содержит 5 пунктов:

  • Анализ: информация о состоянии компонента и его окружения

  • Журналирование: доступ к журналам системных событий;

  • JVM: отслеживание состояния Java-машины, где запущен процесс, возможность снять дамп памяти;

  • Маппинги: спецификация (HTTP-метод, URL, тип возвращаемых данных) endpoints компонента (как сервисных, так и функциональных);

  • Кеши: доступ для просмотра и управления экземплярами кешей, управляемых с помощью Spring Cache, если такие существуют в компоненте.