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 API에 대한 직접 호출을 인증하는 방법으로 서비스 계정을 사용할 것을 권장합니다. Grafana Labs가 API 키 중단 작업을 진행함에 따라 더는 워크스페이스 사용자 인터페이스를 통해 API 키를 생성할 수 없습니다. AWS API를 통해서만 API 키를 생성할 수 있습니다.
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에서는 Angular를 사용하는 패널에 더는 지원하지 않는 기능을 사용하고 있다는 배너를 표시하여 향후 버전에서는 해당 기능이 작동하지 않을 것임을 알립니다.
-
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/queryAPI가 제거되었습니다.필요한 작업:
/api/ds/query를 사용합니다. Grafana 공개 설명서의 데이터 소스 쿼리및 GitHub의 문제 #49916 을 참조하세요. -
API 엔드포인트 변경 - 이제 여러 알림 API 엔드포인트에 숫자 ID 대신 데이터 소스 UID가 필요합니다.
영향을 받는 엔드포인트:
api/v1/rule/test,api/prometheus/,api/ruler/,api/alertmanager/필요한 작업: API 호출을 업데이트하여 데이터 소스 UID를 경로 파라미터로 사용합니다. 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에 대한 쿼리 간격 사양이 업데이트되었습니다.
interval에서fixed_interval속성으로 변경되었습니다. Elasticsearch 8.x와 일관성을 제공합니다. 대부분의 쿼리에는 변경 사항이 가시적으로 표시되지 않습니다. GitHub의 문제 #50297을 참조하세요. -
Elasticsearch 원시 문서 모드 중단 - Elasticsearch 데이터 소스에 모드 변경 사항을 표시합니다.
필요한 작업: 원시 데이터 모드를 사용합니다. GitHub의 문제 #62236
을 참조하세요. -
Elasticsearch 버전 지원 - 이전 Elasticsearch 버전은 더는 지원하지 않습니다.
필요한 작업: Elasticsearch를 버전 7.10.0 이상으로 업그레이드합니다. 7.10.0 미만의 버전은 중단된 버전입니다. GitHub의 문제 #48715
를 참조하세요. -
Explore URL 형식 중단 - 단축 Explore URL이 향후 릴리스에서 제거될 예정입니다.
필요한 작업: 표준 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로 설정하여 새로운 구현을 비활성화합니다. 테스트를 위해 대시보드 URLs에?__feature.useLegacyHeatmapPanel=true를 추가합니다. GitHub의 문제 #50229를 참조하세요. -
InfluxDB 백엔드 마이그레이션 - InfluxDB 데이터 구문 분석 동작이 변경되었습니다.
백엔드 처리 문제로 인해 InfluxDB 백엔드 마이그레이션 기능 토글(
influxdbBackendMigration)을 다시 도입합니다. 기본적으로 InfluxDB 데이터의 구문 분석은 프론트엔드에서 수행합니다. 9.4.4로 업그레이드하고 InfluxDB 데이터에 변환을 추가하면 해당 패널이 렌더링되지 않습니다.필요한 작업: 영향을 받는 패널을 제거하고 다시 생성하거나
panel.json또는dashboard.json에서time필드를Time으로 편집합니다. GitHub의 문제 #64842를 참조하세요. -
로그 메시지 형식 업데이트 - 로그 메시지 구조가 변경되었습니다.
lvl은 이제level입니다.eror및dbug는 이제error및debug입니다. 타임스탬프 정밀도가 향상되었습니다.oldlog기능 토글을 통해 옵트아웃할 수 있습니다(임시). GitHub의 문제 #47584를 참조하세요. -
Loki 데이터 형식 최적화 - Loki 로그 데이터는 더욱 효율적인 데이터프레임 형식을 사용합니다.
별도의 여러 데이터 프레임 대신 레이블 열이 있는 단일 데이터 프레임을 사용합니다. 탐색 및 로그 패널은 변경 없이 작동합니다. 다른 패널 또는 변환을 조정해야 할 수 있습니다.
필요한 작업: 레이블에서 필드 변환을 필드 추출 변환으로 교체합니다. GitHub의 문제 #47153
을 참조하세요. -
NaN 값 처리 - Prometheus 및 Loki 데이터 소스 전반에서 일관된
NaN표현을 제공합니다.NaN값은null로 변환되는 대신NaN으로 유지됩니다. 대부분 변경 사항은 사용자에게 보이지 않습니다. 대시보드 경로와 알림 경로 모두에 영향을 줍니다. GitHub의 문제 #49475및 #45389 를 참조하세요. -
암호 재설정 링크 무효화 - 업그레이드 후에는 기존 암호 재설정 링크가 작동하지 않습니다.
업그레이드 전에 전송된 암호 재설정 링크가 잘못되었습니다. 사용자는 새 암호 재설정 링크를 요청해야 합니다. 링크는 2시간 후에 만료됩니다. GitHub의 문제 #42334
를 참조하세요. -
예약 레이블 접두사 -
grafana_로 시작하는 레이블은 예약되어 있습니다.grafana_로 시작하는 수동 구성 레이블을 덮어쓸 수 있습니다. 현재 예약된 레이블:grafana_folder(알림이 포함된 폴더의 제목). GitHub의 문제 #50262를 참조하세요. -
변환 개선 - 정규식 변환을 통한 이름 바꾸기는 이제 글로벌 패턴을 지원합니다.
글로벌 패턴은
/<stringToReplace>/g형식을 사용합니다. 일부 변환은 다르게 동작할 수 있습니다. 이전 방식으로 동작하려면 일치 문자열 앞뒤로 슬래시(/)를 사용합니다. 즉,(.*)를/(.*)/로 만듭니다. GitHub의 문제 #48179를 참조하세요.