Prometheus + Grafana 연동

🎯 최종 목표: 이렇게 된다!

Spring Boot에서 서버 상태 정보를 숫자로 뽑아내고
→ Prometheus가 그걸 수집하고
→ Grafana가 보기 좋게 그래프로 보여줍니다.

---

✅ Step 1: Spring Boot Actuator가 "서버 상태 데이터"를 뽑는다

예: 이런 데이터들이 자동으로 생성됨

 

항목	설명
jvm.memory.used	JVM 메모리 사용량
http.server.requests	HTTP 요청 수, 응답 시간
system.cpu.usage	CPU 사용률
process.uptime	서버 실행 시간
logback.events	로그 발생 수

👉 이 데이터는 /actuator/prometheus라는 URL에 숫자 + 설명 형식으로 노출됩니다:

# HELP jvm_memory_used_bytes The amount of used memory

jvm_memory_used_bytes{area="heap",id="G1 Eden Space",} 2.515968E7

---

✅ Step 2: Prometheus가 /actuator/prometheus에 15초마다 접근해서 데이터를 수집

Prometheus는 "야, 너 지금 상태 어때?" 하고 15초마다 요청을 보냅니다.

global:
  scrape_interval: 15s

scrape_configs:
  - job_name: 'spring-boot-app'
    metrics_path: '/actuator/prometheus'
    static_configs:
      - targets: ['host.docker.internal:8080']

💡 여기서 host.docker.internal은 로컬에서 띄운 Spring 서버를 도커 컨테이너 안에서 접근할 수 있게 해주는 키워드입니다 (맥/윈도우 기준)

 

🔍 이 블록의 의미:

설정	항목설명
job_name: 'spring-boot-app'	이 설정 블록을 Prometheus 내부에서 구분하기 위한 이름 (대시보드 등에서 이 이름으로 그룹화됨)
metrics_path: '/actuator/prometheus'	메트릭을 수집할 HTTP 경로 (Spring Boot가 데이터를 이 경로에서 노출함)
targets: ['host.docker.internal:8080']	데이터를 수집할 실제 대상 서버 (여기서는 로컬에서 8080으로 실행 중인 Spring Boot 서버)

 

---

✅ Step 3: Grafana가 Prometheus에서 수집된 데이터를 시각화

Grafana는 직접 데이터를 수집하지 않고,
➡ Prometheus에 쌓인 데이터를 시각적으로 보여주는 역할입니다.

• 예: CPU 사용률 → 선 그래프
• 예: API 응답 속도 → 시간대별 꺾은선 그래프
• 예: 에러 응답 비율 → 도넛 차트

👇 이런 식으로 보여집니다

시간 → 15초 간격 값 → CPU 사용량, 요청 수, 메모리 사용량 등

---

✅ Step 4: Grafana에서 Dashboard 만들기

1. http://localhost:3001 접속
2. 로그인 (기본: admin / admin)
3. 좌측 메뉴 → ⚙️ Data Sources → Prometheus 추가
4. 좌측 메뉴 → 📊 Dashboards → Import
5. Dashboard ID: 4701 (Micrometer + Spring Boot 대시보드)
6. 확인하면 자동으로 그래프들이 생성됩니다!

---

✨ 정리 순서

단계	설명
1️⃣	Spring Boot에 actuator, micrometer 추가 → /actuator/prometheus에서 상태 공개
2️⃣	Prometheus가 이 URL을 정기적으로 방문해서 데이터 수집
3️⃣	Grafana가 Prometheus에서 데이터 가져옴
4️⃣	Grafana 대시보드에서 그래프로 시각화됨

---

📌 실제 운영에서 이런 것도 볼 수 있어요

• 어느 API가 제일 느린지
• 5xx 에러가 많이 발생한 API는 무엇인지
• 메모리 누수가 있는지
• 서버가 다운되기 전 이상징후는 무엇이었는지

---

📦 1단계: Spring Boot 설정

① 의존성 추가 (build.gradle)

// APM (Monitoring)
implementation 'org.springframework.boot:spring-boot-starter-actuator'
runtimeOnly 'io.micrometer:micrometer-registry-prometheus'

② application.properties 설정

# APM
management.endpoints.web.exposure.include=health,info,prometheus
management.endpoint.prometheus.enabled=true
management.metrics.export.prometheus.enabled=true

👉 이렇게 하면 http://localhost:8080/actuator/prometheus에서 메트릭이 노출됩니다.

 

Spring Security에도 추가

http
.authorizeHttpRequests((auth) -> auth
.requestMatchers("/actuator/**").permitAll() // 프로메테우스

---

📦 2단계: Prometheus + Grafana Docker로 실행

📁 docker-compose.yml

version: '3'

services:
  prometheus:
    image: prom/prometheus
    ports:
      - "9090:9090"
    volumes:
      - ./prometheus/prometheus.yml:/etc/prometheus/prometheus.yml

  grafana:
    image: grafana/grafana
    ports:
      - "3001:3000"  # 3000번 포트는 Next.js가 쓰고 있으므로 3001로 변경
    volumes:
      - grafana-storage:/var/lib/grafana

volumes:
  grafana-storage:

---

📄 3단계: Prometheus 설정 파일

📁 prometheus/prometheus.yml

global:
  scrape_interval: 15s

scrape_configs:
  - job_name: 'spring-boot-app'
    metrics_path: '/actuator/prometheus'
    static_configs:
      - targets: ['host.docker.internal:8080']

📌 host.docker.internal은 도커 컨테이너에서 로컬 호스트(윈도우/맥 기준)를 바라볼 때 사용합니다.
리눅스는 대신 172.17.0.1 사용하거나 network_mode: host 필요합니다.

---

🚀 4단계: 실행

docker-compose up -d

• Prometheus: http://localhost:9090
• Grafana: http://localhost:3001

---

📊 5단계: Grafana 대시보드 구성

1. Grafana 접속 (ID: admin / PW: admin)
2. 좌측 "⚙️ 설정 → Data Sources"
   • Prometheus 선택
   • URL: http://prometheus:9090
3. "Import Dashboard"
   • 템플릿 ID: 4701 (Spring Boot with Micrometer)
   • ✔️ 데이터가 자동으로 들어오기 시작합니다