[Grafana Basic] Grafana 설치

1. 실행 환경

Docker는 리눅스 컨테이너 기술을 기반으로 동작한다. macOS와 Linux 환경에서는 별도의 가상화 설정 없이 사용할 수 있다. Windows 환경에서는 WSL2와 같은 리눅스 실행 환경이 필요하다. WSL2는 Windows에서 리눅스 커널을 직접 구동하는 방식으로, Docker Desktop과 함께 사용하는 구성이 일반적이다.

2. docker-compose 구성

services:
  grafana:
    image: grafana/grafana-oss:11.1.5
    container_name: grafana
    restart: always
    ports:
      - 3000:3000
    volumes:
      - grafana-storage:/var/lib/grafana

volumes:
  grafana-storage:

항목	설명
image	Grafana OSS 이미지를 사용한다. 버전을 명시적으로 지정하는 것이 환경 재현성과 안정성 측면에서 바람직하다.
ports	컨테이너 내부 3000 포트를 호스트 3000 포트에 매핑한다.
volumes	/var/lib/grafana는 Grafana의 내부 데이터 저장 경로로, 볼륨을 지정하지 않으면 컨테이너 삭제 시 설정 정보와 대시보드가 함께 삭제된다.
restart: always	컨테이너 중단 시 자동 재시작하도록 설정한다.

docker-compose 파일이 위치한 디렉터리에서 다음 명령을 실행한다.

docker-compose up -d

정상적으로 실행되면 네트워크, 볼륨, 컨테이너가 생성된다. 실행 상태는 docker ps 명령으로 확인할 수 있다.

3. 접속

브라우저에서 다음 주소로 접속한다.

http://localhost:3000

초기 계정 정보는 아래와 같으며, 최초 로그인 시 비밀번호 변경이 요구된다.

• ID: admin
• Password: admin