히트맵
히트맵 (Heatmap)
히트맵은 시간에 따른 히스토그램을 보여주는 시각화예요. 히스토그램이 특정 값 범위에 속하는 데이터 분포를 보여준다면, 히트맵은 시간에 따른 히스토그램 데이터 분포에서 패턴을 식별할 수 있게 해줍니다. 예를 들어 지난 몇 년간의 온도 변화 추이를 파악하고 싶을 때 히트맵으로 데이터의 트렌드를 식별할 수 있어요.
출처: 문서
본문
히트맵은 시간에 따른 히스토그램을 볼 수 있게 합니다. 히스토그램은 특정 값 범위에 속하는 데이터 분포를 표시하고, 히트맵은 시간에 따른 분포에서 패턴을 식별하게 합니다. 자세한 내용은 Introduction to histograms and heatmaps를 참고하세요.
다음과 같은 경우 히트맵을 사용할 수 있습니다.
- 데이터 분포의 큰 밀도 시각화
- 해석하기 쉬운 다양한 색상 스킴으로 많은 양의 데이터 압축
- 데이터 분포의 이상치 식별
- 값·추세가 시간에 따라 어떻게 변하는지 통계 분석 제공
지원 데이터 형식
히트맵은 시계열 데이터를 지원합니다.
예시
| Time | Walking (km) |
|---|---|
| 2023-06-25 21:13:09 | 10 |
| 2023-08-25 21:13:10 | 8 |
| 2023-08-30 21:13:10 | 10 |
| 2023-10-08 21:13:11 | 12 |
| 2023-12-25 21:13:11 | 14 |
| 2024-01-05 21:13:12 | 13 |
| 2024-02-22 21:13:13 | 10 |
패널 시간 범위 팬과 줌
패널 시간 범위를 좌우로 팬하고 확대·축소할 수 있으며, 이는 대시보드 시간 범위도 변경합니다.
- Zoom in — 패널을 클릭·드래그해 특정 시간 범위 확대
- Zoom out — 패널 아무 곳이나 더블클릭해 시간 범위 축소. 축소 시 각 더블클릭마다 범위가 두 배가 되며 양쪽에 동일한 시간이 추가됩니다. 원래 9:00
9:59면 다음 범위는 8:3010:29, 그다음 7:30~11:29 - Pan — 패널 x축 영역을 클릭·드래그하면 드래그한 거리만큼 시간 범위가 이동. 9:00
9:59에서 30분 오른쪽으로 드래그하면 9:3010:29
화면 녹화는 Panel overview 문서를 참고하세요.
구성 옵션
패널 옵션 (Panel options)
패널 편집기 창의 Panel options 섹션에서 패널 제목, 설명, 패널 링크 등 기본 옵션을 설정합니다.
히트맵 옵션
다음 옵션은 히트맵 데이터가 계산·그룹화되는 방식을 제어합니다.
| 옵션 | 설명 |
|---|---|
| Calculate from data | 데이터가 이미 계산된 히트맵(데이터 소스·트랜스포머로부터)인지, 패널에서 계산해야 하는지 결정. |
| X Bucket | x축이 버킷으로 분할되는 방식을 결정. Size 입력에 시간 간격 지정. 예: 1h는 x축 셀을 1시간 폭으로. Count 기반 간격도 설정 가능. |
| Y Bucket | y축이 버킷으로 분할되는 방식을 결정. Size 또는 Count 선택. |
| Y Bucket scale | Calculate from data가 Yes일 때 y축 값 스케일 선택. Linear - 선형. Logarithmic - Log base를 2 또는 10으로. Symlog - Log base 2·10과 Linear threshold 값 입력. |
| Y Bucket scale | Calculate from data가 No일 때 사전 버킷 데이터의 y축 스케일 설정. Auto, Linear, Log(Log base 2·10), Symlog(Linear threshold 필요). |
Y축 옵션
| 옵션 | 설명 |
|---|---|
| Placement | y축 표시 위치. Left, Right, Hidden. |
| Unit | 단위 구성. |
| Decimals | 소수 구성. |
| Min/Max value | 축 범위 구성. |
| Axis width | 축 너비 구성. |
| Axis label | 축 값 구성. |
| Tick alignment | 눈금 정렬. Auto, Top (LE), Middle, Bottom (GE). Calculate from data가 No이고 Y Bucket scale이 Auto일 때만 표시. |
| Reverse | 선택 시 축이 역순으로 표시. |
여러 y축
온도와 습도를 모두 표시하는 데이터셋처럼 여러 단위의 두 y축을 표시하고 싶은 경우가 있습니다. 필드 오버라이드를 추가해 여러 y축을 구성하고 표시 위치를 제어할 수 있습니다. 온도·습도 데이터셋 예시를 참고하고 표시할 각 y축마다 반복하세요.
색상 옵션 (Colors options)
색 스펙트럼은 각 버킷의 값 개수와 할당된 색 사이의 매핑을 제어합니다. 스펙트럼 가장 왼쪽 색은 최소 개수, 가장 오른쪽 색은 최대 개수를 나타냅니다. 일부 색 스킴은 라이트 테마에서 자동 반전됩니다. 색 모드를 Opacity로 변경할 수도 있는데, 이 경우 색은 그대로이고 버킷 개수에 따라 불투명도가 바뀝니다.
Mode
- Scheme — 버킷 값을 셀 색으로 표현. Scheme 모드이면 색 스킴 선택.
- Opacity — 버킷 값을 셀 불투명도로 표현. 불투명 셀은 최대값 의미.
- Color — 셀 기본 색.
- Scale — 버킷 값을 불투명도로 매핑하는 스케일. Exponential — 지수 스케일(Exponent 값 k로 셀 불투명도를 value^k로 계산. k<1이면 로그, k>1이면 지수, 1이면 선형). Linear — 선형 스케일.
Steps
1~128 사이 값 설정.
Reverse
색 스킴을 뒤집는 스위치. Scheme 색 모드에서만 적용.
Start/end color scale from value
기본적으로 Grafana는 최소·최대 버킷 값을 기반으로 셀 색을 계산합니다. Start color scale from value와 End color scale at value로 그 값을 덮어쓸 수 있습니다. 버킷 값을 z축, 시작·끝 값을 z-min·z-max로 생각하면 됩니다.
- Start color scale from value — 셀 색 계산에 사용되는 최소값. Auto(min) 자리 표시자는 시리즈 최소값 사용. 이 값보다 작은 버킷 값은 최소 색에 매핑.
- End color scale at value — 셀 색 계산에 사용되는 최대값. Auto(max)는 시리즈 최대값 사용. 이 값보다 큰 버킷 값은 최대 색에 매핑.
셀 표시 옵션 (Cell display options)
| 옵션 | 설명 |
|---|---|
| Value name | Calculate from data가 No일 때 셀 값 열의 라벨 설정. |
| Unit | 단위 구성. |
| Decimals | 소수 구성. |
| Cell gap | 셀 사이 공간 설정. |
| Hide cells with values <= | 값 입력. |
| Hide cells with values >= | 값 입력. |
툴팁 옵션 (Tooltip options)
| 옵션 | 설명 |
|---|---|
| Tooltip mode | 커서를 올릴 때 툴팁 동작. |
| Show histogram (Y axis) | Tooltip mode가 Single일 때 표시. 툴팁에 y축 히스토그램 포함 여부 제어. |
| Show color scale | 툴팁에 범례에도 표시되는 색 스케일 포함 여부 제어. |
| Max width | 툴팁 박스 최대 너비. |
| Max height | 툴팁 박스 최대 높이. Tooltip mode가 All이거나 예시 데이터가 있을 때 표시. 설정 안 하면 스크롤 제한 없음. |
Tooltip mode
- Single — 호버 툴팁이 마우스를 올린 단일 시리즈만 표시
- All — 모든 시리즈 표시. 호버 중인 시리즈를 툴팁 목록에서 굵게 강조
- Hidden — 상호작용 시 툴팁 미표시
범례 옵션 (Legend options)
| 옵션 | 설명 |
|---|---|
| Show legend | 범례 켜기/끄기. |
| Placement | Bottom - 그래프 아래, Right - 그래프 오른쪽. |
| Width | 오른쪽 배치 시 너비 제어. 기본 픽셀 너비 또는 max(200px, 20%) 같은 CSS width 속성. 오른쪽 배치일 때만 표시. |
자세한 내용은 Configure a legend를 참고하세요.
주석 옵션 (Annotation options)
| 옵션 | 설명 |
|---|---|
| Multi-row annotations | 각 주석 데이터 프레임을 시각화의 별도 행으로 분리. 주석을 여러 개 표시하는 패널에서만 보임. |
| Annotation clustering | 인접한 포인트 주석을 단일 주석 영역으로 결합. |
| Hide lines and areas | 주석 표시선과 영역 주석의 음영 영역 표시 제어. |
예시 (Exemplars)
예시 데이터를 표시하는 색 설정.
데이터 링크와 액션
데이터 링크로 소스 패널 컨텍스트를 유지하며 다른 패널·대시보드·외부 리소스로 연결할 수 있습니다. 각 데이터 링크에 Title, URL, Open in new tab을 설정합니다.
참고: 이 시각화는 Actions를 지원하지 않습니다.
자세한 내용은 Configure data links and actions를 참고하세요.
필드 오버라이드 (Field overrides)
오버라이드로 특정 필드·시리즈의 시각화 설정을 커스터마이즈합니다. 옵션: Fields with name, Field with name matching regex, Fields with type, Fields returned by query, Fields with values. 자세한 내용은 Configure field overrides를 참고하세요.