[Spring] Actuator

Actuator

실행 중인 스프링 부트 애플리케이션의 정보를 API 형식으로 확인할 수 있게 해주는 기능입니다. 애플리케이션의 실행 여부, 패키지 로깅 레벨, Bean 목록, Metric(CPU, Heap, Thread 등) 등 여러 정보들을 확인할 수 있는 기능을 제공합니다.

🏷️ 사용법

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

 

maven의 경우 위의 dependency를 추가하여 사용하고

implementation 'org.springframework.boot:spring-boot-starter-actuator'

gradle의 경우 위와 같이 implementation합니다.

management.endpoints.web.exposure.include=*

application.properties파일을 위와 같이 설정을 하면 모든 엔드 포인트를 노출하게 됩니다.

 

위와 같이 설정 후 http://localhost:8080/actuator에 접속하게 되면

이와 같은 페이지에 접속하게 됩니다.

management.endpoints.web.exposure.include=health

노출하고 싶은 항목을 위와 같이 health로 지정하게 되면 다음과 같이 출력되도록 할 수 있습니다.

🏷️ actuator 조회 정보 

✅ /actuator/beans

애플리케이션에서 생성한 모든 스프링 빈

✅ /actuator/conditions

스프링 빈의 생성조건이 충족됐는지 여부 (Conditions Evaluation Report)

✅ /actuator/configprops

애플리케이션에서 액세스할 수 있는 모든 Environment속성

✅ /actuator/health

health정보(설정에 따라 기본 또는 확장)

✅ /actuaotr/heapdump

트러블슈팅과 분석을 위해 힙덤프 시작 

✅ /actuator/loggers

모든 컴포넌트의 로깅수준

✅ /actuator/mappings

모든 엔드포인트 매핑과 세부 지원 정보 

✅ /actuator/metrics

애플리케이션에서 현재 캡처 중인 메트릭스 

✅ /actuator/threaddump

트러블 슈팅과 분석을 위해 스레드 덤프 시작 

 

📖 Reference

Pli's 개발일기