그룹 위젯
그룹 위젯 (Group Widget)
그룹 위젯은 대시보드에서 유사한 그래프를 함께 모아 둘 수 있게 해 주는 위젯이에요. 각 그룹은 사용자 지정 헤더를 가지며, 하나에서 여러 개의 그래프를 담을 수 있고 접고 펼칠 수 있어요. 그룹을 사용하면 대시보드의 위젯을 정리할 수 있습니다.
참고: screenboard 위젯은 그룹 안에 배치할 수 없어요.
출처: 문서
본문
개요
그룹 위젯은 대시보드에서 유사한 그래프를 함께 모아 두어 정리할 수 있게 해 줍니다. 각 그룹은 사용자 지정 헤더를 가지며, 하나에서 여러 개의 그래프를 담을 수 있고 접고 펼칠 수 있어요.
참고: screenboard 위젯은 그룹 안에 배치할 수 없어요.
설정
- 대시보드에 여러 위젯을 추가해요.
- 클릭 앤 드래그 기능으로 여러 위젯을 선택하거나, Shift를 누른 채 클릭해요.
- Group 옵션을 클릭해요.
- 그룹의 오른쪽 위 모서리에 있는 연필 아이콘을 클릭해 이름을 선택하고 그룹에 스타일을 적용해요.
API
이 위젯은 **Dashboards API**와 함께 사용할 수 있어요. widget JSON 스키마 정의는 다음 표를 참조해요:
참고: screenboard 위젯은 그룹 안에 배치할 수 없어요.
| 필드 | 타입 | 설명 |
|---|---|---|
background_color |
string | 위젯의 배경색. 지원되는 값은 white, blue, purple, pink, orange, yellow, green, gray, vivid_blue, vivid_purple, vivid_pink, vivid_orange, vivid_yellow, vivid_green, transparent예요. |
banner_img |
string | 그룹의 배너로 표시할 이미지의 URL. |
layout_type [필수] |
enum | 그룹의 레이아웃 유형. 허용되는 enum 값: ordered |
show_title |
boolean | 제목을 표시할지 여부. 기본값: true |
title |
string | 위젯의 제목. |
title_align |
enum | 위젯에서 텍스트를 정렬하는 방법. 허용되는 enum 값: center,left,right |
type [필수] |
enum | 그룹 위젯의 유형. 허용되는 enum 값: group, 기본값: group |
widgets [필수] |
object[] | 위젯 그룹의 목록. 각 위젯은 위젯 정의를 따르며, alert_graph, alert_value, bar_chart 등 모든 위젯 유형을 포함할 수 있어요. |
widgets 배열의 각 항목은 개별 위젯의 전체 스키마(자체 type, 필드, 쿼리, 시간 설정 등)를 가져요. 그룹 위젯은 본질적으로 다른 위젯들의 컨테이너이며, 각 위젯은 위에서 설명한 것과 동일한 JSON 스키마 구조를 따릅니다.
JSON 예시:
{
"background_color": "white",
"banner_img": "",
"layout_type": "ordered",
"show_title": true,
"title": "My Group",
"title_align": "center",
"type": "group",
"widgets": [
{
"definition": {
"title": "CPU Usage",
"type": "timeseries"
}
}
]
}