spring actuator를 활용한 회복탄력성 관리(2)

Spring Boot Actuator는 Spring Boot 애플리케이션의 런타임 정보를 모니터링하고 관리하기 위한 기능을 제공하는 라이브러리입니다. 애플리케이션의 상태, 건강 상태, 환경 정보 등을 실시간으로 확인할 수 있습니다.

• 엔드포인트 (Endpoints): Actuator는 애플리케이션에 다양한 관리 엔드포인트를 제공합니다. 이 엔드포인트를 통해 애플리케이션의 상태, 정보, 설정 등을 확인할 수 있습니다.
  • /actuator/health: 애플리케이션의 건강 상태를 확인합니다.
  • /actuator/info: 애플리케이션의 정보를 확인합니다.
  • /actuator/metrics: 애플리케이션의 메트릭 정보를 확인합니다.
• 애플리케이션 정보 노출 (Application Information Exposure): Actuator는 애플리케이션의 정보를 노출합니다. 이 정보에는 애플리케이션의 이름, 버전, 환경 변수 등이 포함될 수 있습니다.
• 메트릭 수집 (Metrics Collection): Actuator는 애플리케이션의 다양한 메트릭 정보를 수집합니다. 이를 통해 애플리케이션의 성능 및 상태를 모니터링할 수 있습니다.
• 데이터소스 상태 확인 (Data Source Health Check): Actuator는 데이터베이스 연결 풀의 상태를 확인할 수 있는 엔드포인트를 제공합니다.
• 스레드 덤프 (Thread Dump): Actuator는 애플리케이션의 스레드 상태를 확인할 수 있게 해주는 엔드포인트를 제공합니다.
• 환경 속성 (Environment Properties): Actuator는 애플리케이션의 환경 변수와 속성을 확인할 수 있습니다.
• 빈 정보 (Bean Information): Actuator는 애플리케이션에서 사용 중인 빈 (Bean)들에 대한 정보를 제공합니다.
• Spring Boot Configuration Properties 확인 (Spring Boot Configuration Properties Inspection): Actuator는 Spring Boot 애플리케이션에서 사용되는 설정 속성들을 확인할 수 있습니다.

build.gradle 의존성 추가

• 추가한 즉시 애플리케이션에 Actuator가 활성화되어 엔드포인트들이 사용 가능합니다.

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

 

application.yml이나 application.properties 작성

• 민감한 정보를 포함해서 제공하기 때문에 어떤 기능을 오픈할지 작성해야 합니다.

# 모든 Actuator 엔드포인트를 노출 (기본적으로 일부만 활성화됨)
management.endpoints.web.exposure.include: '*'

# /actuator/health 엔드포인트에서 상세 정보를 항상 제공
management.endpoint.health.show-details: always

# 디스크 공간(디스크 용량) 관련 헬스 체크 비활성화
management.health.diskspace.enabled: false

# Resilience4j 서킷 브레이커 상태를 /actuator/health 에서 확인할 수 있도록 활성화
management.health.circuitbreakers.enabled: true

# 애플리케이션의 메트릭 수집 시, application 이름을 태그로 포함
management.metrics.tags.application: ${spring.application.name}

# HTTP 요청의 응답 시간(레이턴시) 분포를 히스토그램으로 저장하여 분석 가능하게 함
management.metrics.distribution.percentiles-histogram.http.server.requests: true

# Resilience4j 서킷 브레이커 호출(call) 관련 히스토그램을 활성화하여 모니터링 가능하게 함
management.metrics.distribution.percentiles-histogram.resilience4j.circuitbreaker.calls: true