플러그인 설치

플러그인 설치 (Install a plugin)

Grafana 플러그인을 설치하는 여러 가지 방법을 안내해요. 기본 방법인 Grafana UI를 비롯해 Grafana CLI, ZIP 파일, Grafana 설정, 그리고 Helm chart를 사용한 설치 방법을 다룹니다.

출처: 문서

본문

참고: Grafana Cloud 사용자라면 Grafana UI를 통한 플러그인 설치를 따르세요.

Grafana UI를 통한 플러그인 설치 (default)

플러그인 설치의 기본 방법은 Grafana UI를 통하는 것이에요.

Grafana의 사이드 네비게이션 메뉴에서 Administration > Plugins and data > Plugins 로 이동해 모든 플러그인을 봅니다.
설치할 플러그인을 찾아봅니다.
플러그인의 로고를 클릭합니다.
Install 을 클릭합니다.

환경이나 설정에 따라 다음 대체 방법을 사용할 수 있어요.

Grafana CLI로 플러그인 설치하기

Grafana CLI는 명령줄 도구로 Grafana 플러그인을 설치·업그레이드·관리할 수 있게 해줍니다. Grafana CLI 플러그인 명령에 대한 자세한 내용은 Plugin commands를 참고하세요.

ZIP 파일에서 플러그인 설치하기

이 방법은 보통 Plugin Catalog에서 제공되지 않거나 인터넷 접근이 없는 환경의 플러그인에 사용해요. 플러그인 자산이 담긴 아카이브를 다운로드하고, 아카이브를 플러그인 디렉토리에 추출해 설치합니다. 예:

unzip my-plugin-0.2.0.zip -d YOUR_PLUGIN_DIR/my-plugin

플러그인 디렉토리 경로는 설정 파일에 정의됩니다. 자세한 내용은 Configuration을 참고하세요.

Grafana 설정을 통한 플러그인 설치

참고: 이 기능은 Grafana 11.5.0 이상이 필요해요.

Grafana 설정 파일의 plugins.preinstall 섹션에 플러그인 ID를 추가해 플러그인을 설치할 수 있어요. 이렇게 하면 플러그인이 실수로 제거되는 것을 방지하고 자동 업데이트할 수 있습니다. 자세한 내용은 Configuration을 참고하세요.

에어갭(air-gapped) 환경에서 플러그인 설치

플러그인 설치는 보통 인터넷 연결이 필요해요. 인스턴스에서 설치 중 사용되는 엔드포인트를 확인하고 인스턴스의 허용 목록에 추가할 수 있습니다. 가능하지 않다면 Grafana CLI 또는 ZIP 파일로 설치를 시도해 보세요.

Grafana.com API의 다운로드 링크로 어떤 플러그인이든 가져올 수 있어요. grafana-lokiexplore-app 플러그인을 예로 들면:

https://grafana.com/api/plugins/grafana-lokiexplore-app 를 열고 links 섹션을 찾습니다.
https://grafana.com/api/plugins/grafana-lokiexplore-app/versions/1.0.2/download 같은 형태의 download url을 찾습니다.
이 URL을 사용해 플러그인 ZIP 파일을 다운로드한 뒤 위에서 설명한 대로 설치합니다.

Grafana Helm chart로 플러그인 설치

Grafana Helm chart로 플러그인을 설치할 수 있습니다. 아래 YAML 스니펫들은 모두 Grafana OnCall App 플러그인과 Redis 데이터 소스 플러그인의 v1.9.0을 설치합니다. 설치가 완료되면 플러그인이 성공적으로 설치됐다는 확인 메시지를 받을 수 있어요.

Method 1: plugins 필드 사용

values 파일에 설치할 플러그인 목록을 추가합니다. 구성에 대한 자세한 내용은 Helm chart 구성 참조를 참고하세요.

plugins:
  - https://grafana.com/api/plugins/grafana-oncall-app/versions/v1.9.0/download;grafana-oncall-app
  - redis-datasource

Method 2: GF_PLUGINS_PREINSTALL_SYNC 사용

values.yaml 파일에 다음을 추가합니다:

env:
  # Format: <plugin ID>@[<plugin version>]@<url to plugin zip>
  GF_PLUGINS_PREINSTALL_SYNC: [email protected]@https://grafana.com/api/plugins/grafana-oncall-app/versions/v1.9.0/download

  # Or without version and URL (latest version will be used)
  # GF_PLUGINS_PREINSTALL_SYNC: grafana-oncall-app

  # Multiple plugins (comma-separated)
  # GF_PLUGINS_PREINSTALL_SYNC: grafana-oncall-app,redis-datasource

Method 3: GF_PLUGINS_INSTALL 사용 (v12.1.0부터 deprecated)

values.yaml 파일에 다음을 추가합니다:

env:
  # Comma-separated list of plugin IDs
  GF_PLUGINS_INSTALL: grafana-oncall-app,redis-datasource

플러그인 설치