Spring Boot Actuator 기본 설정 및 사용법 - 1

1. Actuator란?

• Spring Boot Actuator는 Spring Boot 애플리케이션의 상태, 메트릭, 운영 정보를 쉽게 모니터링하고 관리 할 수 있게 해주는 도구
• 주요 기능: 애플리케이션 상태 점검, 메트릭 수집, 헬스 체크 등

2. Actuator 주요 Endpoint

Endpoint	URL	설명	비고
health	/actuator/health	앱 및 구성 요소 상태 점검	기본 노출, 상세 정보 설정 가능
info	/actuator/info	빌드 정보, 메타데이터 표시	사용자 정의 가능
metrics	/actuator/metrics	성능 메트릭 목록	Prometheus 연동 시 중요
loggers	/actuator/loggers	로그 레벨 조회 및 변경	운영 중 로그 레벨 조정에 활용
env	/actuator/env	환경 변수 조회	보안상 주의 필요

3. 기본 설정 방법

• build.gradle Actuator 의존성 추가
• application.yml 최소 설정 예시

management:
  endpoints:
    web:
      exposure:
        include: health, info, metrics

4. Endpoint 확인하기

• http://localhost:8080/actuator 접속하면 나오는 Endpoint 목록 확인
• actuator/health 호출 예시 및 결과 설명

5. 운영 시 보안 팁

• 최소한 필요한 Endpoint만 노출
• management.endpoint.web.exposure.include 활용
• IP 필터링 등 간단한 제한 방법