구성

구성

Grafana에는 기본 및 사용자 정의 구성 파일이 있습니다. 사용자 지정 구성 파일을 수정하거나 환경 변수를 사용하여 Grafana 인스턴스를 사용자 지정할 수 있습니다. Grafana 인스턴스에 대한 설정 목록을 보려면 서버 설정 보기 를 참조하십시오 .

참고: 사용자 지정 옵션을 추가한 후 구성 파일의 관련 섹션 에서 주석 을 제거하십시오. 변경 사항을 적용하려면 Grafana를 다시 시작하십시오.

구성 파일 위치

Grafana 인스턴스의 기본 설정은 $WORKING_DIR/conf/defaults.ini파일에 저장됩니다. 이 파일을 변경 하지 마십시오 .

OS에 따라 사용자 정의 구성 파일은 $WORKING_DIR/conf/defaults.ini파일 또는 /usr/local/etc/grafana/grafana.ini파일입니다. 사용자 지정 구성 파일 경로는 매개변수를 사용하여 재정의할 수 있습니다 --config.

리눅스

deb또는 패키지 를 사용하여 Grafana를 설치한 경우 rpm구성 파일은 에 있으며 /etc/grafana/grafana.ini별도의 파일은 custom.ini사용되지 않습니다. 이 경로는 --config파일 매개변수를 사용하여 Grafana init.d 스크립트에서 지정됩니다.

도커

환경 변수, 영구 저장소 및 사용자 지정 Docker 이미지 빌드에 대한 정보 는 Grafana Docker 이미지 구성 을 참조하십시오 .

창

Windows에서 sample.ini파일은 파일과 동일한 디렉토리에 defaults.ini있습니다. 주석 처리된 모든 설정이 포함되어 있습니다. 복사 sample.ini하고 이름을 지정합니다 custom.ini.

맥 OS

기본적으로 구성 파일은 에 있습니다 /usr/local/etc/grafana/grafana.ini. Homebrew를 사용하여 설치된 Grafana 인스턴스의 경우 grafana.ini파일을 직접 편집합니다. 그렇지 않으면 폴더에 이름 custom.ini이 지정된 구성 파일을 추가하여 conf에 정의된 설정을 재정의합니다 conf/defaults.ini.

.ini 파일에서 주석 제거

Grafana는 세미콜론( ;문자)을 사용하여 파일의 줄을 주석 처리 .ini합니다. custom.ini또는 해당 줄의 시작 부분에서 grafana.ini제거하여 수정하는 파일 의 각 줄에 대한 주석 처리를 제거해야 합니다 . ;그렇지 않으면 변경 사항이 무시됩니다.

예를 들어:

# The HTTP port  to use
;http_port = 3000

환경 변수로 구성 재정의

환경 변수를 사용하여 새 구성 설정 을 추가 하지 마십시오 . 대신 환경 변수를 사용하여 기존 옵션 을 재정의 하십시오.

옵션을 무시하려면:

GF_<SectionName>_<KeyName>
  

여기서 섹션 이름은 대괄호 안의 텍스트입니다. 모두 대문자 여야 .하며 -로 대체되어야 합니다 _. 예를 들어 다음과 같은 구성 설정이 있는 경우:

# default section
  instance_name = ${HOSTNAME}
  
  [security]
  admin_user = admin
  
  [auth.google]
  client_secret = 0ldS3cretKey
  
  [plugin.grafana-image-renderer]
  rendering_ignore_https_errors = true
  

다음을 사용하여 Linux 시스템에서 재정의할 수 있습니다.

export GF_DEFAULT_INSTANCE_NAME=my-instance
  export GF_SECURITY_ADMIN_USER=owner
  export GF_AUTH_GOOGLE_CLIENT_SECRET=newS3cretKey
  export GF_PLUGIN_GRAFANA_IMAGE_RENDERER_RENDERING_IGNORE_HTTPS_ERRORS=true
  

변수 확장

참고: Grafana 7.1 이상에서만 사용할 수 있습니다.

$__<provider>{<argument>} 옵션에 또는 식이 포함된 경우 ${<environment variable>}Grafana의 변수 확장기에 의해 처리됩니다. 확장기는 제공된 인수로 공급자를 실행하여 옵션의 최종 값을 가져옵니다.

env, file및 의 세 가지 공급자가 있습니다 vault.

환경 제공자

env공급자를 사용하여 환경 변수를 확장할 수 있습니다 . 옵션을 설정하면 $__env{PORT}환경 PORT변수가 대신 사용됩니다. 환경 변수의 경우 단축 구문을 사용할 수도 있습니다 ${PORT}. Grafana의 로그 디렉토리는 다음 예에서 환경 변수 grafana뒤에 있는 디렉토리의 디렉토리 로 설정됩니다.LOGDIR

[paths]
  logs = $__env{LOGDIR}/grafana
  

파일 제공자

file파일 시스템에서 파일을 읽습니다. 파일의 시작과 끝에서 공백을 자릅니다. 다음 예의 데이터베이스 비밀번호는 /etc/secrets/gf_sql_password파일 내용으로 대체됩니다.

[database]
  password = $__file{/etc/secrets/gf_sql_password}
  

금고 제공자

공급자를 통해 Hashicorp Vaultvault 로 비밀을 관리할 수 있습니다 .

볼트 공급자는 Grafana Enterprise v7.1+에서만 사용할 수 있습니다. 자세한 내용 은 Grafana Enterprise 의 Vault 통합 을 참조하십시오 .

---

앱 모드

옵션은 production및 development입니다. 기본값은 production입니다. Grafana 개발 작업을 하지 않는 한 이 옵션을 변경 하지 마십시오 .

instance_name

grafana-server 인스턴스의 이름을 설정합니다. 로깅, 내부 메트릭 및 클러스터링 정보에 사용됩니다. 기본값 ${HOSTNAME}은 환경 변수로 대체되며 HOSTNAME, 이것이 비어 있거나 존재하지 않는 경우 Grafana는 시스템 호출을 사용하여 시스템 이름을 가져오려고 시도합니다.

force_migration

강제 마이그레이션은 데이터 손실을 유발할 수 있는 마이그레이션을 실행합니다. 기본값은 false입니다.

---

[경로]

데이터

Grafana가 sqlite3 데이터베이스(사용되는 경우), 파일 기반 세션(사용되는 경우) 및 기타 데이터를 저장하는 경로입니다. 이 경로는 일반적으로 init.d 스크립트 또는 systemd 서비스 파일의 명령줄을 통해 지정됩니다.

macOS: 기본 SQLite 데이터베이스는 다음 위치에 있습니다./usr/local/var/lib/grafana

temp_data_lifetime

data디렉토리 의 임시 이미지를 보관해야 하는 기간 입니다. 기본값: 24h. 지원되는 수정자: h(시간), m(분), 예: 168h, 30m, 10h30m. 0임시 파일을 절대 정리하지 않는 데 사용 합니다.

로그

Grafana가 로그를 저장하는 경로입니다. 이 경로는 일반적으로 init.d 스크립트 또는 systemd 서비스 파일의 명령줄을 통해 지정됩니다. 구성 파일이나 기본 환경 변수 파일에서 재정의할 수 있습니다. 그러나 이것을 재정의하면 Grafana가 완전히 초기화/시작될 때까지 기본 로그 경로가 일시적으로 사용됩니다.

명령줄 인수를 사용하여 로그 경로 재정의 cfg:default.paths.logs:

./grafana-server --config /custom/config.ini --homepath /custom/homepath cfg:default.paths.logs=/custom/path
  

macOS: 기본적으로 로그 파일은 /usr/local/var/log/grafana/grafana.log.

플러그인

Grafana가 자동으로 플러그인을 검색하고 찾는 디렉토리입니다. 플러그인 수동 또는 자동 설치에 대한 정보는 Grafana 플러그인 설치 를 참조하십시오 .

macOS: 기본적으로 Mac 플러그인 위치는 /usr/local/var/lib/grafana/plugins.

프로비저닝

시작 시 Grafana가 적용할 프로비저닝 구성 파일 이 포함된 폴더입니다 . json 파일이 변경되면 대시보드가 ​​다시 로드됩니다.