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

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

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

Grafana 워크스페이스를 생성하고 로그인한 후 대시보드를 생성하고 요구 사항에 맞게 설정을 수정할 수 있습니다.

**Topics**
+ [대시보드 생성](v9-dash-creating.md)
+ [패널 추가 또는 편집](v9-dash-edit-panels.md)
+ [대시보드 설정 수정](v9-dash-modify-settings.md)
+ [대시보드 URL 변수](v9-dash-dashboard-url-variables.md)
+ [대시보드에 라이브러리 패널 추가](v9-dash-manage-library-panels.md)
+ [대시보드 버전 기록 관리](v9-dash-manage-version-history.md)
+ [대시보드 링크 관리](v9-dash-manage-dashboard-links.md)
+ [대시보드 JSON 모델](v9-dash-dashboard-json-model.md)

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

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

**대시보드 생성 **

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

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

1. Grafana에 로그인하고 **대시보드** 위에 커서를 놓고 **\$1 새 대시보드**를 클릭하세요.

1. **새 패널 추가**를 클릭하세요.

1. **쿼리** 탭의 첫 번째 줄에서 드롭다운 목록을 클릭하고 데이터 소스를 선택하세요.

1. 데이터 소스의 쿼리 언어로 쿼리를 작성하거나 구성하세요.

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

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

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

**반복 행 구성**

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

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

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

1. 대시보드 홈 페이지에서 **패널 추가**를 클릭하세요.

1. **패널 추가** 대화 상자에서 **새 행 추가**를 클릭하세요.

1. 행 제목 위로 마우스를 가져가서 톱니 아이콘을 클릭하세요.

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

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

1.  대시보드를 엽니다.

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

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

1.  대시보드를 엽니다.

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

# 패널 추가 또는 편집
<a name="v9-dash-edit-panels"></a>

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

대시보드를 생성한 후에는 언제든지 패널을 추가, 편집 또는 제거할 수 있습니다.
+ **대시보드 보기**: 대시보드를 보려면 **홈** 메뉴에서 **대시보드**를 선택한 다음, 보려는 대시보드를 선택합니다. 대시보드가 포함된 폴더를 확장해야 할 수 있습니다.
+ **패널 추가**: 대시보드에 패널을 추가하려면 페이지 상단 근처의 메뉴 표시줄에서 **패널 추가** 아이콘을 선택합니다.
+ **패널 편집:** 대시보드에서 기존 패널을 편집하려면 패널 위로 마우스를 가져가면 나타나는 메뉴 아이콘을 선택한 다음, **편집**을 선택합니다.
+ **패널 제거:** 대시보드에서 기존 패널을 제거하려면 패널 위로 마우스를 가져가면 나타나는 메뉴 아이콘을 선택한 다음, **제거**를 선택합니다.

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

****  
이 설명서 주제는 **Grafana 버전 9.x**를 지원하는 Grafana 워크스페이스를 위해 설계되었습니다.  
Grafana 버전 10.x를 지원하는 Grafana 워크스페이스의 경우 [Grafana 버전 10에서 작업](using-grafana-v10.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 값을 피하기 위해 데이터 집계의 알려진 지연을 수용하려면 이 옵션을 사용합니다.
+ **시간 선택기 숨기기**는 Grafana 시간 선택기 표시를 제거합니다.

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

**주석 쿼리 추가**

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

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

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

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

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

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

쿼리 편집기 UI는 선택한 데이터 소스에 따라 변경됩니다. 쿼리를 구성하는 방법에 대한 자세한 내용은 [데이터 소스](AMG-data-sources.md) 설명서를 참조하세요.

**변수 추가**

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

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

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

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

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

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

**링크 추가 **

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

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

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

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

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

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

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

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

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

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

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

Grafana는 대시보드 URL에서 쿼리 파라미터로 전달되는 변수 값을 적용할 수 있습니다. 자세한 내용은 [대시보드 링크 관리](v9-dash-manage-dashboard-links.md) 및 [템플릿 및 변수](v9-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는 대시보드 설정에서 변수를 생성할 때 대시보드 링크에 변수를 추가할 수 있습니다. 변수를 추가하는 자세한 내용과 단계는 [대시보드 링크 관리](v9-dash-manage-dashboard-links.md)를 참조하세요.

**임시 필터 전달**

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

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

예를 들어, 이 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="v9-dash-manage-library-panels"></a>

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

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

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

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

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

1. 편집 모드에서 패널을 여세요.

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

1. **생성** 대화 상자를 열려면 **라이브러리 패널** 옵션을 클릭한 다음, **라이브러리 패널 생성**을 클릭하세요.

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

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

1. 변경 사항을 저장하려면 **라이브러리 패널 생성**을 클릭하세요.

1. 대시보드를 저장하려면 **저장**을 클릭하세요.

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

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

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

1. 왼쪽 메뉴의 **대시보드** 옵션 위로 마우스를 가져간 다음, 드롭다운 옵션에서 **새 대시보드**를 선택하세요. **패널 추가** 대화 상자가 열립니다.

1. 패널 라이브러리에서 **패널 추가** 옵션을 클릭하세요. 라이브러리 패널 목록이 표시됩니다.

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

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

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

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

1. 왼쪽 메뉴의 **대시보드** 위에 마우스를 올려 놓은 다음, **라이브러리 패널**을 클릭하세요.

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

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

1. 패널의 제목을 클릭한 다음, **편집**을 클릭하세요. 패널이 편집 모드로 열립니다.

1. 페이지 오른쪽 상단에서 **연결 해제** 옵션을 클릭하세요.

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

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

1. 왼쪽 메뉴의 **대시보드** 옵션 위에 마우스를 올려 놓은 다음, **라이브러리 패널**을 클릭하세요. 이전에 정의한 라이브러리 패널 목록을 볼 수 있습니다.

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

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

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

1. 왼쪽 메뉴의 **대시보드** 위에 마우스를 올려 놓은 다음, **라이브러리 패널**을 선택하세요.

1. 삭제할 패널을 선택하세요.

1. 라이브러리 이름 옆에 있는 삭제 아이콘을 클릭하세요.

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

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

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

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

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

두 대시보드 버전을 비교하려면 비교할 두 버전을 목록에서 선택하세요. **버전 비교**를 클릭하여 두 버전 간의 차이를 확인합니다.

버튼을 클릭하면 차이 보기로 이동합니다. 기본적으로 변경 사항에 대한 텍스트 요약이 표시됩니다.

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

차이를 비교하는 기준이 되는 버전으로 복원하려는 경우 오른쪽 상단의 **버전 <x>(으)로 복원** 버튼을 클릭하여 복원할 수 있습니다.

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

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

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

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

****  
이 설명서 주제는 **Grafana 버전 9.x**를 지원하는 Grafana 워크스페이스를 위해 설계되었습니다.  
Grafana 버전 10.x를 지원하는 Grafana 워크스페이스의 경우 [Grafana 버전 10에서 작업](using-grafana-v10.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 문제](https://github.com/grafana/grafana/issues/new?title=Dashboard%3A%20HTTP%20Requests)를 제출하는 등 외부 시스템에 대한 바로 가기로도 사용할 수 있습니다.

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

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

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

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

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

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

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

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

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

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

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

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

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

1. 다음 중에서 링크 옵션을 선택하세요.
   + **URL**: 연결할 URL을 입력합니다. 대상에 따라 필드 값을 포함할 수 있습니다. 자세한 내용은 [Github 예제](https://github.com/grafana/grafana/issues/new?title=Dashboard%3A%20HTTP%20Requests)를 참조하세요.
   + **제목**: 링크를 표시할 제목을 입력합니다.
   + **툴팁**: 링크를 표시할 툴팁을 입력합니다.
   + **아이콘**: 링크와 함께 표시할 아이콘을 선택합니다.
   + **시간 범위**: 링크에 대시보드 시간 범위를 포함하려면 이 옵션을 선택합니다. 사용자가 링크를 클릭하면 표시된 시간 범위가 설정된 상태로 연결된 대시보드가 열립니다.
     + `from`에서는 시간 범위의 하한(밀리초 에포크로 지정됨)을 정의합니다.
     + `to`에서는 시간 범위의 상한(밀리초 에포크로 지정됨)을 정의합니다.
     + `time` 및 `time.window`는 `time-time.window/2`\$1`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. 링크를 추가하려는 패널 위에 커서를 놓고 `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. **편집**(연필) 아이콘을 클릭하여 링크 편집 창을 여세요.

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

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

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

  1. **패널** 탭에서 변경하려는 링크를 찾으세요.

  1. 삭제할 링크 옆의 **X** 아이콘을 클릭하세요.

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

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

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

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

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

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

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

1. **JSON 모델**을 클릭하세요.

**JSON 필드**

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

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

```
{
  "id": null,
  "uid": "cLV5GDCkz",
  "title": "New dashboard",
  "tags": [],
  "style": "dark",
  "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) | 
| **제목** | 대시보드의 현재 제목 | 
| **tags** | 대시보드와 연결된 태그, 문자열 배열 | 
| **style** | *dark* 또는 *light*와 같은 대시보드 테마 | 
| **시간대** | *utc* 또는 *browser*와 같은 대시보드 시간대 | 
| **editable** | 대시보드 편집 가능 여부 | 
| **graphTooltip** | 공유 십자선 또는 툴팁이 없는 경우 0(기본값), 공유 십자선의 경우 1, 공유 십자선 및 공유 툴팁의 경우 2 | 
| **time** | *지난 6시간* 또는 *지난 7일*과 같은 대시보드의 시간 범위 | 
| **timepicker** | 시간 선택기 메타데이터, 자세한 내용은 [시간 선택기 섹션](#v9-dash-dashboard-json-model) 참조 | 
| **템플릿 지정 ** | 템플릿 지정 메타데이터, 자세한 내용은 [템플릿 지정 섹션](#v9-dash-dashboard-json-model) 참조 | 
| 주석**** | 주석 메타데이터, 주석을 추가하는 방법은 [주석](v9-panels-annotate-visualizations.md) 참조 | 
| **refresh** | 자동 새로 고침 간격 | 
| **schemaVersion** | JSON 스키마 버전(정수), Grafana 업데이트에서 해당 스키마를 변경할 때마다 증가 | 
| **version** | 대시보드 버전(정수), 대시보드가 업데이트될 때마다 증가 | 
| **패널** | 패널 배열(자세한 내용은 아래 참조) | 

**패널**

패널은 대시보드의 구성 요소입니다. 데이터 소스 쿼리, 그래프 유형, 별칭 등으로 구성됩니다. 패널 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"
      }
    ]
  }
```