[Springboot] 프로메테우스-설정

Spring/Springboot

늘이 2023. 12. 31. 23:54

프로메테우스는 메트릭을 수집하고 보관하는 DB

프로메테우스가 애플리케이션의 메트릭을 수집하도록 연동을 해야 함

1. 애플리케이션 설정

프로메테우스가 애플리케이션의 메트릭을 가져갈 수 있도록 애플리케이션에서 프로메테우스 포맷에 맞추어 메트릭 만들기

프로메테우스는 /actuator/metrics에서 보았던 포맷(JSON)을 이해하지 못함 하지만 마이크로미터가 이런 부분을 해결해 줌

각각의 메트릭들은 내부에서 마이크로미터 표준 방식으로 측정되고 있음, 따라서 어떤 구현체를 사용할지 지정해 주면 됨

1) 의존성 추가

implementation 'io.micrometer:micrometer-registry-prometheus'

localhost:8080/actuator에 promethus 가 추가된 것을 확인할 수 있음

실행

http://localhost:8080/actuator/prometheus

모든 메트릭이 프로메테우스 포맷으로 만들어진 것을 확인할 수 있음

1) 프로메테우스는 액츄에이터의 '.' 대신 '_' 포맷을 사용함

2) 액츄에이터 logback.events가 프로메테우스는 logback_events_total

로그 수처럼 지속해서 숫자가 증가하는 메트릭을 카운터라고 함
프로메테우스는 카운터 메트릭의 마지막에는 관례상 _total을 붙임
프로메테우스는 log_events_total {level="warn",}, log_events_total {level="debug",}, log_events_total {level="error",}, log_events_total {level="trace",}, log_events_total {level="info",}로 분리된 것을 확인할 수 있음

3) 액츄에이터의 http.server.requests 메트릭은 내부에 요청수, 시간 합, 최대 시간 정보를 가지고 있는데 프로메테우스에서는 아래 3가지로 분리되고 3가지 밑으로 요청별로 분리되어 나타나는 것을 확인할 수 있음

프로메테우스가 애플리케이션의 /actuator/prometheus를 호출해서 메트릭을 주기적으로 수집하도록 설정

프로메테우스 폴더에 있는 prometheus.yml 수정

# add
- job_name: "spring-actuator"
  metrics_path: '/actuator/prometheus'
  scrape_interval: 1s 
  static_configs:
    - targets: ['localhost:8080']

job_name: 수집하는 이름, 임의의 이름을 사용하면 됨
metrics_path: 수집할 경로 지정
scrape_interval: 수집할 주기 설정, 현재는 1초에 한 번씩 호출 주기를 지정했지만 기본값은 1m, 수집 주기가 너무 짧으면 애플리케이션 성능에 영향을 줄 수 있으므로 실제 운영에서는 10s ~ 1m 정도 지정
targets: 수집할 서버의 IP, PORT를 지정

yml 수정 후 프로메테우스 재실행

localhost://9090/config 접속 -> 상단 Satus -> Configuration 클릭하면 아래와 같이 yml 수정 부분이 들어온 것을 확인할 수 있음