Stat
Stat
Stat 시각화는 관심 있는 단일 값(예: 시리즈의 최신값, 현재값)으로 데이터를 표시하며, 선택적으로 그래프 스파크라인을 포함할 수 있어요. 스파크라인은 stat 시각화에서만 제공되는 기능으로, 각 값의 배경에 표시되는 작은 시계열 그래프예요. 예를 들어 다양한 서비스의 최신 사용률을 한눈에 보여줄 때 유용합니다.
참고: 이 시각화는 Grafana 7.0에서 deprecated되고 8.0에서 제거된 Singlestat 시각화를 대체합니다.
출처: 문서
본문
Stat 시각화는 단일 관심 값(시리즈의 최신값·현재값 등)으로 데이터를 표시하며, 선택적으로 그래프 스파크라인을 포함합니다. 스파크라인은 stat 시각화에서만 제공되며 각 값의 배경에 표시되는 작은 시계열 그래프입니다.
다음 경우에 사용합니다.
- 애플리케이션의 최신 상태, 높은 우선순위 버그 수, 총 판매 수 같은 핵심 메트릭을 한눈에 모니터링
- 서비스 평균 응답 시간 같은 집계 데이터 표시
- 정상 임계값 위의 값을 강조해 메트릭이 예상 범위를 벗어나는지 빠르게 식별
지원 데이터 형식
Stat 시각화는 다양한 데이터 표시 형식을 지원합니다.
- 단일 값 (Single values) - 가장 일반적. 숫자, 문자열, 부울 값 가능.
- 시계열 데이터 (Time-series data) - 시계열 데이터에 계산 유형을 적용해 지정된 시간 범위 내 단일 값을 표시.
예시
단일 숫자 값:
| Number of high priority bugs |
|---|
| 80 |
| 52 |
| 59 |
| 40 |
데이터는 마지막 값이 표시되고 스파크라인과 백분율 변화와 함께 시각화됩니다.
시계열 데이터:
| Time | Cellar | Living room | Porch | Bedroom | Guest room | Kitchen |
|---|---|---|---|---|---|---|
| 2024-03-20 06:34:40 | 12.3 | 18.3 | 18.8 | 15.9 | 9.29 | 9.61 |
| 2024-03-20 06:41:40 | 16.8 | 17.1 | 21.5 | 14.1 | 10.5 | 17.5 |
| 2024-03-20 06:48:40 | 16.7 | ... | ... | ... | ... | ... |
구성 옵션
패널 옵션 (Panel options)
패널 편집기 창의 Panel options 섹션에서 패널 제목, 설명, 패널 링크 등 기본 옵션을 설정합니다.
값 옵션 (Value options)
| 옵션 | 설명 |
|---|---|
| Show | Calculate - 모든 행을 기반으로 계산된 값 표시. All values - 행마다 별도 값 표시. |
| Calculation | Show로 Calculate를 선택했다면 여러 필드를 단일 값으로 축소할 reducer 함수 선택. Calculation types 참고. |
| Limit | All values 선택 시 표시할 최대 행 수 입력. 기본 25, 최대 5,000. |
| Fields | 패널에 표시할 필드 선택. |
Stat 스타일 (Stat styles)
| 옵션 | 설명 |
|---|---|
| Orientation | 값 배치 방향. Auto, Horizontal, Vertical. |
| Text mode | Auto, Value and name, Value, Name. |
| Color mode | 값 색상 지정 방식. Value - 값 기반 색, Background - 배경으로 단색 표시. |
| Graph mode | 스파크라인 모드. None, Area, Line. |
| Justify mode | 값 배치 위치. Auto, Center, Left, Right. |
| Alignment mode | 값 정렬. Auto, Center, Left, Right. |
텍스트 크기 옵션 (Text size options)
- Title — 값 제목 크기
- Value — 값 크기
표준 옵션 (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를 참고하세요.