

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

# Grafana 버전 10에서의 대시보드
<a name="v10-dashboards"></a>

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

 대시보드는 하나 이상의 [패널](v10-panels.md)로 구성되고 하나 이상의 행으로 배열된 세트입니다. Grafana는 다양한 패널을 함께 제공하므로 올바른 쿼리를 쉽게 구성하고 시각화를 사용자 지정하여 필요에 맞는 완벽한 대시보드를 생성할 수 있습니다. 각 패널은 구성된 모든 [데이터 원본에 연결](AMG-data-sources.md)의 데이터와 상호 작용할 수 있습니다.

 대시보드 스냅샷은 정적입니다. 쿼리 및 표현식은 스냅샷에서 다시 실행될 수 없습니다. 따라서 쿼리 또는 표현식의 변수를 업데이트해도 대시보드 데이터는 변경되지 않습니다.

**Topics**
+ [대시보드 사용](v10-dash-using-dashboards.md)
+ [대시보드 빌드](v10-dash-building-dashboards.md)
+ [대시보드 관리](v10-dash-managing-dashboards.md)
+ [재생 목록 관리](v10-dash-managing-playlists.md)
+ [대시보드 및 패널 공유](v10-dash-sharing.md)
+ [변수](v10-dash-variables.md)
+ [대시보드 사용량 평가](v10-dash-assess-dashboard-usage.md)
+ [대시보드 문제 해결](v10-dash-troubleshoot.md)
+ [Grafana 버전 10에서 대시보드 검색](v10-search.md)

# 대시보드 사용
<a name="v10-dash-using-dashboards"></a>

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

이 주제에서는 대시보드 기능 및 단축키에 대한 개요를 제공하고 대시보드 검색을 사용하는 방법을 설명합니다.

## 특성
<a name="v10-dash-features"></a>

대시보드를 사용하여 데이터 프레젠테이션을 사용자 지정할 수 있습니다. 다음 이미지에서는 Amazon Managed Grafana 워크스페이스의 대시보드 인터페이스를 보여줍니다.

![\[Amazon Managed Grafana 워크스페이스에서 대시보드 인터페이스를 보여주는 이미지(다양한 기능에 대한 버튼이 강조 표시됨).\]](http://docs.aws.amazon.com/ko_kr/grafana/latest/userguide/images/AMG-dashboard-overview-v10.png)



|  기능  |  설명  | 
| --- | --- | 
| **1: 홈** | Grafana 인스턴스에 구성된 홈 페이지로 리디렉션하려면 Grafana 홈 아이콘을 선택합니다. | 
| **2. 제목** | 대시보드 제목을 선택하면 현재 폴더에 포함된 대시보드를 검색할 수 있습니다. | 
| **3. 대시보드 공유** | 이 옵션을 사용하여 링크 또는 스냅샷별로 현재 대시보드를 공유합니다. 공유 모달에서 대시보드 정의를 내보낼 수도 있습니다. | 
| **4. 새 패널 추가** | 이 옵션을 사용하여 현재 대시보드에 패널, 대시보드 행 또는 라이브러리 패널을 추가합니다. | 
| **5. 대시보드 저장** | 저장 아이콘을 선택하여 대시보드에 변경 사항을 저장합니다. | 
| **6. 대시보드 인사이트** | 사용자, 활동 및 쿼리 수에 대한 정보를 포함하여 대시보드에 대한 분석을 보려면 선택합니다. 자세한 내용은 [대시보드 사용량 평가](v10-dash-assess-dashboard-usage.md) 단원을 참조하십시오. | 
| **7. 대시보드 설정** | 대시보드 이름, 폴더 또는 태그를 변경하고 변수 및 주석 쿼리를 관리하려면 이 옵션을 사용합니다. 대시보드 설정에 대한 자세한 내용은 [대시보드 설정 수정](v10-dash-modify-settings.md) 섹션을 참조하세요. | 
| **8. 시간 선택기 드롭다운** |  이 옵션을 사용하여 상대 시간 범위 옵션을 선택하고 사용자 지정 절대 시간 범위를 설정합니다. **시간 설정 변경** 버튼을 클릭하여 시간 범위 제어에서 **시간대** 및 **회계 연도** 설정을 변경할 수 있습니다. 시간 설정은 대시보드 단위로 저장됩니다.  | 
| **9. 시간 범위 축소** |  이 옵션을 사용하여 시간 범위를 축소합니다. 시간 범위 제어 사용 방법에 대한 자세한 내용은 [대시보드 시간 범위 설정](#v10-dash-setting-dashboard-time-range) 섹션을 참조하세요.  | 
| **10. 대시보드 새로 고침** | 쿼리를 즉시 트리거하고 대시보드 데이터를 새로 고치려면 선택합니다. | 
| **11. 대시보드 시간 간격 새로 고침** | 대시보드 자동 새로 고침 시간 간격을 선택합니다. | 
| **12. 보기 모드**  | TV 또는 키오스크와 같은 대형 화면에 대시보드를 표시하려면 선택합니다. 보기 모드는 탐색 메뉴와 같은 관련 없는 정보를 숨깁니다.  | 
| **13. 대시보드 패널** |  대시보드의 기본 구성 요소는 패널입니다. 새 패널, 대시보드 행 또는 라이브러리 패널을 추가하려면 **패널 추가**를 선택합니다. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/grafana/latest/userguide/v10-dash-using-dashboards.html)  | 
| **14. 그래프 범례** | 범례에서 직접 시리즈 색상, y축 및 시리즈 표시 여부를 변경합니다. | 
| **15. 대시보드 행** | 대시보드 행은 패널을 그룹화하는 대시보드 내 논리적 분할기입니다. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/grafana/latest/userguide/v10-dash-using-dashboards.html)  | 

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

Grafana에서는 다양한 키보드 단축키를 사용할 수 있습니다. 사용 가능한 모든 키보드 단축키를 표시하려면 키보드에서 **?** 또는 **h**를 누릅니다.
+ `Ctrl+S`는 현재 대시보드를 저장합니다.
+ `f`는 대시보드 찾기/검색을 엽니다.
+  `d+k`는 키오스크 모드를 전환합니다(메뉴 숨김).
+ `d+e`는 모든 행을 확장합니다.
+ `d+s`는 대시보드 설정을 엽니다.
+ `Ctrl+K`는 명령 팔레트를 엽니다.
+ `Esc`는 전체 화면 보기 또는 편집 모드에 있을 때 패널을 종료합니다. 또한 대시보드 설정에서 대시보드로 돌아갑니다.

**초점 패널**

특정 패널을 대상으로 하는 단축키를 사용하려면 포인터로 패널 위에 마우스를 올려 놓습니다.
+ `e`는 패널 편집 보기를 전환함 
+ `v`는 패널 전체 화면 보기를 전환함 
+ `ps`는 패널 공유 기능을 염 
+ `pd`는 패널을 복제함 
+ `pr`는 패널을 제거함 
+ `pl`은 패널 범례를 전환함 

## 대시보드 시간 범위 설정
<a name="v10-dash-setting-dashboard-time-range"></a>

Grafana는 대시보드, 패널 및 알림도 포함하여 이러한 요소에 대해 시각화되는 데이터의 시간 범위를 관리하는 여러 방법을 제공합니다.

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

**시간 단위 및 상대 범위**

Grafana는 `s (seconds)`, `m (minutes)`, `h (hours)`, `d (days)`, `w (weeks)`, `M (months)`, `Q (quarters)`, `y (years)`와 같은 시간 단위를 지원합니다.

빼기 연산자를 사용하면 현재 날짜 및 시간을 기준으로 또는 `now`를 기준으로 시간을 되돌릴 수 있습니다. 단위의 전체 기간(일, 주 또는 월)을 표시하려면 끝에 `/<time unit>`를 추가합니다. 회계 기간을 보려면 `fQ (fiscal quarter)` 및 `fy (fiscal year)` 시간 단위를 사용합니다.

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

다음 표에서는 상대 범위 예제를 제공합니다.


| 상대 범위 예제 | From | 목적 | 
| --- | --- | --- | 
| 지난 5분 |  `now-5m`  |  `now`  | 
| 지금까지 일수 |  `now/d`  |  `now`  | 
| 이번 주 |  `now/w`  |  `now/w`  | 
| 이번 주까지 |  `now/w`  |  `now`  | 
| 이번 달 |  `now/M`  |  `now/M`  | 
| 이번 달까지 |  `now/M`  |  `now`  | 
| 전월 |  `now-1M/M`  |  `now-1M/M`  | 
| 올해까지 |  `now/Y`  |  `now`  | 
| 올해 |  `now/Y`  |  `now/Y`  | 
| 이전 회계 연도 |  `now-1y/fy`  |  `now-1y/fy`  | 

**참고**  
 Grafana 알림은 다음 구문을 지원하지 않습니다.  
`now+n` - 향후 타임스탬프와 관련됩니다ㅣ.
`now-1n/n` - 절대 타임스탬프이므로 *n의 시작부터 n의 종료까지*.

**일반적인 시간 범위 제어**

대시보드 및 패널 시간 제어에는 공통된 사용자 인터페이스가 있습니다. 다음에서는 일반적인 시간 범위 제어를 설명합니다.
+ *시간 선택기*라고도 하는 현재 시간 범위는 현재 보고 있는 대시보드 또는 패널에 표시된 시간 범위를 보여줍니다. 필드 위로 커서를 가져가면 범위의 정확한 타임스탬프와 해당 소스(예: 로컬 브라우저 시간)를 볼 수 있습니다. *현재 시간 범위*를 클릭하여 변경합니다. 지난 15분과 같은 *상대 시간 범위* 또는 `2020-05-14 00:00:00`\$1`2020-05-15 23:59:59`와 같은 절대 시간 범위를 사용하여 현재 시간을 변경할 수 있습니다.
+ **상대 시간 범위**는 **상대 시간 범위** 목록에서 선택할 수 있습니다. 상단의 입력 필드를 사용하여 목록을 필터링할 수 있습니다. 시간 범위의 몇 가지 예로는 *지난 30분*, *지난 12시간*, *지난 7일*, *지난 2년*, *어제*, *그제*, *지난 주 이날*, *오늘까지*, *이번 주까지*, *이번 달까지*가 있습니다.
+ **절대 시간 범위**는 두 가지 방법으로 설정할 수 있습니다. 정확한 시간 값 또는 상대 시간 값을 **시작** 및 **종료** 필드에 입력하고 **시간 범위 적용**을 클릭하거나 **시작** 또는 **종료** 필드를 클릭할 때 표시된 달력에서 날짜 또는 날짜 범위를 클릭합니다. 선택을 적용하려면 **시간 범위 적용**을 클릭합니다. 최근에 사용한 절대 시간 범위 목록에서 선택할 수도 있습니다.
+ 절대 시간 범위 설정에서 **반상대(Semi-relative) 시간 범위**를 선택할 수 있습니다. 예를 들어 특정 날짜 이후의 활동을 표시하려면 시작 시간에 대해 절대 시간을 선택하고 종료 시간에 대해 상대 시간(예: `now`)을 선택할 수 있습니다.

  시간이 지남에 따라 반상대 시간 범위를 사용하면 대시보드가 점진적으로 자동 축소되어 더 많은 기록과 더 적은 세부 정보를 표시합니다. 동일한 속도로 높은 데이터 해상도가 감소함에 따라 전체 기간의 과거 추세가 더 명확해집니다.
**참고**  
알림은 반상대 시간 범위를 지원하지 않습니다.
+ 축소 아이콘을 선택하거나 Cmd\$1Z 또는 Ctrl\$1Z를 키보드 단축키로 사용하여 **축소**합니다. 그러면 보기가 증가하여 대시보드 또는 패널 시각화에서 더 큰 시간 범위를 보여줍니다.
+ 시각화의 그래프에서 보려는 시간 범위를 선택하여 **확대**합니다.
**참고**  
확대는 그래프 시각화에만 적용됩니다.

**대시보드 새로 고침**

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

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

**URL을 사용하여 시간 범위 제어**

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

# 대시보드 빌드
<a name="v10-dash-building-dashboards"></a>

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

Grafana 워크스페이스를 생성하고 로그인한 후 대시보드를 생성하고 요구 사항에 맞게 설정을 수정할 수 있습니다. 대시보드는 [시각화를 포함하는 패널로](v10-panels-viz.md) 구성됩니다. 각 패널에는 [데이터 원본에 연결](AMG-data-sources.md) 중 하나에서 데이터를 가져오도록 쿼리가 연결되어 있습니다.

[변수](v10-dash-variables.md)를 추가 및 사용하여 보다 동적이고 대화형 기능이 강화된 대시보드를 생성할 수 있습니다. 지표 쿼리에서 서버, 애플리케이션 또는 기타 이름을 하드 코딩하는 대신 해당 위치에서 변수를 사용할 수 있습니다.

**Topics**
+ [대시보드 생성](v10-dash-creating.md)
+ [대시보드 가져오기](v10-dash-importing.md)
+ [대시보드 내보내기](v10-dash-exporting.md)
+ [대시보드 설정 수정](v10-dash-modify-settings.md)
+ [대시보드 URL 변수](v10-dash-dashboard-url-variables.md)
+ [라이브러리 패널 관리](v10-dash-manage-library-panels.md)
+ [대시보드 버전 기록 관리](v10-dash-manage-version-history.md)
+ [대시보드 링크 관리](v10-dash-manage-dashboard-links.md)
+ [시각화 주석 달기](v10-dash-annotations.md)
+ [대시보드 JSON 모델](v10-dash-dashboard-json-model.md)
+ [대시보드 모범 사례](v10-dash-bestpractices.md)

# 대시보드 생성
<a name="v10-dash-creating"></a>

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

**대시보드 생성 **

대시보드와 패널을 통해 Grafana를 사용하여 시각적 형식으로 데이터를 표시할 수 있습니다. 시각화를 표시하려면 각 패널에 하나 이상의 쿼리가 필요합니다. 시작하기 전에 다음 사전 조건을 완료합니다.
+ 필수 권한이 있는지 확인합니다. 권한에 대한 자세한 내용은 [사용자, 팀 및 권한](Grafana-administration-authorization.md) 섹션을 참조하세요.
+ 패널을 추가하려는 대시보드를 식별합니다.
+ 대상 데이터 소스의 쿼리 언어를 이해합니다.
+ 쿼리를 작성하는 데이터 소스가 추가되었는지 확인합니다. 자세한 내용은 [데이터 원본에 연결](AMG-data-sources.md) 단원을 참조하십시오.

 대시보드를 생성하는 방법:

1. Grafana에 로그인하고 왼쪽 메뉴에서 **대시보드**를 선택하세요.

1. **새로 만들기**를 선택한 다음, **새 대시보드**를 선택하세요.

1. 빈 대시보드에서 **\$1 시각화 추가**를 선택하세요. 그러면 새 시각화 대화 상자가 열립니다.

1. 데이터 소스를 선택하세요. 테스트를 위해 기존 데이터 소스, Grafana의 기본 제공 데이터 소스 중 하나를 선택하거나 **새 데이터 소스 구성**을 선택하여 새 데이터 소스를 설정할 수 있습니다(관리자 권한이 있는 사용자만 새 데이터 소스를 구성할 수 있음).

   데이터 소스가 선택된 **편집 패널** 보기가 열립니다. 필요한 경우 패널 편집기의 **쿼리** 탭을 사용하여 나중에 패널의 데이터 소스를 변경할 수 있습니다.

1. 데이터 소스의 쿼리 언어로 쿼리를 작성하거나 구성하세요. 대시보드 새로 고침 아이콘을 선택하여 데이터 소스에 대한 쿼리를 수행하고 결과를 확인하세요.

1. **시각화** 목록에서 시각화 유형을 선택하세요. Grafana에서 시각화가 적용된 쿼리 결과의 미리 보기를 표시합니다. 자세한 내용은 [시각화 옵션](v10-panels-viz.md)을 참조하세요.

1. **패널 옵션**에서 패널의 제목과 설명을 입력할 수 있습니다.

1. 대부분의 시각화는 필요한 정확한 정보를 표시하기 전에 약간의 조정이 필요합니다. 다음과 같은 방법으로 패널 설정을 조정할 수 있습니다.
   + [값 매핑 구성](v10-panels-configure-value-mappings.md)
   + [시각화별 옵션](v10-panels-viz.md)
   + [필드 값 재정의](v10-panels-configure-overrides.md)
   + [임계치 구성](v10-panels-configure-thresholds.md)
   + [표준 옵션 구성](v10-panels-configure-standard-options.md)

1. 패널 구성을 완료했으면 **저장**을 선택하여 대시보드를 저장하세요.

   또는 **적용**을 선택하여 패널 편집기에서 나가지 않고 변경 사항을 확인하세요.

1. 시각화를 설명하거나 변경 사항을 설명하는 메모를 추가한 다음, 페이지 오른쪽 상단에서 **저장**을 클릭하세요.
**참고**  
이 메모는 대시보드를 이전 버전으로 되돌려야 하는 경우에 유용합니다.

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

1. 선택적으로 대시보드 헤더에서 **추가**를 선택하고 드롭다운에서 **시각화**를 선택하여 대시보드에 패널을 더 추가할 수 있습니다.

**기존 대시보드 공유**

기존 대시보드를 빠르게 복사하여 새 대시보드 생성을 시작할 수 있습니다.

**기존 대시보드를 복사하는 방법**

1. 왼쪽 메뉴에서 **대시보드**를 선택하세요.

1. 복사하려는 대시보드를 선택하여 여세요.

1. 대시보드 오른쪽 상단에서 **설정**(톱니 아이콘)을 선택하세요.

1. 대시보드의 오른쪽 상단에서 **다른 이름으로 저장**을 선택하세요.

1. (선택 사항) 이름, 폴더, 설명 및 복사된 대시보드의 원본 대시보드 태그를 복사할지 여부를 지정하세요.

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

**반복 행 구성**

변수 값을 기반으로 대시보드에 패널 또는 행을 동적으로 추가하도록 Grafana를 구성할 수 있습니다. 변수는 대시보드의 모든 행에서 쿼리를 동적으로 변경합니다. 반복 패널에 대한 자세한 내용은 [반복 패널 구성]()을 참조하세요.

`Multi-value` 또는 `Include all values`를 선택하여 설정된 변수가 있는 경우 행을 반복할 수도 있습니다.

시작하기 전에 쿼리에 다중 값 변수가 포함되어 있는지 확인한 후, 다음 단계를 완료해야 합니다.

**반복 행을 구성하는 방법**

1. 왼쪽 메뉴에서 **대시보드**를 선택한 다음, 수정하려는 대시보드를 선택하세요.

1. 대시보드 상단에서 **추가**를 선택한 다음, 드롭다운에서 **행**을 선택하세요.

   대시보드가 비어 있는 경우 대시보드 가운데 있는 **\$1 행 추가** 버튼을 번갈아 선택할 수 있습니다.

1. 행 제목 위로 마우스를 가져가서 나타나는 **설정**(톱니) 아이콘을 선택하세요.

1. **행 옵션** 대화 상자에서 제목을 추가하고 반복 행을 추가할 변수를 선택하세요.
**참고**  
 대시보드 사용자에게 컨텍스트를 제공하려면 행 제목에 변수를 추가하세요.

1. **업데이트**를 선택합니다.

**행 및 대시보드 특수 데이터 소스 반복**

행이 특수 [대시보드](AMG-data-sources.md#AMG-data-sources-special) 데이터 소스를 사용하는 패널을 포함하는 경우(이때 동일한 대시보드의 다른 패널에 속하는 결과 세트를 사용하는 데이터 소스) 반복된 행의 해당 패널은 반복된 행의 패널이 아닌 원본 행에서 패널을 참조합니다.

예를 들어 대시보드에서 다음과 같습니다.
+ `Row 1`에는 `Panel 1A` 및 `Panel 1B`가 포함됩니다.
+ `Panel 1B`에서는 `Dashboard` 데이터 소스를 사용하여 `Panel 1A`의 결과를 사용합니다.
+ 반복 `Row 2`에는 `Panel 2A` 및 `Panel 2B`가 포함됩니다.
+ `Panel 2B`에서는 `Panel 2A`가 아닌 `Panel 1A`를 참조하세요.

**패널을 이동하는 방법**

1.  대시보드를 엽니다.

1. 패널 제목을 선택하고 패널을 새 위치로 끄세요. 대시보드에서 임의의 위치에 패널을 배치할 수 있습니다.

**패널 크기를 조정하는 방법**

1.  대시보드를 엽니다.

1. 패널의 크기를 조정하려면 패널의 오른쪽 하단을 끕니다. 요구 사항에 맞게 대시보드 패널의 크기를 조정할 수 있습니다.

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

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

사전 구성된 대시보드를 Amazon Managed Grafana 워크스페이스로 가져올 수 있습니다.

**대시보드를 가져오는 방법**

1. Amazon Managed Grafana 워크스페이스에 로그인하세요.

1. 왼쪽 메뉴에서 **대시보드**를 선택하세요.

1. **새로 만들기**를 선택하고 드롭다운 메뉴에서 **가져오기**를 선택하세요.

1. 다음으로, 가져올 대시보드 JSON 정의를 선택해야 합니다. JSON을 가져오는 방법에 세 가지 옵션이 있습니다.
   + 대시보드 JSON이 포함된 파일을 업로드합니다.
   + JSON 텍스트를 텍스트 영역에 직접 복사합니다.
   + Grafana Labs 대시보드 URL 또는 ID를 필드에 붙여넣습니다. grafana.com 대시보드 URL에 대한 자세한 내용은 다음 섹션을 참조하세요.
   + (선택 사항) 변경하려는 대시보드 세부 정보를 변경하세요.
   + 필요한 경우 데이터 소스를 선택하세요.
   + **가져오기**를 선택합니다.
   + 대시보드를 저장합니다.

## grafana.com에서 대시보드 찾기
<a name="v10-dash-import-from-grafana"></a>

grafana.com의 [대시보드](https://grafana.com/grafana/dashboards/) 페이지에서는 일반적인 서버 애플리케이션을 위한 대시보드를 제공합니다. 공식 및 커뮤니티에서 빌드한 대시보드의 라이브러리를 검색해 대시보드를 가져와 빠르게 시작하고 실행하세요.

**참고**  
grafana.com 대시보드를 가져오려면 Amazon Managed Grafana 워크스페이스에서 인터넷에 액세스할 수 있어야 합니다.

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

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

Grafana UI 또는 HTTP API를 사용하여 대시보드를 내보낼 수 있습니다.

대시보드 내보내기 작업은 나중에 대시보드를 가져올 수 있도록 레이아웃, 변수, 스타일, 데이터 소스, 쿼리 등을 포함하여 필요한 모든 항목이 포함된 Grafana JSON 파일을 생성합니다.

**이동식 대시보드 설정**

다른 사용자가 사용하도록 대시보드를 내보내려면 지표 접두사(상수 변수 사용) 및 서버 이름과 같은 항목에 대해 템플릿 변수를 추가할 수 있습니다.

`Constant` 유형의 템플릿 변수는 대시보드에 자동으로 숨겨지며 대시보드를 가져올 때 필수 입력으로 추가됩니다.

**대시보드를 내보내는 방법**

1. 내보내려는 대시보드를 엽니다.

1. 공유 아이콘을 선택하세요.

1. **내보내기**를 선택합니다.

1. **파일에 저장**을 선택하세요.

**참고**  
Grafana는 로컬 시스템에 JSON 파일을 다운로드합니다.

# 대시보드 설정 수정
<a name="v10-dash-modify-settings"></a>

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

대시보드 설정 페이지에서 다음을 수행할 수 있습니다.
+ 시간 설정을 포함한 일반 대시보드 속성을 편집합니다.
+ 주석 쿼리를 추가합니다.
+ 대시보드 변수를 추가합니다.
+ 링크를 추가합니다.
+ 대시보드 JSON 모델을 봅니다.

**대시보드 설정 페이지에 액세스하는 방법**

1. 편집 모드에서 대시보드를 여세요.

1. 페이지 상단에 있는 **대시보드 설정**(톱니 아이콘)을 클릭하세요.

**대시보드 시간 설정 수정**

대시보드 시간대, 로컬 브라우저 시간을 변경하고 자동 새로 고침 시간 간격을 지정하려는 경우 대시보드 시간 설정을 조정합니다.

**대시보드 시간 설정을 수정하는 방법**

1. **대시보드** 설정 페이지에서 **일반**을 선택하세요.

1. **시간 옵션** 섹션으로 이동하세요.

1. 다음 설명에 따라 시간 설정을 지정하세요.

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

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

**주석 쿼리 추가**

주석 쿼리는 이벤트를 쿼리하는 쿼리입니다. 이러한 이벤트는 여러 대시보드의 그래프에서 세로선으로 시각화할 수 있으며, 마우스로 가리키면 이벤트 정보를 볼 수 있는 작은 아이콘이 함께 표시됩니다.

**주석 쿼리를 추가하는 방법**

1. **대시보드 설정** 페이지에서 **주석**을 선택하세요.

1. **주석 쿼리 추가**를 선택하세요.

1. 이름을 입력하고 데이터 소스를 선택하세요.

1. 양식의 나머지 부분을 작성하여 쿼리와 주석을 작성하세요.

쿼리 편집기 UI는 선택한 데이터 소스에 따라 변경됩니다. 쿼리를 구성하는 방법에 대한 자세한 내용은 [데이터 소스](AMG-data-sources.md) 설명서를 참조하세요. 또는[플러그인 카탈로그를 사용하여 플러그인 찾기](grafana-plugins.md#plugin-catalog) 에서 설치하는 데이터 소스 플러그인의 경우 [Grafana Labs 웹 사이트의 설명서](https://grafana.com/docs/grafana/v10.3/datasources/)를 사용할 수 있습니다.

**변수 추가**

변수를 사용하면 보다 동적이고 대화형 기능이 강화된 대시보드를 생성할 수 있습니다. 지표 쿼리에서 서버, 애플리케이션 및 센서 이름과 같은 사물을 하드 코딩하는 대신 해당 위치에서 변수를 사용할 수 있습니다. 변수는 대시보드 상단에 드롭다운 목록으로 표시됩니다. 이러한 드롭다운을 사용하면 대시보드에 표시되는 데이터를 쉽게 변경할 수 있습니다.

변수에 대한 자세한 내용은 [변수](v10-dash-variables.md)를 참조하세요.

**변수를 추가하는 방법**

1. **대시보드 설정** 페이지의 왼쪽 섹션 메뉴에서 **변수**를 클릭한 다음, **변수 추가** 버튼을 클릭하세요.

1. **일반** 섹션에서 변수의 이름을 추가하세요. 나중에 쿼리에 사용할 이름입니다.

1. 변수 **유형**을 선택하세요.
**참고**  
선택하는 변수 유형은 페이지에서 채우는 필드에 영향을 미칩니다.

1. 변수를 정의하고 **업데이트**를 클릭하세요.

**링크 추가**

대시보드 링크를 사용하면 대시보드 헤더 바로 아래에 다른 대시보드 및 웹 사이트에 대한 링크를 배치할 수 있습니다. 링크를 사용하면 다른 관련 대시보드 및 콘텐츠를 쉽게 탐색할 수 있습니다.

**링크를 추가하는 방법**

1. **대시보드 설정** 페이지의 왼쪽 섹션 메뉴에서 **링크**를 선택한 다음, **링크 추가** 버튼을 선택하세요.

1. 제목을 입력하고 **유형** 필드에서 **대시보드** 또는 **링크**를 선택하세요.

1. 대시보드 링크를 추가하려면 선택적 태그를 추가하고 대시보드 링크 옵션 중 하나를 선택한 다음, **적용**을 클릭하세요.
**참고**  
태그를 사용하면 모든 대시보드에 특정 태그가 있는 동적 드롭다운이 생성됩니다.

1. 웹 링크를 추가하려면 사용자가 링크 위로 마우스를 가져갈 때 나타나는 URL 및 툴팁 텍스트를 추가하고 링크 옆에 나타나는 아이콘을 선택한 다음, 대시보드 링크 옵션 중 하나를 선택하세요.

**대시보드 JSON 모델 보기 **

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

대시보드 JSON 모델을 보려면 **대시보드 설정** 페이지에서 **JSON**을 클릭합니다.

JSON 필드에 대한 자세한 내용은 [JSON 필드](v10-dash-dashboard-json-model.md)를 참조하세요.

# 대시보드 URL 변수
<a name="v10-dash-dashboard-url-variables"></a>

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

Grafana는 대시보드 URL에서 쿼리 파라미터로 전달되는 변수 값을 적용할 수 있습니다. 자세한 내용은 [대시보드 링크 관리](v10-dash-manage-dashboard-links.md) 및 [템플릿 및 변수](v10-dash-variables.md)를 참조하세요.

**변수를 쿼리 파라미터로 전달**

Grafana는 접두사가 `var-`인 쿼리 문자열 파라미터를 지정된 대시보드에서 변수로 해석합니다.

예를 들어, 이 URL에서 다음과 같습니다.

```
https://${your-domain}/path/to/your/dashboard?var-example=value
```

쿼리 파라미터 `var-example=value`는 값이 `value`인 대시보드 변수 예제를 나타냅니다.

**변수에 대한 여러 값 전달**

여러 값을 전달하려면 각 값에 대해 변수 파라미터를 한 번 반복합니다.

```
https://${your-domain}/path/to/your/dashboard?var-example=value1&var-example=value2
```

Grafana는 `value1` 및 `value2`의 두 가지 값을 사용하여 대시보드 변수 예제로 `var-example=value1&var-example=value2`를 해석합니다.

**대시보드 링크에 변수 추가**

Grafana는 대시보드 설정에서 변수를 생성할 때 대시보드 링크에 변수를 추가할 수 있습니다. 변수를 추가하는 자세한 내용과 단계는 [대시보드 링크 관리](v10-dash-manage-dashboard-links.md)를 참조하세요.

**임시 필터 전달**

임시 필터는 지정된 데이터 소스를 사용하는 모든 지표 쿼리에 키 또는 값 필터를 적용합니다. 자세한 내용은 [임시 필터](v10-dash-variable-add.md#v10-dash-variable-add-adhoc)를 참조하세요.

임시 필터를 쿼리 파라미터로 전달하려면 변수 구문을 사용하여 임시 필터 변수를 전달하고 키와 연산자를 값으로, 값을 파이프로 구분된 목록으로 제공합니다.

예를 들어, 이 URL에서 다음과 같습니다.

`https://${your-domain}/path/to/your/dashboard?var-adhoc=example_key|=|example_value` 

쿼리 파라미터 `var-adhoc=key|=|value`는 `example_key` 키, `=` 연산자 및 `example_value` 값을 사용하여 임시 대시보드 변수로 구성된 임시 필터를 적용합니다.

**참고**  
임시 필터와 URL을 공유할 때는 URL을 인코딩해야 합니다. 위 예제에서 파이프(`|`)를 `%7C`로 바꾸고 등호 연산자(`=`)를 `%3D`로 바꿉니다.

**URL을 사용하여 시간 범위 제어**

대시보드의 시간 범위를 설정하려면 `from`, `to`, `time` 및 `time.window` 쿼리 파라미터를 사용합니다. 변수가 아니기 때문에 `var-` 접두사는 필요하지 않습니다.

# 라이브러리 패널 관리
<a name="v10-dash-manage-library-panels"></a>

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

라이브러리 패널은 모든 대시보드에서 사용할 수 있는 재사용 가능한 패널입니다. 라이브러리 패널을 변경하면 변경 사항이 패널이 사용되는 모든 인스턴스로 전파됩니다. 라이브러리 패널은 여러 대시보드에서 패널의 재사용을 간소화합니다.

저장된 대시보드와 함께 폴더에 라이브러리 패널을 저장할 수 있습니다.

**라이브러리 패널 생성**

라이브러리 패널을 생성하면 소스 대시보드의 패널도 라이브러리 패널로 변환됩니다. 패널을 변환한 후 원본 대시보드를 저장해야 합니다.

**라이브러리 패널을 생성하는 방법**

1. 편집 모드에서 라이브러리 패널로 변환할 패널을 여세요.

1. 패널 표시 옵션에서 아래쪽 화살표 옵션을 클릭하여 시각화에 대한 변경 사항을 시작하세요.

1. **라이브러리 패널**을 선택한 다음, **\$1 라이브러리 패널 생성**을 선택하세요. 그러면 생성 대화 상자가 열립니다.

1. **라이브러리 패널 이름**에 패널에 사용할 이름을 입력하세요.

1. **폴더에 저장**에서 라이브러리 패널을 저장할 폴더를 선택하세요.

1. **라이브러리 패널 생성**을 선택하여 라이브러리에 변경 사항을 저장하세요.

1. 대시보드를 저장합니다.

라이브러리 패널이 생성된 후 나타나는 대시보드를 사용하여 패널을 수정할 수 있습니다. 변경 사항을 저장하면 라이브러리 패널의 모든 인스턴스에 이러한 수정 사항이 반영됩니다.

**추가...**를 선택한 다음, **라이브러리 패널 생성**을 선택하여 패널의 편집 메뉴에서 직접 라이브러리 패널을 생성할 수도 있습니다.

**대시보드에 라이브러리 패널 추가**

다른 대시보드 사용자에게 시각화를 제공하려는 경우 Grafana 라이브러리 패널을 대시보드에 추가합니다.

**대시보드에 라이브러리 패널을 추가하는 방법**

1. 왼쪽 메뉴에서 **대시보드**를 선택하세요.

1. **새로 만들기**를 선택한 다음, 드롭다운에서 **새 대시보드**를 선택하세요.

1. 빈 대시보드에서 **\$1 라이브러리 패널 가져오기**를 선택합니다. 라이브러리 패널 목록이 표시됩니다.

1. 목록을 필터링하거나 검색하여 추가하려는 패널을 찾으세요.

1. 패널을 클릭하여 대시보드에 추가하세요.

**라이브러리 패널 연결 해제**

패널을 변경하고 라이브러리 패널의 다른 인스턴스에는 영향을 주지 않으려면 라이브러리 패널의 연결을 해제하세요.

**라이브러리 패널의 연결을 해제하는 방법**

1. 왼쪽 메뉴에서 **대시보드**를 선택하세요.

1. **라이브러리 패널**을 선택하세요.

1. 다른 대시보드에서 사용 중인 라이브러리 패널을 선택하세요.

1. 연결을 해제할 패널을 선택하세요.

1. 패널 제목을 선택하거나 패널 위 아무 곳이나 포인터로 가리키면 패널의 오른쪽 상단에 작업 메뉴가 표시됩니다.

1. **편집**을 선택합니다. 패널이 편집 모드로 열립니다.

1. 페이지 오른쪽 상단에서 **연결 해제**를 선택하세요.

1. **예, 연결 해제**를 선택하세요.

**라이브러리 패널 목록 보기**

사용 가능한 라이브러리 패널 목록을 보고 라이브러리 패널을 검색할 수 있습니다.

**라이브러리 패널 목록을 보는 방법**

1. 왼쪽 메뉴에서 **대시보드**를 선택하세요.

1. **라이브러리 패널**을 선택하세요. 이전에 정의한 라이브러리 패널 목록을 볼 수 있습니다.

1. 이름을 알고 있는 경우 특정 라이브러리 패널을 검색하세요. 폴더 또는 유형별로 패널을 필터링할 수도 있습니다.

**라이브러리 패널 삭제**

더 이상 필요 없는 라이브러리 패널을 삭제합니다.

**라이브러리 패널을 삭제하는 방법**

1. 왼쪽 메뉴에서 **대시보드**를 선택하세요.

1. **라이브러리 패널**을 선택하세요.

1. 삭제하려는 패널의 라이브러리 패널 이름 옆에 있는 삭제 아이콘을 선택합하세요.

# 대시보드 버전 기록 관리
<a name="v10-dash-manage-version-history"></a>

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

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

**참고**  
대시보드의 최신 버전 20개가 저장됩니다.

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

**두 대시보드 버전 비교**

두 대시보드 버전을 비교하려면 비교할 두 버전을 목록에서 선택하세요. **버전 비교**를 클릭하여 두 버전 간의 차이를 확인합니다. 그러면 버전 차이 보기가 나타납니다. 기본적으로 변경 사항에 대한 텍스트 요약이 표시됩니다.

대시보드를 나타내는 원시 JSON의 차이를 보려면 하단의 **JSON Diff 보기** 버튼을 클릭하면 됩니다.

**이전에 저장된 대시보드 버전으로 복원**

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

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

# 대시보드 링크 관리
<a name="v10-dash-manage-dashboard-links"></a>

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

링크를 사용하여 일반적으로 사용되는 대시보드를 탐색하거나 다른 대시보드를 시각화에 연결할 수 있습니다. 링크를 사용하면 다른 대시보드, 패널 및 외부 웹 사이트에 대한 바로 가기를 생성할 수 있습니다.

Grafana는 대시보드 링크, 패널 링크 및 데이터 링크를 지원합니다. 대시보드 링크는 대시보드 상단에 표시됩니다. 패널 링크는 패널의 왼쪽 상단에 있는 아이콘을 클릭하여 액세스할 수 있습니다.

**사용할 링크 선택**

먼저 현재 대시보드 사이를 이동하는 방법부터 살펴봅니다. 대시보드 세트 사이를 자주 이동하고 각 세트에서 동일한 컨텍스트를 찾기 위해 애쓰는 경우 링크를 사용하면 워크플로를 최적화하는 데 도움이 될 수 있습니다.

다음 단계는 워크플로에 적합한 링크 유형을 파악하는 것입니다. Grafana의 모든 링크 유형은 다른 대시보드 또는 외부 웹 사이트에 대한 바로 가기를 생성하는 데 사용되지만 다른 컨텍스트에서도 작동합니다.
+ 대시보드의 모든 패널이 아니라 대부분과 링크가 관련된 경우 대시보드 링크를 사용합니다.
+ 특정 패널로 드릴다운하려면 패널 링크를 사용합니다.
+ 외부 사이트에 연결하려는 경우 대시보드 링크 또는 패널 링크를 사용할 수 있습니다.
+ 특정 시리즈 또는 단일 측정으로 드릴다운하려면 데이터 링크를 사용합니다.

**URL을 사용하여 시간 범위 제어**

패널 또는 대시보드의 시간 범위를 제어하려면 대시보드 URL에서 쿼리 파라미터를 제공할 수 있습니다.
+ `from`에서는 시간 범위의 하한(밀리초 에포크로 지정됨)을 정의합니다.
+ `to`에서는 시간 범위의 상한(밀리초 에포크로 지정됨)을 정의합니다.
+ `time` 및 `time.window`는 `time-time.window/2`\$1`time+time.window/2`의 시간 범위를 정의합니다. 두 파라미터 모두 밀리초 단위로 지정해야 합니다. 예를 들어 `?time=1500000000000&time.window=10000`인 경우 1499999995000에서 1500000005000의 10초 시간 범위에 해당합니다.

**대시보드 링크**

대시보드 링크를 생성할 때 시간 범위와 현재 템플릿 변수를 포함하여 다른 대시보드에서 동일한 컨텍스트로 직접 이동할 수 있습니다. 이렇게 하면 링크를 보내는 사람이 올바른 데이터를 보고 있는지 걱정하지 않아도 됩니다. 다른 유형의 링크는 [데이터 링크 변수]()를 참조하세요.

대시보드 링크는 현재 대시보드 이름으로 GitHub 문제를 제출하는 등 외부 시스템에 대한 바로 가기로도 사용할 수 있습니다.

대시보드 링크를 추가하면 대시보드의 오른쪽 상단에 표시됩니다.

**대시보드에 링크 추가**

현재 대시보드 상단에서 다른 대시보드에 대한 링크를 추가하세요.

**대시보드에 링크를 추가하는 방법**

1. 연결하려는 대시보드를 보는 동안 화면 상단의 톱니를 클릭하여 **대시보드 설정**을 여세요.

1. **링크**를 선택하고 **대시보드 링크 추가** 또는 **새로 만들기**를 선택하세요.

1. **유형**에서 **대시보드**를 선택하세요.

1. 다음 중에서 링크 옵션을 선택하세요.
   + **태그 사용** - 입력한 태그가 있는 대시보드로만 연결된 대시보드를 제한하려면 태그를 입력합니다. 그렇지 않으면 Grafana에 다른 모든 대시보드에 대한 링크가 포함됩니다.
   + **드롭다운** - 여러 대시보드에 연결하는 경우 기본적으로 Grafana는 대시보드 상단에 모두 나란히 표시합니다. 이 옵션을 선택하고 선택적 제목을 추가하면 드롭다운에 링크가 표시됩니다.
   + **시간 범위** - 링크에 대시보드 시간 범위를 포함하려면 이 옵션을 선택합니다. 사용자가 링크를 클릭하면 표시된 시간 범위가 이미 설정된 상태로 연결된 대시보드가 열립니다.
   + **변수 값** - 현재 쿼리 파라미터로 사용되는 템플릿 변수를 링크에 포함하려면 이 옵션을 선택합니다. 사용자가 링크를 클릭하면 연결된 대시보드에서 일치하는 모든 템플릿이 링크의 값으로 설정됩니다. 자세한 내용은 [대시보드 URL 변수](v10-dash-dashboard-url-variables.md)를 참조하세요.
   + **새 탭에서 열기** - 대시보드 링크를 새 탭 또는 새 창에서 열려면 이 옵션을 선택합니다.

1. **추가**를 클릭합니다.

**대시보드에 URL 링크 추가**

현재 대시보드 상단에서 URL에 대한 링크를 추가하세요. 대시보드, 패널 또는 외부 사이트를 포함하여 사용 가능한 URL에 연결할 수 있습니다. Grafana에서 사용자가 올바른 데이터를 확대할 수 있도록 시간 범위를 제어할 수도 있습니다.

**대시보드에 URL 링크를 추가하는 방법**

1. 연결하려는 대시보드를 보는 동안 화면 상단의 톱니를 선택하여 **대시보드 설정**을 여세요.

1. **링크**를 선택하고 **대시보드 링크 추가** 또는 **새로 만들기**를 선택하세요.

1. **유형**에서 **링크**를 선택하세요.

1. 다음 중에서 링크 옵션을 선택하세요.
   + **URL** - 연결할 URL을 입력합니다. 대상에 따라 필드 값을 포함할 수 있습니다.
   + **제목** - 링크를 표시할 제목을 입력합니다.
   + **툴팁** - 링크를 표시할 툴팁을 입력합니다.
   + **아이콘** - 링크와 함께 표시할 아이콘을 선택합니다.
   + **시간 범위** - 링크에 대시보드 시간 범위를 포함하려면 이 옵션을 선택합니다. 사용자가 링크를 클릭하면 표시된 시간 범위가 설정된 상태로 연결된 대시보드가 열립니다.
     + `from` - 시간 범위의 하한(밀리초 에포크로 지정됨)을 정의합니다.
     + `to` - 시간 범위의 상한(밀리초 에포크로 지정됨)을 정의합니다.
     + `time` 및 `time.window` - `time-time.window/2`에서 `time+time.window/2`의 시간 범위를 정의합니다. 두 파라미터 모두 밀리초 단위로 지정해야 합니다. 예를 들어 `?time=1500000000000&time.window=10000`인 경우 1499999995000에서 1500000005000의 10초 시간 범위에 해당합니다.
   + **변수 값** - 현재 쿼리 파라미터로 사용되는 템플릿 변수를 링크에 포함하려면 이 옵션을 선택합니다. 사용자가 링크를 클릭하면 연결된 대시보드에서 일치하는 모든 템플릿이 링크의 값으로 설정됩니다.

     변수 형식은 다음과 같습니다.

     ```
     https://${you-domain}/path/to/your/dashboard?var-${template-varable1}=value1&var-{template-variable2}=value2
     ```
   + **새 탭에서 열기** - 대시보드 링크를 새 탭 또는 새 창에서 열려면 이 옵션을 선택합니다.

1. **추가**를 선택합니다.

**대시보드 링크 업데이트**

기존 대시보드 링크를 변경하거나 업데이트하려면 다음 절차를 따르세요.

**대시보드 링크를 업데이트하는 방법**

1. **대시보드 설정**의 **링크** 탭에서 편집할 기존 링크를 선택하세요.

1. 설정을 변경한 후 **업데이트**를 선택하세요.

**대시보드 링크 복제**

기존 대시보드 링크를 복제하려면 복제하려는 기존 링크 옆에 있는 복제 아이콘을 선택하세요.

**대시보드 링크 삭제**

기존 대시보드 링크를 삭제하려면 삭제하려는 링크 옆에 있는 휴지통 아이콘을 선택하세요.

**패널 링크**

각 패널에는 패널의 왼쪽 상단에 고유한 링크 세트가 표시될 수 있습니다. 대시보드, 패널 또는 외부 사이트를 포함하여 사용 가능한 URL에 연결할 수 있습니다. Grafana에서 사용자가 올바른 데이터를 확대할 수 있도록 시간 범위를 제어할 수도 있습니다.

사용 가능한 패널 링크를 보려면 패널 제목 오른쪽에 있는 아이콘을 선택하세요.
+ **패널 링크 추가**: 각 패널에는 패널의 왼쪽 상단에 고유한 링크 세트가 표시될 수 있습니다. 대시보드, 패널 또는 외부 사이트를 포함하여 사용 가능한 URL에 연결할 수 있습니다. Grafana에서 사용자가 올바른 데이터를 확대할 수 있도록 시간 범위를 제어할 수도 있습니다. 패널 왼쪽 상단에 있는 아이콘을 클릭하여 사용 가능한 패널 링크를 확인하세요.

  1. 링크를 추가하려는 패널 위에 커서를 놓으세요.

  1. 메뉴를 선택하고 **편집**을 선택하거나 키보드 단축키(`e`)를 사용할 수 있습니다.

  1. **패널 옵션** 섹션을 확장하고 아래로 스크롤하여 **패널 링크 **로 이동하세요.

  1. **링크 추가**를 선택하세요.

  1. **제목**을 입력하세요. 사람이 읽을 수 있는 링크에 대한 레이블로, UI에 표시됩니다.

  1. 연결할 **URL**을 입력하세요. `Ctrl+Space` 또는 `Cmd+Space`를 누르고 URL 필드를 선택하여 사용 가능한 변수를 확인하세요. 패널 링크에 템플릿 변수를 추가하면 링크는 관련 변수가 이미 설정된 올바른 컨텍스트로 사용자를 보냅니다.

     시간 변수를 사용할 수도 있습니다.
     + `from`에서는 시간 범위의 하한(밀리초 에포크로 지정됨)을 정의합니다.
     + `to`에서는 시간 범위의 상한(밀리초 에포크로 지정됨)을 정의합니다.
     + `time` 및 `time.window`는 `time-time.window/2`\$1`time+time.window/2`의 시간 범위를 정의합니다. 두 파라미터 모두 밀리초 단위로 지정해야 합니다. 예를 들어 `?time=1500000000000&time.window=10000`인 경우 1499999995000에서 1500000005000의 10초 시간 범위에 해당합니다.
+ **패널 링크 업데이트**

  1. 패널 오른쪽 상단에 작업 메뉴를 표시하려면 패널을 선택하거나 패널 위에 커서를 놓으세요.

  1. 메뉴에서 **편집**을 선택하세요.

     또는 키보드 단축키, `e`를 사용할 수 있습니다.

  1. **패널 옵션** 섹션을 확장하고 아래로 스크롤하여 **패널 링크 **로 이동하세요.

  1. 변경하려는 링크를 찾아 옆에 있는 **편집**(연필) 아이콘을 선택하세요.

  1. 필요한 경우 변경하세요.

  1. **저장**을 선택하여 변경 사항을 저장하고 창을 닫으세요.

  1. 오른쪽 상단에서 **저장**을 선택하여 대시보드의 변경 사항을 저장하세요.
+ **패널 링크 삭제**

  1. 패널 오른쪽 상단에 작업 메뉴를 표시하려면 패널을 선택하거나 패널 위에 커서를 놓으세요.

  1. 메뉴에서 **편집**을 선택하세요.

     또는 키보드 단축키, `e`를 사용할 수 있습니다.

  1. **패널 옵션** 섹션을 확장하고 아래로 스크롤하여 **패널 링크 **로 이동하세요.

  1. 삭제할 링크를 찾아 옆에 있는 **X** 아이콘을 선택하세요.

  1. 오른쪽 상단에서 **저장**을 선택하여 대시보드의 변경 사항을 저장하세요.

# 시각화 주석 달기
<a name="v10-dash-annotations"></a>

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

주석은 시각화에서 리치 이벤트로 점을 표시하는 방법을 제공합니다. 모든 그래프 패널에서 세로선과 아이콘으로 시각화됩니다. 주석을 가리키면 이벤트 설명 및 이벤트 태그를 볼 수 있습니다. 텍스트 필드에는 자세한 정보를 제공하기 위해 다른 시스템에 대한 링크가 포함될 수 있습니다.

다음 세 가지 방법으로 시각화에 주석을 작성할 수 있습니다.
+ [기본 제공 주석 쿼리](#v10-dash-built-in-query)를 사용하여 패널에서 직접 주석 작성.
+ Grafana HTTP API 사용.
+ 대시보드 설정에서 주석 쿼리 구성.

처음 두 경우에서는 새 주석을 생성하는 반면, 마지막에서는 데이터 소스에서 기존 주석을 쿼리합니다. 기본 제공 주석 쿼리도 이를 지원합니다.

이 섹션에서는 첫 번째 및 세 번째 옵션을 설명합니다. Grafana HTTP API 사용에 대한 자세한 내용은 [주석 API](Grafana-API-Annotations.md) 섹션을 참조하세요.

주석은 다음 시각화 유형에 대해 지원됩니다.
+ 시계열 
+ 상태 타임라인
+ 캔들스틱

## 패널에서 주석 생성
<a name="v10-dash-create-annotations-in-panels"></a>

Grafana는 모든 대시보드에 존재하는 [기본 제공 주석 쿼리](#v10-dash-built-in-query)를 사용하여 패널에서 직접 주석 이벤트를 추가하는 기능을 제공합니다. 이러한 방식으로 생성하는 주석은 Grafana에 저장됩니다.

패널에서 직접 주석을 추가하려는 경우:
+ 대시보드가 이미 저장되어 있어야 합니다.
+ 기본 제공 쿼리를 활성화해야 합니다.

**주석을 추가하는 방법**

1. 대시보드에서 주석을 추가할 패널을 선택하세요. 컨텍스트 메뉴가 나타납니다.

1. 컨텍스트 메뉴에서 **주석 추가**를 선택하세요.

1. (선택 사항) 주석 설명 및 태그를 추가하세요.

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

또는 주석을 추가하려면 패널을 선택하는 동안 `Ctrl` 또는 `Cmd`를 누르세요. 그러면 **주석 추가** 팝오버가 나타납니다.

**리전 주석**

시각화에서 리전 또는 기간을 포함하는 주석을 생성할 수도 있습니다.

**리전 주석을 추가하는 방법**

1. 대시보드에서 `Ctrl` 또는 `Cmd`를 누른 상태에서 패널 영역을 선택하세요.

1.  주석 설명 및 태그를 추가하세요(선택 사항).

1.  **저장**을 클릭합니다.

**주석을 편집하는 방법**

1. 대시보드에서 패널의 주석 표시기 위에 마우스를 올려 놓으세요.

1. 주석 툴팁에서 **편집**(연필) 아이콘을 선택하세요.

1. 설명 및/또는 태그를 수정하세요.

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

**주석을 삭제하는 방법**

1. 대시보드에서 패널의 주석 표시기 위에 마우스를 올려 놓으세요.

1. 주석 툴팁에서 **삭제**(휴지통) 아이콘을 선택하세요.

## 대시보드 설정을 통해 주석 가져오기
<a name="v10-dash-fetch-annotations"></a>

대시보드 설정의 **주석** 아래에서 기본 제공 데이터 주석 데이터 소스를 포함한 모든 데이터 소스를 사용하여 새 쿼리를 가져오기 주석에 추가할 수 있습니다. 주석 쿼리는 대시보드 전반의 그래프에서 이벤트 마커로 시각화할 수 있는 이벤트를 반환합니다.

**새 주석 쿼리를 추가하는 방법**

1. 대시보드 헤더에서 **설정**(톱니) 아이콘을 선택하여 설정 메뉴를 여세요.

1. **주석**을 선택하세요.

1. **주석 쿼리 추가**를 클릭하세요.

1. 주석 쿼리의 이름을 입력하세요.

   이 이름은 토글(확인란)에 지정되며, 이를 통해 이 쿼리에서 주석 이벤트를 표시할 수 있습니다.

1. 주석의 데이터 소스를 선택하세요.

   **고급 데이터 소스 선택기 열기**를 선택하여 새 데이터 소스 추가를 포함한 추가 옵션을 볼 수도 있습니다(관리자만 사용 가능).

1. 주석 쿼리를 바로 사용하지 않으려면 **활성화됨** 확인란을 선택 취소하세요.

1. 주석 쿼리 토글을 대시보드에 표시하지 않으려면 **숨김** 확인란을 선택하세요.

1. 이벤트 마커의 색상을 선택하세요.

1. **표시 위치** 드롭다운에서 다음 옵션 중 하나를 선택하세요.
   + **모든 패널** - 주석을 지원하는 모든 패널에 주석이 표시됩니다.
   + **선택한 패널** - 선택한 모든 패널에 주석이 표시됩니다.
   + **다음을 제외한 모든 패널** - 주석이 선택한 패널을 제외한 모든 패널에 표시됩니다.

1. 쿼리를 구성하세요.

   주석 쿼리 옵션은 데이터 소스마다 다릅니다. 특정 데이터 소스의 주석에 대한 자세한 내용은 [데이터 원본에 연결](AMG-data-sources.md) 섹션을 참조하세요.

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

주석을 추가한 후에도 주석은 계속 표시됩니다. 이는 모든 대시보드에 존재하는 기본 제공 주석 쿼리 때문입니다. 이 주석 쿼리는 현재 대시보드에서 시작된 모든 주석 이벤트를 가져와서 생성된 패널에 표시합니다. 여기에는 알림 상태 기록 주석이 포함됩니다.

기본적으로 기본 제공 주석 쿼리는 `Grafana` 특수 데이터 소스를 사용하며 수동 주석은 이 데이터 소스를 통해서만 지원됩니다. 기본 제공 주석 쿼리에서 다른 데이터 소스를 사용할 수 있지만 해당 데이터 소스에 대한 쿼리 편집기를 사용하는 방식으로만 자동화된 주석을 생성할 수 있습니다.

대시보드에 직접 주석을 추가하려면 이 쿼리를 활성화해야 합니다.

**기본 제공 쿼리가 활성화되었는지 확인하는 방법**

1. 대시보드 헤더에서 대시보드 **설정**(톱니) 아이콘을 선택하여 대시보드 설정 메뉴를 여세요.

1. **주석**을 선택하세요.

1. **주석 및 알림(기본 제공)** 쿼리를 찾으세요.

   쿼리 이름 앞에 **비활성화됨**이 표시되면 쿼리 이름을 선택하여 열고 설정을 업데이트해야 합니다.

**주석을 가져오고 그리는 것을 중지하는 방법**

1. 대시보드 헤더에서 대시보드 **설정**(톱니) 아이콘을 선택하여 대시보드 설정 메뉴를 여세요.

1. **주석**을 선택하세요.

1. **주석 및 알림(기본 제공)** 쿼리를 선택하세요.

1. **활성화됨** 토글을 선택하여 끄세요.

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

**태그를 기준으로 쿼리 필터링**

**필터링 기준**을 `Tags`로 설정하여 `Grafana` 데이터 소스를 통해 기본 제공 주석 쿼리에서 주석을 가져올 새 쿼리를 생성할 수 있습니다.

예를 들어 주석 쿼리 이름 `outages`를 생성하고 `outage` 태그를 지정합니다. 이 쿼리는 모든 대시보드에서 또는 API를 통해 `outage` 태그가 포함된 모든 주석을 표시합니다. 주석 쿼리에 여러 태그가 정의된 경우 Grafana는 모든 태그와 일치하는 주석만 표시합니다. 동작을 수정하려면 **임의 일치**를 활성화합니다. 그러면 Grafana에서 사용자가 제공한 태그 중 하나를 포함하는 주석을 표시합니다.

 태그 쿼리에서 템플릿 변수를 사용할 수도 있습니다. 즉, 다양한 서비스에 대한 통계를 보여주는 대시보드와 표시할 서비스를 나타내는 템플릿 변수가 있는 경우 주석 쿼리에서 동일한 템플릿 변수를 사용하여 해당 서비스에 대한 주석만 표시할 수 있습니다.

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

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

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

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

1. 대시보드로 이동하세요.

1. 상단 탐색 메뉴에서 **대시보드 설정**(톱니) 아이콘을 선택하세요.

1. **JSON 모델**을 선택하세요.

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

사용자가 새 대시보드를 생성하면 새 대시보드 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의 각 필드를 설명합니다.


| 이름 | 사용법 | 
| --- | --- | 
| `id` | 대시보드의 고유 숫자 식별자(db에서 생성됨) | 
| `uid` | 누구나 생성할 수 있는 고유한 대시보드 식별자, 문자열(8\$140) | 
| `title` | 대시보드의 현재 제목 | 
| `tags` | 대시보드와 연결된 태그, 문자열 배열 | 
| `style` | `dark` 또는 `light`와 같은 대시보드 테마 | 
| `timezone` | `utc` 또는 `browser`와 같은 대시보드 시간대 | 
| `editable` | 대시보드 편집 가능 여부 | 
| `graphTooltip` | 공유 십자선 또는 툴팁이 없는 경우 0(기본값), 공유 십자선의 경우 1, 공유 십자선 및 공유 툴팁의 경우 2 | 
| `time` | `last 6 hours` 또는 `last 7 days`와 같은 대시보드의 시간 범위 | 
| `timepicker` | 시간 선택기 메타데이터, 자세한 내용은 [시간 선택기 섹션](#v10-dash-json-panels) 참조 | 
| `templating` | 템플릿 지정 메타데이터, 자세한 내용은 [템플릿 지정 섹션](#v10-dash-json-panels) 참조 | 
| `annotations` | 주석 메타데이터, 주석을 추가하는 방법은 [주석](v10-dash-annotations.md) 참조 | 
| `refresh` | 자동 새로 고침 간격 | 
| `schemaVersion` | JSON 스키마 버전(정수), Grafana 업데이트에서 이 스키마를 변경할 때마다 증가 | 
| `version` | 대시보드 버전(정수), 대시보드가 업데이트될 때마다 증가 | 
| `panels` | 패널 배열(자세한 내용은 다음 섹션 참조) | 

## 패널
<a name="v10-dash-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"
  }
```

**패널 크기 및 위치**

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

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

**시간 선택기**

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

다음 표는 템플릿 지정 필드의 사용을 설명합니다.


| 이름 | 사용법 | 
| --- | --- | 
|  `enable`  |  템플릿 지정 활성화 여부  | 
|  `list`  |  각각 하나의 템플릿 변수를 나타내는 객체 배열  | 
|  `allFormat`  |  `wildcard`, `glob`, `regex`, `pipe`를 포함하여 데이터 소스에서 모든 값을 가져오는 데 사용할 형식.  | 
|  `current`  |  대시보드에 현재 선택된 변수 텍스트/값 표시  | 
|  `datasource`  |  변수의 데이터 소스 표시  | 
|  `includeAll`  |  모든 값 옵션을 사용할 수 있는지 여부  | 
|  `multi`  |  변수 값 목록에서 다중 값을 선택할 수 있는지 여부  | 
|  `multiFormat`  |  데이터 소스에서 시계열을 가져오는 동안 사용할 형식  | 
|  `name`  |  변수의 이름  | 
|  `options`  |  대시보드에서 선택할 수 있는 다양한 변수 텍스트/값 페어 배열  | 
|  `query`  |  변수 값을 가져오는 데 사용되는 데이터 소스 쿼리  | 
|  `refresh`  |  변수를 새로 고칠 시기 구성  | 
|  `regex`  |  시리즈 이름 또는 지표 노드 세그먼트의 일부 추출  | 
|  `type`  |  변수 유형, `custom`, `query` 또는 `interval`  | 

# 대시보드 모범 사례
<a name="v10-dash-bestpractices"></a>

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

이 섹션에서는 Grafana 대시보드를 구축하고 유지하는 방법에 대한 Grafana 관리자 및 사용자를 위한 모범 사례에 대한 정보를 제공합니다.

생성할 수 있는 다양한 종류의 대시보드에 대한 자세한 내용은 Grafana Labs 웹 사이트의 [Grafana dashboards: A complete guide to all the different types you can build](https://grafana.com/blog/2022/06/06/grafana-dashboards-a-complete-guide-to-all-the-different-types-you-can-build/?pg=webinar-getting-started-with-grafana-dashboard-design-amer&plcmt=related-content-1) 블로그 게시물을 참조하세요.

**참고**  
이 섹션에서는 모니터링 및 대시보드 유지 관리를 위한 전략을 생성하는 데 도움이 될 수 있습니다. 시스템을 가장 잘 파악하고, 이 섹션을 사용하여 이해도를 높여야 합니다. 궁극적으로 시스템에 가장 적합한 전략을 생성하는 것은 사용자의 몫입니다.

## 일반적인 관찰성 전략
<a name="v10-dash-common-observability-strategies"></a>

서버 팜과 같이 모니터링해야 할 내용이 많은 경우 모니터링할 만큼 중요한 항목을 결정하는 전략이 필요합니다. 이 페이지에서는 모니터링할 항목을 선택하는 몇 가지 일반적인 방법을 설명합니다.

논리적 전략을 사용하면 균일한 대시보드를 만들고 관찰성 플랫폼을 더 쉽게 확장할 수 있습니다.

**전략을 위한 지침**
+ USE 방법에서는 시스템의 안정성을 알려주고, RED 방법에서는 사용자의 만족도를 알려줍니다.
+ USE에서는 문제의 원인을 보고합니다.
+ RED에서는 사용자 경험을 보고하지만 문제의 증상을 보고할 가능성도 큽니다.
+ 두 가지를 모두 모니터링하는 것은 시스템을 이해하는 데 중요합니다. 가장 좋은 방법은 원인보다는 증상에 주의하는 것입니다. 일반적으로 알림은 RED 대시보드에서 구성됩니다.

**USE 방법**

USE는 다음의 약어입니다.
+ **사용률(Utilization)** - 노드 CPU 사용량과 같이 리소스가 사용 중인 시간 비율.
+ **포화도(Saturation)** - 리소스가 수행해야 하는 작업의 양(종종 대기열 길이 또는 노드 로드).
+ **오류(Errors)** - 오류 이벤트 수.

이 방법은 CPU, 메모리, 네트워크 디바이스와 같은 인프라의 하드웨어 리소스에 가장 적합합니다. 자세한 내용은 Brendan Gregg의 [The USE Method](http://www.brendangregg.com/usemethod.html) 블로그 게시물을 참조하세요.

**RED 방법**

RED는 다음의 약어입니다.
+ **속도(Rate)** - 초당 요청 수
+ **오류(Errors)** - 실패한 요청 수.
+ **기간(Duration)** - 이러한 요청에 걸리는 시간, 지연 시간 측정의 분포.

이 방법은 서비스, 특히 마이크로서비스 환경에 가장 적합합니다. 각 서비스에 대해 코드를 계측하여 각 구성 요소에 대한 이러한 지표를 표시합니다. RED 대시보드는 알림 및 SLA에 적합합니다. 잘 설계된 RED 대시보드는 사용자 경험을 위한 프록시 역할을 합니다.

자세한 내용은 Tom Wilkie의 [The RED method: How to instrument your services](https://grafana.com/blog/2018/08/02/the-red-method-how-to-instrument-your-services) 블로그 게시물을 참조하세요.

**네 가지 골든 신호**

[Google SRE 핸드북](https://landing.google.com/sre/sre-book/chapters/monitoring-distributed-systems/#xref_monitoring_golden-signals)에 따르면 사용자 대면 시스템의 지표 네 가지만 측정할 수 있는 경우 이 네 가지에 집중하세요.

이 방법은 RED 방법과 유사하지만 포화도를 포함합니다.
+ **지연 시간** - 요청을 처리하는 데 걸리는 시간.
+ **트래픽** - 시스템에 대한 수요.
+ **오류** - 실패한 요청의 비율.
+ **포화도** - 시스템이 '가득 찬' 정도.

## 대시보드 관리 성숙도 모델
<a name="v10-dash-management-maturity-model"></a>

*대시보드 관리 성숙도*는 대시보드 에코시스템이 얼마나 잘 설계되고 효율적인지 나타냅니다. 대시보드 설정을 주기적으로 검토하여 현재 상태와 개선 방법을 측정하는 것이 좋습니다.

일반적으로 대시보드 성숙도는 낮음, 중간 또는 높음으로 정의할 수 있습니다.

 이 주제에 대한 대부분의 콘텐츠는 KubeCon 2019 토크 [Fool-Proof Kubernetes Dashboards for Sleep-Deprived Oncalls](https://www.youtube.com/watch?v=YE2aQFiMGfY)에서 발췌했습니다.

**낮음 - 기본 상태**

이 단계에서는 일관된 대시보드 관리 전략이 없습니다. 거의 모든 사람이 여기에서 시작합니다.

현재 상태는 어떻게 알 수 있나요?
+ 누구나 대시보드를 수정할 수 있습니다.
+ 복사된 대시보드가 많으며, 대시보드 재사용이 거의 또는 전혀 없습니다.
+ 영구 지속되는 일회성 대시보드.
+ 버전 제어 없음(버전 제어의 대시보드 JSON).
+ 많은 대시보드 검색(올바른 대시보드를 찾기 위한 검색). 즉, 필요한 대시보드를 찾는 데 많은 시간이 낭비됩니다.
+ 올바른 대시보드로 안내하는 알림이 없습니다.

**중간 - 체계적인 대시보드**

이 단계에서는 체계적인 대시보드와 함께 사용하여 대시보드 사용을 관리하기 시작합니다. 전략을 세웠을 수도 있지만 개선할 사항이 몇 가지 있습니다.

 현재 상태는 어떻게 알 수 있나요?
+ 템플릿 변수를 사용하여 확장을 방지합니다. 예를 들어 각 노드에 대해 별도의 대시보드가 필요하지 않으므로 쿼리 변수를 사용할 수 있습니다. 또한 데이터 소스를 템플릿 변수로 만들 수 있으므로 다른 클러스터 및 모니터링 백엔드에서 동일한 대시보드를 재사용할 수 있습니다.

  아이디어는 [변수](v10-dash-variables.md)의 예제 목록을 참조하세요.
+ [관찰성 전략](#v10-dash-common-observability-strategies)에 따른 체계적 대시보드.
+ 다음 수준으로 드릴다운하는 계층적 대시보드.
+ 대시보드 설계는 서비스 계층 구조를 반영합니다. 예를 들어 서비스당 하나의 행으로 RED 방법을 사용할 수 있습니다. 행 순서는 대시보드를 아래로 스크롤할 때 데이터 흐름을 반영할 수 있습니다.
+ 비슷한 크기로 비교: 크기에 차이가 있을 때 서비스 대시보드를 분할합니다. 집계된 지표가 중요한 정보를 손상시키지 않도록 하세요.
+ 의미 있게 색상을 사용하고 가능하면 축을 정규화하는 다양한 표현의 차트.
  + 의미 있는 색상의 예: 파란색은 양호한 상태이고 빨간색은 불량한 상태입니다. [임계치](v10-panels-configure-thresholds.md)가 도움이 될 수 있습니다.
  + 축 정규화의 예: CPU 사용량을 비교할 때 시스템의 코어 수가 다를 수 있으므로 원시 수가 아닌 백분율로 측정합니다. 코어 수를 기준으로 CPU 사용량을 정규화하면 최종 사용자가 CPU 수를 알지 않고도 100%에서 모든 코어가 사용되고 있음을 신뢰할 수 있으므로 인지 부하가 줄어듭니다.
+ 직접 찾아보는 경우 추측이 줄어듭니다.
  + 템플릿 변수를 사용하면 무작위 또는 무의미한 찾아보기가 어렵습니다.
  + 대부분의 대시보드는 알림으로 연결되어야 합니다.
  + 찾아보기는 링크와 함께 표시됩니다. 자세한 내용은 [대시보드 링크 관리](v10-dash-manage-dashboard-links.md) 단원을 참조하십시오.
+  버전 제어 대시보드 JSON.

**높음 - 최적화된 사용**

이 단계에서는 일관되고 신중한 전략으로 대시보드 관리 사용을 최적화했습니다. 유지 관리가 필요하지만 그만한 성과를 얻을 수 있습니다.
+ 확장을 적극적으로 줄입니다.
  + 기존 대시보드를 정기적으로 검토하여 여전히 관련성이 있는지 확인합니다.
  + 마스터 대시보드 목록에는 승인된 대시보드만 추가되었습니다.
  + 대시보드 사용 추적. [사용량 인사이트](v10-dash-assess-dashboard-usage.md)를 활용할 수 있습니다.
+ 설계에서 지원하는 일관성.
+ 스크립팅 라이브러리를 사용하여 대시보드를 생성하고 패턴과 스타일의 일관성을 보장합니다.
  + grafonnet(Jsonnet)
  + grafanalib(Python)
+ 브라우저에 편집 기능이 없습니다. 대시보드 최종 사용자는 변수를 사용하여 보기를 변경합니다.
+ 대시보드 찾아보기는 규칙이 아닌 예외입니다.
+ 프로덕션 인스턴스가 아닌 해당 목적을 위한 별도의 Grafana 인스턴스에서 실험 및 테스트를 수행합니다. 테스트 환경의 대시보드가 유용한 것으로 입증되면 해당 대시보드를 기본 Grafana 인스턴스에 추가합니다.

## 대시보드 생성 모범 사례
<a name="v10-dash-best-practices-for-creating-dashboards"></a>

이 섹션에서는 Grafana 대시보드를 생성할 때 따라야 할 몇 가지 모범 사례를 간략하게 설명합니다.

**시작하기 전에**

 다음은 대시보드를 생성하기 전에 고려해야 할 몇 가지 원칙입니다.

**대시보드는 스토리를 전달하거나 질문에 답해야 합니다.**

대시보드로 어떤 스토리를 전달하려고 하나요? 대규모에서 소규모로 또는 일반에서 특정한 상황으로 데이터의 논리적 진행을 생성해 보세요. 이 대시보드의 목표는 무엇인가요? (힌트: 대시보드에 목표가 없는 경우 대시보드가 정말 필요한지 자문해 보세요.)

간단하게 그래프를 작성하고 질문하는 질문에 답변하는 데 집중하세요. 예를 들어, '어떤 서버에 문제가 있나요?'와 같은 질문의 경우 모든 서버 데이터를 표시할 필요가 없을 수 있습니다. 문제가 있는 데이터만 표시하면 됩니다.

**대시보드는 인지 부하를 줄여야 하며, 이를 더하지 않아야 합니다.**

*인지 부하*는 기본적으로 특정 정보를 파악하기 위해 생각해야 하는 노력을 말합니다. 쉽게 해석할 수 있도록 대시보드를 만드세요. 다른 사용자에게는 물론, 오전 2시에 일어나 상황을 파악하려고 하는 미래를 방지하려면 매우 중요한 기능입니다.

 다음을 스스로에게 물어보세요.
+ 각 그래프의 정확한 의미를 알 수 있나요? 의미가 명확한가요 아니면 더 검토해야 하나요?
+ 다른 사람에게 제시한 경우 의미를 파악하는 데 시간이 얼마나 걸리나요? 의미를 파악하지 못할까요?

**모니터링 전략 보유**

그러면 새 대시보드를 쉽게 만들 수 있습니다. 대시보드 생성을 최적화하고 계획을 준수하는 것이 더 어렵지만 그만한 가치가 있습니다. 이 전략에서는 전체 대시보드 체계를 모두 관리하고 개별 대시보드 설계에서 일관성을 적용해야 합니다.

자세한 내용은 [일반적인 관찰성 전략](#v10-dash-common-observability-strategies) 및 [대시보드 관리 성숙도](#v10-dash-management-maturity-model)를 참조하세요.

**기록**

전략 또는 설계 지침이 있으면 시간 경과에 따라 일관성을 유지하는 데 도움이 되도록 이를 기록합니다.

**모범 사례 준수**
+ 새 대시보드를 생성할 때 의미 있는 이름을 사용해야 합니다.
  + 재생 또는 실험할 대시보드를 생성하는 경우 `TEST` 또는 `TMP` 단어를 이름에 입력합니다.
  + 대시보드 이름에 또는 태그로 이름이나 이니셜을 포함시켜 사람들이 대시보드를 소유한 사람을 알 수 있도록 하는 것이 좋습니다.
  + 임시 실험 대시보드는 사용한 후에 제거합니다.
+ 관련 대시보드를 여러 개 생성하는 경우 쉽게 탐색할 수 있도록 상호 참조하는 방법을 생각해 보세요. 자세한 내용은 이 섹션 뒷부분의 [대시보드 관리 모범 사례](#v10-dash-best-practices-for-managing-dashboards)를 참조하세요.
+ Grafana는 데이터 소스에서 데이터를 검색합니다. 일반적으로 [데이터 원본에 연결](AMG-data-sources.md) 및 특정 데이터 소스에 대한 기본적인 이해가 중요합니다.
+ 네트워크 또는 백엔드에 대한 부하를 줄이도록 불필요한 대시보드 새로 고침을 피합니다. 예를 들어 데이터가 1시간마다 변경되면 대시보드 새로 고침 빈도를 30초로 설정할 필요가 없습니다.
+ 단위 또는 범위가 다른 시계열을 표시할 때는 왼쪽 및 오른쪽 Y축을 사용합니다.
+ 대시보드 및 패널에 설명서를 추가합니다.
  + 대시보드에 설명서를 추가하려면 대시보드에 [텍스트 패널 시각화](v10-panels-text.md)를 추가합니다. 대시보드의 목적, 유용한 리소스 링크 및 사용자가 대시보드와 상호 작용하는 데 필요할 수 있는 모든 지침을 기록합니다.
  + 패널에 설명서를 추가하려면 패널 설정을 편집하고 설명을 추가합니다. 패널의 왼쪽 상단에 있는 작은 `i`에 커서를 놓으면 추가한 텍스트가 표시됩니다.
+ [템플릿 및 변수](v10-dash-variables.md)를 사용하여 대시보드를 재사용하고 일관성을 적용합니다.
+ 그래프 데이터를 스택할 때 주의하세요. 시각화에 오해의 소지가 있으며 중요한 데이터를 숨길 수 있습니다. 대부분의 경우 끄는 것이 좋습니다.

## 대시보드 관리 모범 사례
<a name="v10-dash-best-practices-for-managing-dashboards"></a>

 이 페이지에서는 Grafana 대시보드를 관리할 때 따를 수 있는 몇 가지 모범 사례를 간략하게 설명합니다.

**시작하기 전에**

다음은 대시보드 관리를 시작하기 전에 고려해야 할 몇 가지 원칙입니다.

**전략적 관찰성**

몇 가지 [일반적인 관찰성 전략](#v10-dash-common-observability-strategies)이 있습니다. 이 전략을 검토하고 그 중 사용자에게 적합한 전략이 있는지 아니면 자체적으로 전략을 수립해야 하는지 결정해야 합니다. 어느 쪽이든 계획을 세우고 기록한 후 이를 준수합니다.

필요에 따라 변화하는 요구 사항에 맞게 전략을 조정합니다.

**성숙도 수준**

대시보드 성숙도 수준은 어느 정도인가요? 현재 대시보드 설정을 분석하고 [대시보드 관리 성숙도 모델](#v10-dash-management-maturity-model)과 비교합니다. 현재 상태를 파악하면 원하는 목표에 도달하는 방법을 결정하는 데 도움이 될 수 있습니다.

**모범 사례 준수**
+ 대시보드 확장(대시보드의 통제되지 않은 확장)을 방지하세요. 대시보드 확장은 올바른 대시보드를 찾는 데 걸리는 시간에 부정적인 영향을 미칩니다. 대시보드를 복제하고 '하나'만 변경하는 경우(원본 태그를 유지하는 경우 상황이 악화됨)가 가장 쉬운 확장 유형입니다.
  + 대시보드를 정기적으로 검토하고 불필요한 대시보드를 제거합니다.
  + 임시 대시보드를 생성하는 경우 테스트하려고 한다면 이름에 `TEST:` 접두사를 추가합니다. 완료되면 대시보드를 삭제합니다.
+ 큰 변경 사항이 없는 대시보드를 복사하는 것은 좋은 생각이 아닙니다.
  + 설명서 변경, 버그 수정 또는 지표에 추가와 같은 원본 대시보드에 대한 업데이트를 놓칠 수 있습니다.
  + 많은 경우 템플릿 파라미터를 설정하여 보기를 사용자 지정하기 위해 사본이 생성됩니다. 대신 마스터 대시보드에 대한 링크를 유지하고 [URL 파라미터](v10-panels-configure-data-links.md#v10-panels-data-link-variables)로 보기를 사용자 지정해야 합니다.
+ 대시보드를 복사해야 하는 경우 대시보드의 이름을 명확하게 바꾸고 대시보드 태그를 복사하지 *마세요*. 태그는 검색 중에 사용되는 대시보드의 중요한 메타데이터입니다. 태그를 복사하면 잘못된 일치가 발생할 수 있습니다.
+ 대시보드 또는 상호 참조 대시보드의 대시보드를 유지 관리합니다. 여러 방법으로 수행할 수 있습니다.
  + 대시보드 링크, 패널 또는 데이터 링크를 생성합니다. 링크는 다른 대시보드 또는 외부 시스템으로 이동할 수 있습니다. 자세한 내용은 [대시보드 링크 관리](v10-dash-manage-dashboard-links.md)를 참조하세요.
  +  [대시보드 목록 패널](v10-panels-dashboard-list.md)을 추가합니다. 그런 다음, 태그 또는 폴더 검색을 수행하여 표시되는 내용을 사용자 지정할 수 있습니다.
  + [텍스트 패널](v10-panels-dashboard-list.md)을 추가하고 마크다운을 사용하여 표시를 사용자 지정합니다.

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

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

워크스페이스의 **대시보드** 페이지에서(왼쪽 메뉴에서 **대시보드**를 선택하여 사용 가능) 대시보드를 폴더로 구성하는 등 대시보드 관리 작업을 수행할 수 있습니다.

대시보드 생성에 대한 자세한 내용은 [대시보드 빌드](v10-dash-building-dashboards.md) 섹션을 참조하세요

## 대시보드 찾아보기
<a name="v10-dash-browse-dashboards"></a>

**대시보드** 페이지에서 폴더와 대시보드를 찾아보고 관리할 수 있습니다. 여기에는 다음 옵션이 포함됩니다.
+ 폴더 및 대시보드를 생성합니다.
+ 폴더 사이에서 대시보드를 이동합니다.
+ 여러 대시보드 및 폴더를 삭제합니다.
+ 폴더로 이동합니다.
+ 폴더 권한을 관리합니다. 자세한 내용은 [대시보드 및 폴더 권한](dashboard-and-folder-permissions.md) 단원을 참조하십시오.

## 대시보드 폴더 생성
<a name="v10-dash-create-dashboard-folder"></a>

폴더는 대시보드를 구성하고 그룹화하는 데 도움이 되며, 이는 동일한 Grafana 인스턴스를 사용하는 대시보드가 많거나 여러 팀이 있는 경우에 유용합니다. 하위 폴더를 사용하면 대시보드 조직에서 중첩된 계층을 생성할 수 있습니다.

**사전 조건**

Grafana 관리자 권한이 있는지 확인합니다. 대시보드 권한에 대한 자세한 내용은 [대시보드 및 폴더 권한](dashboard-and-folder-permissions.md) 섹션을 참조하세요.

**대시보드 폴더를 생성하는 방법**

1. Grafana에 로그인하세요.

1. 왼쪽 메뉴에서 **대시보드**를 선택하세요.

1. **대시보드** 페이지에서 **새로 만들기**를 선택한 다음, 드롭다운에서 **새 폴더**를 선택하세요.

1. 고유한 이름을 입력하고 **생성**을 클릭하세요.

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

**폴더 이름을 편집하는 방법**

1. 왼쪽 메뉴에서 **대시보드**를 선택하세요.

1. 이름을 바꿀 폴더를 선택하세요.

1. 헤더에서 **제목 편집**(연필) 아이콘을 선택하고 폴더 이름을 업데이트하세요.

   새 폴더 이름이 자동으로 저장됩니다.

**폴더 권한**

폴더에 권한을 할당할 수 있습니다. 폴더의 대시보드는 폴더에 할당한 모든 권한을 상속합니다. 조직 역할, 팀 및 사용자에게 권한을 할당할 수 있습니다.

**폴더에 대한 권한을 수정하는 방법**

1. 왼쪽 메뉴에서 **대시보드**를 선택하세요.

1. 목록에서 폴더를 선택하세요.

1. 폴더의 세부 정보 페이지에서 **폴더 작업**을 선택하고 드롭다운 목록에서 **권한 관리**를 선택하세요.

1. 원하는 대로 권한을 업데이트하세요.

변경 내용은 자동으로 저장됩니다.

# 재생 목록 관리
<a name="v10-dash-managing-playlists"></a>

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

*재생 목록*은 순서대로 표시되는 대시보드 목록입니다. 재생 목록을 사용하여 상황 인식을 구축하거나 팀 또는 방문자에게 지표를 제시할 수 있습니다. Grafana는 모든 해상도로 대시보드를 자동으로 조정하므로 큰 화면에 적합합니다. Grafana 측 메뉴를 통해 **대시보드** 하위 메뉴에서 재생 목록 기능에 액세스할 수 있습니다.

## 재생 목록 액세스, 공유 및 제어
<a name="v10-dash-access-share-control-playlist"></a>

이 섹션의 정보를 사용하여 기존 재생 목록에 액세스합니다. 사용 가능한 다섯 가지 모드 중 하나를 사용하여 재생 목록 표시를 시작하고 제어합니다.

**재생 목록에 액세스하는 방법**

1. 왼쪽 메뉴에서 **재생 목록**을 선택하세요.

1. 기존 재생 목록 목록에서 재생 목록을 선택하세요.

**재생 목록 시작**

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

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

**재생 목록을 시작하는 방법**

1. 재생 목록 페이지에 액세스하여 기존 재생 목록 목록을 확인하세요.

1. 시작하려는 재생 목록을 찾은 다음, **재생 목록 시작**을 클릭하세요.

   재생 목록 시작 대화 상자가 열립니다.

1. 다음 표의 정보를 기반으로 사용 가능한 다섯 가지 재생 목록 모드 중 하나를 선택하세요.

1. **<재생 목록 이름> 시작**을 클릭하세요.

재생 목록에는 재생 목록을 생성하거나 편집할 때 설정된 `Interval` 필드에 지정된 시간 동안 각 대시보드가 표시됩니다. 재생 목록을 시작한 후에는 화면 상단의 탐색 표시줄을 사용하여 제어할 수 있습니다.


| Mode | 설명 | 
| --- | --- | 
| 일반 모드 |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/grafana/latest/userguide/v10-dash-managing-playlists.html)  | 
| TV 모드 |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/grafana/latest/userguide/v10-dash-managing-playlists.html)  | 
| TV 모드(자동 맞춤 패널 지원) |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/grafana/latest/userguide/v10-dash-managing-playlists.html)  | 
| 키오스크 모드 |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/grafana/latest/userguide/v10-dash-managing-playlists.html)  | 
| 키오스크 모드(자동 맞춤 패널 지원) |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/grafana/latest/userguide/v10-dash-managing-playlists.html)  | 

**재생 목록 제어**

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


| Button | 작업 | 
| --- | --- | 
| 다음(오른쪽 이중 화살표) | 다음 대시보드로 이동합니다. | 
| 뒤로(왼쪽 화살표) | 이전 대시보드로 돌아갑니다. | 
| 중지(사각형) | 재생 목록을 종료하고 현재 대시보드로 나갑니다. | 
| 주기 보기 모드(모니터 아이콘) | 다양한 보기 모드에서 대시보드의 표시를 순환합니다. | 
| 시간 범위 | 시간 범위 내의 데이터를 표시합니다. 아래쪽 화살표를 사용하여 최근 5분에서 최대 5년 전을 표시하도록 설정할 수 있습니다. | 
| 새로 고침(화살표에 동그라미 표시) | 대시보드를 다시 로드하여 현재 데이터를 표시합니다. 드롭다운 화살표를 사용하여 5초\$11일마다 자동으로 다시 로드하도록 설정할 수 있습니다. | 

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

재생 목록을 생성하여 대시보드 간에 설정된 순서와 시간 간격에 따라 순서대로 대시보드를 표시할 수 있습니다.

**재생 목록을 생성하는 방법**

1. 왼쪽 메뉴에서 **대시보드**를 선택하세요.

1. **재생 목록** 페이지에서 재생 목록을 선택하세요.

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

1. **이름** 텍스트 상자에 설명이 포함된 이름을 입력하세요.

1. **간격** 텍스트 상자에 시간 간격을 입력하세요. 추가하는 대시보드는 순차적으로 나열됩니다.

1. **대시보드**에서 **제목별 추가** 및 **태그별 추가** 드롭다운 옵션을 사용하여 재생 목록에 기존 대시보드를 추가하세요.

1. 선택적으로 다음을 수행하세요.
   + 이름, 정규식 또는 태그로 대시보드를 검색하세요.
   + 별표 상태 또는 태그를 기준으로 결과를 필터링하세요.
   + 위쪽 및 아래쪽 화살표 아이콘을 사용하여 추가한 대시보드의 순서를 재정렬하세요.
   + 대시보드 옆에 있는 **x** 아이콘을 클릭하여 재생 목록에서 대시보드를 제거하세요.

1. 변경 사항을 저장하려면 **저장**을 선택하세요.

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

재생 목록을 저장하고 **재생 목록** 페이지에 추가할 수 있습니다. 여기서 재생 목록을 시작할 수 있습니다.

**중요**  
재생 목록을 생성하거나 편집할 때 재생 목록에 표시하려는 모든 대시보드가 추가되었는지 확인한 후 저장합니다.

**재생 목록을 저장하는 방법**

1. 왼쪽 메뉴에서 **대시보드**를 선택하세요.

1. **재생 목록**을 선택하여 사용 가능한 재생 목록을 보세요.

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

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

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

1. 변경 사항을 저장하려면 **저장**을 선택하세요.

## 재생 목록 편집 또는 삭제
<a name="v10-dash-edit-delete-playlist"></a>

이름, 간격 시간을 업데이트하고 대시보드 순서를 추가, 제거 및 재정렬하여 재생 목록을 편집하거나 재생 목록을 삭제할 수 있습니다.

**재생 목록을 편집하는 방법**

1. 재생 목록 페이지에서 **재생 목록 편집**을 선택하세요.

1. 이름 및 시간 간격을 업데이트한 다음, 위의 재생 목록 생성의 지침을 사용하여 재생 목록에서 대시보드를 추가하거나 제거하세요.

1. 변경 사항을 저장하려면 **저장**을 선택하세요.

**재생 목록을 삭제하는 방법**

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

1. 삭제하려는 재생 목록 옆의 **제거**를 선택하세요.

**재생 목록에서 대시보드 순서를 재정렬하는 방법**

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

1. 변경 사항을 저장하려면 **저장**을 선택하세요.

**대시보드를 제거하는 방법**

1. **제거**를 선택하여 재생 목록에서 대시보드를 제거하세요.

1. 변경 사항을 저장하려면 **저장**을 선택하세요.

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

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

**보기 모드에서 재생 목록을 공유하는 방법**

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

1. 공유하려는 재생 목록 옆에 있는 **재생 목록 시작**을 선택하세요.

1. 드롭다운에서 원하는 보기 모드를 오른쪽 클릭하세요.

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

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

# 대시보드 및 패널 공유
<a name="v10-dash-sharing"></a>

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

Grafana를 사용하면 조직 내 다른 사용자와 대시보드 및 패널을 공유하고 특정 상황에서는 웹에서 공개적으로 공유할 수 있습니다. 다음을 사용하여 공유할 수 있습니다.
+ 직접 링크
+ 스냅샷
+ 내보내기 링크(대시보드만 해당)

직접 링크로 렌더링된 이미지를 보려면 승인된 최종 사용자 권한이 있어야 합니다.

패널 또는 대시보드를 스냅샷으로 공유하면 스냅샷(스냅샷을 생성한 시점의 패널 또는 대시보드)을 웹에서 공개적으로 사용할 수 있습니다. 링크가 있는 모든 사용자가 액세스할 수 있습니다. 스냅샷은 볼 수 있는 권한이 필요하지 않으므로 Grafana는 스냅샷을 가져오는 가져온 계정과 관련된 정보와 스냅샷의 민감한 데이터를 제거합니다.

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

대시보드를 직접 링크 또는 스냅샷으로 공유할 수 있습니다. 대시보드를 내보낼 수도 있습니다.

**참고**  
대시보드를 변경하는 경우 공유하기 전에 변경 사항을 저장해야 합니다.

**대시보드를 공유하는 방법**

1. 워크스페이스의 왼쪽 메뉴에서 **대시보드**를 선택하세요.

1. 공유할 대시보드를 선택하세요.

1. 화면 상단의 공유 아이콘을 선택하세요.

   공유 대화 상자가 열리고 **링크** 탭이 표시됩니다.

**직접 링크 공유**

**링크** 탭에는 현재 시간 범위, 템플릿 변수 및 기본 테마가 표시됩니다. 단축 URL을 공유할 수도 있습니다.

**직접 링크를 공유하는 방법**

1. **복사**를 선택합니다. 이 작업에서는 기본 URL 또는 단축 URL을 클립보드에 복사합니다.

1. 링크를 볼 수 있는 권한이 있는 Grafana 사용자에게 복사된 URL을 보내세요.

**스냅샷 게시**

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

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

**스냅샷을 게시하는 방법**

1. **스냅샷** 탭을 선택하세요.

1. **로컬 스냅샷**을 선택하세요.

1. Grafana에서 스냅샷 링크를 생성합니다. 스냅샷 링크를 복사하여 조직 내에서 공유하거나 웹에서 공개적으로 공유하세요.

**대시보드 내보내기**

Grafana 대시보드는 쉽게 내보내고 가져올 수 있습니다. 자세한 내용은 [대시보드 빌드](v10-dash-building-dashboards.md)의 가져오기 및 내보내기 섹션을 참조하세요.

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

패널을 직접 링크 또는 스냅샷으로 공유할 수 있습니다. 모든 패널에서 **공유** 옵션을 사용하여 라이브러리 패널을 생성할 수도 있습니다.

**패널을 공유하는 방법**

1. 공유할 패널의 패널 제목을 선택하세요. 패널 메뉴가 열립니다.

1. **공유**를 선택하세요. 공유 대화 상자가 열리고 **링크** 탭이 표시됩니다.

**직접 링크 사용**

**링크** 탭에는 현재 시간 범위, 템플릿 변수 및 기본 테마가 표시됩니다. 선택적으로 단축 URL을 공유하도록 활성화할 수 있습니다.

**직접 링크를 사용하는 방법**

1. **복사**를 선택하여 기본 URL 또는 단축 URL을 클립보드에 복사하세요.

1. 링크를 볼 수 있는 권한이 있는 Grafana 사용자에게 복사된 URL을 보내세요.

**패널의 스냅샷 게시**

패널 스냅샷은 대화형 패널의 공개적 공유 항목입니다. Grafana는 대시보드에 포함된 표시되는 지표 데이터와 시리즈 이름만 남기고 민감한 데이터를 제거합니다. 패널 스냅샷은 링크가 있는 모든 사용자가 액세스할 수 있습니다.

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

**패널의 스냅샷을 게시하는 방법**

1. **패널 공유** 대화 상자에서 **스냅샷** 탭을 선택하세요.

1. **로컬 스냅샷**을 선택하세요. Grafana에서 스냅샷 링크를 생성합니다.

1. 스냅샷 링크를 복사하여 조직 내에서 공유하거나 웹에서 공개적으로 공유하세요.

실수로 스냅샷을 생성한 경우 **스냅샷 삭제**를 클릭하여 Grafana 인스턴스에서 스냅샷을 제거하세요.

**라이브러리 패널 생성**

**패널 공유** 대화 상자에서 라이브러리 패널을 생성하는 방법.

**라이브러리 패널을 생성하는 방법**

1. **라이브러리 패널**을 선택하세요.

1. **라이브러리 패널 이름**에 이름을 입력하세요.

1. **폴더에 저장**에서 라이브러리 패널을 저장할 폴더를 선택하세요. 기본적으로 루트 폴더가 선택됩니다.

1. **라이브러리 패널 생성**을 선택하여 변경 사항을 저장하세요.

1. 대시보드를 저장합니다.

# 변수
<a name="v10-dash-variables"></a>

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

변수는 값의 자리표시자입니다. 지표 쿼리 및 패널 제목에서 변수를 사용할 수 있습니다. 따라서 대시보드 상단의 드롭다운을 사용하여 값을 변경하는 경우 패널의 지표 쿼리가 새 값을 반영하도록 변경됩니다.

변수를 사용하면 보다 동적이고 대화형 기능이 강화된 대시보드를 생성할 수 있습니다. 지표 쿼리에서 서버, 애플리케이션 및 센서 이름과 같은 사물을 하드 코딩하는 대신 해당 위치에서 변수를 사용할 수 있습니다. 변수는 대시보드 상단에 드롭다운 목록으로 표시됩니다. 이러한 드롭다운을 사용하면 대시보드에 표시되는 데이터를 쉽게 변경할 수 있습니다.

이는 Grafana 최종 사용자가 시각화를 빠르게 조정할 수 있도록 허용하되 전체 편집 권한을 부여하지 않으려는 관리자에게 특히 유용할 수 있습니다. Grafana 최종 사용자는 변수를 사용할 수 있습니다.

변수 및 템플릿을 사용하면 단일 소스 대시보드도 사용할 수 있습니다. 동일한 데이터 소스 또는 서버가 여러 개 있는 경우 하나의 대시보드를 만들고 변수를 사용하여 보고 있는 내용을 변경할 수 있습니다. 이를 통해 유지 관리가 크게 간소화됩니다.

**템플릿**

템플릿은 변수를 포함하는 모든 쿼리입니다. 예를 들어 여러 서버를 모니터링하기 위해 대시보드를 관리하는 경우 각 서버에 대해 대시보드를 만들거나 하나의 대시보드를 생성하고 다음과 같은 템플릿 쿼리가 있는 패널을 사용할 수 있습니다.

```
wmi_system_threads{instance=~"$server"}
```

변수 값은 항상 var-<varname>=value 구문을 사용하여 URL에 동기화됩니다.

**예시**

변수는 화면 상단의 드롭다운 목록에 나열됩니다. 시각화가 어떻게 변경되는지 보려면 다른 변수를 선택합니다.

변수 설정을 보려면 **대시보드 설정 > 변수**로 이동합니다. 목록에서 변수를 클릭하여 해당 설정을 확인합니다.

변수는 제목, 설명, 텍스트 패널 및 쿼리에 사용할 수 있습니다. `$`로 시작하는 텍스트가 있는 쿼리는 템플릿입니다. 모든 패널에 템플릿 쿼리가 있는 것은 아닙니다.

**변수 모범 사례**
+ 변수 드롭다운 목록은 **대시보드 설정**의 변수 목록에 나열된 순서대로 표시됩니다.
+ 자주 변경하는 변수를 맨 위에 배치하면 해당 변수가 먼저 표시됩니다(대시보드에서 맨 왼쪽).
+ 변수는 기본적으로 드롭다운 목록에서 최상위 값을 미리 선택합니다. 대신 빈 값을 선택하려면 다음과 같이 변수 설정을 변경합니다.

  1. **모든 옵션 포함** 확인란을 선택합니다.

  1. **모든 사용자 지정 값** 필드에 `+` 값을 입력합니다.

**Topics**
+ [변수 추가 및 관리](v10-dash-variable-add.md)
+ [변수 검사](v10-dash-variable-add-inspect.md)
+ [변수 구문](v10-dash-variable-syntax.md)

# 변수 추가 및 관리
<a name="v10-dash-variable-add"></a>

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

다음 표에는 Grafana의 변수 유형이 나열되어 있습니다.


| 변수 유형 | 설명 | 
| --- | --- | 
| Query | 지표 이름, 서버 이름, 센서 ID, 데이터 센터 등과 같은 쿼리 생성 값 목록. | 
| 사용자 지정 | 쉼표로 구분된 목록을 사용하여 변수 옵션을 수동으로 정의합니다. | 
| 텍스트 상자 | 선택적 기본값이 있는 자유 텍스트 입력 필드를 표시합니다. | 
| 상수 | 숨겨진 상수를 정의합니다. | 
| 데이터 소스 | 전체 대시보드의 데이터 소스를 빠르게 변경합니다. | 
| 간격 | 간격 변수는 시간 범위를 나타냅니다. | 
| 임시 필터 | 데이터 소스의 모든 지표 쿼리에 자동으로 추가되는 키-값 필터(Prometheus, Loki, InfluxDB 및 Elasticsearch만 해당). | 
| 전역 변수 | 쿼리 편집기의 표현식에 사용할 수 있는 기본 제공 변수. | 
| 체인 변수 | 변수 쿼리는 다른 변수를 포함할 수 있습니다. | 

**Topics**
+ [일반 옵션 입력](#v10-dash-variable-options)
+ [쿼리 변수 추가](#v10-dash-variable-add-query)
+ [사용자 지정 변수 추가](#v10-dash-variable-add-custom)
+ [텍스트 상자 변수 추가](#v10-dash-variable-add-text)
+ [상수 변수 추가](#v10-dash-variable-add-constant)
+ [데이터 소스 변수 추가](#v10-dash-variable-add-datasource)
+ [간격 변수 추가](#v10-dash-variable-add-internal)
+ [임시 필터 추가](#v10-dash-variable-add-adhoc)
+ [변수 선택 옵션 구성](#v10-dash-variable-add-selection)
+ [전역 변수](#v10-dash-variable-add-global)
+ [체인 변수](#v10-dash-variable-add-chained)
+ [변수 관리](#v10-dash-variable-add-manage)
+ [정규식으로 변수 필터링](#v10-dash-variable-add-filter)

## 일반 옵션 입력
<a name="v10-dash-variable-options"></a>

생성하는 모든 유형의 변수에 대한 일반 옵션을 입력해야 합니다.

**일반 옵션을 입력하는 방법**

1. 변수를 생성할 대시보드로 이동하여 페이지 상단의 **대시보드 설정**(톱니) 아이콘을 선택하세요.

1. **변수** 탭에서 **새 변수**를 선택하세요.

1. 변수의 **이름**을 입력하세요.

1. **유형** 목록에서 **쿼리**를 선택하세요.

1. (선택 사항) **레이블**에 변수 드롭다운의 표시 이름을 입력하세요.

   표시 이름을 입력하지 않으면 드롭다운 레이블이 변수 이름입니다.

1. **숨기기** 옵션을 선택하세요.
   + **선택 사항 없음(비어 있음)** - 변수 드롭다운에 변수 **이름** 또는 **레이블** 값이 표시됩니다.
   + **레이블** - 변수 드롭다운에는 선택한 변수 값과 아래쪽 화살표만 표시됩니다.
   + **변수** - 대시보드에 변수 드롭다운이 표시되지 않습니다.

## 쿼리 변수 추가
<a name="v10-dash-variable-add-query"></a>

쿼리 변수를 사용하면 지표 이름, 태그 값 또는 키 목록을 반환할 수 있는 데이터 소스 쿼리를 작성할 수 있습니다. 예를 들어 쿼리 변수는 서버 이름, 센서 IDs 또는 데이터 센터 목록을 반환할 수 있습니다. 변수 값은 데이터 소스 쿼리를 사용하여 옵션을 동적으로 가져올 때 변경됩니다.

쿼리 변수는 일반적으로 문자열에서만 지원됩니다. 쿼리에서 숫자 또는 기타 데이터 유형을 반환하는 경우 이를 변수로 사용하려면 문자열로 변환해야 할 수 있습니다. 예를 들어 Azure 데이터 소스의 경우 이 용도로 [tostring](https://docs.microsoft.com/en-us/azure/data-explorer/kusto/query/tostringfunction) 함수를 사용할 수 있습니다.

쿼리 표현식에는 다른 변수에 대한 참조가 포함될 수 있으며 실제로 연결된 변수를 생성할 수 있습니다. Grafana에서 이를 감지하고 연결된 변수 중 하나가 변경될 때 자동으로 변수를 새로 고칩니다.

**참고**  
쿼리 표현식은 데이터 소스마다 다릅니다. 자세한 내용은 [데이터 소스](AMG-data-sources.md)에 대한 설명서를 참조하세요.

**쿼리 변수를 추가하는 방법**

1. 위와 같이 일반 옵션을 입력하세요.

1. **데이터 소스** 목록에서 쿼리의 대상 데이터 소스를 선택하세요.

1. **새로 고침** 목록에서 변수가 옵션을 업데이트해야 하는 시기를 선택하세요.
   + **대시보드 로드 시** - 대시보드가 로드될 때마다 데이터 소스를 쿼리합니다. 이 경우 대시보드를 초기화하기 전에 변수 쿼리를 완료해야 하므로 대시보드 로드가 느려집니다.
   + **시간 범위 변경 시** - 대시보드 시간 범위가 변경될 때 데이터 소스를 쿼리합니다. 변수 옵션 쿼리에 시간 범위 필터가 포함되어 있거나 대시보드 시간 범위에 따라 달라지는 경우에만 이 옵션을 사용하세요.

1. **쿼리** 필드에 쿼리를 입력하세요.
   + 쿼리 필드는 데이터 소스에 따라 다릅니다. 일부 데이터 소스에는 사용자 지정 쿼리 편집기가 있습니다.
   + 쿼리는 `__text` 및 `__value`라는 값을 반환해야 합니다. 예를 들어 SQL에서는 `SELECT hostname AS __text, id AS __value from MyTable`과 같은 쿼리를 사용할 수 있습니다. 다른 언어에 대한 쿼리는 구문에 따라 달라집니다.
   + 단일 입력 필드 쿼리 편집기에 더 많은 공간이 필요한 경우 필드의 오른쪽 하단에 있는 선 위에 커서를 놓고 아래로 끌어 확장하세요.

1. (선택 사항) **정규식** 필드에 정규식을 입력하여 데이터 소스 쿼리에서 반환된 이름의 특정 부분을 필터링하거나 캡처하세요. 예제를 보려면 [정규식으로 변수 필터링](#v10-dash-variable-add-filter)을 참조하세요.

1. **정렬** 목록에서 드롭다운 목록에 표시할 값의 정렬 순서를 선택하세요. 기본 옵션, **비활성화됨**은 데이터 소스 쿼리에서 반환된 옵션 순서가 사용됨을 의미합니다.

1. (선택 사항) [선택 옵션](#v10-dash-variable-add-selection)을 입력하세요.

1. **값 미리 보기**에서 Grafana는 현재 변수 값 목록을 표시합니다. 이를 검토하여 예상한 내용과 일치하는지 확인하세요.

1. **추가**를 선택하여 대시보드에 변수를 추가하세요.

## 사용자 지정 변수 추가
<a name="v10-dash-variable-add-custom"></a>

숫자 또는 문자열과 같이 변경되지 않는 값에 대해 *사용자 지정* 변수를 사용합니다.

예를 들어 변경되지 않은 서버 이름이나 리전 이름이 있는 경우 쿼리 변수가 아닌 사용자 지정 변수로 생성할 수 있습니다. 변경되지 않으므로 다른 쿼리 변수가 아닌 [체인 변수](#v10-dash-variable-add-chained)에서 사용할 수 있습니다. 이 경우 체인 변수가 업데이트될 때 Grafana에서 전송해야 하는 쿼리 수가 줄어듭니다.

**사용자 지정 변수를 추가하는 방법**

1. 위와 같이 일반 옵션을 입력하세요.

1. **쉼표로 구분된 값** 목록에서 쉼표로 구분된 목록에 이 변수의 값을 입력하세요. 공백과 콜론으로 구분된 숫자, 문자열 또는 키-값 페어를 포함할 수 있습니다. 예를 들어 `key1 : value1,key2 : value2`입니다.

1. (선택 사항) [선택 옵션](#v10-dash-variable-add-selection)을 입력하세요.

1. **값 미리 보기**에서 Grafana는 현재 변수 값 목록을 표시합니다. 이를 검토하여 예상한 내용과 일치하는지 확인하세요.

1. **추가**를 선택하여 대시보드에 변수를 추가하세요.

## 텍스트 상자 변수 추가
<a name="v10-dash-variable-add-text"></a>

*텍스트 상자* 변수는 선택적 기본값이 있는 자유 텍스트 입력 필드를 표시합니다. 값을 입력할 수 있으므로 이 변수가 가장 유연한 변수입니다. 카디널리티가 높은 지표가 있거나 대시보드에서 여러 패널을 동시에 업데이트하려는 경우 이 유형의 변수를 사용합니다.

**텍스트 상자 변수를 추가하는 방법**

1. 위와 같이 일반 옵션을 입력하세요.

1. (선택 사항) **기본값** 필드에서 변수의 기본값을 선택하세요. 이 필드에 아무 것도 입력하지 않으면 Grafana는 사용자가 텍스트를 입력할 수 있는 빈 텍스트 상자를 표시합니다.

1. **값 미리 보기**에서 Grafana는 현재 변수 값 목록을 표시합니다. 이를 검토하여 예상한 내용과 일치하는지 확인하세요.

1. **추가**를 선택하여 대시보드에 변수를 추가하세요.

## 상수 변수 추가
<a name="v10-dash-variable-add-constant"></a>

*상수* 변수를 사용하면 숨겨진 상수를 정의할 수 있습니다. 공유하려는 대시보드의 지표 경로 접두사에 유용합니다. 대시보드를 내보내면 상수 변수가 가져오기 옵션으로 변환됩니다.

상수 변수는 유연하지 *않습니다*. 각 상수 변수는 하나의 값만 보유하며 변수 설정을 업데이트하지 않으면 업데이트할 수 없습니다.

상수 변수는 쿼리에 포함해야 하지만 모든 쿼리에 다시 입력하지 않으려는 복잡한 값이 있는 경우에 유용합니다. 예를 들어 `i-0b6a61efe2ab843gg`라는 서버 경로가 있는 경우 `$path_gg`라는 변수로 바꿀 수 있습니다.

**상수 변수를 추가하는 방법**

1. 위와 같이 일반 옵션을 입력하세요.

1. **값** 필드에 변수 값을 입력하세요. 문자, 숫자 및 기호를 입력할 수 있습니다. [원시 형식](v10-dash-variable-syntax.md#v10-dash-variable-syntax-raw)을 사용하는 경우 와일드카드도 사용할 수 있습니다.

1. **값 미리 보기**에서 Grafana는 현재 변수 값 목록을 표시합니다. 이를 검토하여 예상한 내용과 일치하는지 확인하세요.

1. **추가**를 선택하여 대시보드에 변수를 추가하세요.

## 데이터 소스 변수 추가
<a name="v10-dash-variable-add-datasource"></a>

*데이터 소스* 변수를 사용하면 전체 대시보드의 데이터 소스를 빠르게 변경할 수 있습니다. 여러 환경에서 데이터 소스의 인스턴스가 여러 개 있는 경우 유용합니다.

**데이터 소스를 추가하는 방법**

1. 위와 같이 일반 옵션을 입력하세요.

1. **유형** 목록에서 변수의 대상 데이터 소스를 선택하세요.

   **고급 데이터 소스 선택기 열기**를 선택하여 데이터 소스 추가(관리자만 해당)를 포함한 추가 옵션을 볼 수도 있습니다. 자세한 내용은 [데이터 원본에 연결](AMG-data-sources.md) 단원을 참조하십시오.

1. (선택 사항) **인스턴스 이름 필터**에 변수 값 드롭다운 목록에서 선택할 데이터 소스 인스턴스의 정규식 필터를 입력하세요. 모든 인스턴스를 표시하려면 이 필드를 비워 두세요.

1. (선택 사항) [선택 옵션](#v10-dash-variable-add-selection)을 입력하세요.

1. **값 미리 보기**에서 Grafana는 현재 변수 값 목록을 표시합니다. 이를 검토하여 예상한 내용과 일치하는지 확인하세요.

1. **추가**를 선택하여 대시보드에 변수를 추가하세요.

## 간격 변수 추가
<a name="v10-dash-variable-add-internal"></a>

*간격* 변수를 사용하여 `1m`, `1h` 또는 `1d`와 같은 시간 범위를 나타냅니다. 이를 대시보드 전체에 적용되는 **group by time 명령으로 간주할 수 있습니다. 간격 변수는 시각화에서 데이터를 그룹화하는 방법을 변경합니다. 자동 옵션을 사용하여 시간 범위당 설정된 데이터 포인트 수를 반환할 수도 있습니다.

간격 변수를 그룹화 시간 파라미터(InfluxDB의 경우), 날짜 히스토그램 간격(Elasticsearch의 경우) 또는 summarize 함수 파라미터(Graphite의 경우)로 사용할 수 있습니다.

**간격 변수를 추가하는 방법**

1. 위와 같이 일반 옵션을 입력하세요.

1. **값** 필드에 변수 드롭다운 목록에서 표시할 시간 범위 간격을 입력하세요. `s (seconds)`, `m (minutes)`, `h (hours)`, `d (days)`, `w (weeks)`, `M (months)`, `y (years)`와 같은 시간 단위가 지원됩니다. 기본값(`1m,10m,30m,1h,6h,12h,1d,7d,14d,30d`)을 수락하거나 편집할 수도 있습니다.

1. (선택 사항) 목록에 `auto` 옵션을 추가하려면 **자동 옵션**을 켜세요. 이 옵션을 사용하면 현재 `auto` 시간 범위를 계산하기 위해 현재 시간 범위를 분할해야 하는 횟수를 지정할 수 있습니다. 이 기능을 켜면 두 가지 추가 옵션이 나타납니다.
   + **단계 수** - **최대 데이터 포인트** 쿼리 옵션과 마찬가지로 값을 계산하기 위해 현재 시간 범위를 분할하는 횟수를 선택합니다. 예를 들어 현재 표시되는 시간 범위가 30분인 경우 `auto` 간격은 데이터를 30분 단위로 그룹화합니다. 기본값은 30개의 단계입니다.
   + **최소 간격** - 단계 수 간격에서 시간을 나누지 않는 최소 임계치. 30분 예제를 계속하려면 최소 간격이 2m로 설정된 경우 Grafana는 데이터를 15분 증분 단위로 그룹화합니다.

1. **값 미리 보기**에서 Grafana는 현재 변수 값 목록을 표시합니다. 이를 검토하여 예상한 내용과 일치하는지 확인하세요.

1. **추가**를 선택하여 대시보드에 변수를 추가하세요.

**간격 변수 예제**

다음 예제에서는 Graphite 함수에서 템플릿 변수 `myinterval`을 보여줍니다.

```
summarize($myinterval, sum, false)
```

## 임시 필터 추가
<a name="v10-dash-variable-add-adhoc"></a>

*임시 필터*를 사용하면 지정된 데이터 소스를 사용하는 모든 지표 쿼리에 자동으로 추가되는 키-값 필터를 추가할 수 있습니다. 다른 변수와 달리 쿼리에서 임시 필터를 사용하지 않습니다. 대신 임시 필터를 사용하여 기존 쿼리에 대한 필터를 작성합니다.

**참고**  
임시 필터 변수는 Prometheus, Loki, InfluxDB 및 Elasticsearch 데이터 소스에서만 작동합니다.

1. 위와 같이 일반 옵션을 입력하세요.

1. **데이터 소스** 목록에서 대상 데이터 소스를 선택합니다.

   **고급 데이터 소스 선택기 열기**를 선택하여 데이터 소스 추가(관리자만 해당)를 포함한 추가 옵션을 볼 수도 있습니다. 자세한 내용은 [데이터 원본에 연결](AMG-data-sources.md) 단원을 참조하십시오.

1. **추가**를 선택하여 대시보드에 변수를 추가하세요.

**임시 필터 생성**

임시 필터는 가장 복잡하고 유연한 가용 변수 옵션 중 하나입니다. 변수 옵션의 일반적인 목록 대신 이 변수를 사용하면 대시보드 전반의 임시 쿼리를 빌드할 수 있습니다. 이러한 방식으로 적용하는 필터는 대시보드의 모든 패널에 적용됩니다.

## 변수 선택 옵션 구성
<a name="v10-dash-variable-add-selection"></a>

*선택 옵션*은 변수 옵션 선택을 관리하는 데 사용할 수 있는 기능입니다. 모든 선택 옵션은 선택 사항이며 기본적으로 꺼져 있습니다.

### 다중 값 변수
<a name="v10-dash-variable-add-selection-multi"></a>

선택한 다중 값 변수 보간은 변수가 사용되는 지정된 컨텍스트에서 유효한 문자열로 다중 값 형식을 지정하는 방법이 간단하지 않기 때문에 어렵습니다. Grafana는 각 데이터 소스 플러그인이 템플릿 지정 보간 엔진에 다중 값에 사용할 형식을 알릴 수 있도록 함으로써 이 문제를 해결하려고 합니다.

**참고**  
Grafana가 모든 값을 단일 문자열 형식으로 지정하려면 변수의 **모든 사용자 지정 값** 옵션이 비어 있어야 합니다. 비워 두면 Grafana에서는 쿼리의 모든 값을 연결(함께 추가)합니다. 예를 들어 `value1,value2,value3`입니다. 사용자 지정 `all` 값을 사용하는 경우 대신 값은 `*` 또는 `all`입니다.

**Graphite 데이터 소스에서 다중 값 변수**

Graphite에서는 glob 표현식을 사용합니다. 이 경우 다중 값 변수는 현재 값이 *host1*, *host2* 및 *host3*인 것처럼 `{host1,host2,host3}`으로 보간됩니다.

**Prometheus 또는 InfluxDB 데이터 소스에서 다중 값 변수**

InfluxDB 및 Prometheus는 정규식을 사용하므로 동일한 변수가 `(host1|host2|host3)`으로 보간됩니다. 또한 모든 값이 정규식으로 이스케이프 처리됩니다. 그렇지 않은 경우 정규식 제어 문자가 있는 값으로 인해 정규식이 손상됩니다.

**탄력적 데이터 소스에서 다중 값 변수**

Elasticsearch는 Lucene 쿼리 구문을 사용하므로 동일한 변수가 `("host1" OR "host2" OR "host3")` 형식으로 지정됩니다. 이 경우 모든 값이 이스케이프 처리되므로 값에는 Lucene 제어 단어와 따옴표만 포함됩니다.

**다중 값 변수 문제 해결**

자동 이스케이프 처리 및 형식 지정은 문제를 일으킬 수 있으며 이후 로직을 포착하기 까다로울 수 있습니다. 특히 정규식 구문을 사용하려면 정규식 연산자 컨텍스트에서 변수를 사용해야 하는 InfluxDB 및 Prometheus의 경우에 더 까다롭습니다.

Grafana에서 이 자동 정규식 이스케이프 처리 및 형식 지정을 수행하지 않도록 하려면 다음 중 하나를 수행해야 합니다.
+ **다중 값** 또는 **모든 옵션 포함** 옵션을 끕니다.
+ [원시 형식](v10-dash-variable-syntax.md#v10-dash-variable-syntax-raw)을 사용합니다.

### 모두 포함 옵션
<a name="v10-dash-variable-add-multi-all"></a>

Grafana는 변수 드롭다운 목록에 `All` 옵션을 추가합니다. 사용자가 이 옵션을 선택하면 모든 변수 옵션이 선택됩니다.

### 모든 값 사용자 지정
<a name="v10-dash-variable-add-multi-custom"></a>

이 옵션은 **모든 옵션 포함**을 선택한 경우에만 표시됩니다.

**모든 값 사용자 지정** 필드에 정규식, glob 또는 Lucene 구문을 입력하여 `All` 옵션의 값을 정의합니다.

기본적으로 `All` 값에는 결합된 표현식의 모든 옵션이 포함됩니다. 그러면 매우 길고 성능 문제가 있을 수 있습니다. 와일드카드 정규식과 같이 모든 사용자 지정 값을 지정하는 것이 더 나을 수 있습니다.

**모든 사용자 지정 값** 옵션에 사용자 지정 정규식, glob 또는 Lucene 구문을 포함하려면 이스케이프 처리되지 않으므로 데이터 소스에 유효한 값이 무엇인지 생각해야 합니다.

## 전역 변수
<a name="v10-dash-variable-add-global"></a>

Grafana에는 쿼리 편집기의 표현식에 사용할 수 있는 전역 기본 제공 변수가 있습니다. 이 주제에서는 사전순으로 나열하고 정의합니다. 이러한 변수는 쿼리, 대시보드 링크, 패널 링크 및 데이터 링크에 유용합니다.

**\$1\$1\$1dashboard**

이 변수는 현재 대시보드의 이름입니다.

**\$1\$1\$1from 및 \$1\$1\$1to**

Grafana에는 `$__from` 및 `$__to`의 두 가지 기본 제공 시간 범위 변수가 있습니다. 현재는 기본적으로 에포크 밀리초로 보간되지만 날짜 형식을 제어할 수 있습니다.


| 구문 | 결과 예제 | 설명 | 
| --- | --- | --- | 
|  `${__from}`  |  1594671549254  |  Unix 밀리초 에포크  | 
|  `${__from:date}`  |  2020-07-13T20:19:09.254Z  |  인수 없음, 기본값: ISO 8601/RFC 3339  | 
|  `${__from:date:iso}`  |  2020-07-13T20:19:09.254Z  |  ISO 8601/RFC 3339  | 
|  `${__from:date:seconds}`  |  1594671549  |  Unix 초 에포크  | 
|  `${__from:date:YYYY-MM}`  |  2020-07  |  : 문자를 포함하지 않는 사용자 지정 날짜 형식  | 

위의 구문은 `${__to}`에서도 작동합니다.

**\$1\$1\$1interval**

`$__interval` 변수를 그룹화 시간 파라미터(InfluxDB, MySQL, Postgres, MSSQL의 경우), 날짜 히스토그램 간격(Elasticsearch의 경우) 또는 **summarize 함수 파라미터(Graphite의 경우)로 사용할 수 있습니다.

Grafana는 쿼리에서 시간별로 그룹화하는 데 사용할 수 있는 간격을 자동으로 계산합니다. 그래프에 표시할 수 있는 것보다 많은 데이터 포인트가 있는 경우 더 큰 간격으로 그룹화하여 쿼리의 효율성을 개선할 수 있습니다. 예를 들어 3개월 분량의 데이터 그래프를 보는 경우 분 단위로 세부 정보를 보지 못할 수도 있습니다. 시간 또는 일별로 그룹화하면 그래프에 표시되는 내용에 영향을 주지 않고 쿼리의 효율성을 개선할 수 있습니다. `$__interval`은 그래프의 시간 범위와 너비(픽셀 수)를 사용하여 계산됩니다.

대략적인 계산: `(to - from) / resolution`

예를 들어, 시간 범위가 1시간이고 그래프가 전체 화면인 경우 간격은 `2m`으로 계산될 수 있습니다. 포인트는 2분 간격으로 그룹화됩니다. 시간 범위가 6개월이고 그래프가 전체 화면인 경우 간격은 `1d`(1일)일 수 있습니다. 포인트는 일별로 그룹화됩니다.

InfluxDB 데이터 소스에서 레거시 변수 `$interval`은 동일한 변수입니다. 대신 `$__interval`을 사용해야 합니다.

InfluxDB 및 Elasticsearch 데이터 소스에는 간격을 하드 코딩하거나 `$__interval` 변수에 대한 최소 제한을 설정하는 데 사용되는 `Group by time interval` 필드가 있습니다(`>` 구문 사용, 예: `>10m`).

**\$1\$1\$1interval\$1ms**

이 변수는 시간 간격 형식 문자열이 아닌 밀리초 단위의 `$__interval` 변수입니다. 예를 들어 `$__interval`이 `20m`이면 `$__interval_ms`는 `1200000`입니다.

**\$1\$1\$1org**

이 변수는 현재 조직의 ID입니다. `${__org.name}`은 현재 조직의 이름입니다.

**\$1\$1\$1user**

`${__user.id}`는 현재 사용자의 ID입니다. `${__user.login}`은 현재 사용자의 로그인 핸들입니다. `${__user.email}`은 현재 사용자의 이메일입니다.

**\$1\$1\$1range**

Prometheus 및 Loki 데이터 소스에 대해서만 지원됩니다. 이 변수는 현재 대시보드의 범위를 나타냅니다. `to - from`에 의해 계산됩니다. `$__range_ms` 및 `$__range_s`와 같은 밀리초 및 초 표현을 사용합니다.

**\$1\$1\$1rate\$1interval**

Prometheus 데이터 소스에 대해서만 지원됩니다. `$__rate_interval` 변수는 비율 함수에 사용하기 위해 제공됩니다.

**\$1timeFilter 또는 \$1\$1\$1timeFilter**

`$timeFilter` 변수는 현재 선택한 시간 범위를 표현식으로 반환합니다. 예를 들어 시간 범위 간격 `Last 7 days` 표현식은 `time > now() - 7d`입니다.

이는 다음을 포함한 여러 곳에서 사용됩니다.
+ InfluxDB 데이터 소스의 WHERE 절. Grafana는 쿼리 편집기 모드에서 InfluxDB 쿼리에 이를 자동으로 추가합니다. 텍스트 편집기 모드에서 수동으로 추가할 수 있습니다(`WHERE $timeFilter`).
+ Azure Monitor 데이터 소스의 Log Analytics 쿼리.
+ MySQL, Postgres 및 MSSQL의 SQL 쿼리.
+ `$__timeFilter` 변수는 MySQL 데이터 소스에서 사용됩니다.

**\$1\$1\$1timezone**

`$__timezone` 변수는 현재 선택한 시간대(`utc`) 또는 IANA 시간대 데이터베이스의 항목(예: `America/New_York`)을 반환합니다.

현재 선택한 시간대가 *브라우저 시간*인 경우 Grafana는 브라우저 시간대를 확인하려고 시도합니다.

## 체인 변수
<a name="v10-dash-variable-add-chained"></a>

*체인 변수*(*연결된 변수* 또는 *중첩된 변수*라고도 함)는 변수 쿼리에 하나 이상의 다른 변수를 포함하는 쿼리 변수입니다.

체인 변수 쿼리는 모든 데이터 소스에서 다르지만, 전제는 모든 데이터 소스에서 동일합니다. 이를 허용하는 모든 데이터 소스에서 체인 변수 쿼리를 사용할 수 있습니다.

매우 복잡한 연결된 템플릿 대시보드가 나타날 수 있으며, 깊이는 5\$110의 수준입니다. 엄밀히 말하면 깊이나 복잡성에는 제한이 없지만 링크가 많을수록 쿼리 로드가 커집니다.

**모범 사례 및 팁**

다음 방법을 사용하면 대시보드와 변수를 더 쉽게 사용할 수 있습니다.

**연결된 새 변수 생성**
+ 변수를 체인화하면 상위/하위 종속 항목이 생성됩니다. 사다리나 트리로 구상할 수 있습니다.
+ 새 체인 변수를 생성하는 가장 쉬운 방법은 새 변수를 기반으로 할 변수를 복사하는 것입니다. 변수 목록에서 변수 항목 오른쪽에 있는 변수 **복제** 아이콘을 클릭하여 사본을 생성합니다. 그런 다음, 상위 변수에 대한 쿼리에 추가할 수 있습니다.
+ 이렇게 생성된 새 변수는 목록 하단에 표시됩니다. 논리적 순서로 가져오려면 목록의 다른 위치로 끌어야 할 수 있습니다.

**변수 순서**

각 항목의 오른쪽에 있는 위쪽 및 아래쪽 화살표를 클릭하여 대시보드 변수 목록에서 변수의 순서를 변경할 수 있습니다. Grafana는 이 목록에 따라 왼쪽에서 오른쪽으로 변수 드롭다운을 나열하고 이때 변수는 맨 왼쪽 상단에 위치합니다.
+ 종속 항목이 없는 변수는 하위 변수 앞, 맨 위에 나열합니다.
+ 각 변수는 종속된 항목을 따라야 합니다.
+ UI에는 종속 관계가 있는 변수에 대한 표시가 없습니다. 사용자 및 다른 사용자가 쉽게 사용할 수 있도록 변수를 논리적 순서로 나열합니다.

**복잡성 고려 사항**

변수에 종속 항목 계층이 많을수록 변수를 변경한 후 대시보드를 업데이트하는 데 시간이 오래 걸립니다.

예를 들어 연결된 변수(국가, 리전, 서버, 지표)가 네 개이고 루트 변수 값(국가)을 변경하는 경우 Grafana는 대시보드의 시각화를 업데이트하기 전에 모든 종속 변수에 대한 쿼리를 실행해야 합니다.

## 변수 관리
<a name="v10-dash-variable-add-manage"></a>

변수 페이지에서는 변수를 추가하고 기존 변수를 관리할 수 있습니다. 또한 변수를 [검사](v10-dash-variable-add-inspect.md)하고 변수가 다른 변수나 대시보드에서 참조 또는 사용되고 있는지 식별할 수 있습니다.

**이동** - 끌어서 놓기를 사용하여 변수를 목록 위 또는 아래로 이동할 수 있습니다.

**복제** - 변수를 복제하려면 오른쪽에 있는 아이콘 세트에서 복제 아이콘을 클릭합니다. 이렇게 하면 접두사가 `copy_of_`인 원본 변수의 이름을 사용하는 변수의 사본이 생성됩니다.

**삭제** - 변수를 삭제하려면 오른쪽에 있는 아이콘 세트에서 휴지통 아이콘을 클릭합니다.

## 정규식으로 변수 필터링
<a name="v10-dash-variable-add-filter"></a>

정규식 쿼리 옵션을 사용하여 변수 쿼리에서 반환된 옵션 목록을 필터링하거나 반환된 옵션을 수정합니다.

이 페이지에서는 정규식을 사용하여 변수 드롭다운에서 값을 필터링/수정하는 방법을 보여줍니다.

정규식 쿼리 옵션을 사용하여 변수 쿼리에서 반환된 옵션 목록을 필터링하거나 반환된 옵션을 수정합니다. 자세한 내용은 Mozilla 안내서의 [Regular expressions](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Guide/Regular_Expressions)를 참조하세요.

다음 예제에서는 다음 옵션 목록에 대한 필터링을 보여줍니다.

```
backend_01
backend_02
backend_03
backend_04
```

**`01` 또는 `02`로 끝나는 옵션만 반환되도록 필터링**

정규식:

```
/
(
01|02 
) 
$/
```

결과:

```
backend_01
backend_02
```

**정규식 캡처 그룹을 사용해 옵션을 필터링 및 수정하여 텍스트의 일부를 반환합니다.**

정규식:

```
/.* 
(
01|02 
)
/
```

결과:

```
01
02
```

**필터링 및 수정 - Prometheus 예제**

이 옵션 목록의 경우:

```
up{instance="demo.robustperception.io:9090",job="prometheus"} 1 1521630638000
up{instance="demo.robustperception.io:9093",job="alertmanager"} 1 1521630638000
up{instance="demo.robustperception.io:9100",job="node"} 1 1521630638000
```

이 정규식의 경우:

```
/. *instance="
(
[^"]*
)
.*/
```

다음 결과를 반환합니다.

```
demo.robustperception.io:9090
demo.robustperception.io:9093
demo.robustperception.io:9100
```

**이름 지정된 텍스트 및 값 캡처 그룹을 사용하여 필터링 및 수정**

이름 지정된 캡처 그룹을 사용하여 변수 쿼리에서 반환된 옵션과 별도의 '텍스트' 및 '값' 부분을 캡처할 수 있습니다. 이렇게 하면 변수 드롭다운 목록에 선택할 수 있는 각 값에 대한 친숙한 이름이 포함될 수 있습니다.

예를 들어 `node_hwmon_chip_names` Prometheus 지표를 쿼리할 때 `chip_name`은 `chip` 값보다 훨씬 더 친숙합니다. 따라서 다음과 같은 변수 쿼리 결과가 생성됩니다.

```
node_hwmon_chip_names{chip="0000:d7:00_0_0000:d8:00_0",chip_name="enp216s0f0np0"} 1
node_hwmon_chip_names{chip="0000:d7:00_0_0000:d8:00_1",chip_name="enp216s0f0np1"} 1
node_hwmon_chip_names{chip="0000:d7:00_0_0000:d8:00_2",chip_name="enp216s0f0np2"} 1
node_hwmon_chip_names{chip="0000:d7:00_0_0000:d8:00_3",chip_name="enp216s0f0np3"} 1
```

다음 정규식을 통해 전달됩니다.

```
/chip_name="(?<text>[ ^ " ] + ) |chip=" (?<value >[ ^ " ] + )/g
```

다음 드롭다운 목록을 생성합니다.

```
Display Name          Value
------------          -------------------------
enp216s0f0np0         0000:d7:00_0_0000:d8:00_0
enp216s0f0np1         0000:d7:00_0_0000:d8:00_1
enp216s0f0np2         0000:d7:00_0_0000:d8:00_2
enp216s0f0np3         0000:d7:00_0_0000:d8:00_3
```

`text` 및 `value` 캡처 그룹 이름만 지원됩니다.

# 변수 검사
<a name="v10-dash-variable-add-inspect"></a>

변수 페이지를 사용하면 변수가 다른 변수 또는 대시보드에서 참조 또는 사용되고 있는지 쉽게 식별할 수 있습니다.

참조 또는 사용되는 모든 변수 옆에는 녹색 확인 표시가 있고, 참조되지 않은 변수 옆에는 주황색 주의 아이콘이 있습니다. 또한 참조된 모든 변수에는 녹색 확인 표시 옆에 종속 항목 아이콘이 있습니다. 아이콘을 선택하여 종속 항목 맵을 볼 수 있습니다. 종속 항목 맵은 이동할 수 있습니다. 마우스 휠 또는 이에 상응하는 기능을 사용하여 확대하거나 축소할 수 있습니다.

# 변수 구문
<a name="v10-dash-variable-syntax"></a>

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

패널 제목과 지표 쿼리는 두 가지 다른 구문을 사용하여 변수를 참조할 수 있습니다.
+ `$varname` - 이 구문은 읽기 쉽지만 단어 중간에 변수를 사용할 수 없습니다.

  **예**: `apps.frontend.$server.requests.count`
+ `${var_name}` - 표현식 중간에 변수를 사용하려는 경우 이 구문을 사용합니다.
+ `${var_name:<format>}` - 이 형식을 사용하면 Grafana에서 값을 해석하는 방법을 더 잘 제어할 수 있습니다. 자세한 내용은 목록 다음에 나오는 *고급 변수 형식 옵션*을 참조하세요.
+ `[[varname]]` - 사용하지 않습니다. 이 구문은 오래되어 더 이상 사용되지 않습니다. 향후 릴리스에서 제거됩니다.

쿼리가 데이터 소스로 전송되기 전에 쿼리가 *보간*됩니다. 즉, 변수가 현재 값으로 대체됩니다. 보간 중에 쿼리 언어의 구문과 사용되는 위치를 준수하기 위해 변수 값이 *이스케이프 처리*될 수 있습니다. 예를 들어 InfluxDB 또는 Prometheus 쿼리의 정규식에 사용되는 변수는 정규식 이스케이프 처리됩니다.

**고급 변수 형식 옵션**

변수 보간의 형식 지정은 데이터 소스에 따라 다르지만 기본 형식 지정을 변경하려는 상황이 있습니다.

예를 들어 MySQL 데이터 소스의 기본값은 따옴표로 묶어 쉼표로 구분된 다중 값을 조인하는 것입니다(`'server01','server02'`). 경우에 따라 `server01,server02`와 같이 따옴표 없이 쉼표로 구분된 문자열을 사용할 수 있습니다. 아래에 나열된 고급 변수 형식 지정 옵션을 사용하여 이러한 작업을 수행할 수 있습니다.

**일반 구문**

구문: `${var_name:option}`

잘못된 형식 지정 옵션이 지정된 경우 `glob`가 기본/대체 옵션입니다.

**CSV**

다중 값 변수를 쉼표로 구분된 문자열 형식으로 지정합니다.

```
servers = [ 'test1',  'test2' ]
String to interpolate:  '${servers:csv}'
Interpolation result:  'test1,test2'
```

**분산 - OpenTSDB**

다중 값 변수를 OpenTSDB에 대한 사용자 지정 형식으로 지정합니다.

```
servers = [ 'test1',  'test2' ]
String to interpolate:  '${servers:distributed}'
Interpolation result:  'test1,servers=test2'
```

**큰따옴표**

단일 및 다중 값 변수를 쉼표로 구분된 문자열 형식으로 지정하고, 각 값에서 `"`를 `\"`로 이스케이프 처리하고 각 값을 `"`로 묶습니다.

```
servers = [ 'test1',  'test2' ]
String to interpolate:  '${servers:doublequote}'
Interpolation result:  '"test1","test2"'
```

**Glob - Graphite**

다중 값 변수를 Graphite 쿼리에 대한 glob 형식으로 지정합니다.

```
servers = [ 'test1',  'test2' ]
String to interpolate:  '${servers:glob}'
Interpolation result:  '{test1,test2}'
```

**JSON**

다중 값 변수를 쉼표로 구분된 문자열 형식으로 지정합니다.

```
servers = [ 'test1',  'test2' ]
String to interpolate:  '${servers:json}'
Interpolation result:  '["test1", "test2"]'
```

**Lucene - Elasticsearch**

Elasticsearch에 대해 Lucene 형식으로 사용하여 다중 값 변수의 형식을 지정합니다.

```
servers = [ 'test1',  'test2' ]
String to interpolate:  '${servers:lucene}'
Interpolation result:  '("test1" OR "test2")'
```

**Percentencode**

URL 파라미터에서 사용할 단일 및 다중 값 변수로 형식을 지정합니다.

```
servers = [ 'foo()bar BAZ',  'test2' ]
String to interpolate:  '${servers:percentencode}'
Interpolation result:  'foo%28%29bar%20BAZ%2Ctest2'
```

**파이프**

다중 값 변수를 파이프로 구분된 문자열 형식으로 지정합니다.

```
servers = [ 'test1.',  'test2' ]
String to interpolate:  '${servers:pipe}'
Interpolation result:  'test1.|test2'
```

**원시**

SQL 쿼리에서 작은따옴표와 같은 데이터 소스 특정 형식 지정을 끕니다.

```
servers = [ 'test.1',  'test2' ]
String to interpolate:  '${var_name:raw}'
Interpolation result:  'test.1,test2'
```

**Regex**

다중 값 변수를 정규식 문자열 형식으로 지정합니다.

```
servers = [ 'test1.',  'test2' ]
String to interpolate:  '${servers:regex}'
Interpolation result:  '(test1\.|test2)'
```

**Singlequote**

단일 및 다중 값 변수를 쉼표로 구분된 문자열 형식으로 지정하고, 각 값에서 `'`를 `\'`로 이스케이프 처리하고 각 값을 `'`로 묶습니다.

```
servers = [ 'test1',  'test2' ]
String to interpolate:  '${servers:singlequote}'
Interpolation result:  "'test1','test2'"
```

**Sqlstring**

단일 및 다중 값 변수를 쉼표로 구분된 문자열 형식으로 지정하고, 각 값에서 `'`를 `''`로 이스케이프 처리하고 각 값을 `'`로 묶습니다.

```
servers = [ "test'1",  "test2" ]
String to interpolate:  '${servers:sqlstring}'
Interpolation result:  "'test''1','test2'"
```

**텍스트**

단일 및 다중 값 변수를 텍스트 표현 형식으로 지정합니다. 단일 변수의 경우 텍스트 표현만 반환합니다. 다중 값 변수의 경우 `+`와 결합된 텍스트 표현을 반환합니다.

```
servers = [ "test1",  "test2" ]
String to interpolate:  '${servers:text}'
Interpolation result:  "test1 + test2"
```

**쿼리 파라미터**

단일 및 다중 값 변수를 쿼리 파라미터 표현 형식으로 지정합니다. 예시: `var-foo=value1&var-foo=value2`

```
servers = [ "test1",  "test2" ]
String to interpolate:  '${servers:queryparam}'
Interpolation result:  "var-servers=test1&var-servers=test2"
```

# 대시보드 사용량 평가
<a name="v10-dash-assess-dashboard-usage"></a>

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

모든 대시보드 및 데이터 소스에 대해 사용량 정보에 액세스할 수 있습니다.

**대시보드 인사이트**

대시보드 사용량 정보를 보려면 상단 표시줄에서 **대시보드 인사이트**를 선택합니다.

대시보드 인사이트에 다음 정보가 표시됩니다.
+ **통계** - 지난 30일 동안의 일일 쿼리 및 오류 수.
+ **사용자 및 활동** - 지난 30일 동안의 일일 보기 수, 대시보드의 마지막 활동 및 최근 사용자(20개로 제한).

**데이터 소스 인사이트**

데이터 소스 인사이트는 다음과 같이 지난 30일 동안 데이터 소스가 사용된 방식에 대한 정보를 제공합니다.
+ 일일 쿼리 수
+ 일일 오류 수
+ 일일 쿼리 로드 시간(단위: 밀리초)

**데이터 소스 인사이트를 찾는 방법**

1. 워크스페이스의 기본 탐색에서 **연결**을 선택하세요.

1. **데이터 소스**을 선택하세요.

1. 데이터 원본을 선택합니다.

1. **인사이트** 탭을 선택하세요.

## 현재 상태 표시기
<a name="v10-dash-presence-indicator"></a>

로그인하고 대시보드를 보면 최근 대시보드와 상호 작용한 사용자의 아바타를 표시하는 현재 상태 표시기를 통해 동일한 대시보드를 보고 있는 사용자를 확인할 수 있습니다. 기본 타임프레임은 10분입니다. 사용자 이름을 보려면 사용자 아바타 위에 마우스를 올려 놓습니다. 아바타는 사용자의 이메일을 기반으로 [Gravatar](https://gravatar.com/)에서 가져옵니다.

대시보드에 현재 상태 표시기에서 수용할 수 있는 수보다 활성 사용자가 더 많으면 **\$1X** 아이콘을 클릭합니다. 이렇게 하면 최근 사용자 활동에 대한 세부 정보가 포함된 대시보드 인사이트가 열립니다.

## 인사이트 데이터를 사용하여 대시보드 정렬
<a name="v10-dash-sort-dashboards"></a>

검색 보기에서 인사이트 데이터를 사용하여 가장 많이 사용한 대시보드, 연결이 끊어진 대시보드 및 사용하지 않은 대시보드를 파악할 수 있습니다. 다음과 같은 대시보드를 정렬할 수 있습니다.
+ 뷰
+ 오류
+ 뷰
+ 생성된 시간
+ 업데이트된 시간

# 대시보드 문제 해결
<a name="v10-dash-troubleshoot"></a>

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

 다음 전략을 사용하여 일반적인 대시보드 문제를 해결할 수 있습니다.

## 대시보드가 느림
<a name="v10-dash-dashboard-is-slow"></a>
+ 그래프에서 수십 개(또는 수백이나 수천 개)의 시계열을 렌더링하려고 하시나요? 이 경우 브라우저에서 지연이 발생할 수 있습니다. `highestMax`(Graphite)와 같은 함수를 사용하여 반환되는 시리즈 수를 줄이세요.
+ 때로는 시리즈 이름이 매우 클 수 있습니다. 이로 인해 응답 크기가 커집니다. `alias`를 사용하여 반환되는 시리즈 이름의 크기를 줄이세요.
+ 여러 시계열을 쿼리하고 있나요? 아니면 긴 시간 범위를 쿼리하고 있나요? 이러한 두 조건 모두 Grafana 또는 데이터 소스에서 많은 데이터를 가져와 대시보드 속도가 느려질 수 있습니다. 이 중 하나 또는 둘 다 줄이세요.
+ 네트워크 인프라에 부하가 높을 수 있습니다. 속도가 일관되지 않으면 문제가 될 수 있습니다.

## 대시보드 새로 고침 빈도 문제
<a name="v10-dash-refresh-rate-issues"></a>

기본적으로 Grafana는 30초마다 데이터 소스를 쿼리합니다. 그러나 대시보드에서 새로 고침 빈도를 낮게 설정하면 백엔드에 불필요한 스트레스가 발생합니다. 데이터 소스에서 30초마다 변경되기에 충분한 데이터를 자주 전송하지 않기 때문에 대부분의 경우 자주 쿼리하지 않아도 됩니다.

다음과 같이 하는 것이 좋습니다:
+ 필요한 경우에만 대시보드, 패널 또는 변수에서 자동 새로 고침을 활성화합니다. 사용자는 브라우저를 수동으로 새로 고칠 수 있습니다.
+ 자동 새로 고침이 필요한 경우 새로 고침 빈도를 1분에 한 번, 10분마다 또는 1시간마다와 같이 타당한 더 긴 기간으로 설정합니다.
+ 대시보드의 시간 범위를 확인합니다. 대시보드의 시간 범위가 일주일과 같이 더 긴 경우 자동 새로 고침이 필요하지 않으므로 비활성화해야 합니다.

## null 데이터 처리 또는 렌더링이 잘못되었거나 혼동됨
<a name="v10-dash-handling-or-rendering-null-data-is-wrong-or-confusing"></a>

일부 애플리케이션은 데이터를 간헐적으로 게시합니다. 예를 들어 이벤트가 발생할 때만 지표를 게시합니다. 기본적으로 Grafana 그래프는 데이터 포인트 사이를 선으로 연결하지만, 이는 진짜가 아닐 수 있습니다.

**null 값 연결** 옵션이 **항상**으로 설정된 그래프는 누락된 값이 있는 선을 연결합니다.

이를 수정하는 한 가지 방법은 선 대신 막대를 사용하고 **값 없음** 옵션(**표준 옵션** 아래)을 `0`으로 설정하는 것입니다. 이 경우 누락된 데이터는 데이터가 없는 그래프 영역으로 표시됩니다.

# Grafana 버전 10에서 대시보드 검색
<a name="v10-search"></a>

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

대시보드 이름 및 패널 제목으로 대시보드를 검색할 수 있습니다. 대시보드를 검색하면 대시보드의 콘텐츠를 볼 권한이 없더라도 Grafana 인스턴스 내에서 사용할 수 있는 모든 대시보드가 반환됩니다.

## 대시보드 이름을 사용하여 대시보드 검색
<a name="v10-search-by-name"></a>

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

다음은 대시보드 검색의 특징입니다.
+ 실시간
+ 대소문자를 구분하지 *않음*
+ 저장된 대시보드와 파일 기반 대시보드에서 작동합니다.

**작은 정보**  
키보드 화살표 키를 사용하여 결과를 탐색하고 `Enter`를 눌러 선택한 대시보드를 열 수 있습니다.

## 패널 제목을 사용하여 대시보드 검색
<a name="v10-search-by-title"></a>

대시보드에 표시되는 패널의 제목으로 대시보드를 검색할 수 있습니다. 패널의 제목이 검색 쿼리와 일치하면 대시보드가 검색 결과에 나타납니다.

## 태그별 대시보드 검색 결과 필터링
<a name="v10-search-by-tag"></a>

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

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

태그별 대시보드 검색 결과를 필터링하려면 다음 단계 중 하나를 완료하세요.
+ 태그별 대시보드 검색 결과를 필터링하려면 검색 결과의 오른쪽 열에 나타나는 태그를 선택하세요.

  추가 태그를 선택하여 계속 필터링할 수 있습니다.
+ 사용 가능한 모든 태그 목록을 보려면 **태그별 필터링** 드롭다운 메뉴를 클릭하고 태그를 선택하세요.

  모든 태그가 표시되고 태그를 선택하면 대시보드 검색이 즉시 필터링됩니다.

**작은 정보**  
키보드만 사용하는 경우 `tab` 키를 누르고 **태그별 필터링** 드롭다운 메뉴로 이동한 다음, 아래쪽 화살표 키를 눌러 메뉴를 활성화하고 태그를 찾은 다음, `Enter`를 눌러 태그를 선택하세요.

## 명령 팔레트
<a name="v10-search-palette"></a>

이러한 명령을 사용하여 다음을 수행할 수 있습니다.
+ 대시보드 및 폴더를 검색하고 엽니다.
+ 대시보드 및 알림 규칙을 생성합니다.
+ Grafana 내에서 페이지를 찾습니다.
+ 테마를 어둡거나 밝게 변경합니다.

명령 팔레트를 먼저 열고 `ctrl+k`를 입력합니다(MacOS의 경우 `cmd+k`). Grafana 탐색 표시줄에서 검색 입력을 선택할 수도 있습니다.

**참고**  
이전 단계로 이동하려면 명령 팔레트가 비어 있는 상태에서 `backspace`를 누릅니다.