히스토그램

히스토그램 (Histogram)

히스토그램은 값의 분포를 계산해 막대 차트로 나타내는 시각화예요. 각 막대는 버킷을 나타내며, y축과 막대 높이는 각 버킷에 속하는 값의 개수, x축은 값 범위를 뜻해요. 예를 들어 사람들의 키 분포를 이해하고 싶을 때 데이터 분포에서 패턴이나 인사이트를 식별하는 데 유용합니다.

출처: 문서

본문

히스토그램은 값의 분포를 계산해 막대 차트로 표시합니다. 각 막대는 버킷을 나타내며, y축·막대 높이는 각 버킷에 속하는 값의 개수, x축은 값 범위를 나타냅니다.

다음 경우 히스토그램을 사용할 수 있습니다.

특정 시간 범위의 데이터 분포를 시각화·분석해 특정 값이 얼마나 자주 발생하는지 파악
데이터 분포의 이상치 식별
의사결정을 돕는 통계 분석 제공

지원 데이터 형식

히스토그램은 시계열과 하나 이상의 숫자 필드를 가진 테이블 결과를 지원합니다. 데이터 소스가 사전 계산된 히스토그램 버킷을 반환하면 패널에서 버킷을 계산하는 대신 제공된 빈도수를 렌더링합니다.

예시

시계열 테이블:

Time	Walking (km)
2024-03-25 21:13:09	37.2
2024-03-25 21:13:10	37.1
2024-03-25 21:13:10	37.0
2024-03-25 21:13:11	37.2
2024-03-25 21:13:11	36.9
2024-03-25 21:13:12	36.7
2024-03-25 21:13:13	36.3

기본 숫자 테이블:

Gender	Height (in)	Weight (lbs)
Male	73.8	242
Male	68.8	162
Male	74.1	213
Male	71.7	220
Male	69.9	206
Male	67.3	152
Male	68.8	184

구성 옵션

패널 옵션 (Panel options)

패널 편집기 창의 Panel options 섹션에서 패널 제목, 설명, 패널 링크 등 기본 옵션을 설정합니다.

히스토그램 옵션

쿼리 데이터가 이미 히스토그램 프레임이면 버킷 옵션은 읽기 전용이고 Grafana는 쿼리가 계산한 빈도수를 표시합니다.

옵션	설명
Bucket count	데이터를 그룹화하는 데 사용되는 빈(bin) 개수 지정. 표시 분포의 세밀도에 영향. 비워두면 자동 버킷 개수 30.
Bucket size	버킷 크기. 비워두면 자동 버킷 크기(전체 범위의 ~10%).
Bucket offset	첫 버킷이 0에서 시작하지 않아야 할 때. 0이 아닌 오프셋은 집계 창을 이동시킴.
Combine series	모든 시리즈·필드를 결합된 하나의 히스토그램으로 병합.
Stacking	여러 시리즈의 표시 방식. Off - 나란히 표시. Normal - 위에 쌓아 누적값 표시. 100% - 차트를 100%로 채워 각 시리즈의 상대 비율 표시.
Line width	막대 선 너비 제어.
Fill opacity	막대 채움 불투명도 제어.
Gradient mode	그라디언트 채움 모드 설정. 채움 그라디언트는 선 색 기반.

Bucket offset

첫 버킷이 0에서 시작하지 않아야 할 때, 0이 아닌 오프셋은 집계 창을 이동시킵니다. 예를 들어 기본 0 오프셋의 5 크기 버킷(0-5, 5-10, 10-15)은 오프셋 2에서 2-7, 7-12, 12-17이 됩니다. 이 경우 오프셋 0, 5, 10은 실질적으로 아무 효과가 없습니다. 보통 자동이 아닌 명시적 버킷 크기와 함께 사용합니다. 효과를 보려면 오프셋이 0보다 크고 버킷 크기보다 작아야 하며, 범위 밖 값도 범위 안 값과 같은 효과입니다.

Gradient mode

None — 그라디언트 채움 없음 (기본)
Opacity — y축 값을 기반으로 그라디언트 투명도 계산
Hue — 선 색의 색조를 기반으로 그라디언트 색 생성
Scheme — 선택한 색 팔레트를 히스토그램 막대에 적용

채움 불투명도 설정이 그라디언트 표시에 영향을 줍니다. 색을 바꾸려면 표준 color scheme 필드 옵션을 사용하세요.

옵션	설명
Tooltip mode	커서를 올릴 때 툴팁 동작.
Values sort order	툴팁 값의 나열 순서 제어.
Max width	툴팁 박스 최대 너비.
Max height	툴팁 박스 최대 높이. 기본 600픽셀.

Tooltip mode

Single — 호버한 단일 시리즈만 표시
All — 모든 시리즈 표시, 호버 중인 시리즈를 굵게 강조
Hidden — 툴팁 미표시

Values sort order

Tooltip mode가 All일 때 표시. None - 자동 정렬, Ascending - 작은 값부터, Descending - 큰 값부터.

범례 옵션 (Legend options)

범례 옵션은 그래프 아래·오른쪽에 나타나는 시리즈 이름과 통계를 제어합니다.

옵션	설명
Visibility	범례 켜기/끄기.
Mode	List - 목록으로 표시(기본). Table - 테이블로 표시.
Placement	Bottom - 아래, Right - 오른쪽.
Width	오른쪽 배치 시 너비 제어. 기본 픽셀 또는 CSS width 속성. 오른쪽 배치일 때만 표시.
Limit	기본 표시 시리즈 수 제한. 나머지는 Show all 링크로 확장.
Values	범례에 표시할 표준 계산 선택. 여러 개 가능.
Overflow	긴 시리즈 이름 처리. Ellipsis - 끝에 "…"로 자름. Wrap - 여러 줄로 줄바꿈. 오른쪽 배치 + Table 모드일 때만 표시.

자세한 내용은 Configure a legend를 참고하세요.

표준 옵션 (Standard options)

패널 편집기의 Standard options로 필드 데이터 표시 방식을 변경합니다. 설정 시 모든 필드·시리즈에 적용됩니다. 자세한 내용은 Configure standard options를 참고하세요.

옵션	설명
Unit	필드 단위.
Min/Max	백분율 임계값 계산의 최소·최대 또는 자동 계산.
Field min/max	각 필드의 min·max 개별 계산.
Decimals	렌더링 값의 소수 자릿수.
Display name	모든 필드의 표시 제목. 변수 사용 가능.
Color scheme	전체 시각화 색상.
No value	값이 비었거나 null일 때 표시. 기본 하이픈(-).

데이터 링크와 액션

데이터 링크로 소스 패널 컨텍스트를 유지하며 다른 패널·대시보드·외부 리소스로 연결합니다. 각 링크에 Title, URL, Open in new tab 설정. 자세한 내용은 Configure data links and actions를 참고하세요.

참고: 이 시각화는 Actions를 지원하지 않습니다.

값 매핑 (Value mappings)

값 매핑으로 데이터 표시 방식을 변경합니다. Condition(Value, Range, Regex, Special), Display text, Color(선택), Icon(Canvas 전용) 설정. 자세한 내용은 Configure value mappings를 참고하세요.

임계값 (Thresholds)

임계값은 충족·초과 시 시각적으로 반영되는 메트릭 값·한계입니다. 각 임계값에 Value와 Thresholds mode(Absolute·Percentage) 설정. 자세한 내용은 Configure thresholds를 참고하세요.

필드 오버라이드 (Field overrides)

오버라이드로 특정 필드·시리즈 설정을 커스터마이즈합니다. 옵션: Fields with name, Field with name matching regex, Fields with type, Fields returned by query, Fields with values. 자세한 내용은 Configure field overrides를 참고하세요.