Grafana v8.2로 업그레이드하기

최신 수정 사항과 개선 사항을 반영하려면 Grafana를 자주 업그레이드하는 것을 권장해요. Grafana 업그레이드는 하위 호환이 되기 때문에 업그레이드 과정이 간단하고, 대시보드와 그래프는 변경되지 않아요.

모든 Grafana 버전에 적용되는 공통 작업 외에도, 특정 버전에는 추가로 완료해야 하는 업그레이드 작업이 있을 수 있어요.

⚠️ 일부 릴리스에는 호환성을 깨는 변경(breaking changes)이 있을 수 있어요. 대부분의 릴리스에서는 이런 변경 사항을 What's New 문서에, 호환성 변경이 많은 릴리스에서는 별도의 Breaking changes 문서에 정리해 두었어요. v9.2 이전 버전은 Release Notes에 추가 정보를 게시했어요. 가능한 경우 모든 변경 사항은 Changelog에 pull request 또는 issue 링크와 함께 나열돼 있어요.

가능하면 테스트 또는 개발 환경에서 Grafana 업그레이드 과정을 먼저 시험해 보는 것이 좋아요.

출처: 문서

본문

Grafana 백업하기

이 항목에서는 로컬 Grafana 배포의 구성, 플러그인 데이터, Grafana 데이터베이스를 포함한 백업 방법을 설명해요.

Grafana 구성 파일 백업하기

Grafana 배포에서 수정했을 수 있는 구성 파일을 백업 디렉터리에 복사해요.

Grafana 구성 파일은 다음 디렉터리에 위치해요:

기본 구성: $WORKING_DIR/defaults.ini (이 파일은 변경하지 마세요)
사용자 정의 구성: $WORKING_DIR/custom.ini

구성 파일의 위치에 대한 자세한 내용은 "Configuration file location" 문서를 참조해요.

💡 deb 또는 rpm 패키지로 Grafana를 설치했다면 구성 파일은 /etc/grafana/grafana.ini에 있어요. 이 경로는 Grafana init.d 스크립트에서 --config 파일 매개변수로 지정돼 있어요.

플러그인 데이터 백업하기

Grafana에 플러그인을 설치하면 각 플러그인에 대한 폴더가 관련 파일과 데이터와 함께 생성돼요. 이 위치에서 모든 파일과 폴더를 백업 저장소로 재귀적으로 복사해요.

Grafana 플러그인 파일은 다음 디렉터리에 위치해요:

바이너리 또는 소스 설치에서 기본 플러그인 위치: $WORKING_DIR/data/plugins
deb 또는 rpm 패키지에서 기본 플러그인 위치: /var/lib/grafana/plugins (이 경로는 Grafana init.d 스크립트에서 --config 파일 매개변수로 지정돼 있어요)

Grafana 데이터베이스 백업하기

필요할 때 이전 버전으로 롤백할 수 있도록 Grafana 데이터베이스를 백업하는 것을 권장해요.

SQLite

기본 Grafana 데이터베이스는 SQLite로, 데이터를 단일 파일로 디스크에 저장해요. 이 파일을 백업하려면 백업 저장소에 복사하면 돼요.

💡 데이터 무결성을 보장하려면 SQLite 데이터베이스를 백업하기 전에 Grafana 서비스를 종료해요.

SQLite 데이터베이스 파일은 다음 디렉터리 중 하나에 위치해요:

바이너리 또는 소스 설치에서 SQLite 데이터 기본 위치: $WORKING_DIR/data/grafana.db
deb 또는 rpm 패키지에서 SQLite 데이터 기본 위치: /var/lib/grafana/grafana.db (이 경로는 Grafana init.d 스크립트에서 --config 파일 매개변수로 지정돼 있어요)

MySQL

MySQL Grafana 데이터베이스를 백업하거나 복원하려면 다음 명령을 실행해요:

backup:
> mysqldump -u root -p[root_password] [grafana] > grafana_backup.sql

restore:
> mysql -u root -p grafana < grafana_backup.sql

Postgres

Postgres Grafana 데이터베이스를 백업하거나 복원하려면 다음 명령을 실행해요:

backup:
> pg_dump grafana > grafana_backup

restore:
> psql grafana < grafana_backup

Grafana 업그레이드하기

다음 섹션에서는 설치 방법에 따른 Grafana 업그레이드 방법을 설명해요. 구성 파일 위치에 대한 자세한 내용은 "Configuration file location" 문서를 참조해요.

Debian

Debian 패키지(.deb)로 설치한 Grafana를 업그레이드하려면 다음 단계를 완료해요:

현재 Grafana 설치에서 사용자 정의 구성 변경 사항을 <grafana_install_dir>/grafana.ini 파일에 저장해요. 이렇게 하면 구성 변경 사항을 잃을 위험 없이 Grafana를 업그레이드할 수 있어요.
최신 버전의 Grafana를 다운로드해요.
다음 dpkg -i 명령을 실행해요.

wget <debian package url>
sudo apt-get install -y adduser
sudo dpkg -i grafana_<version>_amd64.deb

APT 저장소

Grafana Labs APT 저장소에서 설치한 Grafana를 업그레이드하려면 다음 단계를 완료해요:

현재 Grafana 설치에서 사용자 정의 구성 변경 사항을 <grafana_install_dir>/grafana.ini 파일에 저장해요. 이렇게 하면 구성 변경 사항을 잃을 위험 없이 Grafana를 업그레이드할 수 있어요.
다음 명령을 실행해요:

sudo apt-get update
sudo apt-get upgrade

apt-get upgrade를 실행하면 Grafana가 자동으로 업데이트돼요.

바이너리 .tar 파일

바이너리 .tar.gz 패키지로 설치한 Grafana를 업그레이드하려면 다음 단계를 완료해요:

현재 Grafana 설치에서 사용자 정의 구성 변경 사항을 사용자 정의 구성 파일인 custom.ini 또는 grafana.ini에 저장해요. 이렇게 하면 구성 변경 사항을 잃을 위험 없이 Grafana를 업그레이드할 수 있어요.
바이너리 .tar.gz 패키지를 다운로드해요.
다운로드한 패키지를 압축 해제하고 기존 파일을 덮어써요.

RPM 또는 YUM

RPM 또는 YUM을 사용해 설치한 Grafana를 업그레이드하려면 다음 단계를 완료해요:

현재 Grafana 설치에서 사용자 정의 구성 변경 사항을 <grafana_install_dir>/grafana.ini 파일에 저장해요. 이렇게 하면 구성 변경 사항을 잃을 위험 없이 Grafana를 업그레이드할 수 있어요.
설치 방법에 따라 다음 중 하나를 수행해요:
- RPM 패키지를 다운로드해 Grafana를 설치했다면, "Install Grafana on Red Hat, RHEL, or Fedora" 또는 "Install Grafana on SUSE or openSUSE" 문서에 정리된 단계를 완료해 Grafana를 업그레이드해요.
- Grafana YUM 저장소를 사용했다면 다음 명령을 실행해요:
```
sudo yum update grafana
```
- openSUSE 또는 SUSE에 Grafana를 설치했다면 다음 명령을 실행해요:
```
sudo zypper update
```

Docker

Docker 컨테이너에서 실행 중인 Grafana를 업그레이드하려면 다음 단계를 완료해요:

Grafana 환경 변수를 사용해 사용자 정의 구성을 저장해요. 이 방법이 권장돼요. 또는 배포된 컨테이너에 접속해 구성 파일을 수동으로 볼 수도 있어요. 이렇게 하면 구성 변경 사항을 잃을 위험 없이 Grafana를 업그레이드할 수 있어요.
다음 명령과 유사한 명령을 실행해요.

💡 이는 예시예요. 입력하는 매개변수는 Grafana 컨테이너를 어떻게 구성했는지에 따라 달라져요.

docker pull grafana/grafana
docker stop my-grafana-container
docker rm my-grafana-container
docker run -d --name=my-grafana-container --restart=always -v /var/lib/grafana:/var/lib/grafana grafana/grafana

Windows

Windows에 설치된 Grafana를 업그레이드하려면 다음 단계를 완료해요:

현재 Grafana 설치에서 사용자 정의 구성 변경 사항을 <grafana_install_dir>/conf/custom.ini 파일에 저장해요. 이렇게 하면 구성 변경 사항을 잃을 위험 없이 Grafana를 업그레이드할 수 있어요.
Windows 바이너리 패키지를 다운로드해요.
패키지 내용을 Grafana를 설치한 위치에 압축 해제해요. 메시지가 표시되면 기존 파일과 폴더를 덮어써도 돼요.

Mac

Mac에 설치된 Grafana를 업그레이드하려면 다음 단계를 완료해요:

현재 Grafana 설치에서 사용자 정의 구성 변경 사항을 사용자 정의 구성 파일인 custom.ini에 저장해요. 이렇게 하면 구성 변경 사항을 잃을 위험 없이 Grafana를 업그레이드할 수 있어요.
Mac 바이너리 패키지를 다운로드해요.
패키지 내용을 Grafana를 설치한 위치에 압축 해제해요. 메시지가 표시되면 기존 파일과 폴더를 덮어써도 돼요.

Grafana 플러그인 업데이트하기

Grafana를 업그레이드한 후에는 모든 플러그인을 업데이트하는 것을 권장해요. 새 버전의 Grafana는 이전 플러그인을 제대로 작동하지 않게 만들 수 있기 때문이에요.

플러그인을 업데이트하려면 다음 명령을 실행해요:

grafana cli plugins update-all

기술 노트

이 버전의 Grafana에는 완료해야 할 추가 업그레이드 단계가 없어요.

더 알아보기 (Learn more)

Grafana 업그레이드 개요 및 일반 절차
Grafana 구성 파일 위치 및 백업 방법