자체 관리 Grafana 인스턴스 업그레이드 전략
자체 관리 Grafana 인스턴스 업그레이드 전략
Grafana Labs는 기능을 빠르고 자주 제공하는 것을 믿고 있고, 최근 몇 년 동안 그 철학에 대한 commitment를 강화해 왔어요.
더 이상 연례 메이저 릴리스를 기다렸다가 다음 큰 개선에 접근하지 않아요. 대신 연중 내내 자체 관리형 사용자(Grafana OSS와 Grafana Enterprise)에게 정기적으로 새 기능, 버그 수정, 보안 패치를 제공해요.
안정적인 릴리스 프로세스를 갖추면 사용자에게 최고의 Grafana 경험을 제공하고, 사용자와 조직에 가장 잘 맞는 방식으로 업그레이드할 수 있는 유연성도 줘요.
참고: Grafana Cloud는 Grafana OSS 및 Enterprise와 다른 릴리스 주기를 따르는 점 참고해요. Cloud에서 Grafana는 Rolling release 채널을 사용해요. 릴리스 채널에 대해 더 알고 싶으면 Grafana Cloud의 Rolling release channels를 참고하세요.
출처: 문서
본문
릴리스 유형별 기대사항
Grafana OSS와 Grafana Enterprise 릴리스를 세 가지 주요 범주로 나눠요:
- 마이너 릴리스 (격월): 새 기능, 폐기 공지, 예정된 breaking change 공지, 이전에 공지된 breaking change, 버그 수정, 보안 취약점 패치가 포함될 수 있어요.
- 메이저 릴리스 (연 1회, 4월/5월): 마이너 릴리스와 비슷하지만, GrafanaCON과 1년에 한 번만 업그레이드하려는 사용자를 위한 종합 업그레이드 가이드가 함께 제공돼요.
- 패치 릴리스 (최소 월 1회): 현재 지원되는 버전의 버그 수정과 보안 취약점 패치가 포함돼요.
주기를 스스로 고를 수 있어요. 자주 업데이트하려면 마이너 릴리스(예: 11.1에서 11.2로)를 따르는 게 좋아요. 최신 기능에도 접근할 수 있거든요. 새 릴리스를 검토할 시간이 더 필요하면 메이저 릴리스를 따르세요. 두 전략 모두 보안 수정이 포함된 패치 릴리스를 받아요 (심각도 높은 보안 수정은 임시 패치 릴리스로도 나와요). 업그레이드 주기에 대한 추가 지침은 이 가이드의 뒷부분에서 다룰게요.
릴리스별 세부 사항 찾기
모든 훌륭한 기능을 공유해서 Grafana를 최대한 활용하게 해드리고 싶어요. 또한 완전한 릴리스 문서가 있으면 자신 있게 업그레이드할 수 있다는 것도 이해해요.
버그가 수정됐는지, 보안 취약점이 패치됐는지, breaking change의 영향을 완화하는 방법을 이해하는 것 등, 적절한 문서가 있으면 로컬 Grafana 인스턴스를 언제 업그레이드할지 정보에 기반한 결정을 내릴 수 있어요.
다양한 필요를 위해 여러 곳에 릴리스 문서를 제공해요:
- What’s new는 각 메이저·마이너 릴리스에서 데뷔하는 새 기능을 설명해요.
- Breaking changes는 메이저 릴리스에 포함된, 사용자에게 영향을 줄 수 있는 업데이트를 알리고 필요 시 완화 권장 사항을 제공해요.
- Upgrade guides는 더 새로운 마이너 또는 메이저 버전으로 업그레이드하는 방법을 안내해요.
- 마지막으로, 모든 릴리스(메이저, 마이너, 패치, 보안)마다 changelog가 생성되어 그 릴리스에 포함된 모든 변경 사항을 설명해요.
릴리스 시기
Grafana는 격월로 새 마이너 버전을 릴리스하고 그 사이에 패치 릴리스를 냅니다. 아래는 2026년 남은 기간의 계획된 릴리스예요. 다만 이 날짜는 변경될 수 있어요:
| Release date | Grafana versions | Release type |
|---|---|---|
| Feb. 24, 2026 | 12.4 & Supported versions | Minor & patching |
| Apr. 14, 2026 | Grafana 13 | Major |
| Jun. 23, 2026 | 13.1 & Supported versions | Minor & patching |
| Jul. 21, 2026 | Supported versions | Patching |
| Aug. 4, 2026 | Supported versions | Patching |
| Aug. 18, 2026 | 13.2 & Supported versions | Minor & patching |
| Sept. 1, 2026 | Supported versions | Patching |
| Oct. 20, 2026 | 13.3 & Supported versions | Minor & patching |
몇 가지 중요한 참고사항
- 위 일정은 릴리스 날짜를 어떻게 계획하는지 요약해요. 하지만 예상치 못한 사건과 상황으로 날짜가 바뀔 수 있어요.
- 심각도 높은 보안 및 기능 저하 사고는 사전에 예정되지 않은 임시 릴리스가 돼요.
- 패치 릴리스는 지원되는 모든 마이너 버전을 대상으로 해요. 각 지원 마이너 버전은 수명 종료(EOL)까지 버그 수정과 보안 패치가 포함된 패치 릴리스를 받아요.
- 릴리스 프리즈: Grafana는 매년 휴가 시즌에 맞춰 두 번의 릴리스 프리즈를 시행해요. 이 기간에는 예정된 릴리스가 실행되지 않아요. 다만 운영·보안 사고 중 필요할 수 있는 변경에는 적용되지 않아요.
Grafana 보안 릴리스: 개선된 버전 명명 규칙
보안 릴리스 버전의 명명 규칙을 개선해서 표준 패치 릴리스와 보안 릴리스를 명확히 구분하기 쉽게 만들었어요.
과거에는 치명적 취약점이 패치 버전을 올리는 예정 없는 릴리스(예: 10.3.0 → 10.3.1)를 트리거했어요. 하지만 이 릴리스들의 명명 규칙이 업데이트의 성격을 명확히 전달하지 않는다는 것을 발견했어요. 예를 들어 11.3.0에서 11.3.1로 버전이 바뀌면 보안 수정인지, 버그 수정인지, 사소한 기능 업데이트인지 알 수 없었어요. 이런 명확성 부족이 업데이트의 시급성과 성격에 대한 혼란을 일으켰어요.
참고: Docker는 이미지 태그 이름에 더하기(+) 기호를 허용하지 않아요. 더하기(+) 기호는 docker 태그에서 대시(-)로 렌더링돼요.
새 접근 방식이 이 문제를 직접 해결해요. 앞으로 보안 릴리스는 해당 버전 PLUS 보안 수정임을 나타내기 위해 "+security"가 붙어요.
예: "11.2.3+security-01"이라는 이름의 릴리스는 11.2.3에서 릴리스된 것 PLUS 표시된 보안 수정으로 구성돼요. 릴리스되면 보안 수정은 영향받는 버전의 향후 모든 릴리스에도 자동으로 포함돼요.
이 명명 규칙은 보안 업데이트와 그 기반이 되는 Grafana 버전을 식별하기 쉽게 만들어, 각 릴리스의 중요성과 시급성을 더 잘 이해하게 해줘요.
버전 지원에 대해 알아야 할 것
자체 관리 Grafana 사용자는 새 버전을 언제 업그레이드할지 스스로 통제해요. 업그레이드할 때인지 정보에 기반해 결정 내리도록, 현재 버전에 대해 제공되는 지원 수준을 이해하는 것이 중요해요.
자체 관리 Grafana(Enterprise와 OSS 모두)의 버전 지원은 다음 규칙을 따릅니다:
- 각 마이너 릴리스는 출시일 후 9개월간 지원돼요
- 메이저 버전의 마지막 마이너 릴리스는 출시일 후 15개월의 연장 지원을 받아요
- 새 버전이 나오면서 지원 수준이 바뀌어요:
- Full Support: 현재 메이저 버전이 새 마이너 릴리스를 통해 새 기능을 받아요
- Patch Support: 개별 마이너 버전이 수명 종료까지 패치 릴리스(버그 수정·보안 패치)를 받아요
- Not Supported: 지원 기간을 지난 버전은 업데이트를 받지 못해요
2027년까지의 버전 지원 개요는 다음과 같아요:
| Version | Release date | Support end date | Support level |
|---|---|---|---|
| 11.4.x | December 5, 2024 | September 5, 2025 | Not Supported |
| 11.5.x | January 28, 2025 | October 28, 2025 | Not Supported |
| 11.6.x (Last minor of 11) | March 25, 2025 | June 25, 2026 | Not Supported |
| 12.0.x | May 5, 2025 | February 5, 2026 | Not Supported |
| 12.1.x | July 22, 2025 | April 22, 2026 | Not Supported |
| 12.2.x | September 23, 2025 | June 23, 2026 | Not Supported |
| 12.3.x | November 19, 2025 | August 19, 2026 | Not Supported |
| 12.4.x (Last minor of 12) | February 24, 2026 | May 24, 2027 | Patch Support |
| 13.0.x | April 14, 2026 | January 9, 2027 | Patch Support |
| 13.1.x | June 23, 2026 | March 20, 2027 | Patch Support |
| 13.2.x | August 18, 2026 | May 18, 2027 | Patch Support |
| 13.3.x | October 20, 2026 | July 20, 2027 | Patch Support |
이 버전들은 어떻게 지원되나요?
자체 관리 Grafana는 유사 시맨틱 버저닝(MAJOR.MINOR.PATCH)을 따릅니다. 다른 유형의 릴리스가 어떻게 동작하는지 살펴볼게요:
- 메이저 릴리스 (예: 12.0.0, 13.0.0): 훌륭한 새 기능뿐 아니라 상당한 아키텍처 개선과 현대화 포함
- 마이그레이션 단계가 필요한 breaking change를 포함할 수 있어요
- 연 1회 릴리스
- 마이너 릴리스 (예: 12.3.0, 12.4.0): 새 기능과 개선 포함
- 버그 수정·보안 패치 포함
- 격월 릴리스
- 패치 릴리스 (예: 12.3.1, 12.3.2): 버그 수정과 보안 패치만 포함
- 새 기능 없음 — 기능은 다음 마이너 릴리스까지 기다려요
- 월간 릴리스
버전별 지원 수준:
- Full Support (현재 메이저 버전): 대략 격월로 새 기능이 든 새 마이너 릴리스를 받아요
- 메이저 내 모든 마이너 버전이 수명 종료까지 패치 릴리스를 받아요
- 예: 메이저 12.x는 12.1.0, 12.2.0, 12.3.0 등으로 새 기능을 받아요
- Patch Support (개별 마이너 버전): 각 마이너 버전이 수명 종료까지 패치 릴리스(버그 수정·보안 패치)를 받아요
- 새 기능 없음 — 기능은 새 마이너 릴리스와 함께만 와요
- 예: 12.3.x는 수정만 담긴 12.3.1, 12.3.2 등을 받아요
- Not Supported: 지원 기간을 지난 버전은 업데이트를 받지 못하고 업그레이드해야 해요.
예: 12.3.0이 릴리스되면 새 기능이 포함돼요. 12.3.1, 12.3.2 같은 이후 릴리스는 버그 수정과 보안 업데이트만 포함해요. 12.3.0 이후 개발된 모든 새 기능은 12.4.0이 릴리스될 때까지 기다려요.
치명적 기능 저하란 무엇인가요?
치명적 기능 저하는 보통 다음 기준 중 하나를 충족해요:
- 주요 기능이 전 세계적으로 사용 불가 (예: 대시보드 생성 불가, 인증 불가).
- 상당수의 고객에게 주요(치명적) 영향.
- 한 명 이상의 고객에게 발생한 주요 확대 사고.
자체 관리 업그레이드 전략
필요에 따라 이상적인 업그레이드 전략을 고르세요. 실제로는 이렇게 보일 수 있어요:
| Strategy/cadence | Advantages/disadvantages | Example upgrade procedure |
|---|---|---|
| Minor / bi-monthly (11.1 to 11.2) | Our recommended strategy. It combines up-to-date, secure releases with access to latest features as soon as they’re released. Small changelog to review. Highest compatibility with actively maintained plugins. Easy migration to Grafana Cloud. | January 2025: You review the 11.5 changelog and deploy the release to testing. February 2025: You deploy 11.5 to production. March 2025: 11.6 is released. |
| Major / yearly (10.0 to 11.0) | Yearly upgrade path that still gives access to up-to-date features presented at GrafanaCON. Big changelog to review. High compatibility with plugins. Relatively easy migration to Grafana Cloud. | May 2024: 11.0 is released, you start a big changelog review. June 2024: You deploy 11.0 to testing. July 2024: You deploy 11.0 to production. May 2025: 12.0 is released. |
| Previous major / yearly (10.4 to 11.6) | Release with extended support timeline. Limited compatibility with actively developed plugins. Big changelog to review. Migrations to Grafana Cloud might require professional support. | May 2025: 12.0 is released, marking the previous minor (11.6.x) with extended support, you start a big changelog review (10.4.x to 11.6.x). June 2025: You deploy 11.6.x to testing. July 2025: You deploy 11.6.x to production. |
가장 유연하려면 "minor" 전략을 따르세요. 가끔 주기를 한 분기 전체로 늘려도 현재 배포된 마이너 릴리스가 보안 수정으로 지원받는 데 계속 의존할 수 있으니까요.
업그레이드 시기·여부를 결정하는 요소
업그레이드 전에 다음 요소를 고려하세요:
- 현재 버전의 지원 상태와 지원 종료 시기
- 사용 중인 기능·플러그인과 새 버전의 호환성
- 도입 예정 breaking change와 마이그레이션 단계
- 업그레이드 후 회귀(버그) 위험을 낮추기 위한 테스트 환경 계획
Grafana 팀이 릴리스 과정에서 버그와 장애를 잡는 방법
- 각 팀은 코드에 자동화 테스트를 작성하고, 단위 테스트·통합 테스트·엔드투엔드 테스트·부하 테스트를 포함한 자동화 테스트를 실행해요. 특히 플러그인은 데이터 소스의 프런트엔드와 백엔드 부분(단위), 데이터 소스를 다양한 Grafana 버전 매트릭스와 통합(E2E), 데이터 소스와 그것이 소비하는 API 사이의 계약(통합)을 테스트해요.
- 새 기능에 대해 내부 관측성 스택에 배포해 수동 인수·스모크 테스트를 수행해요. 그 후 Grafana Cloud에서 점진적으로 롤아웃하고, OSS·Enterprise 릴리스를 잘라내요. 각 단계가 버그를 잡아요.
- 새 기능을 기능 토글 뒤의 Experimental 또는 Private Preview 릴리스 단계로 출시해요. 개발 중에 기능을 개선하는 데 도움이 돼요. 기능 조기 접근(개발·테스트 환경 포함)에 관심이 있으면 알려주세요.
- Grafana와 모든 플러그인, 의존성을 보안 취약점에 대해 지속적으로 스캔해요.
업그레이드 중 버그·문제 가능성 최소화하기
철저한 테스트에도 불구하고 업그레이드할 때 문제를 겪을 수 있어요.
버그
버그는 릴리스의 코드 변경으로 발생한 예상치 못한 부작용으로 문제를 일으켜요. 일부 버그는 모든 사용자에게 발생하고, 보통 테스트 초기 단계에서 잡아요. 다른 버그는 특정 구성이나 특이한 사용 사례를 가진 소수의 Grafana 인스턴스에서 발생해요. 예를 들어 특정 인증 설정이나 기능 토글 조합처럼요. Grafana 플러그인도 API로 외부 서비스와 상호작용해 데이터를 쿼리하는데, 때로 이 API가 예고 없이 바뀌어 그 데이터소스에 의존하는 대시보드에 문제를 일으켜요. Grafana Labs는 이 API들을 정기적으로 테스트하는 모니터링을 갖추고 있지만, 때로 예상치 못한 방식으로 고장 나요.
버그 위험을 줄이려면 최신 상태를 유지하고 프로덕션 전에 dev·test 환경에서 업그레이드를 롤아웃하세요. Grafana Enterprise 라이선스는 이 목적을 위한 추가 dev/test 인스턴스를 제공하며, 계정 팀을 통해 받을 수 있어요. Grafana Cloud에서는 rolling release 채널을 사용해 프로덕션보다 먼저 업그레이드되는 dev/test 스택을 만들 수 있어요.
- 정기적으로, 특히 업그레이드 전에 데이터베이스를 백업하세요.
- dev나 test에서 문제가 있으면 롤백하고 문제를 보고하세요.
- Cloud에서는 fast 채널로 dev/test 스택을, steady 또는 slow로 프로덕션 스택을 실행하세요. 릴리스 채널을 바꾸려면 지원 티켓을 여세요.
알려진 breaking changes
원칙적으로 항상 하위 호환성과 마이그레이션을 추구하고, breaking change는 Grafana의 연 1회 메이저 릴리스로 아껴두요. 하지만 때때로 작은 breaking change(API 페이로드 업데이트처럼)가 마이너 릴리스로 나오기도 해요. 이것들은 업그레이드 가이드, What’s New, changelog에서 공지해요.
업그레이드 전에는 항상 업그레이드 가이드와 changelog를 읽어 breaking change를 파악하고 대비하세요.
플러그인 비호환성
Grafana 코어는 단일 바이너리로 제공되며 대시보드, 알림, Explore, 인증·권한 부여, Reporting, 일부 코어 데이터 소스, 기타 구성 요소로 구성돼요. 하지만 Grafana를 쓰는 거의 모든 사람이 Grafana와 독립적으로 릴리스되는 플러그인(패널, 데이터 소스, 애플리케이션)도 사용해요. 모든 플러그인 버전은 Grafana 버전 의존성을 나열해요(https://grafana.com/grafana/plugins/에서 볼 수 있어요). 하지만 다른 플러그인의 다른 버전도 서로 상호작용할 수 있어요 — 예를 들어 Grafana의 패널에서 데이터 소스의 데이터를 시각화할 수 있는데, 세 가지 모두 서로 독립적으로 버전이 매겨져요. 테스트에서 잡기 어려운 문제를 만들 수 있어요.
플러그인 비호환성 가능성을 최소화하려면 최신 버전의 플러그인을 실행하고 정기적으로 업데이트하세요. Grafana를 업데이트하기 전에 항상 플러그인을 먼저 업데이트하세요. 플러그인도 Semver 패턴을 따르므로, 해당 플러그인의 새 메이저 버전으로 업그레이드하기 전에 플러그인의 changelog에서 breaking change를 검토하세요.