Actuator

Базовый Spring
≈ 1 мин чтения

Технический взгляд на работающее приложение

После запуска приложения важно понимать не только «отвечает ли оно на запросы», но и жив ли процесс, какие параметры доступны для наблюдения и что происходит с инфраструктурой. Spring Boot Actuator добавляет готовые технические endpoints для таких задач.

dependencies {
    implementation("org.springframework.boot:spring-boot-starter-actuator")
}

После подключения starter приложение получает набор actuator-возможностей. Один из самых известных endpoints — /actuator/health, который показывает состояние приложения. Также доступны данные о метриках и другая диагностическая информация, если соответствующие endpoints включены.

Открывай только то, что действительно нужно

management.endpoints.web.exposure.include=health,info,metrics

Настройка явно перечисляет endpoints, которые должны быть доступны через HTTP. В production такие endpoints обычно рассматривают как часть административного интерфейса, а не как публичный API для всех пользователей.

Не включай наружу все actuator endpoints «на всякий случай». Диагностическая информация может раскрывать устройство приложения и его окружения. Набор доступных endpoints и правила доступа должны быть осознанными.