패널 개요

패널 개요 (Panel overview)

Grafana 패널은 쿼리와 시각화로 구성된 데이터의 시각적 표현이에요. 패널 안에서 변환(transformations)을 적용해 시각화 전에 쿼리 결과를 처리할 수 있고, 데이터 형식 지정과 시각화 옵션 구성으로 패널을 더 커스터마이즈할 수 있어요.

출처: Panel overview

본문

각 패널에는 패널에서 선택한 데이터 소스에 특화된 쿼리 편집기가 있어요. 쿼리 편집기로 시각화할 데이터를 반환하는 쿼리를 만들 수 있어요. 패널은 필드 값에 따라 색상 적용부터 커스텀 단위 생성까지 다양한 형식·스타일 옵션을 제공하며, 각 시각화는 데이터 표시 방식을 더 세밀하게 제어하는 고유 옵션도 함께 제공해요. 패널은 대시보드에서 드래그·드롭·크기 조절로 재배치할 수 있어요.

패널 추가를 시작하려면 데이터 소스가 구성되어 있어야 해요. 데이터 소스 사용에 대한 자세한 내용은 Data sources를, 관리자로서의 데이터 소스 관리는 Data source management를 참고해요.

패널 기능 개요

패널 제목(Panel title): 직접 만들거나 생성형 AI 기능으로 Grafana가 만들어줄 수 있어요.
패널 설명(Panel description): 직접 만들거나 생성형 AI 기능으로 만듦.
링크(Links): 다른 대시보드·패널·외부 사이트로 패널 링크를 추가.
패널 메뉴(Panel menu): View, Edit, Inspect, Remove 같은 작업에 접근.
범례(Legend): 범례에서 직접 시리즈 색상, y축, 시리즈 표시 여부 변경.
툴팁(Tooltips): 데이터 포인트에 대한 추가 정보를 보려면 툴팁을 봐요.

패널 메뉴

패널 편집기에는 패널 오른쪽 상단 모서리에 커서를 올리고 나타나는 패널 메뉴 아이콘을 클릭한 뒤 Edit을 선택해 접근해요. 패널 메뉴는 여러 작업에도 접근을 제공해요.

View: 패널을 전체 화면으로 봐요. View panel 사이드바를 열고 지원되는 시각화에 대한 컨트롤을 표시해요(활성화된 경우).
Edit: 패널과 시각화 옵션을 편집하기 위해 패널 편집기를 열어요.
Share: 패널을 링크, embed, 스냅샷으로 공유해요.
Explore: 쿼리에 집중할 수 있게 패널을 Explore에서 열어요.
Inspect: 패널 데이터, 통계, 메타데이터, JSON, 쿼리를 검토할 수 있는 Inspect 드로어를 열어요.
- Data: Data 탭에서 Inspect 드로어 열기
- Query: Query 탭에서 열기
- Panel JSON: JSON 탭에서 열기
Time settings: 패널별 시간 옵션을 설정하는 Panel time settings 드로어를 열어요. Public preview.
Styles: 편집 모드 전용. 같은 대시보드의 한 패널에서 다른 패널로 스타일을 복사·붙여넣기해요.
Assistant: 보기 모드 전용. Grafana Assistant 도움말 옵션에 접근. Grafana Cloud에서만 사용 가능.
Metrics drilldown: 추가 탐색을 위해 패널을 Drilldown > Metrics 기능에서 열어요.
Extensions: 보기 모드 전용. 인시던트 선언 같은 설치된 애플리케이션의 다른 작업에 접근.
More: 기타 패널 작업에 접근.
- Duplicate: 편집 모드 전용. 패널 복사본 만들기. 복제된 패널은 원본과 별개로 데이터를 쿼리해요.
- Copy: 패널을 클립보드에 복사.
- New library panel: 편집 모드 전용. 다른 대시보드로 가져올 수 있는 패널 만들기.
- New alert rule: 패널 쿼리를 기반으로 Grafana-managed alert를 만들 수 있는 Alerting의 알림 규칙 구성 페이지를 열어요.
- Hide/Show legend: 패널 범례 숨기기/보이기.
- Get help: 스냅샷이나 패널 데이터를 Grafana Labs 기술 지원에 보내요.
Remove: 편집 모드 전용. 대시보드에서 패널 제거.

보기 모드 패널 컨트롤

View panel 사이드바는 현재 public preview 상태이며 기본적으로 활성화돼 있어요. 끄려면 Grafana 구성 파일에서 viewPanelPane 기능 토글을 비활성화하거나 지원팀에 문의하세요.

패널을 전체 화면 보기 모드에서 열면 Grafana가 패널 조정 컨트롤이 있는 View panel 사이드바를 표시해요. 이러한 컨트롤은 보기 모드에 있으므로 편집 권한이 없어도 사용할 수 있고, 저장된 대시보드에는 영향이 없어요. 사이드바 컨트롤:

Quick toggles: 범례 표시 여부, 기본 그래프 스타일 같은 일반 시각화 옵션 조정.
Fan-out by series or label: 하나의 그래프를 시리즈 또는 레이블 값별로 여러 그래프로 분할. 단일 그래프에 시리즈가 많고 어떤 시리즈·레이블이 이상치를 공유하는지 찾아야 할 때 유용.

이 기능은 time series 시각화에서 지원돼요.

시리즈 또는 레이블로 팬아웃 (Fan-out by series or label)

팬아웃은 하나의 패널을 여러 패널로 분할해 시리즈나 레이블 값을 나란히 비교할 수 있게 해요.

Option	Description
Disabled	원래 단일 패널 표시
By series	시리즈당 하나의 패널 생성
Labels	선택한 레이블의 값마다(예: `method`, `status`) 하나의 패널 생성

패널 데이터에 레이블이 없으면 Labels 아래에 Data has no labels가 표시돼요. 팬아웃 모드를 선택하면 Grafana가 대시보드 URL을 fanout 쿼리 파라미터로 갱신해 분할 보기를 공유할 수 있게 해요.

키보드 단축키

패널에 특화된 키보드 단축키. ?를 눌러 모든 단축키를 표시해요. 패널 위에 마우스를 올리면 해당 패널을 대상으로 하는 일부 단축키를 사용할 수 있어요.

e: 패널 편집 보기 토글
v: 패널 전체 화면 보기 토글
pu: 패널 공유 링크 복사
pe: 공유 embed
ps: 공유 스냅샷
px: Explore에서 패널 열기
pc: 패널 복사
pv: 패널 붙여넣기
pd: 패널 복제
i: 검사
pl: 범례 숨기기/보이기
pr: 패널 제거

패널 시간 설정 (Panel time settings)

Panel time settings는 현재 public preview 상태. 사용하려면 Grafana 구성 파일에서 panelTimeSettings 기능 토글을 활성화하세요.

패널의 시간 범위를 제어하는 설정을 구성할 수 있어요.

Option	Description
Panel time range	대시보드 시간 범위를 재정의. 사전 설정 값 또는 `5m`, `2h` 같은 커스텀 값 사용
Time shift	대시보드 또는 패널 시간 범위에 상대적인 시간 이동 추가
Time comparison	두 시간 범위 사이의 데이터 비교. 함께 사용할 때 Time shift 다음에 적용
Hide panel time range	패널 헤더에 패널 시간 범위를 표시하지 않음

패널 시간 범위 팬과 확대/축소

패널 시간 범위를 좌우로 팬하고, 확대·축소할 수 있어요. 이는 대시보드 시간 범위도 바꿔요. 지원 시각화: Candlestick, Heatmap, State timeline, Status history, Time series.

확대(Zoom in): 패널을 클릭·드래그해 특정 시간 범위를 확대.
축소(Zoom out): 패널 어디든 더블클릭하면 시간 범위를 축소. 더블클릭마다 범위가 2배로 커지고 각 측면에 동일한 시간이 추가돼요. 예: 원래 9:00-9:59 → 8:30-10:29 → 7:30-11:29.
팬(Pan): 패널 x축 영역을 클릭·드래그해 시간 범위를 팬. 드래그 거리만큼 시간 범위가 이동해요.

패널 추가

빈 대시보드에 패널을 추가하려면 패널을 대시보드에 클릭하거나 드래그해요. 기존 대시보드에 추가하려면:

대시보드 오른쪽 상단의 Edit을 클릭해요.
Add new element 아이콘(파란색 +)을 클릭해요.
패널을 대시보드에 클릭하거나 드래그해요.

패널 구성

패널 구성에 대한 자세한 내용은 다음 하위 주제를 참고해요.