Heatmap 패널

Heatmap은 시간과 bucket, series label, value로 밀도 변화를 볼 때 사용합니다. latency histogram, error bucket, resource distribution처럼 값의 분포가 중요한 화면에 적합합니다.

Data

Data에서는 x축 시간, y축 bucket, 색상 값이 한 row에 함께 나오도록 query를 구성합니다. ClickHouse SQL에서는 $__fromTime, $__toTime 매크로를 time range와 맞춥니다.

설정	역할
Datasource	trace latency는 `ClickHouse (SQL)`, Prometheus histogram은 `Prometheus (PromQL)`을 사용합니다.
Query type	ClickHouse는 table query, Prometheus histogram은 보통 `Range` query입니다.
반환 field	`x`, `bucket`, `value` 또는 `time`, `le`, `value`처럼 이름을 명확히 둡니다.
Run Query	row가 비어 있지 않은지, bucket label이 너무 많지 않은지 확인합니다.

Fields는 색상 legend와 tooltip 값의 단위, 소수점, 상태 색 기준을 정합니다. Heatmap cell의 위치는 Visualization이 정하지만 값이 어떻게 읽히는지는 Fields가 좌우합니다.

설정	역할
Display Name / No Value Text	tooltip과 빈 cell 문구를 정합니다.
Unit / Decimals	count면 `Short`, latency면 `ms`처럼 맞춥니다.
Min / Max	극단값 때문에 색이 눌릴 때 범위를 조정합니다.
Threshold Steps	특정 값 이상을 warning/critical처럼 읽을 때 사용합니다.
Value Mappings	0, null, 특수 상태값을 사람이 읽는 텍스트나 색상으로 바꿉니다.

Visualization에서는 query 결과의 어떤 field를 x/y/value로 쓸지와 heatmap 렌더링 방식을 정합니다.

설정	역할
Mode	histogram, series, value-binning 중 해석 방식을 고릅니다.
X / Y / Value field	시간, bucket, 색상 값 field를 지정합니다.
Series label field	Y field가 없을 때 행 이름으로 쓸 label입니다.
Color scale / scheme	linear/log와 색상 팔레트를 정합니다.
Empty cells	빈 칸을 blank로 둘지 0으로 채울지 정합니다.
Y sort / Max Y buckets	row 정렬과 bucket 수 상한입니다.
Cumulative histogram delta	누적 histogram을 interval delta처럼 해석합니다.

Data에서 x/y/value shape를 확인하고, Fields에서 값 단위를 맞춘 뒤, Visualization에서 field mapping과 empty cell 정책을 정합니다.