📌 워크로드

1) docker-compse 설정

services:

  prometheus:
    image: prom/prometheus:latest  												# Prometheus 최신 이미지 사용
    container_name: prometheus     												# 컨테이너 이름 지정
    ports:
      - "9090:9090"                												# 호스트 포트 9090 → 컨테이너 포트 9090
    volumes:
      - ./prometheus/prometheus.yml:/etc/prometheus/prometheus.yml   			# 호스트의 설정 파일을 컨테이너로 마운트   
    command:
      - --config.file=/etc/prometheus/prometheus.yml 							# 설정 파일 경로 지정 (옵션)                   
    networks:
      - prometheus               												# prometheus 네트워크에 연결
      
  loki:
    image: loki:latest            												# Loki 최신 이미지 사용 (공식 이미지는 grafana/loki 사용 권장)
    container_name: loki          												# 컨테이너 이름 지정
    user: "$UID:$GID"             												# 현재 사용자 권한으로 실행 (권한 문제 방지)
    ports:
      - "3100:3100"               												# Loki 포트 매핑 (기본 포트 3100)
    volumes:
      - ./loki/loki.yml:/etc/loki/local-config.yaml                   			# Loki 설정 파일 마운트       
      - ./loki:/var/loki    													# 로그 데이터 저장 디렉토리 마운트
    command: -config.file=/etc/loki/local-config.yaml 							# 설정 파일 지정                     
    networks:
      - loki                      												# loki 네트워크에 연결

  grafana:
    image: grafana:latest         												# Grafana 최신 이미지
    container_name: grafana      												# 컨테이너 이름 지정
    user: "$UID:$GID"             												# 현재 사용자 권한으로 실행
    ports:
      - "3000:3000"               												# Grafana 웹 포트 (기본 3000)
    volumes:
      - ./grafana:/var/lib/grafana												# Grafana 데이터 디렉토리 마운트 (대시보드, 설정 등 저장)                             
    depends_on:
      - prometheus                												# Prometheus 서비스가 먼저 시작되도록 설정
      - loki                      												# Loki 서비스가 먼저 시작되도록 설정
    networks:
      - prometheus                												# Prometheus 네트워크에 연결 (메트릭 수집용)
      - loki                      												# Loki 네트워크에 연결 (로그 수집용)
	
networks:																		# 사용자 정의 네트워크 설정
  prometheus:
    driver: bridge                												# 기본 브리지 네트워크 사용
  loki:
    driver: bridge               												# 로그 관련 컨테이너용 네트워크

✅ docker-compose down

• 현재 실행 중인 모든 컨테이너, 네트워크, 볼륨 등을 종료 및 삭제합니다.
• 기본적으로 네트워크와 컨테이너를 삭제하고, 볼륨은 유지됩니다. (--volumes 옵션을 주면 볼륨도 삭제됨)

✅ docker-compose up -d

• docker-compose.yml에 정의된 서비스를 백그라운드(-d)로 실행합니다.
• 변경된 부분만 다시 빌드하고 실행합니다.

2) Spring Application 에서 프로메테우스 서버로 메트릭 데이터를 Export

1. build.gradle 의존성 추가

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

2. yml 파일 설정

management:
  endpoints:
    web:
      exposure:
        include: prometheus
  endpoint:
    prometheus:
      enabled: true

3) Spring Application 에서 Loki 서버로 로그를 전달하는 Appender 설정

1. build.gradle 의존성 추가

implementation 'com.github.loki4j:loki-logback-appender:1.5.1'

2. logback 설정

<!-- Loki로 WARN과 ERROR 레벨의 로그만 전송하는 appender 설정 -->
<appender name="LOKI" class="com.github.loki4j.logback.Loki4jAppender">
    
    <!-- 로그 레벨 필터 설정: WARN 이상만 전송됨 (WARN, ERROR) -->
    <filter class="ch.qos.logback.classic.filter.ThresholdFilter">
        <level>WARN</level> <!-- WARN과 ERROR 레벨만 전송 -->
    </filter>

    <!-- Loki HTTP Push 설정 -->
    <http>
        <!-- Loki 수신 URL (IP 또는 도메인) -->
        <url>http://{Loki 서버 URL}:3100/loki/api/v1/push</url>
    </http>

    <!-- 로그 포맷 설정 -->
    <format>
        <!-- 라벨(label): Loki의 로그 분류 기준으로 사용됨 -->
        <label>
            <!-- 예: appName, host, 로그레벨 등을 라벨로 전송 -->
            <pattern>appName=weather-v2-dev,host=${HOSTNAME},level=%level</pattern>
        </label>

        <!-- 메시지 포맷: 실제 로그 내용 -->
        <message>
            <!-- 로그 출력 형식 설정 (스레드명, 로그레벨, 로거, 메시지) -->
            <pattern> [%thread] %-5level %logger{36} - %msg%n</pattern>
        </message>
    </format>
    
</appender>

4) preometheus.yml 설정

🚨ECS + FARGATE 서비스 디스커버리 연동 시 : dns_sd_config + Cloud Map 사용

global:
  scrape_interval: 1s             				# 메트릭 수집 주기 (기본: 1초)
  evaluation_interval: 1s         				# 알림 룰 평가 주기 (기본: 1초)
  
  
  
  - job_name: "test-one"              
    metrics_path: "/actuator/prometheus"
    static_configs:
      - targets: ["test.application.com"]
    relabel_configs:
      - source_labels: ['__address__']
        target_label: 'instance'
        replacement: '샘플테스트(첫번째)'
    scheme: https

  - job_name: "test-two"                      
    metrics_path: "/actuator/prometheus"
    dns_sd_configs:                              # DNS 기반 서비스 디스커버리 사용
      - names:
          - 'test-two-api.test-two.dev'  	     # 서비스 도메인 {
        type: 'A'                                # A 레코드 조회
        port: 80                                 # HTTP 포트
    relabel_configs:
      - source_labels: ['__address__']
        target_label: 'instance'
    scheme: https       

✅ static_configs

정적인 타겟 설정 – IP나 도메인 주소를 직접 명시

• 타겟을 수동으로 입력
• IP 또는 도메인 주소가 고정되어 있을 때 사용
• 간단한 구조, 테스트/개발 환경에서 많이 사용

사용 예

• EC2, ECS, 로드밸런서 등에 도메인이나 IP로 접근 가능할 때
• 수가 많지 않고 변경되지 않는 서비스들

---

✅ dns_sd_configs

DNS 기반의 서비스 디스커버리 – DNS 쿼리를 통해 동적으로 타겟을 찾음

• 서비스가 등록된 도메인을 기준으로 DNS A/AAAA 레코드를 조회
• 클러스터 내부 서비스(DNS가 자동 관리되는 환경, 예: Kubernetes, ECS 서비스 디스커버리 등)에 적합
• 대상이 늘어나거나 줄어드는 경우 자동 반영 가능 ( ※핵심 )

사용 예

• AWS ECS, Kubernetes 등 동적으로 생성되는 서비스
• DNS를 통해 클러스터 서비스 엔드포인트를 노출할 때

5) Loki 설정

auth_enabled: false  												# 인증 기능 비활성화 (기본적으로 내부 네트워크에서 사용 시 인증 생략 가능)

server:
  http_listen_port: 3100  											# Loki 서버가 HTTP 요청을 수신할 포트 설정

common:
  instance_addr: 127.0.0.1  										# Loki 인스턴스의 주소 (gossip ring에 사용)
  path_prefix: /var/loki  											# Loki가 내부적으로 파일을 저장할 기본 경로
  storage:
    filesystem:  													# 로컬 파일 시스템 기반 저장소 사용
      chunks_directory: /var/loki/chunks  							# 로그 청크 데이터를 저장할 디렉토리
      rules_directory: /var/loki/rules 								# 룰 파일 저장 경로 (알림 룰 등)
  replication_factor: 1  											# 복제 개수 설정, 1은 단일 노드에서 사용
  ring:
    kvstore:
      store: inmemory  												# 키-값 저장소로 인메모리 방식 사용 (단일 노드에 적합)

query_range:
  results_cache:
    cache:
      embedded_cache:
        enabled: true  												# 쿼리 결과에 대한 캐시 기능 활성화
        max_size_mb: 100 										    # 캐시 최대 크기 (MB 단위)

schema_config:
  configs:
    - from: 2020-10-24  											# 이 날짜부터 적용할 스키마 설정
      store: tsdb  													# 저장 방식으로 TSDB(Time Series Database) 사용
      object_store: s3  											# 청크 데이터를 저장할 오브젝트 스토어 타입
      schema: v12  													# Loki 스키마 버전 (최신 버전 중 하나)
      index:
        prefix: index_  											# 인덱스 프리픽스 (S3에 저장될 키 이름의 접두어)
        period: 24h  												# 인덱스를 하루 단위로 생성

storage_config:
  aws:
    s3: tnear-loki-log  											# 사용할 S3 버킷 이름
    region: ap-northeast-2  										# S3 리전 (서울)
    access_key_id: {AWS_ACCESS_KEY}  								# AWS 접근 키 (보안상 주의 필요)
    secret_access_key: {AWS_SECRET_ACCESS_KEY}  					# AWS 비밀 접근 키 (보안상 주의 필요)

6) Grafana 접속

🔹 결론

⭐ Prometheus 메트릭 데이터 + Loki 로그를 연동하여 시각화

⭐ Loki는 레이블 기반의 최소 인덱싱 구조 사용,

⭐ Prometheus는 자체 DB와 압축 구조로 고성능 고효율적임

⭐ Loki와 Prometheus 설정 파일 기반 운영이 쉬움

⭐ 오픈소스 기반으로 별도 라이선스 비용이 없다.

시각화 대시보드 구성에 관해서는 다음 글에서 진행하도록 하겠다. 😊😊😊😊😊😊😊😊