기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
대시보드 JSON 모델
이 설명서 항목은 Grafana 버전 10.x를 지원하는 Grafana 작업 영역을 위해 설계되었습니다.
Grafana 버전 9.x를 지원하는 Grafana 작업 영역에 대한 내용은 을 참조하십시오. Grafana 버전 9에서 작업하기
Grafana 버전 8.x를 지원하는 Grafana 작업 영역에 대한 내용은 을 참조하십시오. Grafana 버전 8에서 작업하기
Grafana의 대시보드는 대시보드의 메타데이터를 저장하는 JSON 개체로 표시됩니다. 대시보드 메타데이터에는 대시보드 속성, 패널의 메타데이터, 템플릿 변수 및 패널 쿼리가 포함됩니다.
대시보드의 JSON을 보려면
-
대시보드로 이동합니다.
-
상단 탐색 메뉴에서 대시보드 설정 (기어) 아이콘을 선택합니다.
-
JSON 모델을 선택합니다.
JSON 필드
사용자가 새 대시보드를 만들면 다음 필드를 사용하여 새 대시보드 JSON 개체가 초기화됩니다.
참고
다음 JSON에서 id는 null로 표시되며, 이는 대시보드가 저장될 때까지 할당되는 기본값입니다. 대시보드를 저장한 후 필드에 정수 값이 할당됩니다. id
{ "id": null, "uid": "cLV5GDCkz", "title": "New dashboard", "tags": [], "timezone": "browser", "editable": true, "graphTooltip": 1, "panels": [], "time": { "from": "now-6h", "to": "now" }, "timepicker": { "time_options": [], "refresh_intervals": [] }, "templating": { "list": [] }, "annotations": { "list": [] }, "refresh": "5s", "schemaVersion": 17, "version": 0, "links": [] }
다음은 대시보드 JSON의 각 필드에 대한 설명입니다.
명칭 | 사용량 |
---|---|
|
대시보드의 고유한 숫자 식별자 (db에서 생성) |
|
누구나 생성할 수 있는 고유한 대시보드 식별자입니다. 문자열 (8-40) |
|
대시보드의 현재 제목 |
|
대시보드와 관련된 태그, 문자열 배열 |
|
대시보드 테마 (예: |
|
대시보드 시간대 (예 |
|
대시보드 편집 가능 여부 |
|
0 - 공유 십자선 또는 툴팁이 없는 경우 (기본값), 1은 공유 십자선, 2는 공유 십자선 및 공유 툴팁입니다. |
|
대시보드 시간 범위 (예: 또는 |
|
타임피커 메타데이터, 자세한 내용은 타임피커 섹션을 참조하십시오. |
|
|
|
주석 메타데이터, 추가 방법은 주석을 참조하십시오. |
|
자동 새로 고침 간격 |
|
Grafana 업데이트가 이 스키마를 변경할 때마다 증가하는 JSON 스키마 버전 (정수) |
|
대시보드 버전 (정수), 대시보드가 업데이트될 때마다 증가됨 |
|
패널 배열 (자세한 내용은 다음 섹션 참조) |
패널
패널은 대시보드의 구성 요소입니다. 데이터 소스 쿼리, 그래프 유형, 별칭 등으로 구성됩니다. 패널 JSON은 각각 다른 패널을 나타내는 JSON 객체 배열로 구성됩니다. 대부분의 필드는 모든 패널에 공통이지만 일부 필드는 패널 유형에 따라 달라집니다. 다음은 텍스트 패널의 패널 JSON 예제입니다.
"panels": [ { "type": "text", "title": "Panel Title", "gridPos": { "x": 0, "y": 0, "w": 12, "h": 9 }, "id": 4, "mode": "markdown", "content": "# title" }
패널 크기 및 위치
GridPos 속성은 패널 크기 및 위치를 그리드 좌표로 설명합니다.
-
w
— 1~24 (대시보드 너비는 24개의 열로 구분됨) -
h
— 그리드 높이 단위로 각 단위는 30픽셀을 나타냅니다. -
x
— x 위치 (단위: 와 동일w
) -
y
— 와 같은 단위에서의 y 위치h
.
그리드는 음의 중력을 가지므로 패널 위에 빈 공간이 있으면 패널 위로 이동합니다.
타임피커
"timepicker": { "collapse": false, "enable": true, "notice": false, "now": true, "refresh_intervals": [ "5s", "10s", "30s", "1m", "5m", "15m", "30m", "1h", "2h", "1d" ], "status": "Stable", "type": "timepicker" }
템플릿링
이 templating
필드에는 저장된 값이 포함된 템플릿 변수 배열과 기타 메타데이터가 포함되어 있습니다.
"templating": { "enable": true, "list": [ { "allFormat": "wildcard", "current": { "tags": [], "text": "prod", "value": "prod" }, "datasource": null, "includeAll": true, "name": "env", "options": [ { "selected": false, "text": "All", "value": "*" }, { "selected": false, "text": "stage", "value": "stage" }, { "selected": false, "text": "test", "value": "test" } ], "query": "tag_values(cpu.utilization.average,env)", "refresh": false, "type": "query" }, { "allFormat": "wildcard", "current": { "text": "apache", "value": "apache" }, "datasource": null, "includeAll": false, "multi": false, "multiFormat": "glob", "name": "app", "options": [ { "selected": true, "text": "tomcat", "value": "tomcat" }, { "selected": false, "text": "cassandra", "value": "cassandra" } ], "query": "tag_values(cpu.utilization.average,app)", "refresh": false, "regex": "", "type": "query" } ] }
다음 표에서는 템플릿 필드의 사용법을 설명합니다.
명칭 | 사용량 |
---|---|
|
템플릿 사용 가능 여부 |
|
각각 하나의 템플릿 변수를 나타내는 객체 배열 |
|
, |
|
현재 선택한 변수 텍스트/값을 대시보드에 표시합니다. |
|
변수의 데이터 소스를 보여줍니다. |
|
모든 값 옵션을 사용할 수 있는지 여부 |
|
변수 값 목록에서 여러 값을 선택할 수 있는지 여부 |
|
데이터 소스에서 시계열을 가져올 때 사용할 형식 |
|
변수 이름 |
|
대시보드에서 선택 가능한 가변 텍스트/값 쌍의 배열 |
|
변수 값을 가져오는 데 사용되는 데이터 소스 쿼리 |
|
변수를 새로 고칠 시기를 구성합니다. |
|
시리즈 이름 또는 메트릭 노드 세그먼트의 일부를 추출합니다. |
|
변수 유형, |