게이지
게이지 (Gauge)
게이지는 정의되거나 계산된 최소·최대 범위 내에서 값이 어디에 위치하는지를 빠르게 보여주는 단일 값 시각화예요. 반복 옵션으로 각각 다른 시리즈·열·행에 대응하는 여러 게이지를 표시할 수 있어요. SLO, 장비 충전 정도, 네트워크 지연, CPU 소비(0-100%), RAM 가용량 등을 추적할 때 유용합니다.
출처: 문서
본문
게이지는 값이 정의되거나 계산된 최소·최대 범위 내 어디에 있는지를 빠르게 보여주는 단일 값 시각화입니다.
추적이 필요할 때 사용할 수 있습니다.
- 서비스 수준 목표(SLOs)
- 장비가 얼마나 찼는지
- 제한 범위 내에서 차량이 얼마나 빠른지
- 네트워크 지연
- 설정점과 알람 임계값이 있는 장비 상태
- CPU 소비 (0-100%)
- RAM 가용량
지원 데이터 형식
게이지 시각화를 만들려면 최소한 하나의 숫자 필드를 포함한 데이터셋이 필요합니다. 값은 필드 이름으로 식별됩니다. 추가 텍스트 필드는 필수는 아니지만 식별·라벨링에 사용할 수 있습니다.
예시 - 한 행, 여러 값
게이지 시각화는 데이터셋의 여러 필드를 지원합니다.
| value1 | value2 | value3 |
|---|---|---|
| 5 | 3 | 10 |
데이터셋에 여러 값이 있으면 시각화는 여러 게이지를 표시하고 최소·최대를 자동 정의합니다(이 경우 3과 10).
예시 - 여러 행과 값
| Identifier | value1 | value2 | value3 |
|---|---|---|---|
| A | 5 | 3 | 10 |
| B | 6 | 9 | 15 |
| C | 1 | 4 | 8 |
기본적으로 시각화는 열·시리즈당 단일 값을 계산하고 마지막 행만 표시합니다. 하지만 최소·최대는 전체 데이터셋에서 도출합니다. 이 예시에서는 행 C만 게이지에 표시되고 최소·최대는 1과 15입니다.
테이블 셀마다 게이지 하나를 보여주려면 Value options에서 Show 설정을 Calculate에서 All values로 변경합니다. 각 게이지 라벨은 텍스트 열과 각 값의 열 이름의 연결입니다.
예시 - 최소·최대 제어
데이터셋에서 직접 정의해 최소·최대를 제어할 수 있습니다.
| value | max | min |
|---|---|---|
| 5 | 10 | 2 |
min·max 필드를 숨기려면 Value options > Fields에서 "value" 필드를 선택합니다. 최소·최대가 표시되지 않아도 시각화는 여전히 그 범위를 사용합니다.
구성 옵션
패널 옵션 (Panel options)
패널 편집기 창의 Panel options 섹션에서 패널 제목, 설명, 패널 링크 등 기본 옵션을 설정합니다.
값 옵션 (Value options)
| 옵션 | 설명 |
|---|---|
| Show | Grafana가 데이터를 표시하는 방식 설정. Calculate - 모든 행 기반 계산 값 표시. All values - 행마다 별도 값 표시. 이 옵션 선택 시 표시할 행 수를 제한할 수 있음. |
| Calculation | Show로 Calculate를 선택했다면 여러 필드를 단일 값으로 축소할 reducer 함수 선택. Calculation types 참고. |
| Limit | Show로 All values를 선택했다면 표시할 최대 행 수 입력. 기본 25, 최대 5,000. |
| Fields | 패널에 표시할 필드 선택. |
게이지 옵션 (Gauge options)
| 옵션 | 설명 |
|---|---|
| Style | 게이지 모양 선택. Circle - 12시 방향에서 시작해 시계 방향으로 채움. Arc - 호를 따라 왼쪽에서 오른쪽으로 채움. |
| Orientation | 쌓는 방향 선택. Auto - 행·열로 표시. Horizontal - 위에서 아래로. Vertical - 왼쪽에서 오른쪽으로. |
| Gauge size | 게이지 크기 모드. Auto - Grafana가 최적 크기 결정. Manual - 수동 구성. Orientation이 Horizontal·Vertical일 때만 적용. |
| Min width | 세로 게이지의 최소 너비. 최소 너비를 설정하면 데이터가 많을 때 x축 스크롤바가 자동 표시. Vertical + Manual 크기일 때만 적용. |
| Min height | 가로 게이지의 최소 높이. Horizontal + Manual 크기일 때만 적용. |
| Bar width factor | 총 게이지 영역 대비 게이지 바 너비를 0.1~1 사이 값으로 제어. |
| Segments | 게이지를 1~100 사이 값으로 동일한 세그먼트로 분할. 세그먼트는 게이지 값이 세그먼트 안에 있어도 항상 완전히 채워짐. |
| Bar style | 게이지 바 모양. Flat 또는 Rounded. Segments가 1일 때만 적용. 모든 세그먼트 게이지는 flat. |
| Segment spacing | 각 세그먼트 사이 간격 크기를 제어하는 0~1 사이 값. Segments가 1보다 클 때만 적용. |
| Text mode | 게이지에 렌더링할 텍스트. Auto, Value and name, Value, Name, None. |
| Neutral value | 모든 게이지가 채워지기 시작하는 시작 값 설정. |
| Show sparkline | 켜면 게이지 시리즈 데이터를 포함한 스파크라인 렌더링. 기본 켬. |
| Show thresholds | 내부 게이지 값 밴드 바깥에 임계값 밴드 표시 여부 제어. |
| Show labels | 게이지 바깥에 임계값·중립 라벨 표시 여부 제어. |
| Endpoint marker | 현재 값 엔드포인트 표시 방식. Point, Glow, None. Glow는 다크 모드에서만 사용 가능. Bar style이 Rounded일 때만 적용. |
| Effects | 기타 스타일링. Gradient - 값에 따라 색이 다른 컬러 스킴에서 그라디언트로 색 전환 표현. 기본 켬. Bar glow - 게이지 바 바깥에 빛나는 그림자 추가. Center glow - 현재 게이지 값 색이 게이지 중앙에 표시. |
Neutral value
기본적으로 게이지의 시작 값은 0이 아니라 최소값입니다. 시작 값을 최소값으로 하고 싶지 않을 때 변경할 수 있습니다. 데이터 값 범위가 음수를 포함하는 경우 특히 유용합니다. 비워두면 구성된 최소값을 사용합니다. 예: 배터리 저장을 표시하고 전력 범위가 -2.5kW(방전)~2.5kW일 때, 중립 값을 0으로 입력하면 해석하기 쉽습니다.
Show sparkline
값 목록을 계산된 게이지 값과 함께 시계열로 시각화하려면 Show sparkline 스위치를 켭니다. 각 게이지는 원·호 안에 스파크라인을 표시합니다.
Show thresholds
내부 게이지 값 밴드 바깥에 임계값 밴드를 표시할지 제어합니다.
텍스트 크기 옵션 (Text size options)
- Title — 게이지 제목 크기 숫자값 입력
- Value — 게이지 값 크기 숫자값 입력
표준 옵션 (Standard options)
패널 편집기의 Standard options로 필드 데이터 표시 방식을 변경합니다. 설정 시 모든 필드·시리즈에 적용됩니다. 더 세밀한 제어는 Configure overrides를 참고하세요.
| 옵션 | 설명 |
|---|---|
| Unit | 필드가 사용할 단위 선택. |
| Min/Max | 백분율 임계값 계산에 사용할 최소·최대 설정 또는 자동 계산. |
| Field min/max | 각 필드의 min·max를 개별 계산하려면 활성화. |
| Decimals | 렌더링 값에 포함할 소수 자릿수 지정. |
| Display name | 모든 필드의 표시 제목 설정. 필드 제목에 변수 사용 가능. |
| Color scheme | 전체 시각화의 단일·다중 색상 설정. |
| No value | 필드 값이 비어있거나 null일 때 표시할 값. 기본은 하이픈(-). |
자세한 내용은 Configure standard options를 참고하세요.
데이터 링크와 액션
데이터 링크로 소스 패널의 컨텍스트를 유지하면서 다른 패널·대시보드·외부 리소스로 연결할 수 있습니다. 시리즈 이름이나 커서 아래 값을 포함한 링크를 만들 수 있습니다. 자세한 내용은 Configure data links and actions를 참고하세요.
참고: 이 시각화는 Actions를 지원하지 않습니다.
각 데이터 링크는 Title, URL, Open in new tab을 설정합니다. 이 시각화의 데이터 링크는 One click 스위치가 없지만, 데이터 링크가 하나뿐이면 단일 클릭 기능이 있습니다. 여러 개면 클릭 시 모든 링크를 표시하는 메뉴가 열립니다.
값 매핑 (Value mappings)
값 매핑은 데이터가 시각화에 표시되는 방식을 변경하는 기법입니다. 각 값 매핑에 Condition(Value, Range, Regex, Special - Null·NaN·boolean 등), 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를 참고하세요.