히트맵 위젯

원문 보기 위키 갱신 2026.10.05

히트맵(Heatmap) 위젯은 여러 태그에 걸쳐 집계된 메트릭을 표시해요. OpenTelemetry 히스토그램, 분포 메트릭, 고해상도 및 데이터 표시를 시각화하는 데 사용해요.

출처: 문서

본문

히트맵 위젯은 여러 태그에 걸쳐 집계된 메트릭을 보여 줍니다. OpenTelemetry 히스토그램, 분포 메트릭, 고해상도 및 데이터 표시를 시각화하는 데 사용해요.

평소처럼 메트릭 쿼리를 구성해요. 'counters' 히스토그램 모드를 사용해 OpenTelemetry 히스토그램을 그래프로 표시해요.

"avg/max/min/sum by/등" 컨트롤에서 선택해 관련 태그에 걸친 데이터를 확인해요.

Y축 컨트롤은 UI와 JSON 편집기를 통해 사용할 수 있어요. 이 컨트롤로 다음을 할 수 있어요:

y축을 특정 범위로 클립.
절대값 임계값을 기반으로 y축 경계를 자동으로 변경. 이 임계값은 그래프의 한쪽 또는 양쪽 끝(하한과 상한)에 적용해 "이상치" 계열을 제거할 수 있어요.
y축 스케일을 선형에서 log, pow, sqrt로 변경.

Y-Axis Controls 버튼을 펼쳐 Y축 스케일을 변경해요.

다음 구성 옵션을 사용할 수 있어요:

옵션	필수	설명
`Min`/`Max`	아니요	y축에 표시할 최솟값 및/또는 최댓값을 지정해요. 기본값으로 숫자 또는 `Auto`를 사용해요.
`Scale`	아니요	스케일 유형을 지정해요. 가능한 값: - linear: 선형 스케일(기본값) - log: 로그 스케일 - pow: 2의 거듭제곱 스케일(기본 2, JSON에서 수정) - sqrt: 제곱근 스케일
`Always include zero`	아니요	항상 0을 포함하거나 축을 데이터 범위에 맞춰요. 기본값은 항상 0을 포함하는 것이에요.

참고: 수학적 로그 함수는 음수 값을 허용하지 않으므로 Datadog 로그 스케일은 값의 부호가 같을 때(모두 > 0 또는 모두 < 0)만 작동해요. 그렇지 않으면 빈 그래프가 반환돼요.

이 위젯은 **Dashboards API**와 함께 사용할 수 있어요. widget JSON 스키마 정의를 참조하세요. type은 heatmap이며, requests 배열에 데이터 소스와 쿼리, 집계, 수식이 포함돼요.