Grafana v10.3의 주요 변경 사항
Grafana v10.3의 주요 변경 사항 (Breaking changes in Grafana v10.3)
다음은 Grafana v10.3으로 업그레이드할 때 알아야 할 주요 변경 사항이에요. 릴리스 10.2.3에서 도입된 주요 변경 사항도 여기에 포함되며 별표(*)로 표시돼요.
여기서 주요 변경 사항이란 사용자나 운영자가 뭔가를 해야 하는 모든 변경을 의미해요. 여기에는 다음이 포함돼요:
- 시스템 한 부분의 변경으로 다른 구성 요소가 실패할 수 있는 변경
- 기능의 폐기(deprecation)나 제거
- 자동화를 깨뜨릴 수 있는 API 변경
- Grafana의 일부 플러그인이나 기능에 영향을 주는 변경
- 되돌릴 수 없는 마이그레이션
각 변경에 대해 제공되는 정보는:
- 영향을 받는지 확인하는 데 도움을 줘요
- 변경 사항이나 관련 배경 정보를 설명해요
- 변경에 대한 완화 또는 마이그레이션 방법을 안내해요
- 더 많은 학습 자료를 제공해요
릴리스 하이라이트와 폐기 사항은 v10.3 What's new를 참고해요. v10.3으로 업그레이드할 때 권장하는 구체적인 단계는 Upgrade guide를 확인해요.
출처: 문서
본문
다음은 Grafana v10.3으로 업그레이드할 때 알아야 할 주요 변경 사항이에요. 릴리스 10.2.3에서 도입된 주요 변경 사항도 여기에 포함되며 별표(*)로 표시돼요.
여기서 주요 변경 사항이란 사용자나 운영자가 뭔가를 해야 하는 모든 변경을 의미해요. 여기에는 다음이 포함돼요:
- 시스템 한 부분의 변경으로 다른 구성 요소가 실패할 수 있는 변경
- 기능의 폐기(deprecation)나 제거
- 자동화를 깨뜨릴 수 있는 API 변경
- Grafana의 일부 플러그인이나 함수에 영향을 주는 변경
- 되돌릴 수 없는 마이그레이션
각 변경에 대해 제공되는 정보는:
- 영향을 받는지 확인하는 데 도움을 줘요
- 변경 사항이나 관련 배경 정보를 설명해요
- 변경에 대한 완화 또는 마이그레이션 방법을 안내해요
- 더 많은 학습 자료를 제공해요
릴리스 하이라이트와 폐기 사항은 v10.3 What's new를 참고해요. v10.3으로 업그레이드할 때 권장하는 구체적인 단계는 Upgrade guide를 확인해요.
일반 주요 변경 사항 (General breaking changes)
변환* (Transformations*)
추출된 이름 중 하나가 이미 존재하는 필드 중 하나와 충돌하는 extract fields 변환을 사용하는 패널에서는 추출된 필드의 이름이 바뀌어요. Issue #77569.
Table 시각화를 사용한다면 패널에서 일부 불일치를 볼 수 있어요. 테이블 열 이름 지정을 업데이트했어요. 이는 필드 변환 및/또는 필드 오버라이드에 잠재적으로 영향을 줄 거예요. 해결하려면 다음 중 하나를 해요:
- 사용 중인 변환을 업데이트해요
- 필드 오버라이드를 업데이트해요. Issue #76899.
Time 필드가 있는 변환을 사용하는 사용자는 변환이 작동하지 않는 것을 볼 수 있어요. 변환이 깨진 패널은 렌더링에 실패할 거예요. 필드 키를 변경했기 때문이에요. 관련 PR 참조: #69865. 해결하려면 다음 중 하나를 해요:
- 영향을 받는 패널을 제거하고 다시 만들어요
- Time 필드를 다시 선택해요
- panel.json 또는 dashboard.json의 변환에서 time 필드를 Time으로 편집해요. Issue #76641.
데이터 소스 권한* (Data source permissions*)
다음 데이터 소스 권한 엔드포인트가 제거됐어요:
GET /datasources/:datasourceId/permissionsPOST /api/datasources/:datasourceId/permissionsDELETE /datasources/:datasourceId/permissionsPOST /datasources/:datasourceId/enable-permissionsPOST /datasources/:datasourceId/disable-permissions
대신 다음 엔드포인트를 사용해요:
- 데이터 소스 권한 나열용
GET /api/access-control/datasources/:uid - 데이터 소스 권한 추가 또는 제거용
POST /api/access-control/datasources/:uid/users/:id,POST /api/access-control/datasources/:uid/teams/:id,POST /api/access-control/datasources/:uid/buildInRoles/:id
Terraform용 Grafana 제공자를 사용해 데이터 소스 권한을 관리한다면, 데이터 소스 권한 프로비저닝이 계속 작동하도록 제공자를 버전 2.6.0 이상으로 업그레이드해야 해요. Issue #5880.