그라파나

그라파나 업그레이드

구일칠구 2022. 8. 13. 02:10

그라파나 업그레이드

최신 수정 사항 및 개선 사항을 최신 상태로 유지하려면 Grafana를 자주 업그레이드하는 것이 좋습니다. 이를 실현하기 위해 Grafana 업그레이드는 이전 버전과 호환되며 업그레이드 프로세스가 간단하고 빠릅니다.

업그레이드는 일반적으로 안전하며(많은 부 버전과 하나의 주 버전 사이) 대시보드와 그래프는 동일하게 보입니다. 릴리스 노트 변경 로그 에 설명된 일부 엣지 케이스에서 사소한 주요 변경 사항이 있을 수 있습니다.

지원

업그레이드를 롤백해야 하는 경우에 대비하여 몇 가지 항목을 백업하는 것이 좋습니다.

  • 설치된 플러그인 - Grafana 버전을 롤백하고 업그레이드 전에 실행했던 것과 똑같은 버전을 얻으려면 업그레이드하기 전에 백업하십시오.
  • 구성 파일은 백업할 필요가 없습니다. 그러나 업그레이드 후에 새 구성 옵션을 추가한 다음 롤백하는 경우를 대비하여 원할 수 있습니다.

데이터베이스 백업

업그레이드하기 전에 Grafana 데이터베이스를 백업하는 것이 좋습니다. 이렇게 하면 항상 이전 버전으로 롤백할 수 있습니다. 시작하는 동안 Grafana는 데이터베이스 스키마를 자동으로 마이그레이션합니다(변경 사항이나 새 테이블이 있는 경우). 나중에 다운그레이드하려는 경우 때때로 이로 인해 문제가 발생할 수 있습니다.

SQLite

sqlite를 사용하는 경우 grafana.db파일을 백업하기만 하면 됩니다. 이것은 일반적 /var/lib/grafana/grafana.db으로 Unix 시스템에 있습니다. 사용하는 데이터베이스와 저장 위치가 확실하지 않은 경우 grafana 구성 파일을 확인하십시오. 바이너리 tar/zip을 사용하여 사용자 지정 위치에 grafana를 설치한 경우 일반적으로 <grafana_install_dir>/data.

mysql

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

포스트그레스

backup:
  > pg_dump grafana > grafana_backup
  
  restore:
  > psql grafana < grafana_backup
  

우분투 또는 데비안

Grafana를 설치할 때와 동일한 절차에 따라 Grafana를 업그레이드할 수 있습니다.

데비안 패키지 업그레이드

Debian 패키지( )를 다운로드하여 Grafana를 설치했다면 동일한 명령을 새 패키지로 .deb실행할 수 있습니다 . dpkg -iGrafana 설치를 업그레이드합니다.

최신 다운로드 링크를 보려면 다운로드 페이지 로 이동 하십시오.

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

APT 저장소에서 업그레이드

APT 저장소에서 Grafana를 설치한 경우 모든 시스템 패키지를 업그레이드하기 위해 apt-get upgrade를 실행할 때 Grafana가 자동으로 업데이트됩니다.

sudo apt-get update
  sudo apt-get upgrade
  

바이너리 .tar 파일에서 업그레이드

바이너리 .tar.gz패키지를 다운로드했다면 새 패키지를 다운로드하여 압축을 풀고 기존 파일을 모두 덮어쓸 수 있습니다. 그러나 이렇게 하면 구성 변경 사항을 덮어쓸 수 있습니다.

사용자 지정 구성 변경 사항을 이라는 파일에 저장하는 것이 좋습니다 <grafana_install_dir>/conf/custom.ini. 이를 통해 구성 변경 사항을 잃을 위험 없이 Grafana를 업그레이드할 수 있습니다.

센토스 / RHEL

RPM 패키지를 다운로드하여 Grafana를 설치한 경우 동일한 설치 가이드를 따르고 동일한 yum install또는 rpm -i명령을 새 패키지로 실행할 수 있습니다. Grafana 설치를 업그레이드합니다.

YUM 저장소를 사용한 경우:

sudo yum update 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 바이너리 패키지를 다운로드했다면 새로운 패키지를 다운로드하고 같은 위치에 압축을 풀고 기존 파일을 덮어쓸 수 있습니다. 이렇게 하면 구성 변경 사항을 덮어쓸 수 있습니다. <grafana_install_dir>/conf/custom.ini구성 변경 사항을 손실하지 않고 쉽게 업그레이드할 수 있도록 구성 변경 사항을 이름이 지정된 파일에 저장하는 것이 좋습니다 .

플러그인 업데이트

업그레이드한 후에는 새 버전의 Grafana로 인해 이전 플러그인이 제대로 작동하지 않을 수 있으므로 모든 플러그인을 업데이트하는 것이 좋습니다.

다음을 사용하여 모든 플러그인을 업데이트할 수 있습니다.

grafana-cli plugins update-all
  

v5.0으로 업그레이드

대시보드 그리드 레이아웃 엔진이 변경되었습니다. 모든 대시보드는 v5에서 로드할 때 자동으로 새로운 위치 지정 시스템으로 업그레이드됩니다. v5에 저장된 대시보드는 이전 버전의 Grafana에서 작동하지 않습니다. 일부 외부 패널 플러그인이 제대로 작동하려면 업데이트해야 할 수 있습니다.

새로운 패널 위치 지정 시스템에 대한 자세한 내용은 패널 크기 위치 를 참조하십시오.

v5.2로 업그레이드

이 릴리스에 포함된 데이터베이스 마이그레이션 중 하나는 모든 주석 타임스탬프를 초에서 밀리초 정밀도로 업데이트합니다. 많은 양의 주석이 있는 경우 데이터베이스 마이그레이션을 완료하는 데 오랜 시간이 걸릴 수 있으며 systemd를 사용하여 Grafana를 실행하면 문제가 발생할 수 있습니다.

systemd, PostgreSQL 및 많은 양의 주석(테이블 크기 1645mb)을 사용하여 데이터베이스 마이그레이션을 완료하는 데 8-20분이 걸렸다는 보고서가 하나 있습니다. 그러나 grafana-server 프로세스는 systemd에 의해 90초 후에 종료되었습니다. systemd가 grafana-server 프로세스를 종료할 때 진행 중인 모든 데이터베이스 마이그레이션 쿼리는 완료될 때까지 데이터베이스에서 계속 실행됩니다.

systemd를 사용 중이고 많은 양의 주석이 있는 경우 업그레이드하기 전에 systemd TimeoutStartSec설정을 일시적으로 높게 조정하는 것이 좋습니다.30m

v6.0으로 업그레이드

스크립트 태그가 있는 텍스트 패널이 있는 경우 기본적으로 정제되지 않은 HTML을 허용하지 않는 새로운 설정으로 인해 더 이상 작동하지 않습니다. 새 설정에 대한 자세한 내용은 html 비활성화 를 참조하세요 .

인증 및 보안

Grafana의 내장, LDAP(Auth Proxy 없음) 또는 OAuth 인증을 사용하는 경우 모든 사용자는 업그레이드 후 다음 방문 시 로그인해야 합니다.

섹션 에서 로 cookie_secure설정 했다면 섹션 에서도 변경하고 싶을 것 입니다. 다음과 같은 구성으로 끝납니다.truesessioncookie_securetruesecurity

[session]
  cookie_secure = true
  
  [security]
  cookie_secure = true
  

login_remember_days, cookie_username및 섹션 cookie_remember_name설정 security은 더 이상 사용되지 않으므로 안전하게 제거할 수 있습니다.

0(영)으로 구성한 경우 login_remember_days유사한 동작을 수행하려면 구성을 변경해야 합니다. 즉, 로그인한 사용자는 강제로 다시 로그인해야 할 때까지 최대 1일 동안 로그인됩니다.

[auth]
  login_maximum_inactive_lifetime_days = 1
  login_maximum_lifetime_days = 1
  

인증 토큰을 저장하기 위한 기본 쿠키 이름은 입니다 grafana_session. login_cookie_name설정 에서 이것을 구성할 수 있습니다 [auth].

v6.2로 업그레이드

데이터 소스 비밀의 암호화 보장

데이터 소스는 기본적으로 암호화된 secureJsonData(CFB 모드의 AES-256)에 비밀번호와 기본 인증 비밀번호를 저장합니다. 기존 데이터 소스는 암호화되지 않은 비밀번호로 계속 작동합니다. 기존 데이터 소스에 대해 암호화된 스토리지로 마이그레이션하려는 경우 다음을 수행할 수 있습니다.

  • UI를 통해 생성된 데이터 소스의 경우 데이터 소스 구성으로 이동하여 비밀번호 또는 기본 인증 비밀번호를 다시 입력하고 데이터 소스를 저장해야 합니다.
  • 프로비저닝으로 생성된 데이터 소스의 경우 구성 파일을 업데이트하고 secureJsonData.password 또는 secureJsonData.basicAuthPassword 필드를 사용해야 합니다. 현재 구성의 예는 프로비저닝 문서 를 참조하십시오 .

그라파나 임베딩

<frame>, 또는 다른 웹사이트 <iframe>에 Grafana를 포함 하는 경우 기본적으로 브라우저에 Grafana 포함을 허용하지 않도록 지시하는 새로운 설정으로 인해 더 이상 작동하지 않습니다. Grafana 포함에 대한 자세한 내용 은 이 새 설정에 대한 구성 포함 을 참조하세요.<embed><object>

세션 저장소는 더 이상 사용되지 않습니다.

6.2에서는 이전 로그인 세션 구현을 인증 토큰으로 교체했기 때문에 백엔드 세션 저장소를 완전히 제거했습니다. LDAP와 함께 인증 프록시를 사용하는 경우 Grafana에서 공유 캐시가 사용되므로 대신 [remote_cache]를 구성할 수 있습니다. 그렇지 않은 경우 Grafana는 데이터베이스를 공유 캐시로 사용하도록 대체합니다.

Elasticsearch를 v7.0 이상으로 업그레이드

max concurrent shard requestsElasticsearch v7.0에서 변경된 의미는 릴리스 정보 를 참조하십시오.

Elasticsearch를 v7.0 이상으로 업그레이드하는 경우 Grafana에서 데이터 소스 구성을 업데이트하여 해당 버전이 7.0+올바르게 max concurrent shard requests구성되었는지 확인해야 합니다. 256은 v7.0 이전 버전에서 기본값이었습니다. v7.0 이상에서는 5가 기본값입니다.

v6.4로 업그레이드

주석 데이터베이스 마이그레이션

이 릴리스에 포함된 데이터베이스 마이그레이션 중 하나는 주석 범위를 나타내는 데 사용되는 여러 행을 단일 행으로 병합합니다. 지역 주석이 많은 경우 데이터베이스 마이그레이션을 완료하는 데 오랜 시간이 걸릴 수 있습니다. 이 프로세스를 관리하는 방법에 대한 팁은 v5.2로 업그레이드를 참조하십시오 .

도커

Grafana의 도커 이미지는 이제 Ubuntu 대신 Alpine 을 기반으로 합니다.

업데이트가 필요한 플러그인

  • 스플렁크

v6.5로 업그레이드

Grafana 6.5.0 이전 버전에서 CloudWatch 데이터 소스는 'id'가 없고 쿼리 편집기에 정의된 '표현식'이 없는 모든 쿼리에 GetMetricStatistics API를 사용했습니다. GetMetricStatistics API의 TPS(초당 트랜잭션 수)는 400개로 제한됩니다. 이 릴리스에서 모든 쿼리는 트랜잭션당 50TPS 및 100메트릭으로 제한되는 GetMetricData API를 사용합니다. 대부분의 사용자에게 이 전환이 원활할 것으로 예상하지만 조절 문제가 발생할 경우 TPS 할당량을 늘리는 것이 좋습니다. 그렇게 하려면 AWS 서비스 할당량 콘솔 을 방문하십시오 . CloudWatch API 제한에 대한 자세한 내용 은 CloudWatch 문서 를 참조하십시오 .

GetMetricData API에 대한 각 요청에는 100개의 쿼리가 포함될 수 있습니다. 즉, Grafana의 각 패널은 패널에 있는 쿼리 행 수에 관계없이 하나의 GetMetricData 요청만 발행합니다. 결과적으로 더 이상 HighRes쿼리 수준별로 설정할 수 없으므로 이 스위치는 이제 쿼리 편집기에서 제거됩니다. 쿼리 편집기에서 더 작은 최소 기간을 선택하여 고해상도를 얻을 수 있습니다.

차원 값의 다중값 템플릿 변수 처리가 Grafana 6.5에서 변경되었습니다. 다중 템플릿 변수를 사용할 때 Grafana는 검색 표현식을 생성합니다. GetMetricData API에서 표현식은 1024자로 제한되므로 값이 많은 다중값 템플릿 변수를 사용하는 경우 이 제한에 도달할 수 있습니다. *이 경우 다중 값 템플릿 변수 대신 와일드카드를 차원 값으로 사용하는 것이 좋습니다 .

v6.6으로 업그레이드

send_client_credentials_via_post비준수 공급자를 지원하는 데 사용되는 일반 OAuth 설정 이 제거되었습니다. 이제부터 Grafana는 자격 증명을 특정 공급자에 대한 URL 또는 요청 본문의 일부로 보내야 하는지 여부를 자동으로 감지합니다. 결과는 해당 공급자에 대한 추가 OAuth 요청에 대해 기억되고 사용됩니다.

속성이 지정 SameSite=Lax되지 않은 경우 Chrome 80은 기본적으로 쿠키를 취급합니다 ( https://www.chromestatus.com/feature/5088147346030592 참조 ) .SameSite

Chrome의 이러한 변경으로 인해 쿠키에 속성이 추가 되지 않은 이전과 비교하여 이제 속성이 있는 쿠키를 렌더링 하도록 구성된 [security]설정 이 있습니다. 이전 동작을 가져오려면 대신 값을 사용하십시오. 자세한 내용 은 구성의 cookie_samesite를 참조 하십시오.cookie_samesitenoneSameSite=NoneSameSitedisablednone

참고: 현재 Mac OSX 및 iOS에 영향을 미치는 버그가 있어 SameSite=None쿠키가 SameSite=Strict사이트 간 요청으로 처리되어 전송되지 않습니다 . 자세한 내용은 https://bugs.webkit.org/show_bug.cgi?id=198181 을 참조하십시오. 이 문제가 해결될 때까지 SameSite=NoneSafari에서 제대로 작동하지 않을 수 있습니다.

이 버전의 Chrome은 안전하지 않은 SameSite=None쿠키도 거부합니다. 자세한 내용은 https://www.chromestatus.com/feature/5633521622188032 를 참조하세요. 로 구성된 경우 [security]설정 cookie_secure을 로 변경하고 trueHTTPS를 사용 하는지 확인하십시오 . 그렇지 않으면 Grafana의 인증이 제대로 작동하지 않습니다.cookie_samesitenone

v7.0으로 업그레이드

PhantomJS가 제거됨

PhantomJS는 Grafana v6.4에서 더 이상 사용되지 않으며 Grafana v7.0.0부터 모든 PhantomJS 지원이 제거되었습니다. 즉, Grafana는 더 이상 내장 이미지 렌더러와 함께 제공되지 않으며 Grafana 이미지 렌더러 플러그인 을 설치하는 것이 좋습니다 .

대시보드 최소 새로 고침 간격 적용

이제 전역 최소 대시보드 새로 고침 간격이 적용되며 기본값은 5초입니다. 이 설정에 대한 자세한 내용은 최소 새로 고침 간격 을 참조하세요 .

백엔드 플러그인

이제 Grafana를 사용하려면 백엔드 플러그인에 서명해야 합니다. 백엔드 플러그인이 서명되지 않은 경우 Grafana는 이를 로드/시작하지 않습니다. 이는 백엔드 플러그인 바이너리 및 파일이 변조되지 않았는지 확인하기 위한 추가 보안 조치입니다. 이제 Enterprise 플러그인을 포함하여 Grafana Labs에서 제작한 모든 백엔드 플러그인이 서명되었습니다. 구성 설정을 사용하여 서명되지 않은 플러그인을 허용하는 것이 가능하지만 하지 않는 것이 좋습니다. 이 설정에 대한 자세한 내용은 서명되지 않은 플러그인 로드 허용 을 참조하세요 .

Grafana v7.0.0부터 RFC 6265 에 맞추기 위해 Grafana가 하위 경로에서 제공되는 경우 쿠키 경로에 후행 슬래시가 포함되지 않습니다 . 그러나 오래된 세션 쿠키(업그레이드 전에 설정)는 변경된 쿠키 경로로 인해 표준 로그인 단계에서 삭제할 수 없기 때문에 로그인에 실패할 수 있습니다. 따라서 로그인 문제가 있는 사용자는 이전 세션 쿠키를 수동으로 삭제하는 것이 좋습니다. 그렇지 않으면 관리자가 을 변경하여 모든 사용자에 대해 이 문제를 수정할 수 login_cookie_name있으므로 이전 쿠키가 무시됩니다.

v7.2로 업그레이드

기존 경보 알림 채널 비밀의 암호화 보장

Grafana v7.2 이전 경고 알림 채널은 API 토큰 및 비밀번호와 같은 민감한 설정/비밀을 데이터베이스에 암호화하지 않았습니다. Grafana v7.2에서 새 경고 알림 채널을 생성하면 데이터베이스에 암호화된 민감한 설정이 저장됩니다.

중요한 설정을 암호화하여 저장할 수 있도록 다음 경고 알림이 업데이트되었습니다.

  • Slack(URL 및 토큰)
  • Pagerduty(통합 키)
  • 웹훅(비밀번호)
  • Prometheus Alertmanager(기본 인증 비밀번호)
  • Opsgenie(API 키)
  • 센수(비밀번호)
  • 텔레그램(BOT API 토큰)
  • LINE(토큰)
  • 푸시오버(API 토큰, 사용자 키)
  • Threema 게이트웨이(API 비밀)

기존 경고 알림 채널의 경우 암호화된 민감한 설정을 저장하는 자동 마이그레이션이 없으며 이전과 같이 계속 작동합니다. 마이그레이션은 수동으로 수행해야 합니다. UI에서 구성된 경고 알림 채널을 열고 저장하면 민감한 설정이 암호화되어 저장되고 동시에 데이터베이스에서 해당 경고 알림 채널의 암호화되지 않은 과거 설정이 재설정됩니다.

알림 채널을 마이그레이션하고 나중에 Grafana를 이전 버전으로 다운그레이드할 때 알림 채널은 저장된 민감한 설정을 읽을 수 없으며 결과적으로 예상대로 작동하지 않습니다.

경보 알림 채널 프로비저닝에 대해서는 경보 알림 채널 을 참조 하십시오 .

v7.3으로 업그레이드

AWS CloudWatch 데이터 소스

AWS CloudWatch 데이터 원본의 인증 체계가 Grafana 7.3에서 변경되었습니다. 가장 중요한 것은 인증 방법 ARN 이 제거되고 AWS SDK Default 라는 새로운 방법이 추가되었다는 것 입니다. 전자를 사용하는 기존 데이터 소스 구성은 후자로 대체됩니다. IAM 역할은 여전히 ​​작동하고 이전 ARN 방법은 기본 AWS SDK 인증 방법을 사용한다고 가정합니다.

ARN 은 인증 방법에서 제거되었으므로 대신 수임할 IAM 역할의 ARN을 제공하는 옵션으로 만들었습니다 . 이것은 선택한 인증 방법과 독립적으로 작동합니다.

새 인증 방법인 AWS SDK Default 는 기본 AWS Go SDK 자격 증명 체인을 사용하며, 작성 시 다음 순서로 자격 증명을 찾습니다.

  1. 환경 변수.
  2. 공유 자격 증명 파일.
  3. 애플리케이션이 ECS 작업 정의 또는 RunTask API 작업을 사용하는 경우 작업에 대한 IAM 역할.
  4. 애플리케이션이 Amazon EC2 인스턴스에서 실행 중인 경우 Amazon EC2에 대한 IAM 역할.

다른 인증 방법인 액세스 및 비밀 키 자격 증명 파일 은 대체와 관련하여 변경되었습니다. 이러한 방법이 실패하면 더 이상 다른 방법으로 대체되지 않습니다. 예를 들어 환경 변수. 대체를 원하는 경우 대신 AWS SDK Default 를 사용해야 합니다.

자세한 내용 은 Grafana에서 AWS CloudWatch 사용 을 참조하십시오 .

사용자가 데이터베이스 마이그레이션을 초대합니다.

사용자 초대를 추적하는 temp_user 데이터베이스 테이블 은 생성 업데이트된 열의 데이터 유형을 변경하는 데이터베이스 마이그레이션의 대상이 됩니다.

데이터 베이스이전 데이터 유형새 데이터 유형

스퀄라이트 날짜 시간 정수
MySQL 날짜 시간 지능
포스트그레스 타임스탬프 정수

Grafana를 이전 버전으로 다운그레이드하는 경우 생성 업데이트된 열의 데이터 유형을 수동으로 이전 데이터 유형 으로 다시 변경해야 합니다 . 그렇지 않으면 사용자 초대 기능이 예상대로 작동하지 않습니다.

스냅샷 데이터베이스 마이그레이션

대시보드 스냅샷을 저장 하는 데이터베이스 테이블 Dashboard_snapshot 은 암호화된 스냅샷을 저장하기 위한 새로운 열 Dashboard_encrypted 를 추가합니다. 참고: Grafana 7.3 이상에서 생성된 스냅샷만 이 열을 사용하여 암호화된 스냅샷 데이터를 저장합니다. 이 버전 이전에 생성된 스냅샷은 영향을 받지 않으며 암호화되지 않은 상태로 유지됩니다.

Docker 이미지에서 루트 그룹 사용

Grafana Docker 이미지는 root그룹 대신 그룹을 사용합니다 grafana. 이 변경으로 인해 Grafana Docker 이미지를 확장하는 사용자의 빌드가 중단될 수 있습니다. Docker 마이그레이션 지침 에서 이 변경 사항에 대해 자세히 알아보십시오.

v7.5로 업그레이드

VictorOps 경고 알리미

이제 VictorOps 경고 알리미는 PagerDuty 경고 알리미 severity와 유사한 맥락에서 태그를 허용합니다. 가능한 값은 VictorOps 문서 에 설명되어 있습니다.

예를 들어 INFOVictorOps에서 경고가 -level이 되도록 하려면 경고에서 태그 severity=info(대소문자 구분 안 함)를 만드십시오.

v8.0으로 업그레이드

플러그인

이제 Grafana를 사용하려면 모든 플러그인에 서명해야 합니다. 플러그인이 서명되지 않은 경우 Grafana는 플러그인을 로드/시작하지 않습니다. 이것은 플러그인 파일과 바이너리가 변조되지 않았는지 확인하기 위한 추가 보안 조치입니다. Enterprise 플러그인을 포함하여 모든 Grafana Labs 저작 플러그인이 이제 서명되었습니다. 구성 설정을 사용하여 서명되지 않은 플러그인을 허용하는 것이 가능하지만 하지 않는 것이 좋습니다. 이 설정에 대한 자세한 내용은 서명되지 않은 플러그인 로드 허용 을 참조하세요 .

그라파나 라이브

Grafana는 이제 실시간 메시징 요구 사항을 위해 지속적인 WebSocket 연결을 유지 관리합니다.

WebSocket 연결이 설정되면 Grafana는 보안상의 이유로 요청 Origin 헤더를 확인합니다(예: WebSocket 연결 하이재킹 방지). 올바르게 정의된 공개 URL( root_url서버 옵션)이 있는 경우 공개 URL 페이지에서 시작된 WebSocket 요청에 대해 출처 확인을 성공적으로 통과해야 합니다. 출발지 확인에 실패한 경우 Grafana는 403 오류를 반환합니다. 원점 확인을 위해 추가 원점 패턴 목록을 추가하는 것도 가능합니다.

많은 동시 WebSocket 연결을 처리하려면 OS 설정 또는 인프라를 조정해야 할 수 있습니다. Grafana Live는 기본적으로 활성화되어 있으며 최대 100개의 동시 WebSocket 연결을 지원하여 파일 설명자 OS 제한과 관련된 가능한 문제를 방지합니다. 설정이 지속적 연결 수를 확장하기 위한 요구 사항을 충족하는 즉시 이 제한을 늘릴 수 있습니다. Grafana Live를 비활성화하는 옵션도 있습니다.

자세한 내용은 Grafana Live 구성 문서를 참조하십시오.

Postgres, MySQL, Microsoft SQL Server 데이터 소스

Grafana v8.0은 기본 데이터 구조를 Postgres, MySQL, Microsoft SQL Server 데이터 소스의 데이터 프레임 으로 변경합니다. 결과적으로 시계열 쿼리 결과는 와이드 형식으로 반환됩니다 . 시각화가 이전과 같이 작동하도록 하려면 몇 가지 수동 마이그레이션을 수행해야 할 수 있습니다.

시간 열이 시간 범위 필터링에만 필요한 시계열 쿼리 를 사용하는 기존 패널/시각화 (예: 막대 게이지 또는 원형 차트 패널 사용)의 경우 대신 테이블 쿼리 를 사용 하고 시간을 제외하는 것이 좋습니다. 열을 응답의 필드로 사용합니다. 자세한 지침 및 해결 방법은 문제 설명 을 참조하십시오.

시리즈 이름에 접두사 추가

metric 이라는 이름이 지정되지 않은 문자열 값과 함께 선택된 시간 값과 숫자 값이 있는 쿼리가 있는 경우 그래프 패널은 Grafana 8 이전의 경우가 value <hostname>아니라 시리즈 이름을 렌더링합니다.<hostname>

SELECT
  $__timeGroup("createdAt",'10m'),
  avg(value) as "value",
  hostname
  FROM grafana_metric
  WHERE $__timeFilter("createdAt")
  GROUP BY time, hostname
  ORDER BY time
  

이 문제를 해결하기 위한 두 가지 가능한 해결 방법이 있습니다.

  1. Grafana v8.0.3에서는 로 선택된 문자열 컬럼의 alias를 사용합니다 metric. 예를 들어, hostname as metric.
  2. 표준 필드 정의의 표시 이름 을 사용 하여 별칭 형식을 지정합니다. 앞의 예제 쿼리의 경우 ${__field.labels.hostname}옵션을 사용합니다.

자세한 내용은 Postgres , MySQL , Microsoft SQL Server 의 관계형 데이터베이스 설명서를 참조하십시오 .

v8.1로 업그레이드

더 이상 지원되지 않는 데이터 소스에 대한 암호화되지 않은 비밀번호 사용

Grafana v8.1부터 암호 및 기본 인증 암호의 암호화되지 않은 저장을 더 이상 지원하지 않습니다.

참고: Grafana v6.2부터 신규 또는 업데이트된 데이터 소스는 암호와 기본 인증 암호를 암호화하여 저장합니다. 자세한 내용은 업그레이드 노트 를 참조하세요. 그러나 암호화되지 않은 암호와 기본 인증 암호도 허용되었습니다.

암호화된 스토리지로 마이그레이션하려면 v6.2 업그레이드 노트 의 지침을 따르세요 . 또한 grafana-cli명령을 사용하여 모든 데이터 원본을 마이그레이션하여 암호화된 비밀 저장소를 사용할 수 있습니다. 추가 지침은 데이터 마이그레이션 및 암호 암호화 를 참조하세요 .

8.3으로 업그레이드

8.3에서 Grafana 대시보드는 이제 데이터 소스 이름 속성 대신 uid및 속성이 있는 개체를 사용하여 데이터 소스를 참조합니다. type기존 대시보드가 ​​열리면 스키마 마이그레이션이 적용됩니다. 여러 Grafana 인스턴스에 대시보드를 프로비저닝하는 경우 데이터 소스도 프로비저닝하는 것이 좋습니다. uid인스턴스 전체의 데이터 소스에 대해 동일하도록 지정할 수 있습니다 . UI에서 생성된 데이터 소스 를 찾아야 한다면 uid데이터 소스 설정 페이지의 URL을 확인하세요. URL은 패턴 /data source/edit/${uid}을 따릅니다. 즉, 마지막 부분은 uid입니다.

8.5로 업그레이드

데이터 소스 의 개념은 default처음부터 Grafana에 존재했습니다. 그러나 그 의미와 행동은 분명하지 않았다. 기본 데이터 소스는 새 패널의 시작 데이터 소스일 뿐만 아니라 특수 값(null)을 사용하여 저장되었습니다. 이를 통해 기본 데이터 소스를 다른 데이터 소스로 변경할 수 있었고 해당 변경 사항이 기본 데이터 소스를 사용하는 모든 대시보드에 영향을 미쳤습니다.

이 동작은 매우 직관적이지 않았으며 기존 대시보드에 영향을 주지 않고 기본값을 변경하려는 사용자에게 문제를 일으킵니다. 이것이 8.5에서 동작을 변경하는 이유입니다. 이제부터 default데이터 소스는 지속 속성이 아니라 새 패널 및 쿼리를 위한 시작 데이터 소스일 것입니다. 여전히 null로 설정된 패널이 있는 기존 대시보드 datasource는 대시보드가 ​​열릴 때 마이그레이션됩니다. 마이그레이션은 데이터 원본 속성을 현재 기본 데이터 원본으로 설정합니다.

'그라파나' 카테고리의 다른 글

Grafana 이름 및 이메일 변경  (0) 2022.08.13
그라파나 다시 시작  (0) 2022.08.13
Kubernetes에 Grafana 배포  (0) 2022.08.12
Grafana Docker 이미지 실행  (0) 2022.08.12
macOS에 설치  (0) 2022.08.12