Grafana v9.3의 새로운 기능

Grafana v9.3의 새로운 기능 (What's new in Grafana v9.3)

Grafana 9.3에 오신 것을 환영해요! 탐색 전면 개편, 네 가지 새 언어 지원, 새 패널과 변환, 여러 자주 요청받은 인증 개선, Alerting의 사용성 개선 등을 배워보세요. 이번 릴리스의 모든 변경 사항에 대한 더 자세한 내용은 changelog를 참고해요.

출처: 문서

본문

Grafana 모든 에디션에서 beta로 제공돼요.

인시던트 대응 워크플로의 일부로 기능 사이를 빠르게 이동하며 시스템 상태를 완전히 파악할 수 있도록 Grafana의 재설계된 탐색을 사용해요.

Grafana가 데이터 시각화 도구에서 옵저버빌리티 솔루션으로 성장하면서 많은 새 기능을 추가했어요. 그 결과 시각적으로 일관되지 않거나 찾기 어려운 페이지가 생겼어요. 이번 탐색 업데이트는 Grafana에 새 모습을 주고 페이지 레이아웃과 탐색 패턴을 더 일관되게 만들어요.

탐색 메뉴를 개편하고 관련 도구를 함께 묶어 필요한 것을 더 쉽게 찾을 수 있게 했어요. Grafana의 페이지는 이제 breadcrumb와 사이드바를 포함한 새 레이아웃을 활용해 페이지 사이를 빠르게 이동할 수 있어요. 또한 Grafana의 모든 페이지에 표시되는 헤더를 도입해 어떤 페이지에서든 대시보드 검색에 접근할 수 있게 했어요.

Grafana의 새 탐색을 사용해 보려면 topnav 기능 토글을 활성화해요. Cloud Advanced 고객이라면 지원 팀에 티켓을 열면 우리가 활성화해 드려요.

Note: Grafana와 Grafana Cloud 문서는 아직 탐색 변경 사항을 반영하도록 업데이트되지 않았어요. 이 변경 사항은 새 탐색이 일반 공개될 때 배포될 거예요.

Grafana용 새 탐색

스페인어, 프랑스어, 독일어, 간체 중국어로 대시보드 보기 (View dashboards in Spanish, French, German, and Simplified Chinese)

Grafana 모든 에디션에서 일반 공개되었어요.

Grafana에 네 가지 새 언어를 추가했어요: 스페인어, 프랑스어, 독일어, 간체 중국어.

전 세계 수백만 사용자와 함께 Grafana는 전 세계적 입지가 있어요. 더 넓은 사용자층이 접근할 수 있도록 주요 워크플로를 현지화하는 첫 단계를 밟았어요. 이제 탐색, 대시보드 보기, 일부 설정에서 Grafana의 언어를 설정할 수 있어요. 이는 Viewer가 Grafana에서 수행하는 주요 활동을 다뤄요.

조직의 기본 언어 구성과 프로필 업데이트에 대해 문서에서 더 읽어보세요.

스페인어, 프랑스어, 독일어, 간체 중국어로 제공되는 Grafana

Geomap 패널 (Geomap panel)

Grafana 모든 에디션에서 일반 공개되었어요.

Geomap에 photo layer라는 새 alpha 레이어 유형을 추가했어요. 이 레이어를 사용하면 각 데이터 포인트에 사진을 렌더링할 수 있어요. photo layer와 geomap 패널에 대해 더 배우려면 Photos layer를 참고해요.

Geomap 패널 사진 레이어

Canvas 패널 (Canvas panel)

Grafana 모든 에디션에서 beta로 제공돼요.

Canvas는 Grafana의 강력함과 커스텀 요소의 유연성을 결합한 새 패널이에요. Canvas 시각화는 정적 및 동적 레이아웃 안에 요소를 명시적으로 배치할 수 있는 확장 가능한 폼 기반 패널이에요. 이를 통해 Grafana UI 안에서 표준 Grafana 패널로는 불가능한 방식으로 커스텀 시각화를 설계하고 데이터를 오버레이할 수 있어요. 인기 있는 UI와 웹 디자인 도구를 사용해 본 적이 있다면 Canvas 패널 설계가 매우 익숙하게 느껴질 거예요.

Grafana v9.3에서는 Canvas 패널에 아이콘 값 매핑 지원을 추가했어요. 이를 통해 데이터에 따라 표시할 아이콘을 동적으로 설정할 수 있어요. Canvas 패널에 대해 더 배우려면 Canvas를 참고해요.

Canvas 패널 아이콘 값 매핑 지원

공개 대시보드 개선 (Public dashboards improvements)

공개 대시보드에 대해 다음과 같은 개선을 만들었어요.

모든 공개 대시보드를 한 곳에서 관리 (Manage all of your public dashboards in one place)

Grafana 오픈 소스, Enterprise, Cloud Advanced에서 실험적으로 제공돼요.

Public Dashboards를 사용하면 로그인 없이 인터넷의 누구에게나 특정 대시보드를 제공할 수 있어요. Grafana v9.3에서는 모든 공개 대시보드를 관리할 수 있는 새 화면을 도입했어요. 여기에서 Grafana 인스턴스의 모든 공개 대시보드 목록을 보고, 기본 대시보드로 이동하고, 활성화 여부를 확인하고, 대시보드의 공개 버전으로 연결하거나, 공개 대시보드 구성을 업데이트할 수 있어요. 대시보드 자체에 대한 보기 접근 권한이 있다면 공개 대시보드 구성을 볼 수 있고, Admin 또는 Server Admin 역할이나 Grafana Enterprise 또는 Cloud Advanced에서 RBAC를 사용하는 경우 "Public Dashboard writer" 역할이 있다면 구성을 편집할 수 있어요.

이 새 화면을 확인하고 공개 대시보드를 구성하려면 Dashboards > Public Dashboards로 이동해요.

공개 대시보드에서 주석 표시 선택 (Choose to display annotations in public dashboards)

Grafana 오픈 소스, Enterprise, Cloud Advanced에서 실험적으로 제공돼요.

쿼리 주석을 제외한 주석이 이제 공개 대시보드에서 지원돼요. 기본적으로 꺼져 있지만 공개 대시보드 설정에서 켤 수 있어요.

Public Dashboards는 실험적 기능이므로 Grafana에서 publicDashboards 기능 토글로 활성화하거나, Cloud Advanced 고객이라면 공개 대시보드를 요청하는 지원 티켓을 열어야 해요.

공개 대시보드에 대해 더 배우려면 Public dashboards를 참고해요.

새 변환: 값별 분할 (New transformation: Partition by values)

Grafana 모든 에디션에서 실험적으로 제공돼요.

이 새 변환은 여러 시리즈를 그래프로 그릴 때 서로 다른 WHERE 절로 같은 데이터 소스에 여러 쿼리를 보낼 필요를 없애줘요.

다음 데이터가 있는 메트릭 SQL 테이블을 생각해보세요.

테이블 펼치기

Time	Region	Value
2022-10-20 12:00:00	US	1520
2022-10-20 12:00:00	EU	2936
2022-10-20 01:00:00	US	1327
2022-10-20 01:00:00	EU	912

v9.3 이전에는 같은 TimeSeries 패널에서 US용 빨간 추세선과 EU용 파란 추세선을 그리려면 이 데이터를 두 개의 쿼리로 나눠야 했어요:

   SELECT Time, Value FROM metrics WHERE Time > ‘2022-10-20’ AND Region=’US’
   SELECT Time, Value FROM metrics WHERE Time > ‘2022-10-20’ AND Region=’EU’

이 방법은 또한 메트릭 테이블에 어떤 지역이 존재하는지 미리 알아야 해요.

값별 분할(partition by values) 변환을 사용하면 단일 쿼리를 발행하고 선택한 하나 이상의 열(필드)에서 고유한 (enum) 값으로 결과를 나눌 수 있어요. 이 경우에는 Region이에요.

   SELECT Time, Region, Value FROM metrics WHERE Time > ‘2022-10-20’

테이블 펼치기

Time	Region	Value
2022-10-20 12:00:00	US	1520
2022-10-20 01:00:00	US	1327

테이블 펼치기

Time	Region	Value
2022-10-20 12:00:00	EU	2936
2022-10-20 01:00:00	EU	912

리포팅: 확대·축소로 데이터를 PDF에 더 잘 맞추기 (Reporting: Zoom in and out to fit your data better into a PDF)

Grafana Enterprise, Cloud Pro, Cloud Advanced에서 일반 공개되었어요.

대시보드는 화면에 표시되고 보고서는 PDF이기 때문에 데이터를 원하는 대로 렌더링하는 것이 어려울 수 있어요. 때로는 보고서가 테이블에 충분한 열을 보여주지 않거나 제목이 너무 작게 보이기도 해요. 이제 보고서의 배율을 조정해 확대해 각 텍스트 필드와 패널을 더 크게 만들거나 축소해 더 많은 데이터를 표시할 수 있어요.

확대/축소 기능은 보고 구성의 Format Report 섹션에 있어요. 리포팅에 대해 더 배우려면 Create and manage reports를 참고해요.

세 가지 다른 확대 수준의 PDF 문서가 있는 보고서 확대 기능

사용자와 접근 (Users and access)

사용자와 접근에 대해 다음과 같은 개선을 만들었어요.

OAuth: 토큰 처리 개선 (OAuth: token handling improvements)

Grafana 모든 에디션에서 일반 공개되었어요.

Grafana의 보안을 개선하기 위한 노력의 일환으로 Grafana의 OAuth 2.0 호환성을 향상시키는 오래 기다려온 기능을 도입하고 있어요. 사용자가 OAuth 제공자로 로그인하면 Grafana는 각 요청에서 사용자의 액세스 토큰이 만료되지 않았는지 확인해요. 액세스 토큰이 만료되면 Grafana는 제공된 리프레시 토큰(존재하는 경우)을 사용해 새 액세스 토큰을 얻어요.

이 기능은 주요 변경 사항을 도입하기 때문에 accessTokenExpirationCheck 기능 토글 뒤에 있으며 기본적으로 비활성화되어 있어요. 특정 OAuth 제공자에 리프레시 토큰을 구성하지 않고 이 기능을 활성화하면 사용자는 액세스 토큰이 만료된 후 로그아웃되고 매번 다시 로그인해야 해요.

리프레시 토큰 획득 구성에 대한 전체 문서는 OAuth ID 제공자에 대한 지침에서 인증 구성 페이지에서 찾을 수 있어요.

Grafana CLI에서 사용자 충돌 해결 (Resolve user conflicts in Grafana's CLI)

이전 Grafana 버전에서는 사용자 이름이 대소문자를 구분했어요. 이로 인해 사용자가 SAML과 OAuth 같은 두 가지 다른 방법으로 로그인해 [email protected]과 [email protected] 같은 두 계정이 생기는 충돌이 발생할 수 있었어요. 이런 상황의 사용자는 자신의 기본 설정과 권한을 잃었다고 생각할 수 있어요. Grafana 인스턴스에서 이런 일이 발생했다면 새 Grafana CLI 명령어로 Grafana 내 사용자 간 사용자 ID 충돌을 해결할 수 있어요.

Note: Grafana Cloud를 사용하거나 MySQL을 데이터베이스로 Grafana를 실행한다면 사용자 ID 충돌이 발생하지 않으므로 이 도구를 사용할 필요가 없어요.

Bash

# 모든 충돌 사용자 나열
$ grafana-cli user-manager conflicts list

# 편집할 충돌 패치 파일 생성
$ grafana-cli user-manager conflicts generate-file

# 검증을 위해 편집된 충돌 패치 파일 읽기
$ grafana-cli user-manager conflicts validate-file <filepath>

# 충돌 사용자 파일 수집. 파일당 한 번 실행할 수 있으며 데이터베이스 상태를 변경해요.
$ grafana-cli user-manager conflicts ingest-file <filepath>

LDAP: 역할 매핑 개선 (LDAP: Role mapping improvements)

Grafana 모든 에디션에서 일반 공개되었어요.

LDAP 디렉터리로 Grafana에 인증하지만 조직과 역할을 Grafana UI나 API로 할당하는 것을 선호한다면, 이제 LDAP 디렉터리와의 사용자 조직 역할 동기화를 건너뛸 수 있어요.

LDAP 인증을 구성할 때 skip_org_role_sync LDAP 인증 구성 옵션을 사용해 LDAP 그룹과 조직 역할 사이의 동기화를 방지하고 사용자 역할을 수동으로 편집 가능하게 만들어요.

Azure AD OAuth2: Graph API에서 항상 그룹을 가져오는 새 옵션 (Azure AD OAuth2: New option to always fetch groups from the Graph API)

Grafana 모든 에디션에서 일반 공개되었어요.

Azure AD OAuth2 인증을 사용하고 Azure가 인증 토큰에 포함하지 않도록 하는 SecurityEnabled 그룹을 사용한다면, Grafana가 대신 Microsoft의 Graph API를 사용하도록 구성할 수 있어요.

Azure AD 인증을 구성할 때 force_use_graph_api 구성 옵션을 사용해 Grafana가 Graph API로 그룹을 가져오도록 강제해요.

RBAC: 토큰 권한 나열 (RBAC: List token's permissions)

Grafana Enterprise와 Cloud Advanced에서 일반 공개되었어요.

사용자와 토큰 권한 부여의 권한 관련 문제를 진단하는 데 도움이 되는 새 엔드포인트를 추가했어요. This endpoint를 사용하면 토큰과 관련된 RBAC 권한의 전체 목록을 얻을 수 있어요.

자세한 내용은 서비스 계정 토큰의 권한 디버그를 참고해요.

Terraform과 함께하는 RBAC: 프로비저닝 권한 확장 지원 (RBAC with Terraform: Extended support for provisioning permissions)

Grafana Enterprise와 Cloud Advanced에서 일반 공개되었어요.

이제 모든 Grafana 사용자는 최신 릴리스의 Terraform Grafana 제공자(버전 1.31.1+)를 사용해 서비스 계정에 대한 사용자와 팀 접근을 프로비저닝할 수 있어요.

이를 통해 서비스 계정 생성과 사용자 접근 허용부터 서비스 계정에 역할 할당과 서비스 계정 토큰 생성까지 Terraform으로 서비스 계정을 완전히 관리할 수 있어요.

Grafana Enterprise와 Cloud Pro 및 Advanced 사용자는 이제 Grafana의 Viewer, Editor, Admin 기본 역할에 대한 데이터 소스 접근을 프로비저닝하고 Edit 권한을 할당할 수 있어요.

또한 Grafana Enterprise와 Cloud Pro 및 Advanced 사용자를 안내하기 위해 RBAC 역할과 역할 할당 프로비저닝 문서를 추가했어요.

마지막으로 더 원활한 프로비저닝 경험을 보장하기 위해 여러 접근 제어 관련 버그를 수정했어요.

알림 (Alerting)

이 새 알림 기능은 모두 Grafana 모든 에디션에서 일반 공개되었어요.

Webex Teams 지원 (Support for Webex Teams)

이제 Cisco Webex Teams를 연락 지점으로 사용해 Webex Teams 공간에 알림을 보낼 수 있어요.

프로비저닝 API로 만든 알림 규칙 편집 (Edit alert rules created using the provisioning API)

Grafana UI에서 API로 프로비저닝된 알림 규칙을 편집할 수 있어요. 프로비저닝된 알림을 편집 가능하게 만들려면 API에서 알림 규칙을 만들거나 편집할 때 다음 요청에 x-disable-provenance 헤더를 추가해요:

POST /api/v1/provisioning/alert-rules

PUT /api/v1/provisioning/alert-rules/{UID}

알림 템플릿에서 값 지원 (Support values in notification templates)

알림 템플릿에 알림 값을 추가해 선택한 형식으로 알림의 주석, 레이블, 값을 출력하는 단일 템플릿을 만들 수 있어요.

알림 오류 보기 (View notification errors)

알림이 발생하지 않으면 연락 지점에 문제가 있을 때 무슨 문제인지와 오류 이유를 확인할 수 있어요. Receivers API에는 타임스탬프, 시도 기간, 오류를 포함한 오류 정보가 들어 있어요. 또한 UI에서 각 연락 지점의 오류를 볼 수 있어요.

알림 알림 오류

표현식 파이프라인 재설계 (Redesign of the expressions pipeline)

표현식 편집기와 미리보기를 단일 보기로 결합하도록 표현식 파이프라인 편집기를 재설계했어요.

표현식 파이프라인 재설계

Grafana v9.3의 새로운 기능