본문 바로가기
WIKI 기술 지식 베이스

분포 위젯

원문 보기 위키 갱신

분포 위젯 (Distribution Widget)

분포(Distribution) 시각화는 hosts 같은 하나 이상의 태그에 걸쳐 집계된 데이터를 보여 줍니다. 히트맵과 달리 분포 그래프의 x축은 시간이 아니라 수량이에요.

이 시각화는 단일 쿼리만 표시하며, 추가 쿼리는 무시돼요. 참고: 이 시각화에서는 이상치(outlier) 감지를 수행할 수 없어요.

출처: 문서

본문

개요

분포 시각화는 hosts 같은 하나 이상의 태그에 걸쳐 집계된 데이터를 보여 줍니다. 히트맵과 달리 분포 그래프의 x축은 시간이 아니라 수량이에요. 이 시각화는 단일 쿼리만 표시하며 추가 쿼리는 무시돼요.

참고: 이 시각화에서는 이상치 감지를 수행할 수 없어요.

설정

구성

  1. 그래프로 표시할 데이터를 선택해요. 분포 시각화는 메트릭, 실시간 프로세스, APM 요청 지연 시간, 로그 이벤트, RUM 이벤트를 포함한 많은 소스를 지원해요.
  2. avg/last/max/min/sum 컨트롤에서 선택해 관련 태그에 걸친 데이터를 확인해요.
  3. 사용 가능한 옵션으로 그래프를 사용자 지정해요.

옵션

포인트 히스토그램 vs 그룹 히스토그램

분포 위젯은 다음 히스토그램 유형을 지원해요:

  • 포인트 히스토그램(Histogram of points): 각 개별 데이터 포인트(예: 원시 요청 지연 측정값)가 값에 따라 버킷에 기여해요. 모든 기록에 걸친 측정값의 전체 분포를 보고 싶을 때 사용해요.
  • 그룹 히스토그램(Histogram of groups): 각 그룹(예: 서비스 또는 호스트)이 먼저 단일 집계 값(예: p75 지연 시간)으로 축소된 다음, 그 집계 값들이 버킷에 분포돼요. 결과 모양은 개별 측정값이 아닌 그룹별 요약 값의 분포를 반영해요.

참고: 두 유형은 데이터를 다르게 집계하므로, 둘 사이를 전환하면 히스토그램의 모양이 크게 달라질 수 있어요.

백분위수 마커

APM 요청 분포에서 x축에 백분위수 마커를 추가할 수 있어요.

X축 및 Y축 컨트롤

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

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

전체 화면

표준 전체 화면 옵션에 더해 x축 컨트롤을 사용해 특정 백분위수로 확대할 수 있어요.

API

이 위젯은 **Dashboards API**와 함께 사용할 수 있어요. widget JSON 스키마 정의를 참조해 분포 위젯의 요청 스키마를 확인할 수 있어요. 분포 위젯은 requests 배열에 메트릭, 로그, APM, 프로세스 등 다양한 data_source와 집계/수식 구성을 지원해요.

더 알아보기 (Learn more)