Spring Boot Actuator: 애플리케이션 모니터링과 관리 강화

Spring Boot Actuator는 실행 중인 Spring Boot 애플리케이션을 모니터링하고 관리하는 데 필수적인 기능을 제공하는 Spring Boot의 하위 프로젝트입니다. Actuator는 애플리케이션의 다양한 메트릭스를 제공하고, 애플리케이션의 내부 상태를 파악할 수 있는 여러 엔드포인트를 노출합니다. 이 글에서는 Spring Boot Actuator의 주요 기능, 설정 방법 및 실제 사용 예시에 대해 알아보겠습니다.

Spring Boot Actuator의 주요 기능

• 애플리케이션 상태 정보 제공: Actuator는 애플리케이션의 건강 상태, 메트릭스, 환경 설정, 로깅 정보 등을 실시간으로 제공합니다.
• 커스텀 메트릭스: 개발자는 Actuator를 통해 커스텀 메트릭스를 정의하고, 애플리케이션의 특정 지표를 모니터링할 수 있습니다.
• 애플리케이션 관리: Actuator 엔드포인트를 통해 애플리케이션의 로깅 레벨을 동적으로 변경하거나, 애플리케이션을 재시작하는 등의 관리 작업을 수행할 수 있습니다.

Actuator 설정하기

Spring Boot Actuator를 사용하기 위해서는 의존성을 프로젝트에 추가해야 합니다. Maven 기반 프로젝트의 경우, pom.xml 파일에 다음과 같이 의존성을 추가합니다.

 

<dependencies>
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-actuator</artifactId>
    </dependency>
</dependencies>

 

Actuator 엔드포인트

Actuator는 다양한 엔드포인트를 제공하는데, 기본적으로 몇몇 엔드포인트는 활성화되어 있고, 다른 엔드포인트는 수동으로 활성화해야 합니다. application.properties 또는 application.yml 파일에서 엔드포인트를 활성화하거나 비활성화할 수 있습니다.

 

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

 

위의 설정은 health, info, metrics 엔드포인트를 노출합니다.

Actuator를 통한 모니터링과 관리

Health 정보 확인

/actuator/health 엔드포인트는 애플리케이션의 건강 상태를 확인할 수 있습니다. 데이터베이스 연결, 디스크 공간, 애플리케이션 에러 등 다양한 건강 지표를 확인할 수 있습니다.

메트릭스 정보 확인

/actuator/metrics 엔드포인트는 애플리케이션의 성능 지표를 제공합니다. JVM 메모리 사용량, 스레드 상태, HTTP 요청 통계 등을 확인할 수 있습니다.

실제 사용 예시: 메모리 사용량 모니터링

@GetMapping("/actuator/metrics/jvm.memory.used")
public Object getJvmMemoryUsed() {
    // Actuator 엔드포인트를 호출하여 JVM 메모리 사용량 정보를 반환
}

결론

Spring Boot Actuator는 운영 중인 Spring Boot 애플리케이션의 모니터링과 관리를 위한 강력한 도구입니다. Actuator를 활용하면 애플리케이션의 건강 상태를 실시간으로 파악하고, 성능 지표를 모니터링하며, 필요한 관리 작업을 수행할 수 있습니다. Actuator의 다양한 엔드포인트를 통해 개발자와 운영 팀은 애플리케이션의 상태를 더욱 효과적으로 관리할 수 있습니다.