복세편살 개발라이프
프로그래밍 & IT › Infra

Grafana 13.3 리뷰 정리: 대시보드 공유 변수와 Notebooks, 기능 토글로 켜는 법

· 읽는 시간 4분

목차
  1. 3줄 요약
  2. 무엇이 바뀌었나
  3. 운영 관점에서 볼 점
  4. 적용해 보려면
  5. 정리
  6. 참고 자료

3줄 요약

  • Grafana 13.3에서 변수를 한 번 정의해 여러 대시보드에서 함께 쓰는 '대시보드 간 공유 변수'가 모든 에디션에 퍼블릭 프리뷰로 나왔습니다 [1].
  • 패널과 조사 메모를 한 문서에 모아 공유하는 Notebooks도 퍼블릭 프리뷰로 추가되어, 장애 조사 기록과 사후 리뷰 준비에 쓸 수 있습니다 [1].
  • 셀프 호스팅 환경에서는 grafana.dashboardGlobalVariables, dashboard.notebooks 기능 토글을 켜야 체험할 수 있습니다 [1].

무엇이 바뀌었나

대시보드 간 공유 변수입니다. 지금까지는 환경(env)이나 리전 같은 선택 상자를 대시보드마다 따로 만들어야 했습니다. 13.3부터는 변수를 한 곳에서 정의하고 여러 대시보드에 붙일 수 있습니다 [1]. Grafana는 복사본을 따로 관리하면 설정이 조금씩 어긋나는 '설정 드리프트'가 생길 수 있다고 설명합니다 [1]. 이 요구는 2021년 GitHub 토론에서도 나왔던 오래된 요청이었습니다 [1].

변수 범위는 두 가지입니다. 조직 전체에서 쓰는 글로벌 범위와, 같은 폴더의 대시보드로 한정하는 폴더 범위입니다 [1]. 편집자는 대시보드 사이드바에서 쓸 수 있는 변수를 하나씩 또는 한꺼번에 추가합니다 [1]. 뷰어는 선택 값을 바꿀 수 있지만 변수 설정 자체는 중앙에서 관리됩니다 [1]. 관리 화면은 대시보드 편집기와 분리되어 Dashboards > Variables에 있습니다 [1].

Notebooks는 대시보드나 Explore의 패널, 직접 쓴 관찰 내용, Grafana Assistant의 분석 결과를 한 문서에 담는 기능입니다 [1]. 수동으로 만들거나 Assistant로 생성한 뒤 저장·공유할 수 있습니다 [1]. Grafana Cloud에는 점진적으로 배포되고 있습니다 [1]. 출처는 Datadog, New Relic에도 비슷한 조사 문서 기능이 있다고 소개합니다 [1].

그 밖의 변경도 있습니다.

  • Assistant의 대시보드 계획(퍼블릭 프리뷰): 모니터링하고 싶은 내용을 설명하면 제목, 패널, 시각화 유형, 변수가 담긴 레이아웃 안을 채팅에서 먼저 보여 줍니다. 읽기 전용 미리보기로 다듬은 뒤 생성 여부를 고릅니다 [1].
  • Undo turn(정식 출시): Assistant가 여러 패널을 바꾼 경우에도 이전 상태로 되돌립니다 [1].
  • 비주얼 리프레시(프리뷰): 테마와 UI 컴포넌트를 새로 다듬었습니다 [1].

운영 관점에서 볼 점

  • 프리뷰 단계라는 점: 공유 변수, Notebooks, 대시보드 계획은 모두 퍼블릭 프리뷰입니다 [1]. 프로덕션 대시보드 전체를 한 번에 옮기기보다 일부 폴더에서 먼저 시험하는 편이 안전합니다.
  • 범위 설계: 글로벌 변수는 조직 전체에 영향을 줍니다 [1]. 팀별로 값 체계가 다르다면 폴더 범위부터 쓰는 것이 영향 범위를 줄입니다.
  • GitOps 흐름: 한 초기 테스터는 Terraform 템플릿 없이 Git Sync를 평가할 때 공유 변수가 유용했다고 전했습니다 [1]. 다만 기존 코드 기반 대시보드 관리와 어떻게 맞물리는지는 출처에서 자세히 확인되지 않았습니다.
  • Undo의 한계: Assistant 편집 이후 대시보드가 다른 이유로 바뀌었다면 되돌리기를 쓸 수 없습니다 [1]. 여러 사람이 동시에 편집하는 대시보드에서는 이 점을 알려 두어야 합니다.
  • 플러그인 호환성: Grafana Labs는 비주얼 리프레시가 기존 내비게이션과 작업 흐름을 유지하고 플러그인에 호환성을 깨는 변경이 없다고 밝혔습니다 [1]. 표준 컴포넌트와 테마 토큰을 쓰는 플러그인은 새 모습이 자동 적용되고, 자체 스타일을 쓰는 플러그인은 따로 옮기면 됩니다 [1].
  • 비용: 가격이나 라이선스 변경은 출처에 언급되지 않았습니다.

적용해 보려면

  1. 셀프 호스팅 Grafana를 13.3으로 올립니다. 업그레이드 절차와 호환 조건은 출처에 없으므로 공식 업그레이드 가이드를 확인합니다.
  2. 쓰려는 기능의 토글을 켭니다. 공유 변수는 grafana.dashboardGlobalVariables, Notebooks는 dashboard.notebooks, 비주얼 리프레시는 grafana.visualDesignRefresh입니다 [1]. 토글을 설정하는 구체적인 파일과 문법은 출처에 나오지 않으므로 공식 문서를 따릅니다.
  3. Dashboards > Variables에서 env, region처럼 자주 쓰는 변수를 글로벌 또는 폴더 범위로 만듭니다 [1].
  4. 대시보드 편집 모드의 사이드바에서 변수를 개별 또는 일괄로 추가합니다 [1].
  5. 다음 장애 대응 때 관련 패널과 메모를 Notebook에 모아 사후 리뷰 초안으로 씁니다 [1].
  6. 비주얼 리프레시는 이전 디자인으로 되돌릴 수 있으므로 [1], 자체 스타일 플러그인이 있다면 화면을 미리 점검합니다.

정리

Grafana 13.3의 핵심은 대시보드마다 반복되던 변수 설정을 한 곳으로 모으고, 장애 조사 과정을 문서로 남기는 흐름을 Grafana 안에 들여온 것입니다 [1]. 아직 프리뷰이므로 셀프 호스팅 환경에서는 기능 토글로 범위를 좁혀 시험하고, 변수 범위와 Assistant 편집 되돌리기 조건을 팀과 미리 공유해 두는 것을 권합니다.

참고 자료

  1. Grafana 13.3 Adds Shared Dashboard Variables and Notebooks · InfoQ DevOps, 2026-11-21

#Grafana#Grafana 13.3#Notebooks#Grafana Assistant#기능 토글#옵저버빌리티