기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
Grafana 버전 간 차이
Grafana 워크스페이스를 생성하는 경우 생성할 Grafana 버전을 선택해야 합니다. Grafana 버전 8, 9 및 10과 호환되는 버전 중에서 선택할 수 있습니다. 이들 각각은 이전 버전의 기능을 추가했습니다. 다음 주제에서는 버전 9에서 사용하는 기능이 중단될 수 있는 버전 10의 변경 사항을 포함하여 버전 9 및 10의 변경 사항을 설명합니다.
참고
Grafana 버전 8에서 작업, Grafana 버전 9에서 작업 및 Grafana 버전 10에서 작업 주제에서 Grafana 워크스페이스 사용에 대한 버전별 설명서를 읽을 수 있습니다.
버전별 자세한 참고 사항과 Grafana Labs에 대한 자세한 내용은 Grafana Labs 설명서의 What's new in Grafana
Grafana 버전 10
다음 기능은 Grafana 버전 10에서 추가되었습니다.
-
상관관계 - 상관관계는 한 데이터 소스의 데이터를 사용하여 다른 데이터 소스의 데이터를 쿼리하는 방법을 정의하고, 이를 통해 탐색 시각화에서 표시된 데이터와 관련된 쿼리를 쉽게 실행할 수 있습니다. 자세한 내용은 Grafana 버전 10에서의 상관관계을 참조하세요.
-
하위 폴더 - 대시보드를 구성할 때 하위 폴더를 사용하여 중첩 계층을 생성할 수 있습니다. 자세한 내용은 대시보드 폴더 생성을 참조하세요.
-
알림 - Grafana 알림은 이제 알림 무음 기능을 지원합니다. 또한 Grafana 알림은 더 이상 알림을 3번 전송하지 않습니다.
-
업그레이드 미리 보기 알림 - 클래식 대시보드 알림에서 Grafana 알림으로 업그레이드하기 전에 알림의 모양을 보고 마이그레이션 시 적용되는 변경 사항도 확인할 수 있습니다. 자세한 내용은 Grafana 알림으로 클래식 대시보드 알림 마이그레이션을 참조하세요. Grafana Labs는 Grafana 버전 11 이상이 더 이상 클래식 대시보드 알림을 지원하지 않을 것이라고 발표했습니다.
-
지원 번들 - 지원 번들을 통해 Grafana 워크스페이스에 대한 정보를 수집하여 제품 지원과 간단하게 공유할 수 있습니다. 마이그레이션, 플러그인, 설정 등에 대한 데이터가 포함된 지원 번들을 빠르게 생성할 수 있습니다. 자세한 내용은 지원을 위한 정보 수집을 참조하세요.
-
새 시각화 - 세 가지 새로운 시각화를 사용할 수 있습니다. XY 차트, 데이터 그리드, 추세 패널은 모두 버전 10과 호환되는 워크스페이스에 대해 사용할 수 있습니다. 버전 9 워크스페이스에서는 XY 차트도 사용할 수 있습니다.
-
PagerDuty – 이제 Enterprise 플러그인에 PagerDuty용 플러그인이 포함됩니다.
-
변환 재설계 - 변환 탭에서 사용자 경험과 시각적 설계를 개선했습니다. 변환은 분류되며 각 변환 유형에는 올바른 변환을 선택하는 데 도움이 되는 그림이 있습니다.
-
Prometheus 지표 백과사전 - Prometheus 쿼리 빌더의 Prometheus 지표에 대한 지표 드롭다운에서 페이지 매김 기능이 적용되고 검색 가능한 지표 백과사전으로 대체되었습니다.
-
API 키 UI 중단됨 - 서비스 계정은 Grafana HTTP APIs에 대한 호출을 인증하는 데 권장되는 방법입니다. API 키 중단을 위한 Grafana Labs 작업의 일환으로 더 이상 워크스페이스 사용자 인터페이스를 통해 API 키를 생성할 수 없습니다. API를 통해서만 API 키를 생성할 수 AWS APIs.
Grafana Labs의 API 키 중단에 대한 자세한 내용은 Grafana GitHub 문제 목록에서 APIKeys: Sunsetting of API keys
를 참조하세요.
호환성에 영향을 미치는 변경 사항
Grafana 버전 10.4 릴리스에는 Grafana 버전 9.5~10.4의 변경 사항이 포함되어 있습니다. Grafana 버전 10.0 및 10.3에는 경우에 따라 기능이 중단될 수 있는 몇 가지 변경 사항이 있었습니다. 새 버전으로 업데이트하는 경우 프로덕션 워크스페이스를 업데이트하기 전에 비프로덕션 환경에서 테스트하는 것이 좋습니다.
다음 변경 사항은 Grafana 버전 10으로 업데이트하는 일부 사용자에게 영향을 미칠 수 있습니다.
-
Angular 중단 - Grafana의 향후 릴리스에서는 Angular를 사용하는 플러그인이 더 이상 지원되지 않습니다. 버전 10에서는 각을 사용하는 패널에 중단된 기능을 사용한다는 배너가 표시되어 향후 버전에서는 작동하지 않을 것임을 알립니다.
-
CloudWatch의 별칭이 제거됨 - CloudWatch 쿼리 편집기의 별칭 패턴이 레이블(동적 레이블)로 대체되었습니다.
별칭 필드를 사용하는 대시보드를 열고 저장합니다. 별칭은 레이블로 자동으로 마이그레이션됩니다.
-
이전 플러그인 업그레이드 필요 - Athena 및 Amazon Redshift 데이터 소스에 대한 플러그인은 Grafana v10 워크스페이스에서 업데이트해야 합니다. Athena 데이터 소스 플러그인은 버전 2.9.3 이상이어야 하며 Amazon Redshift 데이터 소스 플러그인은 버전 1.8.3 이상이어야 합니다.
플러그인 설치 또는 업그레이드에 대한 자세한 내용은 플러그인 카탈로그를 사용하여 플러그인 찾기 섹션을 참조하세요.
-
DoiT BigQuery 플러그인은 더 이상 지원되지 않음 - DoiT BigQuery 데이터 소스 플러그인은 더 이상 지원되지 않습니다. 대신 공식 Grafana Labs BigQuery 데이터 소스 플러그인을 사용합니다.
-
변환 변경 - Grafana 버전 10에는 필드 이름 및 키에 대한 몇 가지 버그 수정 사항이 있습니다. 자세한 내용은 Grafana Labs 설명서의 Transformation breaking changes
를 참조하세요. -
데이터 소스 권한 API - 데이터 소스 권한에 액세스하기 위한 엔드포인트가 변경되었습니다. 자세한 내용은 Grafana Labs 설명서의 Data source permissions changes
를 참조하세요.
호환성에 영향을 미치는 변경 사항 및 플러그인 개발자에게 영향을 미치는 변경 사항에 대한 자세한 내용은 Grafana Labs 설명서의 다음 주제를 참조하세요.
Grafana 버전 9
다음 기능은 Grafana v9에서 추가되었습니다.
-
알림: 이제 Grafana 관리형 알림 규칙에서 그룹 이름을 지원합니다.
-
탐색: 탐색 보기에서 대시보드를 생성합니다.
-
Prometheus 쿼리: Prometheus 쿼리에 대한 새 쿼리 빌더(PromQL 사용)를 사용하면 쿼리를 더 쉽게 작성할 수 있습니다.
-
Loki 쿼리: Loki 쿼리에 대한 새 쿼리 빌더(LogQL 사용)를 사용하면 쿼리를 더 쉽게 작성할 수 있습니다.
-
API 토큰/서비스 계정: 서비스 계정은 Grafana에서 시스템 액세스를 단순화하여 API 토큰을 관리하는 데 도움이 됩니다.
-
플러그인 관리: 플러그인 관리를 활성화하여 워크스페이스에서 커뮤니티 플러그인을 설치, 제거 또는 업데이트할 수 있습니다. 이를 통해 더 많은 데이터 소스와 시각화에 액세스할 수 있으며 사용하는 각 플러그인의 버전을 제어할 수 있습니다.
-
지표 추적: 쿼리 및 태그가 있는 지표에 대한 링크를 추가하도록 추적 데이터 소스를 구성합니다.
-
캔버스 패널: 정적 및 동적 요소가 포함된 새로운 패널 시각화로, 이미지와 오버레이 텍스트가 포함된 데이터 기반 사용자 지정 패널을 생성합니다.
-
재구성된 인터페이스: Grafana 콘솔에서 더 쉽게 탐색할 수 있도록 UI를 업데이트했습니다.
-
CloudWatch: Amazon CloudWatch 데이터 소스는 이제 여러 지표 AWS 계정 를 모니터링할 수 있습니다 AWS 리전.
-
로그: 로그 세부 정보에 대한 인터페이스가 개선되었습니다.
-
일반: 전반적인 버그 수정 및 사소한 개선 사항.
호환성에 영향을 미치는 변경 사항
Grafana 버전 9.4 릴리스에는 이전 버전을 기반으로 하는 다양한 새로운 기능과 개선 사항이 포함되어 있습니다. 이 버전에는 경우에 따라 기능이 중단될 수 있는 몇 가지 변경 사항이 있습니다. 새 버전으로 업데이트할 때는 프로덕션 워크스페이스를 업데이트하기 전에 비프로덕션 환경에서 테스트하는 것이 좋습니다.
다음 변경 사항은 Grafana 버전 9.4로 업데이트하는 일부 사용자에게 영향을 미칠 수 있습니다. 이러한 변경 사항에 대한 자세한 목록은 GitHub의 Grafana 9.4 변경 로그
-
API 중단됨 -
/api/tsdb/query
API가 제거되었습니다.필요한 작업:
/api/ds/query
대신를 사용합니다. Grafana 공개 설명서의 데이터 소스 쿼리및 GitHub의 문제 #49916 을 참조하세요. -
API 엔드포인트 변경 - 이제 여러 알림 API 엔드포인트에 숫자 ID 대신 데이터 소스 UID가 필요합니다.
영향을 받는 엔드포인트:
api/v1/rule/test
,api/prometheus/
,api/ruler/
,api/alertmanager/
필요한 작업: 데이터 소스 UID를 경로 파라미터로 사용하도록 API 호출을 업데이트합니다. GitHub의 문제 #48070
, #48052 , #48046 및 #47978 을 참조하세요. -
Azure Monitor 쿼리 제거됨 - Application Insights 및 Insight Analytics 쿼리는 더 이상 지원되지 않습니다.
Grafana 8.0에서는 더 이상 사용되지 않으며 9.0에서는 제거되었습니다. 더 이상 사용되지 않는 쿼리는 실행되지 않습니다.
필요한 조치: 마이그레이션 지침은 Grafana 퍼블릭 설명서의 Azure Monitor 데이터 소스를
참조하세요. -
브라우저 액세스 모드 제거됨 - InfluxDB 및 Prometheus 데이터 소스에는 더 이상 브라우저 액세스 모드를 사용할 수 없습니다.
필요한 작업: 데이터 소스 구성에서 서버 액세스 모드로 전환합니다. InfluxDB: 8.0.0에서는 더 이상 사용되지 않으며 9.2.0에서는 제거되었습니다. GitHub의 문제 #53529
를 참조하세요. Prometheus: 7.4.0에서는 더 이상 사용되지 않으며 9.2.0에서는 제거되었습니다. GitHub의 문제 #50162 를 참조하세요. -
대시보드 설정 액세스 제한 - 패널을 편집하는 동안 대시보드 설정을 더 이상 열 수 없습니다.
패널 편집 모드가 활성화되면 대시보드 설정이 잠깁니다. 대시보드 설정에 액세스하기 전에 패널 편집 모드를 닫습니다. GitHub의 문제 #54746
을 참조하세요. -
데이터 소스 암호 암호화 - 암호화되지 않은 암호는 더 이상 지원되지 않습니다.
필요한 작업:
secureJsonData.password
및를 사용합니다secureJsonData.basicAuthPassword
. 이전에 v8.1.0에서 중단되었습니다. GitHub의 문제 #49987을 참조하세요. -
기본 데이터 소스 동작 - 기본 데이터 소스 선택은 더 이상 기존 패널에 영향을 주지 않습니다.
기본 데이터 소스는 새 패널에만 적용됩니다. 기본값을 변경해도 기존 대시보드는 업데이트되지 않습니다. 이전에 저장된 패널은 데이터 소스 구성을 유지합니다. GitHub의 문제 #45132
를 참조하세요. -
Elasticsearch 간격 속성 변경됨 - Elasticsearch 7.x에 대한 쿼리 간격 사양이 업데이트되었습니다.
에서
fixed_interval
속성interval
으로 변경되었습니다. Elasticsearch 8.x와의 일관성을 제공합니다. 대부분의 쿼리에는 표시되는 변경 사항이 표시되지 않습니다. GitHub의 문제 #50297을 참조하세요. -
Elasticsearch 원시 문서 모드 중단됨 - Elasticsearch 데이터 소스에 모드 변경 사항을 표시합니다.
필요한 작업: 대신 원시 데이터 모드를 사용합니다. GitHub의 문제 #62236
을 참조하세요. -
Elasticsearch 버전 지원 - 이전 Elasticsearch 버전은 더 이상 지원되지 않습니다.
필요한 조치: Elasticsearch를 버전 7.10.0 이상으로 업그레이드합니다. 7.10.0 미만의 버전은 end-of-life 버전입니다. GitHub의 문제 #48715
를 참조하세요. -
URL 형식 탐색 중단 - Compact 탐색 URLs 향후 릴리스에서 제거될 예정입니다.
필요한 작업: 표준 URL 형식을 사용하도록 하드 코딩된 링크를 업데이트합니다. 압축 URLs:
&left=["now-1h","now"...]
. 표준 URLs:&left={"datasource":"test"...}
. GitHub의 문제 #50873을 참조하세요. -
GitHub OAuth 디스플레이 변경 사항 - GitHub 이름 및 로그인 디스플레이가 업데이트되었습니다.
GitHub 이름은 Grafana 이름으로 표시됩니다. GitHub 로그인은 Grafana 로그인으로 표시됩니다. 사용자 식별 명확성을 개선합니다. GitHub의 문제 #45438
을 참조하세요. -
히트맵 패널 구현 업데이트됨 - 히트맵 패널은 9.1.0부터 새로운 구현을 사용합니다.
렌더링 성능이 크게 향상되었습니다. 버킷은 적절한 경계(1분, 5분, 30초)에 배치됩니다. 라운드 셀은 더 이상 지원되지 않습니다.
필요한 조치: 업그레이드 후 히트맵 패널을 테스트합니다. 필요한 경우
useLegacyHeatmapPanel
기능 플래그를 true로 설정하여 새 구현을 비활성화합니다. 테스트를?__feature.useLegacyHeatmapPanel=true
위해 대시보드 URLs 추가합니다. GitHub의 문제 #50229를 참조하세요. -
InfluxDB 백엔드 마이그레이션 - InfluxDB 데이터 구문 분석 동작이 변경되었습니다.
백엔드 처리 문제로 인해 InfluxDB 백엔드 마이그레이션 기능 토글(
influxdbBackendMigration
)이 다시 도입됩니다. 기본적으로 InfluxDB 데이터는 프런트엔드에서 구문 분석됩니다. 9.4.4로 업그레이드하고 InfluxDB 데이터에 변환을 추가하면 해당 패널이 렌더링되지 않습니다.필요한 작업: 영향을 받는 패널을 제거하고 다시 생성하거나
panel.json
또는Time
에서와 같이time
필드를 편집합니다dashboard.json
. GitHub의 문제 #64842를 참조하세요. -
로그 메시지 형식 업데이트됨 - 로그 메시지 구조가 변경되었습니다.
lvl
는 이제level
이고eror
는 이제error
및dbug
입니다debug
. 타임스탬프 정밀도가 향상되었습니다.oldlog
기능 토글과 함께 옵트아웃 사용 가능(임시). GitHub의 문제 #47584를 참조하세요. -
Loki 데이터 형식 최적화 - Loki 로그 데이터는 보다 효율적인 데이터프레임 형식을 사용합니다.
별도의 데이터 프레임 대신 레이블 열이 있는 단일 데이터 프레임. 탐색 및 로그 패널은 변경 없이 작동합니다. 다른 패널 또는 변환을 조정해야 할 수 있습니다.
필요한 작업: 레이블을 필드 변환으로 바꾸고 필드 추출 변환으로 바꿉니다. GitHub의 문제 #47153
을 참조하세요. -
NaN 값 처리 - Prometheus 및 Loki 데이터 소스에서 일관된
NaN
표현.NaN
값은 로 변환하는NaN
대신 로 유지됩니다null
. 변경 사항은 대부분 사용자에게 보이지 않아야 합니다. 대시보드 및 알림 경로 모두에 영향을 줍니다. GitHub의 문제 #49475및 #45389 를 참조하세요. -
암호 재설정 링크가 무효화됨 - 업그레이드 후에는 기존 암호 재설정 링크가 작동하지 않습니다.
업그레이드 전에 전송된 암호 재설정 링크가 잘못되었습니다. 사용자는 새 암호 재설정 링크를 요청해야 합니다. 링크는 2시간 후에 만료됩니다. GitHub의 문제 #42334
를 참조하세요. -
예약 레이블 접두사 - 로 시작하는 레이블
grafana_
은 예약되어 있습니다.로 시작하는 수동으로 구성된 레이블을 덮어쓸
grafana_
수 있습니다. 현재 예약된 레이블:grafana_folder
(알림이 포함된 폴더의 제목). GitHub의 문제 #50262를 참조하세요. -
변환 개선 - 정규식 변환을 통한 이름 바꾸기는 이제 글로벌 패턴을 지원합니다.
글로벌 패턴은 형식을 사용합니다
/<stringToReplace>/g
. 일부 변환은 다르게 동작할 수 있습니다. 이전 동작에 대해 슬래시로 일치 문자열을 래핑합니다.는이(.*)
됩니다/(.*)/
. GitHub의 문제 #48179를 참조하세요.