Grafana 13.3 리뷰 정리: 대시보드 공유 변수와 Notebooks, 기능 토글로 켜는 법
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].
- 비용: 가격이나 라이선스 변경은 출처에 언급되지 않았습니다.
적용해 보려면
- 셀프 호스팅 Grafana를 13.3으로 올립니다. 업그레이드 절차와 호환 조건은 출처에 없으므로 공식 업그레이드 가이드를 확인합니다.
- 쓰려는 기능의 토글을 켭니다. 공유 변수는
grafana.dashboardGlobalVariables, Notebooks는dashboard.notebooks, 비주얼 리프레시는grafana.visualDesignRefresh입니다 [1]. 토글을 설정하는 구체적인 파일과 문법은 출처에 나오지 않으므로 공식 문서를 따릅니다. - Dashboards > Variables에서 env, region처럼 자주 쓰는 변수를 글로벌 또는 폴더 범위로 만듭니다 [1].
- 대시보드 편집 모드의 사이드바에서 변수를 개별 또는 일괄로 추가합니다 [1].
- 다음 장애 대응 때 관련 패널과 메모를 Notebook에 모아 사후 리뷰 초안으로 씁니다 [1].
- 비주얼 리프레시는 이전 디자인으로 되돌릴 수 있으므로 [1], 자체 스타일 플러그인이 있다면 화면을 미리 점검합니다.
정리
Grafana 13.3의 핵심은 대시보드마다 반복되던 변수 설정을 한 곳으로 모으고, 장애 조사 과정을 문서로 남기는 흐름을 Grafana 안에 들여온 것입니다 [1]. 아직 프리뷰이므로 셀프 호스팅 환경에서는 기능 토글로 범위를 좁혀 시험하고, 변수 범위와 Assistant 편집 되돌리기 조건을 팀과 미리 공유해 두는 것을 권합니다.
참고 자료
- Grafana 13.3 Adds Shared Dashboard Variables and Notebooks · InfoQ DevOps, 2026-11-21