Grafana 13.3.0 업그레이드: 설정 이름 변경과 Alerting 운영 점검
Grafana 13.3.0 업그레이드에서 설정 섹션 변경, 알림 가져오기와 외부 Alertmanager 동기화, 대시보드 기본값과 보안 수정의 확인 범위를 정한다.
2026-11-03
설정 섹션 이름부터 배포 변경에 반영한다
config.ini에 [marketplace]를 쓰고 있다면 Grafana 업그레이드 변경 목록에 [plugins_marketplace]로의 이름 교체를 넣어야 한다. **Grafana v13.3.0 (2026-10-27)**의 공식 릴리스노트는 이를 Breaking changes에 기재했다. 해당 절에 명시된 호환성 변경은 이 항목이다.
운영자가 먼저 확인할 대상은 현재 적용 중인 config.ini와 그 파일을 만드는 설정 템플릿이다. [marketplace]를 사용한다면 새 이름으로 변경하고, 배포 결과에도 [plugins_marketplace]가 반영됐는지 대조한다. 설정 파일을 직접 수정하는 환경이라면 파일을, 템플릿으로 생성하는 환경이라면 생성 결과까지 확인 대상으로 잡는다.
변경의 범위는 섹션 이름이다. 제공된 자료에는 개별 설정 키의 변경이나 기존 이름의 호환 처리 여부가 설명돼 있지 않다. 따라서 기존 이름도 계속 읽힐 것이라는 가정으로 배포를 진행하지 않는다.
다음 비교는 배포 전후에 대조할 설정 식별자를 보여 준다.
설정 변경과 별개로, Alpine Docker 이미지를 사용하는 환경은 이미지에 기대는 실행 절차도 확인할 필요가 있다. 이번 릴리스에는 Alpine Docker 이미지의 bash 의존성 제거가 포함됐다. 이미지 안에서 bash를 호출하는 자체 절차가 있다면 업그레이드 검증 대상에 넣는다. 릴리스노트에 없는 대체 셸이나 수정 명령을 일괄 적용하기보다는, 실제 호출 여부부터 확인하는 편이 정확하다.
알림 가져오기는 staged import의 검토와 승격을 확인한다
Import-to-GMA 마법사는 staged import를 기본 가져오기 방식으로 삼는다. staged import 구성의 승격 기능도 포함됐으며, 가져오기 방식 선택 단계는 제거됐다. 기존 화면의 단계나 선택 항목을 기준으로 만든 운영 문서가 있다면 새 마법사와 대조해야 한다.
Mimir에서 알림 구성을 가져오는 환경에는 alertmanager_config 파일 지원이 직접적인 변경이다. YAML 파일을 가져오기 소스로 드래그 앤드 드롭하는 기능도 추가됐다. 실제 사용하는 파일을 검증 환경의 가져오기 소스로 넣고, 검토 화면에 나타나는 구성을 확인한 뒤 staged import의 승격까지 검증 범위에 포함한다.
가져오기 중에는 화면 상태도 달라진다. import가 staged 상태일 때는 데이터 소스 선택기가 비활성화된다. 운영 절차에서 가져오기 도중 데이터 소스를 바꾸도록 안내하고 있었다면 그 부분을 다시 확인해야 한다. 마법사 미리보기에서는 비밀값을 가리는 변경도 들어갔다. 미리보기만으로 비밀값의 내용까지 대조하려는 절차는 검증 근거를 별도로 정해야 한다.
아래 흐름은 가져오기 소스와 staged 구성, 승격의 관계를 보여 준다.
검증할 때는 파일을 선택할 수 있는지만 보지 않는다. 이번 릴리스에는 Import 마법사의 오래된 dry-run 검증 결과와 YAML 오류에 관한 수정도 포함됐다. 정상 파일의 가져오기와 함께, 기존 운영에서 문제가 됐던 YAML 입력이 있다면 같은 입력으로 검증 결과가 갱신되는지 확인한다.
auto-sync를 사용하는 가져오기에서는 Rules 단계도 확인해야 한다. 릴리스노트에는 auto-sync 때문에 Rules 단계를 강제로 건너뛰던 동작을 막는 변경이 있다. 과거에 해당 단계가 생략되는 것을 전제로 작성한 절차라면 새 화면에서 검토할 항목을 다시 맞춘다.
외부 Alertmanager는 동기화 설정과 시작 직후 전달 경로를 나눠 검증한다
외부 Alertmanager auto-sync는 Config API를 중심으로 변경됐다. 릴리스노트에는 Config API 데이터 계층 추가, 설정 훅과 패널의 이전, Import-to-GMA 마법사의 auto-sync 연동 이전이 함께 기재돼 있다. 기존 admin_config auto-sync 경로의 폐기도 포함된다.
이 변경은 기존 auto-sync 절차를 그대로 재사용하기 전에 확인할 근거다. 자체 연동이나 운영 도구에서 admin_config 경로를 참조한다면 Config API 이전의 영향을 검토해야 한다. 다만 제공된 자료에는 새 엔드포인트, 요청 본문, 인증 예시가 없으므로 호출 코드를 추정해 교체해서는 안 된다.
설정 UI에는 외부 Alertmanager의 동기화 상태를 드러내는 변경이 추가됐다. 업그레이드 후에는 설정을 저장할 수 있는지와 동기화 상태가 어떻게 표시되는지를 각각 확인한다. 가져오기 마법사의 선택기에서도 Auto-sync 지원 여부를 보여 주므로, 실제 사용하는 대상의 표시를 운영 절차와 대조할 수 있다.
다음 도식은 Config API로 옮겨진 연동 지점과 폐기된 기존 경로를 구분한다.
동기화 검증과 알림 전달 검증은 별도로 남겨야 한다. 이번 릴리스에는 외부 Alertmanager만 사용하는 조직에서 시작 후 알림이 내장 Alertmanager로 향하던 문제의 수정이 포함됐다. 해당 구성을 운영한다면 재시작 직후의 전달 대상도 확인한다. 설정 UI의 동기화 상태를 보는 것만으로 이 전달 경로 검증을 대신하지 않는다.
| 확인 대상 | 릴리스에 기재된 변경 | 운영 검증에 넣을 항목 |
|---|---|---|
| 자체 auto-sync 연동 | Config API 이전, 기존 admin_config 경로 폐기 |
기존 경로 참조 여부와 이전 영향 |
| 설정 UI | 외부 Alertmanager 동기화 상태 표시 | 사용 중인 대상의 상태 표시 |
| 가져오기 마법사 | Auto-sync 지원 표시, Rules 강제 건너뛰기 방지 | 지원 표시와 Rules 검토 동작 |
| 외부 전용 조직 | 시작 후 내장 Alertmanager로 향하던 알림 수정 | 재시작 직후 실제 전달 대상 |
대시보드는 기본 레이아웃과 가져오기 결과를 확인한다
대시보드에서는 auto grid가 기본값이 됐다. 새 대시보드를 만드는 절차를 검증할 때 기본 레이아웃을 확인하고, 내부 작성 가이드의 화면과 맞춰 본다. 이 항목만으로 기존 대시보드가 모두 자동 변환된다고 해석할 근거는 없다.
가져오기 작업이 있는 환경은 레이아웃 외에 변수 설정 보존을 확인해야 한다. 릴리스에는 v2 UI 가져오기에서 쿼리 변수의 갱신 설정이 onDashboardLoad로 초기화되던 문제의 수정과, v2 대시보드 가져오기에서 갱신 설정을 보존하는 수정이 포함됐다. 가져오기 성공 여부에 더해 원본과 결과의 변수 갱신 설정을 대조하는 검증이 필요하다.
적용한 spec의 변수 값과 시간 설정을 URL 값으로 되돌리던 문제도 수정됐다. spec을 적용하는 절차가 있다면 기대한 변수 값과 시간 설정이 유지되는지를 확인한다.
| 사용 상황 | 관련 변경 | 대조할 결과 |
|---|---|---|
| 새 대시보드 작성 | auto grid 기본값 | 생성 화면의 기본 레이아웃 |
| v2 대시보드 가져오기 | 쿼리 변수 갱신 설정 보존 | 원본과 가져온 결과의 갱신 설정 |
| spec 적용 | 변수 값과 시간 설정의 URL 값 회귀 수정 | 적용한 spec의 값 유지 여부 |
| 프로비저닝된 대시보드 저장 | Classic 모델이 v2 JSON을 반환하던 문제 수정 | 저장 결과의 모델 형식 |
전역 변수 $__namespace도 추가됐다. 다만 제공된 릴리스노트에는 값의 의미나 사용 예시가 없다. 이번 업그레이드에 맞춰 기존 쿼리를 일괄 변경할 근거로 삼기보다는, 도입을 검토할 항목으로 기록하는 데 그친다.
보안 수정 기록은 릴리스노트의 절을 넘겨 대조한다
릴리스노트의 Security 절에는 CVE 수정 10건이 나열돼 있다. 그런데 Bug fixes 절에도 CVE-2026-17183 수정이 별도로 들어 있다. 보안 변경 기록을 만들 때 Security 절만 복사하면 이 항목을 빠뜨릴 수 있다.
다음 목록은 제공된 자료에 적힌 식별자를 위치별로 구분한 것이다. 영향 범위나 심각도를 뜻하지 않는다.
| 기재 위치 | 수정된 CVE 식별자 |
|---|---|
| Security | CVE-2026-100105, CVE-2026-13719, CVE-2026-13720, CVE-2026-15577, CVE-2026-33374 |
| Security | CVE-2026-81841, CVE-2026-88858, CVE-2026-88967, CVE-2026-93294, CVE-2026-95502 |
| Bug fixes의 Security 항목 | CVE-2026-17183 |
운영 변경 기록에는 대상 버전과 이 식별자들을 함께 남긴다. 제공된 자료에는 CVSS 점수, 취약한 버전 범위, 공격 조건, 우회책이 없으므로 특정 환경이 안전하다거나 특정 CVE가 더 위험하다고 판단할 수는 없다. 이번 글에서 확인할 수 있는 범위는 해당 릴리스에 수정 항목이 기재돼 있다는 사실이다.
배포 완료 기준을 실제 사용하는 경로에 맞춘다
배포 검증표는 새 기능 전체를 나열하기보다 현재 사용하는 경로에 맞춰 작성한다. [marketplace]를 사용하는 환경은 설정 이름의 반영을, Mimir 구성을 가져오는 환경은 파일 입력부터 staged 구성의 검토와 승격까지를 완료 기준에 넣는다.
외부 Alertmanager를 사용한다면 auto-sync 설정과 상태 표시를 확인하고, 외부 전용 조직은 재시작 직후 알림 전달 대상까지 검증한다. 대시보드 가져오기나 spec 적용을 운영 절차에 포함한 환경은 변수 갱신 설정, 변수 값, 시간 설정의 보존 여부를 대조한다.
이렇게 확인한 결과를 보안 수정 식별자와 함께 변경 기록에 남기면, 버전 교체 여부뿐 아니라 설정·알림·대시보드 중 어떤 운영 경로를 검증했는지도 확인할 수 있다.