Grafana 서버 시작하기

Grafana 서버 시작하기 (Start the Grafana server)

이 문서에서는 Grafana 서버를 시작하는 방법을 알려드릴게요. 일부 설정 변경은 Grafana 서버를 재시작해야 적용됩니다. 아래 지침은 패키지 설치 중 만들어진 grafana 사용자로 grafana-server 프로세스를 시작해요.

출처: 문서

본문

APT 리포지토리나 .deb 패키지로 설치했다면 systemd 또는 init.d로 서버를 시작할 수 있고, 바이너리 .tar.gz 파일로 설치했다면 바이너리를 직접 실행해요.

Linux

세 가지 방법(systemd, init.d, 바이너리 직접 실행) 중 하나만 따르세요.

systemd로 Grafana 서버 시작

sudo systemctl daemon-reload
sudo systemctl start grafana-server

실행 확인:

sudo systemctl status grafana-server

부팅 시 자동 시작:

sudo systemctl enable grafana-server.service

1024 미만 포트에서 Grafana 제공

systemd에서 1024보다 낮은 포트로 Grafana를 시작하려면 unit override를 추가해야 해요.

# Alternatively, create a file in /etc/systemd/system/grafana-server.service.d/override.conf
sudo systemctl edit grafana-server.service

CAP_NET_BIND_SERVICE 권한을 부여하는 설정을 추가하세요(capabilities(7) 참고).

[Service]
# Give the CAP_NET_BIND_SERVICE capability
CapabilityBoundingSet=CAP_NET_BIND_SERVICE
AmbientCapabilities=CAP_NET_BIND_SERVICE

# A private user cannot have process capabilities on the host's user
# namespace and thus CAP_NET_BIND_SERVICE has no effect.
PrivateUsers=false

systemd로 재시작:

sudo systemctl restart grafana-server

참고: SUSE·openSUSE 사용자는 systemd 방식으로 시작한 뒤 init.d 방식으로 부팅 시 자동 시작을 구성해야 할 수 있어요.

init.d로 Grafana 서버 시작

sudo service grafana-server start
sudo service grafana-server status

부팅 시 자동 시작:

sudo update-rc.d grafana-server defaults

재시작:

sudo service grafana-server restart

바이너리로 서버 시작

.tar.gz 바이너리 grafana는 작업 디렉터리가 바이너리와 public 폴더가 있는 루트 설치 디렉터리여야 해요.

./bin/grafana server

Docker

docker restart 명령으로 재시작합니다.

docker restart grafana

docker compose restart로도 가능해요. docker-compose.yml 예시:

version: '3.8'
services:
  grafana:
    image: grafana/grafana:latest
    container_name: grafana
    restart: unless-stopped
    environment:
      - TERM=linux
      - GF_PLUGINS_PREINSTALL=grafana-clock-panel,grafana-polystat-panel
    ports:
      - '3000:3000'
    volumes:
      - 'grafana_storage:/var/lib/grafana'
volumes:
  grafana_storage: {}

시작:

docker compose up -d

재시작:

docker compose restart grafana

Windows

grafana.exe server 실행 (bin 디렉터리에 위치). 커맨드라인에서 실행을 권장하며, Windows 서비스로 실행하려면 NSSM을 다운로드하세요.
브라우저에서 Grafana 포트로 이동(기본 http://localhost:3000/). 기본 포트는 3000이며 Windows에서 추가 권한이 필요할 수 있어요.
포트를 바꾸려면: conf 디렉터리에서 sample.ini를 custom.ini로 복사(defaults.ini는 편집하지 말 것) → custom.ini에서 http_port를 주석 해제(ini 파일 주석 문자는 ;)하고 8080 같은 값으로 변경.

재시작: Services 앱 열기 → Grafana 서비스 우클릭 → Restart 클릭.

macOS

설치 방법에 따라 다릅니다.

Homebrew로 시작: brew services start grafana
Homebrew로 재시작: brew services restart grafana
독립형 macOS 바이너리 재시작: 설치 설정 파일이 있는 디렉터리로 이동 후 ./bin/grafana server

다음 단계

Get Started로 첫 대시보드 만들기
Configuration으로 환경 커스터마이즈

Grafana 서버 시작하기