기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# 대시보드
<a name="dashboard-overview"></a>

****  
이 설명서 주제는 **Grafana 버전 8.x**를 지원하는 Grafana 워크스페이스를 위해 설계되었습니다.  
Grafana 버전 10.x를 지원하는 Grafana 워크스페이스의 경우 [Grafana 버전 10에서 작업](using-grafana-v10.md) 섹션을 참조하세요.  
Grafana 버전 9.x를 지원하는 Grafana 워크스페이스는 [Grafana 버전 9에서 작업](using-grafana-v9.md) 섹션을 참조하세요.

 *대시보드*는 하나 이상의 행으로 구성되고 배열된 하나 이상의 패널 세트입니다. Amazon Managed Grafana는 다양한 패널을 함께 제공합니다. Amazon Managed Grafana를 사용하면 필요한 대시보드를 생성할 수 있도록 올바른 쿼리를 쉽게 구성하고 표시 속성을 사용자 지정할 수 있습니다. 각 패널은 구성된 모든 데이터 소스의 데이터와 상호 작용할 수 있습니다.

## 대시보드 관리
<a name="manage-dashboards"></a>

 대시보드의 기간을 제어하려면 대시보드 오른쪽 상단에 있는 [시간 범위 제어](dashboard-time-range-controls.md)를 사용할 수 있습니다.

 대시보드는 템플릿과 변수를 사용하여 동적 및 대화형 기능을 강화할 수 있습니다. 자세한 내용은 [템플릿 및 변수](templates-and-variables.md) 단원을 참조하십시오.

 대시보드는 [Annotations](dashboard-annotations.md)을 사용하여 여러 패널에서 이벤트 데이터를 표시할 수 있습니다. 이렇게 하면 패널의 시계열 데이터를 다른 이벤트와 상관시키는 데 도움이 될 수 있습니다.

 대시보드는 다양한 방법으로 쉽게 공유할 수 있습니다. 자세한 내용은 [대시보드 공유](share-a-dashboard.md) 단원을 참조하십시오.

 대시보드에 태그를 지정할 수 있습니다. 이를 통해 대시보드 선택기는 특정 조직의 모든 대시보드에 대한 빠르고 검색 가능한 액세스를 제공합니다.

## 행
<a name="dashboard-rows"></a>

 *행*은 대시보드 내 논리적 구분 도구입니다. 패널을 그룹화하는 데 사용됩니다.

 행의 너비는 항상 12*단위*입니다. 이러한 단위는 브라우저의 가로 해상도에 따라 자동으로 조정됩니다. 특정 너비를 설정하여 행 내 패널의 상대 너비를 제어할 수 있습니다.

 Amazon Managed Grafana는 단위 추상화를 사용하여 모든 화면 크기에서 모양을 최적화합니다.

**참고**  
 Amazon Managed Grafana는 MaxDataPoint 기능을 사용하여 해상도 또는 시간 범위에 관계없이 필요한 데이터 포인트 수를 표시할 수 있습니다.

 행을 축소하려면 행 제목을 선택합니다. 행이 축소된 상태로 대시보드를 저장하면 대시보드가 해당 상태로 저장되며 행을 확장할 때까지 해당 그래프가 로드되지 않습니다.

 반복 행 기능을 사용하여 선택한 템플릿 변수에 따라 패널의 전체 행을 동적으로 생성하거나 제거합니다.

# Annotations
<a name="dashboard-annotations"></a>

****  
이 설명서 주제는 **Grafana 버전 8.x**를 지원하는 Grafana 워크스페이스를 위해 설계되었습니다.  
Grafana 버전 10.x를 지원하는 Grafana 워크스페이스의 경우 [Grafana 버전 10에서 작업](using-grafana-v10.md) 섹션을 참조하세요.  
Grafana 버전 9.x를 지원하는 Grafana 워크스페이스는 [Grafana 버전 9에서 작업](using-grafana-v9.md) 섹션을 참조하세요.

 주석은 그래프에서 리치 이벤트로 점을 표시하는 방법을 제공합니다. 주석에서 일시 중지하면 이벤트 설명 및 이벤트 태그를 볼 수 있습니다. 텍스트 필드에는 자세한 정보를 제공하기 위해 다른 시스템에 대한 링크가 포함될 수 있습니다.

## 기본 주석
<a name="native-annotations"></a>

 Amazon Managed Grafana에는 기본 주석 저장소와 그래프 패널에서 직접 주석 이벤트를 추가할 수 있는 기능이 함께 제공됩니다.

## 주석 추가
<a name="adding-annotations"></a>

 주석을 추가하려면 **Ctrl** 또는 **Cmd**를 누르고 주석을 추가할 위치를 선택합니다. 주석을 다른 대시보드에서 검색할 수 있도록 하려면 이에 태그를 추가합니다.

### 리전 주석 추가
<a name="adding-regions-events"></a>

 리전에 대한 주석을 생성하려면 **Ctrl** 또는 **Cmd**를 누른 상태로 리전을 선택합니다.

### 기본 제공 쿼리
<a name="annotation-built-in-query"></a>

 주석을 추가한 후에도 계속 표시됩니다. 이는 모든 대시보드에 기본 제공 주석 쿼리가 존재하기 때문입니다. 이 주석 쿼리는 현재 대시보드에서 시작된 모든 주석 이벤트를 가져와서 생성된 패널에 표시합니다. 여기에는 알림 상태 기록 주석이 포함됩니다. **대시보드 설정**(톱니) 아이콘을 선택하고 **주석**을 선택한 다음, `Annotations & Alerts (Built-in)` 쿼리를 수정하여 주석을 가져오고 표시하는 작업을 중지할 수 있습니다.

 **다른 이름으로 저장** 기능을 사용하여 대시보드를 복사하는 경우 새 대시보드에 새 대시보드 ID가 있으므로 소스 대시보드에서 생성된 주석은 사본에 표시되지 않습니다. 소스 대시보드 주석에 필터링할 태그가 있는 경우 새로운 **주석 쿼리**를 추가하고 태그를 기준으로 필터링하여 사본에 주석을 표시할 수 있습니다.

### 태그별 쿼리
<a name="annotation-query-by-tag"></a>

 `-- Grafana --` 데이터 소스를 사용하고 **필터링 기준**을 **태그**로 설정하여 기본 주석 스토어에서 주석을 가져오는 새 주석 쿼리를 생성할 수 있습니다. 하나 이상의 태그를 지정합니다. 예를 들어 `outages`라는 주석 쿼리를 생성하고 `outage`라는 태그를 지정합니다. 이 쿼리는 `outage` 태그가 있는 (모든 대시보드 또는 API를 통해) 생성한 모든 주석을 표시합니다.

기본적으로 주석 쿼리에 여러 태그를 추가하는 경우 Amazon Managed Grafana는 사용자가 제공한 모든 태그가 있는 주석만 표시합니다. 제공한 태그 중 하나 이상이 포함된 주석을 표시하려면 **임의 일치**를 켭니다.

 Amazon Managed Grafana에서는 태그 쿼리에 템플릿 변수를 사용할 수 있습니다. 예를 들어 다양한 서비스에 대한 통계를 보여주는 대시보드와 표시할 서비스를 제어하는 템플릿 변수가 있는 경우 주석 쿼리에서 동일한 템플릿 변수를 사용하여 해당 서비스에 대한 주석만 표시할 수 있습니다.

## 기타 데이터 소스 쿼리
<a name="querying-other-data-sources"></a>

 주석 이벤트는 주석 쿼리를 사용하여 가져옵니다. 대시보드에 새 주석 쿼리를 추가하려면 **대시보드 설정**(톱니) 아이콘을 선택하고 `Annotations`를 선택한 다음, **새로 만들기**를 선택합니다.

 주석 쿼리의 이름을 지정합니다. 이 이름은 이 쿼리에 대한 주석 이벤트를 표시하거나 숨기기 위한 확인란에 표시됩니다. 예를 들어 `Deploys` 및 `Outages`라는 두 개의 주석 쿼리가 있을 수 있습니다. 확인란을 선택하거나 선택 취소하여 표시할 주석을 지정할 수 있습니다.

### 주석 쿼리 세부 정보
<a name="annotation-query-details"></a>

 주석 쿼리 옵션은 데이터 소스마다 다릅니다.
+ [Graphite 쿼리 편집기를 사용하는 주석](https://docs.aws.amazon.com/en_us/grafana/latest/userguide/using-graphite-in-AMG.html#graphite-annotations)
+ [OpenSearch 데이터 소스를 사용하는 주석](https://docs.aws.amazon.com/en_us/grafana/latest/userguide/ES-use-datasource.html#ES-annotations)
+ [Prometheus를 사용하는 주석](https://docs.aws.amazon.com/en_us/grafana/latest/userguide/using-prometheus-datasource.html#p-annotations)
+ [MySQL을 사용하는 주석](https://docs.aws.amazon.com/en_us/grafana/latest/userguide/using-mysql-in-AMG.html#mysql-annotations)
+ [PostgreSQL을 사용하는 주석](https://docs.aws.amazon.com/en_us/grafana/latest/userguide/using-postgresql-in-AMG.html#postgresql-annotations)

# 대시보드 폴더
<a name="dashboard-folders"></a>

****  
이 설명서 주제는 **Grafana 버전 8.x**를 지원하는 Grafana 워크스페이스를 위해 설계되었습니다.  
Grafana 버전 10.x를 지원하는 Grafana 워크스페이스의 경우 [Grafana 버전 10에서 작업](using-grafana-v10.md) 섹션을 참조하세요.  
Grafana 버전 9.x를 지원하는 Grafana 워크스페이스는 [Grafana 버전 9에서 작업](using-grafana-v9.md) 섹션을 참조하세요.

 폴더는 대시보드를 구성 및 그룹화하는 방법입니다. 대시보드가 많거나 여러 팀이 동일한 Grafana 워크스페이스를 사용하는 경우 유용합니다.

## 폴더 생성
<a name="how-to-create-a-folder"></a>

폴더를 생성하려면 다음 중 하나를 수행하세요.
+  사이드 메뉴의 \$1 아이콘에서 **폴더 생성** 링크를 선택하세요.
+  **대시보드 관리** 페이지에서 **폴더 생성** 버튼을 선택하세요.

 **폴더 생성** 페이지에서 폴더의 고유한 이름을 입력한 다음, **생성**을 선택하세요.

대시보드를 저장할 때 기존 폴더를 선택하거나 새 폴더를 생성할 수 있습니다.

## 대시보드 관리
<a name="folders-manage-dashboards"></a>

 **대시보드 관리** 페이지에서 다양한 태스크를 수행할 수 있습니다.
+  폴더를 만듭니다.
+  대시보드를 생성합니다.
+  대시보드를 폴더로 이동합니다.
+  여러 대시보드를 삭제합니다.
+  폴더 페이지로 이동합니다(여기서 폴더 또는 해당 대시보드에 대한 권한을 설정할 수 있음).

## 대시보드 폴더 페이지
<a name="dashboard-folder-page"></a>

 대시보드 폴더 페이지를 열려는 경우 검색 결과 또는 대시보드 관리 페이지에서 대시보드 목록의 폴더에서 일시 중지할 때 나타나는 톱니 아이콘을 선택하세요.

 대시보드 폴더 페이지는 대시보드 관리 페이지와 유사합니다. 대시보드 폴더 페이지에서 다음 작업을 수행할 수 있습니다.
+  폴더에서 대시보드를 이동하거나 삭제합니다.
+  폴더 이름을 변경합니다(**설정** 탭에서).
+  폴더에 대한 권한을 설정합니다(폴더의 대시보드에서 상속됨).

## 권한
<a name="folder-permissions"></a>

 권한은 폴더에 할당되고 포함된 대시보드에 의해 상속될 수 있습니다. 액세스 제어 목록(ACL)은 **조직 역할**, **팀** 및 개별 **사용자**에게 권한을 할당할 수 있는 경우에 사용됩니다. 자세한 내용은 [대시보드 및 폴더 권한](dashboard-and-folder-permissions.md) 단원을 참조하십시오.

# 재생 목록
<a name="dashboard-playlist"></a>

****  
이 설명서 주제는 **Grafana 버전 8.x**를 지원하는 Grafana 워크스페이스를 위해 설계되었습니다.  
Grafana 버전 10.x를 지원하는 Grafana 워크스페이스의 경우 [Grafana 버전 10에서 작업](using-grafana-v10.md) 섹션을 참조하세요.  
Grafana 버전 9.x를 지원하는 Grafana 워크스페이스는 [Grafana 버전 9에서 작업](using-grafana-v9.md) 섹션을 참조하세요.

 재생 목록은 순서대로 표시되는 대시보드 목록입니다. 재생 목록을 사용하여 상황 인식을 구축하거나 팀 또는 방문자에게 지표를 제시할 수 있습니다.

 Amazon Managed Grafana는 큰 화면을 포함하여 모든 해상도로 대시보드를 자동 조정합니다.

 **대시보드** 하위 메뉴의 사이드 메뉴에서 **재생 목록 **기능에 액세스할 수 있습니다.

## 재생 목록 생성
<a name="create-a-playlist"></a>

 재생 목록에서는 설정된 순서와 대시보드 간 시간 간격을 사용하여 순서대로 대시보드를 표시합니다.

1.  **재생 목록** 기능에 액세스하려면 사이드 메뉴에서 일시 중지하세요.

1.  **재생 목록**을 선택하세요.

1.  **새 재생 목록**을 선택하세요.

1.  **이름** 텍스트 상자에 재생 목록의 이름을 입력합니다.

1.  **간격** 텍스트 상자에 시간 간격을 입력합니다.

   시간 간격은 Amazon Managed Grafana가 재생 목록의 다음 대시보드로 진행하기 전에 특정 대시보드에 머무르는 시간입니다.

1.  재생 목록에 추가하려는 각 대시보드 옆에 있는 **재생 목록에 추가**를 선택하세요.

1.  **생성(Create)**을 선택합니다.

## 재생 목록 편집
<a name="edit-a-playlist"></a>

 재생 목록을 생성하는 동안 또는 저장한 후 재생 목록을 편집할 수 있습니다.

1.  재생 목록 기능에 액세스하려면 사이드 메뉴에서 일시 중지하세요.

1.  **재생 목록**을 선택하세요.

1.  편집할 재생 목록을 선택하세요.

### 재생 목록 이름 편집
<a name="edit-the-name-of-a-playlist"></a>

1. **이름** 텍스트 상자를 선택하세요.

1.  이름을 편집합니다.

1.  **저장**을 선택하여 변경 사항을 저장합니다.

### 재생 목록의 간격 편집
<a name="edit-the-interval-of-a-playlist"></a>

1.  **간격** 텍스트 상자를 선택하세요.

1.  간격을 편집합니다.

1.  **저장**을 선택하여 변경 사항을 저장합니다.

### 재생 목록에 대시보드 추가
<a name="add-a-dashboard-to-a-playlist"></a>

1.  추가하려는 대시보드 옆에 있는 **재생 목록에 추가**를 선택하세요.

1.  **저장**을 선택하여 변경 사항을 저장합니다.

### 추가할 대시보드 검색
<a name="search-for-a-dashboard-to-add"></a>

1. **대시보드 추가**에서 **이름으로 대시보드 검색** 텍스트 상자를 선택하세요.

1.  이름 또는 정규식을 입력합니다.

1. 필요한 경우 별표 상태 또는 태그를 기준으로 결과를 필터링하세요. 기본적으로 별표가 지정된 대시보드는 재생 목록에 추가할 옵션으로 표시됩니다.

1.  **저장**을 선택하여 변경 사항을 저장합니다.

### 대시보드 순서 재정렬
<a name="rearrange-dashboard-order"></a>

1.  이동하려는 대시보드 옆에 있는 위쪽 또는 아래쪽 화살표를 선택하세요.

1.  **저장**을 선택하여 변경 사항을 저장합니다.

### 대시보드 제거
<a name="remove-a-dashboard"></a>

1.  재생 목록에서 대시보드를 제거하려면 x 아이콘을 선택하세요.

1.  **저장**을 선택하여 변경 사항을 저장합니다.

### 재생 목록 삭제
<a name="delete-a-playlist"></a>

1.  **재생 목록**을 선택하세요.

1.  삭제하려는 재생 목록 옆의 X 아이콘을 선택하세요.

## 재생 목록 저장
<a name="save-a-playlist"></a>

 재생 목록을 저장하여 **재생 목록** 페이지에 추가할 수 있습니다. 여기서 재생 목록을 시작할 수 있습니다. 저장하기 전에 재생 목록에 표시할 모든 대시보드를 추가해야 합니다.

1.  **재생 목록** 기능에 액세스하려면 사이드 메뉴에서 일시 중지하세요.

1.  **재생 목록**을 선택하세요.

1.  재생 목록을 선택하세요.

1.  재생 목록을 편집하세요.

   재생 목록에 **이름**, **간격**, 하나 이상의 **대시보드**가 추가되었는지 확인하세요.

1.  **저장**을 선택합니다.

## 재생 목록 시작
<a name="start-a-playlist"></a>

 재생 목록은 다섯 가지 보기 모드로 시작할 수 있습니다. 모드는 대시보드에 메뉴 및 탐색 표시줄을 표시하는 방법을 결정합니다.

 기본적으로 각 대시보드는 **간격** 필드에 입력된 시간 동안 표시되며, 이 필드는 재생 목록을 생성하거나 편집할 때 설정할 수 있습니다. 재생 목록을 시작한 후에는 화면 상단의 탐색 표시줄을 사용하여 재생 목록을 제어할 수 있습니다.

1.  **대시보드** 메뉴에서 **재생 목록**을 선택하세요.

1.  시작하려는 재생 목록 옆의 **재생 목록 시작**을 선택하세요.

1.  드롭다운 목록에서 다음 표시 모드 중 하나를 선택하세요.
   +  **일반 모드** 
     +  사이드 메뉴는 계속 표시됩니다.
     +  탐색 표시줄, 행 및 패널 제어가 화면 상단에 나타납니다.
   +  **TV 모드** 
     +  사이드 메뉴가 숨겨지거나 제거됩니다.
     +  탐색 표시줄, 행 및 패널 제어가 화면 상단에 나타납니다.
     +  TV 모드는 1분 동안 사용자 활동이 없으면 자동으로 켜집니다.
     +  **d v** 시퀀스 단축키를 사용하거나 `?inactive` 파라미터를 대시보드 URL에 추가하여 TV 모드를 수동으로 켤 수 있습니다.
     +  마우스 이동 또는 키보드 작업으로 TV 모드를 비활성화할 수 있습니다.
   +  **TV 모드(자동 맞춤 패널 지원)** 
     +  사이드 메뉴가 숨겨지거나 제거됩니다.
     +  탐색 표시줄, 행 및 패널 제어가 화면 상단에 나타납니다.
     +  대시보드 패널은 화면의 공간을 최적화하도록 자동으로 조정됩니다.
   +  **키오스크 모드** 
     +  사이드 메뉴, 탐색 표시줄, 행 및 패널 제어가 보기에서 완전히 숨겨지거나 제거됩니다.
     +  재생 목록이 시작된 후 **d v** 시퀀스 단축키를 사용하여 수동으로 키오스크 모드를 켤 수 있습니다.
     +  동일한 바로 가기를 사용하여 키오스크 모드를 수동으로 끌 수 있습니다.
   +  **키오스크 모드(자동 맞춤 패널 지원):** 
     +  사이드 메뉴, 탐색 표시줄, 행 및 패널 제어가 보기에서 완전히 숨겨지거나 제거됩니다.
     +  대시보드 패널은 화면의 공간을 최적화하도록 자동으로 조정됩니다.

## 재생 목록 제어
<a name="control-a-playlist"></a>

 화면 상단의 탐색 표시줄을 사용하여 재생 목록이 시작된 후 **일반** 또는 **TV** 모드에서 재생 목록을 제어할 수 있습니다.


|  Button  |  결과  | 
| --- | --- | 
|  다음(오른쪽 이중 화살표)  |  다음 대시보드로 이동합니다. | 
|  뒤로(왼쪽 화살표)  |  이전 대시보드로 돌아갑니다. | 
|  중지(사각형)  |  재생 목록을 종료하고 현재 대시보드로 나갑니다. | 
|  주기 보기 모드(모니터 아이콘)  |  대시보드의 표시를 다른 보기 모드로 변경합니다. | 
|  시간 범위  | 시간 범위 내 데이터를 표시합니다. 드롭다운 화살표를 사용하여 최근 5분에서 최대 5년 전을 표시하도록 설정할 수 있습니다. | 
|  새로 고침(원형 화살표)  |  대시보드를 다시 로드하여 현재 데이터를 표시합니다. 드롭다운 화살표를 사용하여 5초에서 1일의 간격으로 자동으로 다시 로드하도록 설정할 수 있습니다. | 

 키보드에서 재생 목록을 중지하려면 **Esc**를 누르세요.

## 보기 모드에서 재생 목록 공유
<a name="share-a-playlist-in-a-view-mode"></a>

원하는 보기 모드에서 URL을 복사하고 URL을 대상에 붙여넣어 재생 목록을 공유할 수 있습니다.

1.  **대시보드** 메뉴에서 **재생 목록**을 선택하세요.

1.  공유하려는 재생 목록 옆의 **재생 목록 시작**을 선택한 다음, 원하는 보기 모드를 선택하세요.

1.  URL을 클립보드에 복사하려면 **링크 주소 복사**를 선택하세요.

    예를 들어 키오스크 모드일 때 Grafana 재생 사이트에서 재생 목록의 URL은 `https://play.grafana.org/d/000000010/annotations?orgId=1&kiosk`와 같을 수 있습니다.

1.  대상에 URL을 붙여넣으세요.

# 대시보드 검색
<a name="dashboard-search"></a>

****  
이 설명서 주제는 **Grafana 버전 8.x**를 지원하는 Grafana 워크스페이스를 위해 설계되었습니다.  
Grafana 버전 10.x를 지원하는 Grafana 워크스페이스의 경우 [Grafana 버전 10에서 작업](using-grafana-v10.md) 섹션을 참조하세요.  
Grafana 버전 9.x를 지원하는 Grafana 워크스페이스는 [Grafana 버전 9에서 작업](using-grafana-v9.md) 섹션을 참조하세요.

 대시보드는 대시보드 이름으로 검색하거나, 하나 이상의 태그로 필터링하거나, 별표로 표시된 상태로 필터링할 수 있습니다. 대시보드 검색은 대시보드 상단 탐색 표시줄에서 사용할 수 있는 대시보드 선택기를 통해 액세스할 수 있습니다. 단축키 **F**를 사용하여 대시보드 검색을 열 수도 있습니다.

키보드만 사용하는 경우 키보드 화살표 키를 사용하여 결과를 탐색하고 **Enter**를 눌러 원하는 대시보드를 열 수 있습니다.

## 대시보드 이름으로 찾기
<a name="find-by-dashboard-name"></a>

검색창에 대시보드 이름의 일부를 입력하세요. 입력하면 검색에서는 부분 문자열 일치에 대한 결과를 실시간으로 반환합니다.

대시보드 검색은 다음과 같습니다.
+ 실시간
+ 대소문자를 구분하지 않음
+  저장된 대시보드 및 파일 기반 대시보드에서 작동

## 태그 기준으로 필터링
<a name="filter-by-tags"></a>

 태그는 특히 대시보드 수가 증가함에 따라 대시보드를 구성하는 데 유용한 방법입니다. 대시보드 **설정**에서 태그를 추가하고 관리할 수 있습니다.

 태그별로 대시보드 목록을 필터링하려면 오른쪽 열에 나타나는 태그를 선택하세요. 추가 태그를 선택하여 목록을 추가로 필터링할 수 있습니다.

사용 가능한 모든 태그 목록을 보려면 **태그별 필터링** 드롭다운 메뉴를 선택하세요. 태그를 선택하면 대시보드 검색이 즉시 필터링됩니다.

키보드만 사용하는 경우 **Tab**을 눌러 태그 링크에 초점을 맞추고 아래쪽 화살표 키를 눌러 태그를 찾은 다음, **Enter**를 눌러 태그를 선택하세요.

**참고**  
 여러 태그를 선택하면 Amazon Managed Grafana에 모든 태그를 포함하는 대시보드가 표시됩니다.

# 대시보드 공유
<a name="share-a-dashboard"></a>

****  
이 설명서 주제는 **Grafana 버전 8.x**를 지원하는 Grafana 워크스페이스를 위해 설계되었습니다.  
Grafana 버전 10.x를 지원하는 Grafana 워크스페이스의 경우 [Grafana 버전 10에서 작업](using-grafana-v10.md) 섹션을 참조하세요.  
Grafana 버전 9.x를 지원하는 Grafana 워크스페이스의 경우 [Grafana 버전 9에서 작업](using-grafana-v9.md) 섹션을 참조하세요.

 대시보드를 공유하려면 상단 탐색 표시줄에서 **대시보드 공유**(공유 아이콘)를 선택합니다. 그러면 현재 선택한 시간 범위 및 템플릿 변수를 사용하여 현재 대시보드에 대한 링크를 가져올 수 있는 **공유** 대화 상자가 열립니다. 대시보드를 변경한 경우 링크를 복사하기 전에 해당 변경 사항을 저장해야 합니다.

## 대시보드 스냅샷
<a name="dashboard-snapshot"></a>

 대시보드 스냅샷은 대화형 대시보드를 공개적으로 공유하는 즉각적인 방법입니다. 스냅샷을 생성할 때 Amazon Managed Grafana는 쿼리(지표, 템플릿 및 주석) 및 패널 링크와 같은 민감한 데이터를 제거하여 대시보드에 임베드되어 표시되는 지표 데이터 및 시리즈 이름만 남깁니다. 대시보드 스냅샷은 링크가 있고 URL에 연결할 수 있는 모든 사용자가 액세스할 수 있습니다.

## 스냅샷 게시
<a name="publish-snapshots"></a>

 로컬 인스턴스에 스냅샷을 게시할 수 있습니다.

# 패널 공유
<a name="dashboard-share-a-panel"></a>

****  
이 설명서 주제는 **Grafana 버전 8.x**를 지원하는 Grafana 워크스페이스를 위해 설계되었습니다.  
Grafana 버전 10.x를 지원하는 Grafana 워크스페이스의 경우 [Grafana 버전 10에서 작업](using-grafana-v10.md) 섹션을 참조하세요.  
Grafana 버전 9.x를 지원하는 Grafana 워크스페이스는 [Grafana 버전 9에서 작업](using-grafana-v9.md) 섹션을 참조하세요.

 패널 제목을 선택하여 패널 메뉴를 연 다음, 패널 메뉴에서 **공유**를 선택하여 **패널 공유** 대화 상자를 엽니다. 링크를 복사하면 현재 시간 범위와 선택한 템플릿 변수가 있는 이 패널로 이동합니다.

# 시간 범위 제어
<a name="dashboard-time-range-controls"></a>

****  
이 설명서 주제는 **Grafana 버전 8.x**를 지원하는 Grafana 워크스페이스를 위해 설계되었습니다.  
Grafana 버전 10.x를 지원하는 Grafana 워크스페이스의 경우 [Grafana 버전 10에서 작업](using-grafana-v10.md) 섹션을 참조하세요.  
Grafana 버전 9.x를 지원하는 Grafana 워크스페이스는 [Grafana 버전 9에서 작업](using-grafana-v9.md) 섹션을 참조하세요.

 Amazon Managed Grafana는 대시보드 수준과 패널 수준에서 시각화되는 데이터의 시간 범위를 관리하는 몇 가지 방법을 제공합니다.

 이 주제에서는 지원되는 시간 단위 및 상대 범위, 일반 시간 제어, 대시보드 전체 시간 설정 및 패널별 시간 설정을 설명합니다.

**참고**  
시간 제어를 사용하려면 데이터에 시간 열이 포함되어야 합니다. 시간 열을 포함하는 방법에 대한 자세한 내용은 특정 [데이터 소스](AMG-data-sources.md)에 대한 설명서를 참조하세요.

## 시간 단위 및 상대 범위
<a name="time-units-and-relative-ranges"></a>

 다음 시간 단위가 지원됩니다.
+ `s`(초)
+ `m`(분)
+ `h`(시간)
+ `d`(일)
+ `w`(주)
+ `M`(월)
+ `y`(년)

 빼기 연산자를 사용하여 현재를 기준으로 이전 시간을 설정합니다. 단위의 전체 기간(예: 일, 주 또는 월)을 표시하려면 `/<time unit>`를 추가합니다.

 더하기 연산자를 사용하여 현재를 기준으로 이후 시간을 설정합니다. 이 기능을 사용하여 미래의 예측 데이터를 볼 수 있습니다.

 여기 몇 가지 예가 있습니다: 


|  상대 범위 예제  |  From  |  목적  | 
| --- | --- | --- | 
|  지난 5분  |  now-5m  |  now  | 
|  지금까지 일수  |  now/d  |  now  | 
|  이번 주  |  now/w  |  now/w  | 
|  현재까지 주  |  now/w  |  now  | 
|  전월  |  now-1M/M  |  now-1M/M  | 

## 공통 시간 범위 제어
<a name="common-time-range-controls"></a>

 대시보드 및 패널 시간 제어에는 다음 옵션과 함께 공통된 사용자 인터페이스가 있습니다.

### 현재 시간 범위
<a name="current-time-range"></a>

 *시간 선택기*라고도 하는 현재 시간 범위는 현재 보고 있는 대시보드 또는 패널에 표시된 시간 범위를 보여줍니다.

 필드에서 일시 중지하여 범위의 정확한 타임스탬프와 로컬 브라우저와 같은 해당 소스를 확인합니다.

 시간 범위를 변경하려면 현재 시간 범위에서 선택합니다. 지난 15분과 같은 *상대 시간 범위* 또는 `2020-05-14 00:00:00 to 2020-05-15 23:59:59`와 같은 *절대 시간 범위*를 사용하여 현재 시간을 변경할 수 있습니다.

### 상대적 시간 범위
<a name="relative-time-range"></a>

 **상대 시간 범위** 목록에서 상대 시간 범위를 선택합니다. 다음은 상대적 시간 범위의 몇 가지 예입니다.
+  지난 30분 
+  지난 12시간 
+  지난 7일 
+  지난 2년 
+  어제 
+  어제까지 일수 
+  지난 주 이 날 
+  오늘까지 
+  이번 주까지 
+  이번 달까지 

### 절대 시간 범위
<a name="absolute-time-range"></a>

 다음 두 가지 방법 중 하나로 절대 시간 범위를 설정합니다.
+  **시작** 및 **종료** 필드에 값을 입력하세요. 정확한 시간 값 또는 상대 값(예: `now-24h`)을 입력하고 **시간 범위 적용**을 선택할 수 있습니다.
+  **시작** 또는 **종료** 필드를 선택합니다. Amazon Managed Grafana에서 달력을 표시합니다. 현재 시간 범위로 사용할 하나 이상의 일수를 선택한 다음, **시간 범위 적용**을 선택하세요.

 Amazon Managed Grafana는 최근에 사용된 절대 범위도 표시합니다.

### 축소(Cmd\$1Z 또는 Ctrl\$1Z)
<a name="zoom-out-cmdz-or-ctrlz"></a>

 대시보드 또는 패널 시각화에서 더 큰 시간 범위를 보려면 **시간 범위 축소** 아이콘을 선택합니다.

### 확대(그래프 시각화만 해당)
<a name="zoom-in-only-applicable-to-graph-visualizations"></a>

 그래프 시각화에서 끌어서 보려는 시간 범위를 선택합니다.

### 대시보드 새로 고침
<a name="refresh-dashboard"></a>

 **대시보드 새로 고침** 아이콘을 선택하여 대시보드의 모든 쿼리를 즉시 실행하고 시각화를 새로 고칩니다. Amazon Managed Grafana는 새로운 새로 고침이 시작될 때 보류 중인 요청을 취소합니다.

 기본적으로 Amazon Managed Grafana는 대시보드를 자동으로 새로 고치지 않습니다. 쿼리는 패널 설정에 따라 자체 일정으로 실행됩니다. 그러나 대시보드를 정기적으로 새로 고치려면 **대시보드 새로 고침** 아이콘 옆의 아래쪽 화살표를 선택한 다음, 새로 고침 간격을 선택합니다.

## 대시보드 시간 설정
<a name="dashboard-time-settings"></a>

 시간 설정은 대시보드별로 저장됩니다.

 대시보드 시간 설정에 액세스하려면 화면 상단의 **대시보드 설정**(톱니) 아이콘을 선택합니다. 설정은 **일반** 탭의 **시간 옵션** 섹션에 있습니다.
+  **시간대** - 모니터링 중인 서비스 또는 시스템의 로컬 시간대. 여러 시간대에서 작동하는 시스템 또는 서비스를 모니터링할 때 유용할 수 있습니다.
  +  **기본값** - 사용자 프로파일, 팀 또는 조직에 대해 선택한 기본 시간대. 사용자 프로파일, 사용자가 멤버로 속한 팀 또는 조직에 대해 시간대가 지정되지 않은 경우 Amazon Managed Grafana는 로컬 브라우저 시간을 사용합니다.
  +  **브라우저 시간** - 사용 중인 브라우저에 대해 구성된 시간대. 일반적으로 컴퓨터에 설정된 시간대입니다.
  +  **협정 세계시** - UTC를 포함한 표준 ISO 8601 시간대. 자세한 내용은 [시간대 목록](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones)을 참조하세요.
+  **자동 새로 고침** - 상대적 시간 및 자동 새로 고침 설정을 사용자 지정할 수 있는 옵션. 항목은 쉼표로 구분되며 유효한 시간 단위일 수 있습니다.
+  **지금 지연** - `now` 값을 재정의하는 시간 지연 값. 가장 일반적으로 이 기능은 데이터 집계의 알려진 지연을 수용하여 null 값을 방지하는 데 사용됩니다.
+  **시간 선택기 숨기기** - 시간 선택기를 표시하지 않는 옵션.

## 패널 시간 재정의 및 시간 전환
<a name="panel-time-overrides-and-timeshift"></a>

 [쿼리 옵션](panel-queries.md#query-options)에서 개별 패널의 상대 시간 범위를 재정의할 수 있습니다. 그러면 상단 탐색 표시줄의 대시보드 시간 선택기에서 선택한 항목과 달라집니다. 서로 다른 기간 또는 일수의 지표를 동시에 표시할 수 있습니다.

## URL을 사용하여 시간 범위 제어
<a name="control-the-time-range-using-a-url"></a>

 대시보드 URL에 다음 쿼리 파라미터를 제공하여 대시보드의 시간 범위를 제어할 수 있습니다.
+  `from` - 시간 범위의 하한(밀리초 에포크 또는 상대 시간으로 지정됨)을 정의합니다. 자세한 내용은 [상대적 시간 범위](#relative-time-range) 단원을 참조하십시오.
+  `to` - 시간 범위의 상한(밀리초 에포크 또는 상대 시간으로 지정됨)을 정의합니다. 자세한 내용은 [상대적 시간 범위](#relative-time-range) 단원을 참조하십시오.
+  `time` 및 `time.window` - `time-time.window/2`에서 `time+time.window/2`의 시간 범위를 정의합니다. 두 파라미터 모두 밀리초 단위로 지정해야 합니다. 예를 들어 `?time=1500000000000&time.window=10000`인 경우 1499999995000에서 1500000005000의 10초 시간 범위에 해당합니다.

# 대시보드 내보내기 및 가져오기
<a name="dashboard-export-and-import"></a>

****  
이 설명서 주제는 **Grafana 버전 8.x**를 지원하는 Grafana 워크스페이스를 위해 설계되었습니다.  
Grafana 버전 10.x를 지원하는 Grafana 워크스페이스의 경우 [Grafana 버전 10에서 작업](using-grafana-v10.md) 섹션을 참조하세요.  
Grafana 버전 9.x를 지원하는 Grafana 워크스페이스는 [Grafana 버전 9에서 작업](using-grafana-v9.md) 섹션을 참조하세요.

 Amazon Managed Grafana 대시보드는 UI 또는 [HTTP API]에서 쉽게 내보내고 가져올 수 있습니다.

## 대시보드 내보내기
<a name="exporting-a-dashboard"></a>

 대시보드는 Amazon Managed Grafana JSON 형식으로 내보내며 레이아웃, 변수, 스타일, 데이터 소스 및 쿼리를 포함하여 나중에 대시보드를 가져오는 데 필요한 모든 항목을 포함합니다.

 내보내기 기능은 대시보드 메뉴에서 공유 버튼을 선택하여 여는 공유 창에서 액세스할 수 있습니다.

### 이동식 대시보드 설정
<a name="making-a-dashboard-portable"></a>

 다른 사용자가 사용하도록 대시보드를 내보내는 경우 지표 접두사(상수 변수 사용) 및 서버 이름과 같은 값에 대해 템플릿 변수를 추가하는 것이 좋습니다.

 `Constant` 유형의 템플릿 변수는 대시보드에 자동으로 숨겨집니다. 또한 대시보드를 가져올 때 필수 입력으로도 추가됩니다. 템플릿 지정 및 템플릿 변수에 대한 자세한 내용은 [템플릿 및 변수](templates-and-variables.md) 섹션을 참조하세요.

## 대시보드 가져오기
<a name="importing-a-dashboard"></a>

 대시보드를 가져오려면 사이드 메뉴에서 \$1 아이콘을 선택한 다음, **가져오기**를 선택하세요.

 대시보드 JSON 파일을 업로드하거나 대시보드 URL을 붙여넣거나 대시보드 JSON 텍스트를 텍스트 영역에 직접 붙여넣을 수 있습니다.

 가져오기 프로세스의 2단계에서는 대시보드의 이름을 변경하고 대시보드에서 사용할 데이터 소스를 지정하며 지표 접두사(대시보드에서 사용하는 경우)를 지정할 수 있습니다.

## Grafana.com에서 대시보드 검색
<a name="discover-dashboards-on-grafana.com"></a>

 [Grafana.com/dashboards](https://grafana.com/dashboards)에서 일반적인 서버 애플리케이션에 대한 대시보드를 찾습니다.

# 대시보드 버전 기록
<a name="dashboard-version-history"></a>

****  
이 설명서 주제는 **Grafana 버전 8.x**를 지원하는 Grafana 워크스페이스를 위해 설계되었습니다.  
Grafana 버전 10.x를 지원하는 Grafana 워크스페이스의 경우 [Grafana 버전 10에서 작업](using-grafana-v10.md) 섹션을 참조하세요.  
Grafana 버전 9.x를 지원하는 Grafana 워크스페이스는 [Grafana 버전 9에서 작업](using-grafana-v9.md) 섹션을 참조하세요.

 대시보드 버전을 저장할 때마다 이전 버전의 대시보드가 사라지지 않도록 해당 버전의 사본이 저장됩니다. **대시보드 설정**을 선택하고 왼쪽 메뉴에서 **버전**을 선택하면 이러한 버전 목록을 사용할 수 있습니다.

 대시보드 버전 기록 기능을 사용하면 이전에 저장된 대시보드 버전을 비교 및 복원할 수 있습니다.

## 두 대시보드 버전 비교
<a name="comparing-two-dashboard-versions"></a>

 두 대시보드 버전을 비교하려면 비교할 두 버전을 목록에서 선택하세요. 두 버전을 선택한 후 **버전 비교**를 선택하여 차이 보기를 여세요. 기본적으로 다음 이미지와 같이 변경 사항에 대한 텍스트 요약이 표시됩니다.

 대시보드를 나타내는 원시 JSON의 차이를 보려면 **JSON 차이 보기**를 선택하세요.

 비교 중인 이전 버전으로 복원하려면 **버전 <x>(으)로 복원**을 선택하세요.

## 이전에 저장된 대시보드 버전으로 복원
<a name="restoring-to-a-previously-saved-dashboard-version"></a>

 이전에 저장한 대시보드 버전으로 복원해야 하는 경우 대시보드 버전 목록의 행 오른쪽에 있는 '복원' 버튼을 선택하거나 차이 보기에 나타나는 **버전 <x>(으)로 복원**을 선택하여 복원할 수 있습니다. 복원을 선택하면 복원을 확인하라는 팝업 상자가 표시됩니다.

 이전 버전으로 복원하면 이전 버전과 정확히 동일한 데이터를 포함하지만 버전 번호가 다른 새 버전이 생성됩니다. **참고** 열에 표시됩니다. 이렇게 하면 이전 대시보드 버전이 변경의 영향을 받지 않도록 하는 데 도움이 됩니다.

# 키보드 바로 가기
<a name="keyboard-shortcuts"></a>

****  
이 설명서 주제는 **Grafana 버전 8.x**를 지원하는 Grafana 워크스페이스를 위해 설계되었습니다.  
Grafana 버전 10.x를 지원하는 Grafana 워크스페이스의 경우 [Grafana 버전 10에서 작업](using-grafana-v10.md) 섹션을 참조하세요.  
Grafana 버전 9.x를 지원하는 Grafana 워크스페이스는 [Grafana 버전 9에서 작업](using-grafana-v9.md) 섹션을 참조하세요.

 Amazon Managed Grafana에서는 다양한 키보드 단축키를 사용할 수 있습니다. Amazon Managed Grafana 버전에서 사용할 수 있는 모든 키보드 단축키를 표시하려면 키보드에서 **Shift \$1 ?**를 누릅니다.

 **Amazon Managed Grafana에는 다음과 같이 자주 사용하는 단축키가 포함되어 있습니다.**
+  **Ctrl\$1S**는 현재 대시보드를 저장합니다.
+  **Ctrl\$1F**는 대시보드 찾기/검색을 엽니다.
+  **Ctrl\$1H**는 모든 제어를 숨깁니다(제어 숨기기는 TV 디스플레이에서 효과적임).
+  **Esc**는 전체 화면 또는 편집 모드에 있을 때 그래프를 종료합니다.

# 대시보드 JSON 모델
<a name="dashboard-json-model"></a>

****  
이 설명서 주제는 **Grafana 버전 8.x**를 지원하는 Grafana 워크스페이스를 위해 설계되었습니다.  
Grafana 버전 10.x를 지원하는 Grafana 워크스페이스의 경우 [Grafana 버전 10에서 작업](using-grafana-v10.md) 섹션을 참조하세요.  
Grafana 버전 9.x를 지원하는 Grafana 워크스페이스는 [Grafana 버전 9에서 작업](using-grafana-v9.md) 섹션을 참조하세요.

 Amazon Managed Grafana의 대시보드는 대시보드의 메타데이터를 저장하는 JSON 객체로 표시됩니다. 대시보드 메타데이터에는 대시보드 속성, 패널의 메타데이터, 템플릿 변수 및 패널 쿼리가 포함됩니다.

**대시보드의 JSON을 보는 방법**

1.  대시보드를 여세요.

1.  상단 탐색 표시줄에서 **대시보드 관리**를 선택하세요.

1.  드롭다운 메뉴에서 **JSON 보기**를 선택하세요.

## JSON 필드
<a name="dashboard-json-fields"></a>

 사용자가 새 대시보드를 생성하면 새 대시보드 JSON 객체가 다음 필드로 초기화됩니다.

**참고**  
 다음 JSON에서 `id`는 대시보드가 저장될 때까지 할당된 기본값인 `null`로 표시됩니다. 대시보드를 저장하면 `id` 필드에 정수 값이 할당됩니다.

```
{
  "id": null,
  "uid": "cLV5GDCkz",
  "title": "New dashboard",
  "tags": [],
  "style": "dark",
  "timezone": "browser",
  "editable": true,
  "hideControls": false,
  "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의 각 필드에 대한 사용 세부 정보를 제공합니다.


|  이름  |  사용법  | 
| --- | --- | 
|  id  |  대시보드의 고유 숫자 식별자(데이터베이스에서 생성됨). | 
|  uid  |  누구나 생성할 수 있는 고유한 대시보드 식별자. uid는 8\$140자의 문자열입니다. | 
|  제목  |  대시보드의 현재 제목. | 
|  tags  |  대시보드와 연결된 태그. JSON에서 태그는 문자열의 배열입니다. | 
|  style  |  대시보드의 테마(예: dark 또는 light). | 
|  timezone  |  대시보드의 시간대(utc 또는 browser). | 
|  editable  |  대시보드를 편집할 수 있는지 여부. | 
|  graphTooltip  |  툴팁 스타일.[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/grafana/latest/userguide/dashboard-json-model.html)  | 
|  time  |  대시보드의 시간 범위(예: 지난 6시간, 지난 7일). | 
|  timepicker  |  시간 선택기 메타데이터. 자세한 내용은 [시간 선택기](#dashboard-json-timepicker) 단원을 참조하십시오. | 
|  templating  |  템플릿 지정 메타데이터. 자세한 내용은 [템플릿 및 변수](templates-and-variables.md) 단원을 참조하십시오. | 
|  annotations  |  주석 메타데이터 자세한 내용은 [Annotations](dashboard-annotations.md) 단원을 참조하십시오. | 
|  refresh  |  자동 새로 고침 간격. | 
|  schemaVersion  |  Amazon Managed Grafana 업데이트에서 스키마를 변경할 때마다 증가하는 JSON 스키마의 버전(정수). | 
|  version  |  대시보드가 업데이트될 때마다 증가하는 대시보드의 버전(정수). | 
|  panels  |  패널 배열. 자세한 내용은 [패널](#dashboard-JSON-panels) 단원을 참조하십시오. | 

## 패널
<a name="dashboard-JSON-panels"></a>

 패널은 대시보드의 구성 요소입니다. 데이터 소스 쿼리, 그래프 유형, 별칭 및 기타 데이터로 구성됩니다. 패널 JSON은 JSON 객체 배열로 구성되며, 각각 서로 다른 패널을 나타냅니다. 대부분의 필드는 모든 패널에 공통이지만 일부 필드는 패널 유형에 따라 다릅니다. 다음 예제는 텍스트 패널의 패널 JSON을 보여줍니다.

```
"panels": [
  {
    "type": "text",
    "title": "Panel Title",
    "gridPos": {
      "x": 0,
      "y": 0,
      "w": 12,
      "h": 9
    },
    "id": 4,
    "mode": "markdown",
    "content": "# title"
  }
```

### 패널 크기 및 위치
<a name="panel-size-and-position"></a>

 `gridPos` 속성은 그리드 좌표의 패널 크기와 위치를 설명합니다.
+  `w` – 1\$124. 대시보드의 너비는 24개의 열로 나뉩니다.
+  `h` – 그리드 높이 단위. 각 그리드 높이 단위는 30픽셀을 나타냅니다.
+  `x` – x 위치. x 위치는 `w`와 동일한 열 단위를 사용합니다.
+  `y` – y 위치. y 위치는 `h`와 동일한 그리드 높이 단위를 사용합니다.

 그리드에서 패널 위에 공백이 있는 경우 패널을 위로 움직이는 중력(음의 방향)이 작용합니다.

### 시간 선택기
<a name="dashboard-json-timepicker"></a>

다음 예제에서는 `timepicker` 옵션을 사용합니다.

```
"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"
  }
```

 다음 표에서는 `timepicker`에 대한 사용 세부 정보를 제공합니다.


|  이름  |  사용법  | 
| --- | --- | 
|  collapse  |  timepicker의 축소 여부  | 
|  enable  |  timepicker의 활성화 여부  | 
|  notice  |  TODO  | 
|  now  |  TODO  | 
|  refresh\$1intervals  |  TODO  | 
|  status  |  TODO  | 
|  type  |  TODO  | 

### 템플릿 지정
<a name="json-templating"></a>

 `templating` 필드에는 저장된 값 및 기타 메타데이터와 함께 템플릿 변수 배열이 포함되어 있습니다. 다음 예제에서는 `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"
      }
    ]
  }
```

 다음 표에서는 템플릿 지정 섹션에 대한 사용 세부 정보를 제공합니다.


|  이름  |  사용법  | 
| --- | --- | 
|  enable  |  템플릿 지정이 활성화되었는지 여부. | 
|  list  |  각각 하나의 템플릿 변수를 나타내는 객체 배열  | 
|  allFormat  |  데이터 소스에서 모든 값을 가져오는 데 사용할 형식(예: wildcard, glob, regex, pipe). | 
|  current  |  대시보드에서 현재 선택한 변수 텍스트 또는 값 표시  | 
|  데이터 원본  |  변수의 데이터 소스 표시  | 
|  includeAll  |  모든 값 옵션을 사용할 수 있는지 여부  | 
|  다중  |  변수 값 목록에서 다중 값을 선택할 수 있는지 여부  | 
|  multiFormat  |  데이터 소스에서 시계열을 가져오는 데 사용할 형식  | 
|  이름  |  변수의 이름  | 
|  options  |  대시보드에서 선택할 수 있는 변수 텍스트/값 페어의 배열  | 
|  query  |  변수의 값을 가져오는 데 사용되는 데이터 소스 쿼리  | 
|  refresh  |  TODO  | 
|  regex  |  TODO  | 
|  type  |  변수 유형(custom, query 또는 interval)  | 

# 스크립트로 작성된 대시보드
<a name="scripted-dashboards"></a>

****  
이 설명서 주제는 **Grafana 버전 8.x**를 지원하는 Grafana 워크스페이스를 위해 설계되었습니다.  
Grafana 버전 10.x를 지원하는 Grafana 워크스페이스의 경우 [Grafana 버전 10에서 작업](using-grafana-v10.md) 섹션을 참조하세요.  
Grafana 버전 9.x를 지원하는 Grafana 워크스페이스는 [Grafana 버전 9에서 작업](using-grafana-v9.md) 섹션을 참조하세요.

**주의**  
 이 기능은 더 이상 사용되지 않으며 향후 릴리스에서 제거됩니다.

 정의된 패턴에서 변경되는 지표 이름(예: 새 서버)이 많은 경우 새 대시보드를 지속적으로 생성하는 데 시간이 많이 걸릴 수 있습니다.

 스크립트로 작성된 대시보드를 사용하면 JavaScript를 사용하여 대시보드를 동적으로 생성할 수 있습니다. Grafana 설치 폴더의 `public/dashboards/` 아래에 `scripted.js` 파일이 있습니다. 이 파일에는 스크립트로 작성된 대시보드 예제가 포함되어 있습니다. `http://grafana_url/dashboard/script/scripted.js?rows=3&name=myName` URL을 사용하여 액세스할 수 있습니다.

 `scripted.js`를 열면 `ARGS` 변수에서 URL 파라미터를 읽은 후 행과 패널을 추가하는 방법을 확인할 수 있습니다.

## 예제: scripted.js
<a name="example"></a>

```
var seriesName = 'argName';

if (!_.isUndefined(ARGS.name)) {
  seriesName = ARGS.name;
}

dashboard.panels.push({
  title: 'Events',
  type: 'graph',
  fill: 1,
  linewidth: 2,
  gridPos: {
    h: 10,
    w: 24,
    x: 0,
    y: 10,
  },
  targets: [
    {
      target: "randomWalk('" + seriesName + "')",
    },
    {
      target: "randomWalk('random walk2')",
    },
  ],
});

return dashboard;
```

## 추가 예제
<a name="more-examples"></a>

 Grafana 설치의 `public/dashboards/` 디렉터리에서 더 많은 예제를 찾을 수 있습니다.