Ubuntu 24.04에 Grafana 메트릭 시각화 플랫폼 배포

디렉터리 구조 설정

1. 프로젝트 디렉터리 구조 만들기

mkdir -p ~/grafana-monitoring/grafana-data
cd ~/grafana-monitoring

2. Grafana 데이터 디렉터리 소유권 설정

sudo chown -R 472:472 grafana-data

3. 환경 파일 만들기

nano .env

DOMAIN=grafana.example.com
LETSENCRYPT_EMAIL=admin@example.com
GF_ADMIN_PASSWORD=changeme

Docker Compose 로 배포

1. Docker Compose 매니페스트 만들기

nano docker-compose.yaml

services:
  traefik:
    image: traefik:v3.6
    container_name: traefik
    command:
      - "--providers.docker=true"
      - "--providers.docker.exposedbydefault=false"
      - "--entrypoints.web.address=:80"
      - "--entrypoints.websecure.address=:443"
      - "--entrypoints.web.http.redirections.entrypoint.to=websecure"
      - "--entrypoints.web.http.redirections.entrypoint.scheme=https"
      - "--certificatesresolvers.letsencrypt.acme.httpchallenge=true"
      - "--certificatesresolvers.letsencrypt.acme.httpchallenge.entrypoint=web"
      - "--certificatesresolvers.letsencrypt.acme.email=${LETSENCRYPT_EMAIL}"
      - "--certificatesresolvers.letsencrypt.acme.storage=/letsencrypt/acme.json"
    ports:
      - "80:80"
      - "443:443"
    volumes:
      - "letsencrypt:/letsencrypt"
      - "/var/run/docker.sock:/var/run/docker.sock:ro"
    restart: unless-stopped

  grafana:
    image: grafana/grafana:latest
    container_name: grafana
    hostname: grafana
    expose:
      - "3000"
    volumes:
      - "./grafana-data:/var/lib/grafana"
    environment:
      - GF_SECURITY_ADMIN_PASSWORD=${GF_ADMIN_PASSWORD}
      - GF_SERVER_ROOT_URL=https://${DOMAIN}
    labels:
      - "traefik.enable=true"
      - "traefik.http.routers.grafana.rule=Host(`${DOMAIN}`)"
      - "traefik.http.routers.grafana.entrypoints=websecure"
      - "traefik.http.routers.grafana.tls.certresolver=letsencrypt"
      - "traefik.http.services.grafana.loadbalancer.server.port=3000"
    restart: unless-stopped

volumes:
  letsencrypt:

2. 서비스 시작

docker compose up -d

3. 서비스 실행 확인

docker compose ps

4. 로그 보기

docker compose logs

Grafana 접속

브라우저에서 https://grafana.example.com 을 열고 로그인합니다.

• 사용자 이름: admin
• 비밀번호: .env 파일에 정의된 GF_ADMIN_PASSWORD 값

Connections → Data sources 로 이동하여 Prometheus, Loki 또는 다른 백엔드를 추가합니다.

다음 단계

Grafana가 HTTPS를 통해 안전하게 실행되고 있습니다. 이제 할 수 있는 일은 다음과 같습니다.

• Prometheus, Loki, Mimir, Tempo 등을 데이터 소스로 추가
• 커뮤니티 대시보드를 가져오거나 스택에 맞는 커스텀 대시보드 제작
• 알림 규칙 및 알림 채널 설정

추가 팁이 포함된 전체 가이드는 Vultr Docs 에서 확인하세요.