컨테이너 내부
├── PID 1: nginx 프로세스
│   ├── stdout → "192.168.1.1 - GET /index.html 200"
│   └── stderr → "error: connection reset by peer"
│
Docker 데몬
└── 두 스트림 캡처 → 로그 파일로 저장
    └── /var/lib/docker/containers/[ID]/[ID]-json.log

[stdout 로그 — docker logs로 확인 가능]
app.py에서:
  print("서버 시작됨")          # stdout
  sys.stderr.write("에러발생")   # stderr
→ docker logs my-container 로 확인 가능 ✓

[파일 로그 — docker logs로 확인 불가]
app.py에서:
  with open("/var/log/app.log", "a") as f:
    f.write("서버 시작됨")
→ docker logs my-container : (아무 출력 없음) ✗
→ docker exec my-container cat /var/log/app.log 로 확인 ✓

# 실습 디렉토리 준비
mkdir -p /tmp/docker/part4/exam_14 && cd /tmp/docker/part4/exam_14

# 기본 로그 드라이버 확인
docker info --format '{{.LoggingDriver}}'
# json-file (기본값)

# 특정 드라이버로 컨테이너 실행
docker run --log-driver local nginx

# 로그 파일이 실제로 저장된 위치 확인
docker inspect my-container --format '{{.LogPath}}'
# /var/lib/docker/containers/abc123.../abc123...-json.log

# 직접 파일 내용 확인 (root 권한 필요)
sudo cat /var/lib/docker/containers/abc123.../abc123...-json.log
# {"log":"서버 시작됨\n","stream":"stdout","time":"2024-01-01T00:00:00Z"}

# 로테이션 없는 컨테이너의 로그 파일 크기 확인
sudo du -sh /var/lib/docker/containers/*/
# 52G  /var/lib/docker/containers/abc123.../  ← 장애!

# 전체 도커 데이터 디스크 사용량
docker system df
# TYPE      TOTAL    ACTIVE   SIZE      RECLAIMABLE
# Containers  5      3        52.3GB    12.1GB

docker run \
  --log-driver json-file \
  --log-opt max-size=10m \
  --log-opt max-file=3 \
  nginx

// /etc/docker/daemon.json
{
  "log-driver": "json-file",
  "log-opts": {
    "max-size": "10m",
    "max-file": "3"
  }
}

# 설정 적용
sudo systemctl restart docker

services:
  web:
    image: nginx
    logging:
      driver: "json-file"
      options:
        max-size: "10m"
        max-file: "3"

  api:
    image: my-api
    logging:
      driver: "json-file"
      options:
        max-size: "50m"   # API는 로그가 많으므로 크게
        max-file: "5"

시간 흐름 →
파일1: [0MB → 10MB] → 순환
파일2:               [0MB → 10MB] → 순환
파일3:                             [0MB → 10MB] → 순환
파일1:                                           [0MB → ...] (파일1 재사용, 이전 내용 삭제)

최대 유지되는 로그: 파일1 + 파일2 + 파일3 = 30MB

# 비구조적 로그 (텍스트 파싱이 어려움)
2026-04-05 10:30:15 ERROR User login failed: invalid password for user john

# 구조적 로그 (JSON — 필드별 검색/집계 가능)
{"time":"2026-04-05T10:30:15Z","level":"ERROR","event":"login_failed",
 "user":"john","reason":"invalid_password","ip":"192.168.1.100","latency_ms":5}

# Python — structlog 라이브러리
import structlog
log = structlog.get_logger()
log.error("login_failed", user="john", reason="invalid_password", ip="1.2.3.4")
# {"event": "login_failed", "user": "john", "reason": "invalid_password", ...}

// Node.js — pino 라이브러리 (고성능)
const pino = require('pino');
const log = pino();
log.error({ user: 'john', reason: 'invalid_password' }, 'login failed');
// {"level":50,"time":1712300000000,"user":"john","reason":"invalid_password","msg":"login failed"}

// Java — logback JSON 레이아웃
// logback.xml에서 JsonLayout 설정
// 모든 로그가 자동으로 JSON으로 출력됨
logger.error("login failed", kv("user", "john"), kv("reason", "invalid_password"));

# 실제 저장된 로그 파일 확인
sudo cat /var/lib/docker/containers/<id>/<id>-json.log | head -5
# {"log":"Exception in thread \"main\"\n","stream":"stderr","time":"..."}
# {"log":"\tat com.example.App.main(App.java:42)\n","stream":"stderr","time":"..."}
# {"log":"\tat com.example.App.run(App.java:28)\n","stream":"stderr","time":"..."}
# ← 스택 트레이스가 3개의 별개 이벤트로 분리됨!

# 방법 2: Promtail (Loki 수집기) 멀티라인 파서 설정
scrape_configs:
  - job_name: docker
    pipeline_stages:
      - multiline:
          firstline: '^\d{4}-\d{2}-\d{2}'  # 날짜로 시작하는 줄이 첫 줄
          max_wait_time: 3s

중앙화 전: 컨테이너마다 docker logs 명령 실행
  → 로그가 각 서버에 분산
  → 서버 장애 시 로그 유실

중앙화 후: 모든 로그를 한 곳에 수집
  → 전체 서비스 로그를 한 화면에서 검색/분석
  → 장기 보관 및 알람 연동

# docker-compose.yml
services:
  app:
    image: myapp
    logging:
      driver: "json-file"          # 기본 (로컬 저장 + docker logs 지원)
      options:
        max-size: "10m"
        max-file: "3"

  app-prod:
    image: myapp
    logging:
      driver: "awslogs"            # AWS CloudWatch로 직접 전송
      options:
        awslogs-region: "ap-northeast-2"
        awslogs-group: "/myapp/prod"
        awslogs-stream: "api-1"

# monitoring/compose.yml
services:
  loki:
    image: grafana/loki:latest
    ports:
      - "3100:3100"
    volumes:
      - loki-data:/loki

  promtail:
    image: grafana/promtail:latest
    volumes:
      - /var/lib/docker/containers:/var/lib/docker/containers:ro
      - /var/run/docker.sock:/var/run/docker.sock
      - ./promtail-config.yml:/etc/promtail/config.yml

  grafana:
    image: grafana/grafana:latest
    ports:
      - "3001:3000"
    environment:
      - GF_AUTH_ANONYMOUS_ENABLED=true
    volumes:
      - grafana-data:/var/lib/grafana

volumes:
  loki-data:
  grafana-data:

# promtail-config.yml
scrape_configs:
  - job_name: docker
    docker_sd_configs:
      - host: unix:///var/run/docker.sock
        refresh_interval: 5s
    relabel_configs:
      - source_labels: [__meta_docker_container_name]
        target_label: container