Grafana v11.3의 새로운 기능

Grafana 11.3에 오신 걸 환영해요! Scenes 기반 대시보드가 이제 일반 공개(GA)가 됐고, Explore Logs 플러그인이 기본으로 설치돼요. 대시보드 경험도 다른 방식으로 개선되었는데, 새 Actions 옵션으로 어떤 canvas 요소에서든 API 호출을 트리거할 수 있고, 변환(transformations)이 업데이트되어 동적 필드에 계산을 적용할 수 있어요. 알림 설정 경험도 단순화했고, 관리자가 모든 사용자에게 보낼 수 있는 커스터마이즈 가능한 공지 배너를 추가했으며, 일부 기본 권한도 개선했어요.

이 릴리스의 모든 변경 사항에 대한 더 자세한 내용은 changelog를 참고하세요. v11.3으로 업그레이드할 때 권장하는 구체적인 단계는 Upgrade Guide를 확인하세요.

출처: 문서

본문

Scenes 기반 대시보드 일반 공개

모든 Grafana 에디션에서 일반 공개

지난 몇 달 동안 Dashboards 아키텍처의 큰 업데이트 작업을 해왔고 Scenes 라이브러리로 마이그레이션했어요. 이 마이그레이션은 더 안정적이고 역동적이며 유연한 대시보드를 제공하고, 우리가 구상하는 Grafana 대시보드의 미래를 위한 기반을 마련해요. 이 작업의 일부로 도입되는 네 가지 개선 사항은 다음과 같아요.

뷰 모드와 편집 모드

대시보드 편집 과정에서 시각적으로 어수선한 옵션을 효율적으로 탐색하기 어려울 수 있어요. 뷰(View) 모드에서는 대시보드 화면이 덜 어수선해요. 편집(Edit) 모드에서는 패널 추가나 설정 변경 같은 옵션에 접근하기 더 쉬워요.

스크롤 중에도 템플릿 변수와 시간 범위 선택기가 유지

시간 선택기가 이제 툴바가 아니라 대시보드 캔버스가 됐고, 템플릿 변수와 함께 대시보드를 스크롤할 때 상단에 고정돼요. 높은 요청이 있던 기능인데 출시하게 되어 매우 기쁘게 생각해요!

Grafana URL의 시간대 파라미터

새 시간대 URL 파라미터 tz를 추가했어요. 이를 통해 선택한 시간대로 대시보드를 공유할 수 있어서, 수신자가 로컬 설정과 무관하게 의도한 시간대로 볼 수 있게 해줘요.

키오스크 모드가 대시보드 컨트롤을 표시

플레이리스트를 재생하거나 대시보드를 전체 화면으로 표시할 때 기본으로 컨트롤을 볼 수 있어요. 이 컨트롤에는 시간 범위 선택기, 새로고침 버튼, 변수, 주석, 링크가 포함돼요.

플레이리스트 재생 중 이 컨트롤을 숨기고 싶다면 플레이리스트를 시작할 때 새 구성 옵션을 사용할 수 있어요. 플레이리스트가 실행되는 동안 표시할 컨트롤을 고를 수 있죠.

플레이리스트 재생 밖에서 컨트롤을 구성하려면 다음 URL 파라미터를 사용할 수 있어요:

_dash.hideTimePicker: 시간·새로고침 선택기를 숨김
_dash.hideVariables: 변수·주석 컨트롤을 숨김
_dash.hideLinks: 대시보드 링크를 숨김

알려진 제한 사항

변수 사용 검사(variable usage check)는 아직 사용할 수 없어요.
패널 편집: Library panels 탭은 더 이상 없어요. 패널 메뉴에서 라이브러리 패널을 교체할 수 있어요.
Overrides 탭이 패널 옵션에 없어요 (Grafana v11.3.0에서 예정). Overrides는 옵션 목록 하단에 표시돼요.
시각화 선택기를 접는 드롭다운 메뉴가 없어요 (Grafana v11.3.0에서 예정).
편집 모드가 활성화되면 Share 버튼이 보이지 않아요 (Grafana v11.3.0에서 예정).

우리가 만든 모든 개선 사항을 자세히 알고 싶다면 블로그 포스트를 놓치지 마세요.

추가 대시보드·시각화 개선

Cell Inspect의 자동 서식 테이블 셀 값

모든 Grafana 에디션에서 일반 공개

테이블 시각화에서 Inspect value 서랍에 Plain text와 Code editor 탭을 추가해 inspect value 경험을 개선했어요.

Cell inspect value 스위치가 켜져 있으면 셀의 inspect 아이콘을 클릭하면 서랍이 열려요. Grafana가 셀의 데이터 타입을 자동 감지하려 시도하고 관련 탭이 표시된 채 서랍을 열어요. 그러나 탭 사이를 자유롭게 오갈 수 있어요.

Canvas 액션

모든 Grafana 에디션에서 실험적

canvas 시각화를 업데이트해서 이제 canvas 요소에 GitHub에서 이슈 열기, 어떤 API 호출 같은 액션을 추가할 수 있어요. Selected element 구성에 이제 Data links and actions 섹션이 있어 요소에 액션을 추가할 수 있어요. 각 액션은 API 엔드포인트를 호출하도록 구성할 수 있어요.

액션은 단일 클릭으로 트리거하도록 구성할 수도 있어요. 이 기능을 활성화하려면 Selected element data links and actions 옵션의 One-click 섹션에서 Action을 선택하세요. 요소에 여러 액션이 있으면 목록의 첫 번째 액션이 원클릭 기능을 가져요.

또한 툴팁에 액션이 표시되는 순서를 드래그 앤 드롭으로 제어하는 기능도 추가했어요.

이 기능을 시험해 보려면 vizActions 기능 토글을 활성화하세요.

bar gauge 시각화의 범례 지원

모든 Grafana 에디션에서 일반 공개

bar gauge 시각화에 범례 지원을 추가했어요. 범례를 표준화하고 더 많은 패널에서 사용 가능하게 만드는 노력의 일환이에요. 패널 옵션의 Legend 섹션으로 이동해 범례를 커스터마이즈할 수 있어요. 기본적으로 범례는 비활성화돼 있어요.

각 bar gauge에서 이름도 숨길 수 있어요. 범례와 중복되니까요. Name placement 옵션에서 Hidden을 선택하면 돼요.

주어진 테이블의 모든 number 필드에 같은 이진 변환을 한 번에 적용

모든 Grafana 에디션에서 일반 공개

Add field from calculation 변환으로 이진 연산을 설정할 때(예: 각 열을 특정 값으로 나눌 때), 선택할 수 있는 새 All number fields 옵션이 있어요. 이를 사용해 여러 number 필드에 수학 연산자를 동시에 적용할 수 있어요. 이 기능은 이름이 동적으로 정해진 여러 필드를 담은 데이터를 스케일링·오프셋할 때 특히 유용해서, 필드 이름을 모르는 상황에서도 변환을 적용할 수 있게 해줘요.

시각화용 액션

모든 Grafana 에디션에서 실험적

액션을 추가할 수 있도록 여러 시각화를 업데이트했어요. 패널 구성에 이제 Data links and actions 섹션이 있어 각각 API 엔드포인트를 호출하도록 구성할 수 있는 액션을 추가할 수 있어요.

또한 툴팁에 액션이 표시되는 순서를 드래그 앤 드롭으로 제어하는 기능도 추가했어요.

이 기능은 다음 시각화에 추가됐어요:

Bar chart
Candlestick
Heatmap
State timeline
Status history
Time series
Trend
XY chart

이 기능을 시험해 보려면 vizActions 기능 토글을 활성화하세요.

Explore Logs

Explore Logs 플러그인이 기본으로 설치됨

모든 Grafana 에디션에서 일반 공개

Explore Logs로 쿼리를 작성하지 않고도 로그를 시각화·탐색해 문제를 해결할 수 있어요. 로그 볼륨의 급증을 쉽게 찾고, 로그를 필터링하고, 문제 있는 로그 라인을 정확히 짚을 수 있어요.

Explore Logs는 클라우드에서 이미 GA이고 기본으로 설치되어 있지만, Grafana v11.3.0부터 Open Source 또는 Enterprise 인스턴스에도 자동으로 설치돼요. Explore Metrics와 나란히 Explore Logs를 수동 설치 없이 사용할 수 있게 해줘요.

이것은 Grafana 구성의 preinstall 구성 파라미터로 설정돼요. Explore Logs에 대한 자세한 내용은 문서를 참고하세요.

상관관계(Correlations)

Explore에서 외부 URL에 상관관계 추가하기

모든 Grafana 에디션에서 일반 공개

Correlations는 Grafana 사용자가 데이터 소스 사이에 링크를 설정하게 해주는 기능이에요. 이전에는 생성된 링크가 한 쿼리에서 다른 쿼리로만 이어졌어요. 즉 쿼리 결과가 다른 쿼리 결과를 담은 두 번째 Explore 창을 여는 링크만 생성할 수 있었죠.

이 기능으로 사용자는 이제 검색 결과에 기반해 타사 웹 기반 소프트웨어에 링크할 수 있어요. 형식은 표준 Grafana 변수 사용 형식을 따릅니다.

알림(Alerting)

알림 규칙 생성을 위한 단순화된 쿼리 섹션

모든 Grafana 에디션에서 일반 공개

Grafana 관리 알림 규칙을 만들 때 단순화된 버전의 쿼리·알림 조건 단계를 사용하세요. 기본 옵션은 깔끔한 헤더와 단일 쿼리·조건으로 규칙 생성을 간소화해요. 더 복잡한 규칙에는 고급 옵션으로 전환해 여러 쿼리와 식을 추가하세요.

이 기능은 앞으로 몇 주에 걸쳐 Grafana Cloud로 롤아웃돼요.

Grafana Enterprise와 OSS:

이 기능을 사용하려면 alertingQueryAndExpressionsStepMode 기능 토글을 활성화하세요.

Alerting의 알림에 대한 역할 기반 접근 제어

Grafana Enterprise와 Grafana Cloud에서 공개 프리뷰

Role-Based Access Control(RBAC)로 contact points, mute timings, notification templates를 관리하세요. 권한이나 고정 역할을 사용해 contact points, mute timings, notification templates를 만들고·편집하고·읽을 수 있는 사람을 선택할 수 있어요.

mute timings와 notification templates의 경우 모든 사용자에게 모든 권한을 부여하거나 아무 권한도 부여하지 않을 수 있어요. contact points의 경우 개별 contact point로 권한을 확장하거나 제한할 수 있어요.

Grafana 관리 알림용 recording rules

모든 Grafana 에디션에서 일반 공개

Grafana 관리 알림 규칙용 recording rules를 만들어 자주 필요한 식이나 계산 비용이 높은 식을 미리 계산하고 그 결과를 새 시계열 집합으로 저장할 수 있어요. 이 새 시계열을 쿼리하는 것이 더 빠르고, 특히 대시보드가 새로고침할 때마다 같은 식을 쿼리하므로 대시보드에 유용해요. 이전에는 이 기능이 데이터소스 관리 알림 규칙에서만 사용할 수 있었어요.

Grafana OSS와 Enterprise에서 grafanaManagedRecordingRules 기능 플래그를 활성화하면 Grafana 관리·데이터소스 관리 recording rules를 모두 만들 수 있어요.

데이터 소스

GitHub 데이터 소스의 GitHub App 인증

모든 Grafana 에디션에서 일반 공개

GitHub App을 사용해 GitHub 데이터 소스를 인증하세요. personal access token(PAT)의 대안이에요. GitHub App 인증은 더 세분화된 권한을 부여해 보안을 강화하고, 과도한 권한 부여의 위험을 줄여줘요.

자세한 내용은 GitHub 데이터 소스 문서의 GitHub App 인증 설정 지침을 참고하세요.

공지 배너

Grafana Enterprise와 Grafana Cloud에서 공개 프리뷰

Grafana 관리자는 이메일과 Slack 같은 전통적인 채널로 중요한 업데이트와 유지보수 정보를 사용자에게 효과적으로 전달하는 데 어려움을 겪어요. 이제 Grafana 인터페이스 안에 커스터마이즈 가능한 배너를 표시해 중요한 정보가 보이고 적시에 전달되게 할 수 있어요. 이를 통해 모든 사용자가 중요한 업데이트, 유지보수 일정, 규정 준수 정보, 기타 중요한 메시지를 즉시 알게 되어 커뮤니케이션을 놓칠 가능성을 줄이고 전반적인 사용자 인식과 참여를 높여요.

기본적으로 조직 관리자만 공지 배너를 만들 수 있어요. 역할 기반 접근 제어로 공지 배너를 만들 수 있는 사람을 커스터마이즈할 수 있어요.

자체 관리 Grafana에서 공지 배너를 사용하려면 Grafana v11.3 이상에서 notificationBanner 기능 토글을 켜고 Grafana 인스턴스에서 Admin > General > Announcement Banner 구성 페이지로 이동하세요.

개선된 하위 폴더 생성 흐름

모든 Grafana 에디션에서 일반 공개

이제 Edit 또는 Admin 권한이 있는 폴더 안에서 추가 권한 없이 하위 폴더를 만들 수 있어요. 이를 통해 사용자와 팀이 폴더·대시보드 계층을 완전히 관리할 수 있고, 사용자에게 최소한의 필요한 권한 집합을 부여해 인스턴스를 안전하게 유지할 수 있어요.

플러그인

플러그인 세부 정보 페이지 재설계

모든 Grafana 에디션에서 공개 프리뷰

관리자가 Grafana 플러그인을 평가하고 상호작용하기 쉽게 하려고, 플러그인 세부 정보 페이지를 재구성해 플러그인이 마지막으로 업데이트된 시기 같은 중요한 메타데이터를 강조하고 있어요.

이 새 레이아웃을 모든 플러그인에 대한 일관된 링크로 더 확장해, 현재 선택적으로 구성할 수 있는 커스텀 링크를 보완할 계획이에요. 이 개선된 일관성은 Grafana Labs, 상용 파트너, 커뮤니티의 플러그인 개발자와 더 간단하게 상호작용하게 해줘요. 이 링크에는 기능 요청이나 버그 보고를 올리는 액션, 커뮤니티 개발자가 그들의 작업에 의존하는 사람들을 위한 지원·후원 옵션을 표시하는 것이 포함돼요.

인증과 권한 부여

UI로 LDAP 구성하기

모든 Grafana 에디션에서 공개 프리뷰

새 UI를 사용해 LDAP 서버를 Identity Provider로 설정해, 설정 과정을 부드럽게 하고 제대로 동작하는지 빠른 확인을 받을 수 있어요.

새 사용자 인터페이스는 각 옵션이 무엇을 하는지 훨씬 명확하게 만들고, 다양한 구성을 설정하는 것이 더 투명해졌어요. 또한 새 설정이 적용되도록 Grafana 인스턴스를 재시작할 필요도 없어요.

UI에서 LDAP를 사용하려면 ssoSettingsLDAP 기능 토글을 활성화하세요.

개발자: 플러그인에서 RBAC 지원

모든 Grafana 에디션에서 일반 공개

플러그인이 이제 Grafana의 역할 기반 접근 제어를 활용해 자체 역할과 권한을 정의해 라우트에 대한 접근을 제어할 수 있다는 것을 발표하게 되어 기쁘게 생각해요.

역할과 기본 할당을 정의하려면 플러그인 개발자가 plugin.json 파일에 roles 섹션을 추가해야 해요. Grafana가 자동으로 이 역할을 등록하고 Viewer, Editor, Admin, Grafana Admin 같은 해당 기본 역할에 할당해요.

다음은 두 개의 RBAC 플러그인 역할을 정의하고 기본으로 Admin과 Viewer(그래서 Editor와 Admin)에 할당하는 예시예요:

"roles": [
  {
    "role": {
      "name": "Patents Reader",
      "description": "Read patents",
      "permissions": [
        {"action": "grafana-appwithrbac-app.patents:read"}
      ]
    },
    "grants": ["Admin"]
  },
  {
    "role": {
      "name": "Research papers Reader",
      "description": "Read research papers",
      "permissions": [
        {"action": "grafana-appwithrbac-app.papers:read"}
      ]
    },
    "grants": ["Viewer"]
  }
]

includes와 routes 보호도 간단하며, plugin.json 파일의 이 섹션의 새 action 및 reqAction 필드로 할 수 있어요.

이것을 테스트하고 플러그인 RBAC를 더 탐색하려면 이 플러그인 예시를 참고하세요.

알려진 제한 사항: 플러그인 권한은 현재 스코프가 없는 액션으로 제한돼요.

Grafana v11.3의 새로운 기능