Grafana 설치 및 초기 설정

설치 방법

Docker로 설치 (권장)

docker run -d \
  --name grafana \
  -p 3000:3000 \
  -v grafana_data:/var/lib/grafana \
  -e GF_SECURITY_ADMIN_PASSWORD=your-password \
  grafana/grafana:latest

브라우저에서 http://localhost:3000 접속, admin / your-password로 로그인

Docker Compose

version: '3'
services:
  grafana:
    image: grafana/grafana:latest
    ports:
      - "3000:3000"
    volumes:
      - grafana_data:/var/lib/grafana
      - ./grafana/provisioning:/etc/grafana/provisioning
    environment:
      - GF_SECURITY_ADMIN_PASSWORD=your-password
      - GF_USERS_ALLOW_SIGN_UP=false

volumes:
  grafana_data:

Ubuntu/Debian 패키지 설치

sudo apt-get install -y apt-transport-https software-properties-common
sudo wget -q -O /usr/share/keyrings/grafana.key https://apt.grafana.com/gpg.key
echo "deb [signed-by=/usr/share/keyrings/grafana.key] https://apt.grafana.com stable main" | sudo tee /etc/apt/sources.list.d/grafana.list

sudo apt-get update
sudo apt-get install -y grafana

sudo systemctl enable grafana-server
sudo systemctl start grafana-server

---

초기 설정

1. 관리자 비밀번호 변경

첫 로그인 후 즉시 변경합니다.

Profile → Change password

또는 환경 변수로 사전 설정:

GF_SECURITY_ADMIN_PASSWORD=strong-password

2. 기본 설정 파일

/etc/grafana/grafana.ini 또는 Docker 환경 변수로 설정합니다.

[server]
http_port = 3000
domain = grafana.example.com
root_url = https://grafana.example.com

[security]
admin_user = admin
admin_password = your-password
disable_gravatar = true

[users]
allow_sign_up = false
auto_assign_org_role = Viewer

[smtp]
enabled = true
host = smtp.gmail.com:587
user = your-email@gmail.com
password = your-app-password
from_address = grafana@example.com

---

시스템 자원 권장 사양

규모	RAM	CPU	디스크
소규모	512MB	1 Core	10GB
중규모	2GB	2 Core	50GB
대규모	4GB+	4 Core+	100GB+

---

Provisioning (자동 설정)

코드로 데이터 소스와 대시보드를 자동 구성합니다. GitOps 환경에 적합합니다.

데이터 소스 프로비저닝 (/etc/grafana/provisioning/datasources/prometheus.yml)

apiVersion: 1
datasources:
  - name: Prometheus
    type: prometheus
    url: http://prometheus:9090
    isDefault: true
    access: proxy

대시보드 프로비저닝 (/etc/grafana/provisioning/dashboards/default.yml)

apiVersion: 1
providers:
  - name: default
    folder: Provisioned
    type: file
    options:
      path: /etc/grafana/dashboards