

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

# Grafana 버전 9에서 작업
<a name="using-grafana-v9"></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 버전을 선택할 수 있습니다. 다음 주제에서는 Grafana 버전 9를 사용하는 Grafana 워크스페이스 사용을 설명합니다.

**Topics**
+ [Grafana 버전 9에서의 대시보드](v9-dashboards.md)
+ [Grafana 버전 9에서의 패널 및 시각화](v9-panels.md)
+ [Grafana 버전 9에서의 탐색](v9-explore.md)
+ [Grafana 버전 9에서의 알림](v9-alerts.md)

# Grafana 버전 9에서의 대시보드
<a name="v9-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) 섹션을 참조하세요.

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

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

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

# 대시보드 사용
<a name="v9-dash-using-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) 섹션을 참조하세요.

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

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

대시보드를 사용하여 다음 방식으로 데이터 프레젠테이션을 사용자 지정할 수 있습니다.


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

## 키보드 바로 가기
<a name="v9-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="v9-dash-setting-dashboard-time-range"></a>

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

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

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

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

빼기 연산자를 사용하여 현재를 기준으로 이전 시간을 설정할 수 있습니다. 단위의 전체 기간(일, 주 또는 월)을 표시하려면 끝에 `/<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`, *n의 시작부터 n의 종료까지*에 대해 `now-1n/n`을 지원하지 않습니다.

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

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

*기타 시간 범위 기능*

1. 축소하려면 **Cmd\$1Z** 또는 **Ctrl\$1Z**를 클릭합니다. 대시보드 또는 패널 시각화에서 더 큰 시간 범위를 보려면 아이콘을 클릭합니다.

1. 확대 기능을 사용하려면 클릭하고 끌어 시각화에서 보려는 시간 범위를 선택합니다.

**참고**  
확대는 그래프 시각화에만 적용됩니다.

*대시보드 새로 고침*

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

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

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

대시보드 URL에 다음 쿼리 파라미터를 제공하여 대시보드의 시간 범위를 제어할 수 있습니다.
+ `from`에서는 시간 범위의 하한(밀리초 에포크 또는 [상대 시간](#v9-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="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"
      }
    ]
  }
```

# 대시보드 관리
<a name="v9-dash-managing-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) 섹션을 참조하세요.

대시보드는 데이터를 하나 이상의 행에 시각적으로 표시하는 하나 이상의 [패널](v9-panels.md) 세트입니다.

대시보드 생성에 대한 자세한 내용은 [패널 추가 및 구성]()을 참조하세요.

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

폴더는 대시보드를 구성하고 그룹화하는 데 도움이 되며, 이는 동일한 Grafana 인스턴스를 사용하는 대시보드가 많거나 여러 팀이 있는 경우에 유용합니다.

**사전 조건**

Grafana 관리자 권한이 있는지 확인합니다. 대시보드 권한에 대한 자세한 내용은 [대시보드 권한](Grafana-administration-authorization.md)을 참조하세요.

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

1. Grafana에 로그인하고 사이드 메뉴에서 **대시보드 > 새 폴더**를 클릭하세요.

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

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

## 대시보드 및 폴더 관리
<a name="v9-dash-manage-dashboard-folder"></a>

**대시보드 및 폴더 관리** 페이지에서 다음을 수행할 수 있습니다.
+ 폴더 생성
+ 대시보드 생성
+ 대시보드를 폴더로 이동
+ 여러 대시보드 삭제
+ 폴더 및 대시보드 권한을 할당할 수 있는 폴더 페이지로 이동

**대시보드 폴더 페이지**

**대시보드** 페이지에서 다음 태스크를 수행할 수 있습니다.
+ 폴더에서 대시보드를 이동하거나 삭제합니다.
+ 폴더 이름을 변경합니다(**설정** 탭에서 사용 가능).
+ 폴더에 권한을 할당합니다(폴더의 대시보드에서 상속됨).

대시보드 폴더 페이지로 이동하려면 대시보드 검색 결과 목록 또는 **대시보드 및 폴더 관리** 페이지에서 폴더 위로 마우스를 가져갈 때 나타나는 톱니 아이콘을 클릭합니다.

**대시보드 권한**

폴더에 권한을 할당할 수 있습니다. 할당한 모든 권한은 폴더의 대시보드에서 상속됩니다. 액세스 제어 목록(ACL)은 **조직 역할**, **팀** 및 **사용자**에게 권한을 할당할 수 있는 경우에 사용됩니다.

자세한 내용은 [권한](Grafana-permissions.md)을 참조하세요.

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

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

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

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

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

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

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

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

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

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

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

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

**대시보드 가져오기**

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

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

1. 다음 단계 중 하나를 수행합니다.
   + 대시보드 JSON 파일을 업로드하세요.
   + [Grafana.com](https://grafana.com/) 대시보드 URL을 붙여넣으세요.
   + 대시보드 JSON 텍스트를 텍스트 영역에 직접 붙여넣으세요.

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

## 대시보드 문제 해결
<a name="v9-dash-troubleshooting"></a>

이 섹션에서는 일반적인 대시보드 문제를 해결하는 데 도움이 되는 정보를 제공합니다.

**대시보드가 느림**

대시보드가 느린 경우 다음을 고려하세요.
+ 그래프에서 수십 개(또는 수백이나 수천 개)의 시계열을 렌더링하려고 하시나요? 이 경우 브라우저에서 지연이 발생할 수 있습니다. highestMax(Graphite)와 같은 함수를 사용하여 반환되는 시리즈를 줄이세요.
+ 때로는 시리즈 이름이 매우 클 수 있습니다. 이로 인해 응답 크기가 커집니다. 별칭을 사용하여 반환되는 시리즈 이름의 크기를 줄이세요.
+ 여러 시계열을 쿼리하고 있나요? 아니면 긴 시간 범위를 쿼리하고 있나요? 이러한 두 조건 모두 Grafana 또는 데이터 소스에서 많은 데이터를 가져와 속도가 느려질 수 있습니다.
+ 네트워크 인프라에 부하가 높을 수 있습니다. 속도가 일관되지 않으면 문제가 될 수 있습니다.

**대시보드 새로 고침 빈도 문제**

기본적으로 Grafana는 30초마다 데이터 소스를 쿼리합니다. 대시보드에서 새로 고침 빈도를 낮게 설정하면 백엔드에 불필요한 스트레스가 발생합니다. 많은 경우 변경 사항을 확인하도록 데이터가 시스템에 전송되지 않으므로 자주 쿼리하지 않아도 됩니다.

이 문제가 있는 경우 다음 솔루션이 권장됩니다.
+ 필요한 경우가 아니면 대시보드, 패널 또는 변수에서 자동 새로 고침을 활성화하지 마세요. 사용자는 브라우저를 수동으로 새로 고치거나 적절한 기간(예: 10분 또는 1시간마다)에 새로 고침 빈도를 설정할 수 있습니다.
+ 필요한 경우 새로 고침 빈도를 1분에 한 번으로 설정합니다. 사용자는 언제든지 대시보드를 수동으로 새로 고칠 수 있습니다.
+ 대시보드의 기간이 더 긴 경우(예: 1주일) 자동 새로 고침이 필요하지 않을 수 있습니다.

**null 데이터 처리 또는 렌더링이 잘못되었거나 혼동됨**

일부 애플리케이션은 데이터를 간헐적으로 게시합니다. 예를 들어 이벤트가 발생할 때만 지표를 게시합니다. 기본적으로 Grafana 그래프는 데이터 포인트 사이를 선으로 연결합니다.

# 대시보드 및 패널 공유
<a name="v9-dash-sharing"></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 인스턴스에 대해 익명 액세스 권한이 활성화되어 있지 않은 한 임베드된 링크를 보려는 경우에도 동일한 권한이 필요합니다.

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

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

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

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

1. Grafana 인스턴스의 홈 페이지로 이동합니다.

1. 상단 탐색에서 공유 아이콘을 클릭합니다.

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

**직접 링크 공유**

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

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

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

**스냅샷 게시**

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

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

1. **로컬 스냅샷**을 클릭하세요.

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

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

Grafana 대시보드는 쉽게 내보내고 가져올 수 있습니다. 자세한 내용은 [대시보드 가져오기 및 내보내기](v9-dash-managing-dashboards.md#v9-dash-export-import-dashboards)를 참조하세요.

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

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

1. 패널 제목을 클릭하여 패널 메뉴를 여세요.

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

**직접 링크 사용**

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

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

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

1. 또한 **렌더링된 이미지 직접 링크**를 클릭하여 패널의 이미지를 공유할 수도 있습니다.

**서버 측 렌더링 이미지에 대한 문자열 파라미터 쿼리**
+ **너비**: 픽셀 단위의 너비. 기본값은 800입니다.
+ **높이**: 픽셀 단위의 높이. 기본값은 400입니다.
+ **tz**: `UTC%2BHH%3AMM` 형식의 시간대(여기서 HH 및 MM은 UTC 다음의 시간 및 분 단위 오프셋).
+ **제한 시간**: 초 수. 패널에 대한 쿼리가 기본값인 30초를 초과해야 하는 경우 제한 시간을 늘릴 수 있습니다.
+ **스케일**: 디바이스 스케일 인수를 구성하는 숫자 값. 기본값은 1. 더 자세한 이미지(더 높은 DPI)를 생성하려면 더 높은 값을 사용합니다. Grafana v7.0 이상에서 지원됩니다.

**스냅샷 게시**

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

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

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

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

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

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

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

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

1. **라이브러리 패널**을 클릭하세요.

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

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

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

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

# 재생 목록 관리
<a name="v9-dash-managing-playlists"></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 측 메뉴를 통해 **대시보드** 하위 메뉴에서 재생 목록 기능에 액세스할 수 있습니다.

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

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

**재생 목록에 액세스**

1. Grafana의 사이드 메뉴 위에 커서를 올려 놓으세요.

1. **재생 목록**을 클릭하세요.

   기존 재생 목록 목록이 표시됩니다.

**재생 목록 시작**

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

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

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

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

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

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

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

1. 시작을 클릭합니다.


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

**재생 목록 제어**

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


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

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

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

1. 재생 목록 페이지에서 **새 재생 목록**을 클릭하세요.

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

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

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

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

1. **Save**를 클릭해 변경 사항을 저장합니다.

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

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

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

1. 재생 목록 기능에 액세스하려면 Grafana의 사이드 메뉴 위에 커서를 올려 놓으세요.

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

1. 원하는 재생 목록을 클릭하세요.

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

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

1. **Save**를 클릭해 변경 사항을 저장합니다.

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

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

**재생 목록 편집**

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

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

1. **Save**를 클릭해 변경 사항을 저장합니다.

**재생 목록 삭제**

1. **재생 목록**을 클릭하세요.

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

**대시보드 순서 재정렬**

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

1. **Save**를 클릭해 변경 사항을 저장합니다.

**대시보드 제거**

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

1. **Save**를 클릭해 변경 사항을 저장합니다.

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

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

1. **대시보드** 하위 메뉴에서 **재생 목록**을 클릭하세요.

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

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

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

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

# 대시보드 변수 추가 및 관리
<a name="v9-dash-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 최종 사용자가 시각화를 빠르게 조정할 수 있도록 허용하되 전체 편집 권한을 부여하지 않으려는 관리자에게 특히 유용할 수 있습니다. Grafana 최종 사용자는 변수를 사용할 수 있습니다.

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

**템플릿**

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

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

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

**예시**

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

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

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

**변수 모범 사례**
+ 변수 드롭다운 목록은 **대시보드 설정**의 변수 목록에 나열된 순서대로 표시됩니다.
+ 자주 변경하는 변수를 맨 위에 배치하면 해당 변수가 먼저 표시됩니다(대시보드에서 맨 왼쪽).

# 변수 추가 및 관리
<a name="v9-dash-variable-add"></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와 함께 제공되는 변수 유형이 나열되어 있습니다.


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

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

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

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

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

1. **변수** 탭에서 **새로 만들기**를 선택하세요.

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

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

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

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

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

## 쿼리 변수 추가
<a name="v9-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. **쿼리** 필드에 쿼리를 입력하세요.
   + 쿼리 필드는 데이터 소스에 따라 다릅니다. 일부 데이터 소스에는 사용자 지정 쿼리 편집기가 있습니다.
   + 단일 입력 필드 쿼리 편집기에 더 많은 공간이 필요한 경우 필드의 오른쪽 하단에 있는 선 위에 커서를 놓고 아래로 끌어 확장하세요.

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

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

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

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

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

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

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

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

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

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

1. 이 경우 

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

## 간격 변수 추가
<a name="v9-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="v9-dash-variable-add-adhoc"></a>

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

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

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

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

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

**임시 필터 생성**

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

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

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

### 다중 값 변수
<a name="v9-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에서 이 자동 정규식 이스케이프 처리 및 형식 지정을 수행하지 않도록 하려면 다음 중 하나를 수행해야 합니다.
+ **다중 값** 또는 **모든 옵션 포함** 옵션을 끕니다.
+ [원시 변수 형식](https://grafana.com/docs/grafana/latest/dashboards/variables/variable-syntax/#raw)을 사용합니다.

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

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

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

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

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

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

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

## 전역 변수
<a name="v9-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 데이터 소스에서 사용됩니다.

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

*체인 변수*(*연결된 변수* 또는 *중첩된 변수*라고도 함)는 변수 쿼리에 하나 이상의 다른 변수를 포함하는 쿼리 변수입니다. 이 섹션에서는 체인 변수의 작동 방식을 설명하고 체인 변수를 사용하는 대시보드 예제에 대한 링크를 제공합니다.

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

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

**모범 사례 및 팁**

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

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

**변수 순서**

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

**복잡성 고려 사항**

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

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

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

변수 페이지에서는 변수를 [추](https://grafana.com/docs/grafana/latest/dashboards/variables/add-template-variables/)가하고 기존 변수를 관리할 수 있습니다. 또한 변수를 [검사](https://grafana.com/docs/grafana/latest/dashboards/variables/inspect-variable/)하고 변수가 다른 변수나 대시보드에서 참조 또는 사용되고 있는지 식별할 수 있습니다.

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

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

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

## 정규식으로 변수 필터링
<a name="v9-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="v9-dash-variable-add-inspect"></a>

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

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

# 변수 구문
<a name="v9-dash-variable-syntax"></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) 섹션을 참조하세요.

패널 제목과 지표 쿼리는 두 가지 다른 구문을 사용하여 변수를 참조할 수 있습니다.
+ `$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="v9-dash-assess-dashboard-usage"></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 인스턴스의 사용 방식을 더 잘 이해할 수 있습니다.

사용량 인사이트 기능은 여러 집계된 데이터를 수집하여 데이터베이스에 저장합니다.
+ 대시보드 보기(사용자당 및 집계)
+ 데이터 소스 오류
+ 데이터 소스 쿼리

집계된 데이터를 통해 대시보드 및 데이터 소스 인사이트, 현재 상태 표시기, 인사이트 데이터를 사용하여 대시보드 정렬, 대시보드에서 사용량 인사이트 데이터 시각화 등 여러 기능에 액세스할 수 있습니다.

또한 이 기능은 Loki로 내보낼 수 있는 세부 로그를 생성합니다.

## 대시보드 및 데이터 소스 인사이트
<a name="v9-dash-insights"></a>

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

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

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

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

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

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

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

1. **데이터 소스** 목록 보기로 이동하세요.

1. **데이터 소스**를 클릭하세요.

1. **인사이트** 탭을 클릭하세요.

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

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

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

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

검색 보기에서 인사이트 데이터를 사용하여 가장 많이 사용한 대시보드, 연결이 끊어진 대시보드 및 사용하지 않은 대시보드를 파악할 수 있습니다.
+ 총 오류
+ 오류 30일
+ 합계 보기
+ 보기 30일

# Grafana 버전 9에서 대시보드 검색
<a name="v9-search"></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 인스턴스 내에서 사용할 수 있는 모든 대시보드가 반환됩니다.

## 대시보드 이름을 사용하여 대시보드 검색
<a name="v9-search-by-name"></a>

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

다음은 대시보드 검색의 특징입니다.
+ 실시간
+ 대소문자를 구분하지 *않음*
+ 저장된 대시보드와 파일 기반 대시보드에서 작동합니다.

**작은 정보**  
키보드 화살표 키를 사용하여 결과를 탐색하고 `Enter`를 눌러 선택한 대시보드를 열 수 있습니다.

## 패널 제목을 사용하여 대시보드 검색
<a name="v9-search-by-title"></a>

대시보드에 표시되는 패널의 제목으로 대시보드를 검색할 수 있습니다. 패널의 제목이 검색 쿼리와 일치하면 대시보드가 검색 결과에 나타납니다.

## 태그별 대시보드 검색 결과 필터링
<a name="v9-search-by-tag"></a>

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

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

태그별 대시보드 검색 결과를 필터링하려면 다음 단계 중 하나를 완료하세요.
+ 태그별 대시보드 검색 결과를 필터링하려면 검색 결과의 오른쪽 열에 나타나는 태그를 선택하세요.

  추가 태그를 선택하여 계속 필터링할 수 있습니다.
+ 사용 가능한 모든 태그 목록을 보려면 **태그별 필터링** 드롭다운 메뉴를 클릭하고 태그를 선택하세요.

  모든 태그가 표시되고 태그를 선택하면 대시보드 검색이 즉시 필터링됩니다.

**작은 정보**  
키보드만 사용하는 경우 `tab` 키를 누르고 **태그별 필터링** 드롭다운 메뉴로 이동한 다음, 아래쪽 화살표 키를 눌러 메뉴를 활성화하고 태그를 찾은 다음, `Enter`를 눌러 태그를 선택하세요.

# Grafana 버전 9에서의 패널 및 시각화
<a name="v9-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) 섹션을 참조하세요.

 *패널*은 Grafana의 기본 시각화 구성 요소입니다. 각 패널에는 패널에서 선택한 데이터 소스에 특정한 쿼리 편집기가 있습니다. 쿼리 편집기를 사용하면 시각화하려는 데이터를 반환하는 쿼리를 빌드할 수 있습니다.

 각 패널에는 다양한 스타일 및 서식 지정 옵션이 있습니다. 패널은 대시보드에서 다시 정렬하도록 끌기, 놓기, 크기 조정이 가능합니다.

 패널을 추가하기 전에 데이터 소스를 구성했는지 확인합니다.

워크스페이스에 추가 [플러그인](grafana-plugins.md)을 설치하여 추가 패널 유형을 사용할 수 있습니다.
+  특정 데이터 소스에 대한 자세한 내용은 [데이터 원본에 연결](AMG-data-sources.md) 섹션을 참조하세요.

**Topics**
+ [패널 편집기 개요](v9-panels-editor-overview.md)
+ [패널 옵션 구성](v9-panels-configure-panel-options.md)
+ [표준 옵션 구성](v9-panels-configure-standard-options.md)
+ [데이터 쿼리 및 변환](v9-panels-query-xform.md)
+ [임계치 구성](v9-panels-configure-thresholds.md)
+ [데이터 링크 구성](v9-panels-configure-data-links.md)
+ [필드 재정의 구성](v9-panels-configure-overrides.md)
+ [값 매핑 구성](v9-panels-configure-value-mappings.md)
+ [범례 구성](v9-panels-configure-legend.md)
+ [계산 유형](v9-panels-calculation-types.md)
+ [시각화 주석 달기](v9-panels-annotate-visualizations.md)
+ [패널 검사 보기](v9-panels-panel-inspector.md)
+ [Grafana 버전 9에서 사용 가능한 시각화](v9-panels-viz.md)

# 패널 편집기 개요
<a name="v9-panels-editor-overview"></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 패널 편집기의 영역을 설명합니다.
+  패널 헤더: 헤더 섹션에는 패널이 나타나는 대시보드와 다음 제어가 나열됩니다.
  +  **대시보드 설정(톱니) 아이콘:** 대시보드 설정에 액세스하려면 선택합니다.
  +  **삭제:** 대시보드를 마지막으로 저장한 이후 패널에 대한 변경 사항을 삭제합니다.
  +  **저장:** 패널에 대한 변경 사항을 저장합니다.
  +  **적용:** 변경 사항을 적용하고 패널 편집기를 닫으면 대시보드로 돌아갑니다. 적용된 변경 사항을 유지하려면 대시보드를 저장해야 합니다.
+  시각화 미리 보기: 시각화 미리 보기 섹션에는 다음 옵션이 포함되어 있습니다.
  +  **테이블 보기:** 데이터를 볼 수 있도록 시각화를 테이블로 변환합니다. 테이블 보기는 문제 해결에 유용합니다. 이 보기에는 원시 데이터만 포함됩니다. 여기에는 데이터 또는 [테이블](v9-panels-table.md) 시각화에서 사용할 수 있는 형식 지정 옵션에 적용했을 수 있는 변환은 포함되지 않습니다.
  +  **채우기:** 시각화 미리 보기가 사용 가능한 공간을 채웁니다. 측면 창의 너비 또는 하단 창의 높이를 변경하면 시각화가 사용 가능한 공간을 채우도록 변경됩니다.
  +  **실제:** 시각화 미리 보기의 크기는 대시보드의 크기와 정확히 동일합니다. 공간이 충분하지 않으면 종횡비를 유지하며 시각화가 스케일 다운됩니다.
  +  **시간 범위 제어:** **기본값**은 브라우저 로컬 시간대 또는 더 상위 수준에서 선택한 시간대입니다.
+  데이터 섹션: 데이터 섹션에는 쿼리를 입력하고, 데이터를 변환하며, 알림 규칙을 생성하는 탭(해당하는 경우)이 포함되어 있습니다.
  +  **쿼리 탭:** 데이터 소스를 선택하고 여기에 쿼리를 입력합니다.
  +  **변환 탭:** 데이터 변환을 적용합니다.
  +  **알림 탭:** 알림 규칙을 작성합니다.
+  패널 표시 옵션: 표시 옵션 섹션에는 데이터 시각화의 거의 모든 측면을 구성하는 탭이 포함되어 있습니다.

## 패널 검사 드로어 열기
<a name="v9-panels-editor-open-panel"></a>

 검사 드로어는 패널을 이해하고 문제를 해결하는 데 도움이 됩니다. 모든 패널의 원시 데이터를 보고, 해당 데이터를 쉼표로 구분된 값(CSV) 파일로 내보내며, 쿼리 요청을 보고, 패널 및 데이터 JSON을 내보낼 수 있습니다.

 **참고:** 모든 패널 유형에 모든 탭이 포함되는 것은 아닙니다. 예를 들어 대시보드 목록 패널에는 검사할 원시 데이터가 없으면 통계, 데이터 또는 쿼리 탭이 표시되지 않습니다.

 패널 검사기는 다음 옵션으로 구성됩니다.
+  패널 검사 드로어는 오른쪽에서 드로어를 열어서 표시합니다. 오른쪽 상단의 화살표를 클릭하여 드로어 창을 확장하거나 줄입니다.
+  **데이터 탭** - 변환이 적용된 상태로 쿼리에서 반환된 원시 데이터를 표시합니다. 재정의 및 값 매핑과 같은 필드 옵션은 기본적으로 적용되지 않습니다.
+  **통계 탭** - 쿼리에 걸리는 시간과 반환되는 양을 보여줍니다.
+  **JSON 탭** - 패널 JSON, 패널 데이터 JSON 및 데이터 프레임 구조 JSON을 보고 복사할 수 있습니다. Grafana를 프로비저닝하거나 관리하는 경우에 유용합니다.
+  **쿼리 탭** - Grafana에서 데이터 소스를 쿼리할 때 서버로 전송된 요청을 표시합니다.
+  **오류 탭** - 오류를 표시합니다. 쿼리가 오류를 반환할 때만 표시됩니다.

# 패널 옵션 구성
<a name="v9-panels-configure-panel-options"></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 모델 보기 
+  반복 행 및 패널 추가 

## 패널 편집
<a name="v9-panels-edit-a-panel"></a>

 대시보드에 패널을 추가한 후 언제든지 패널을 열어 쿼리를 변경 또는 업데이트하고, 데이터 변환을 추가하며, 시각화 설정을 변경할 수 있습니다.

1.  편집하려는 패널이 포함된 대시보드를 여세요.

1.  패널의 아무 부분이나 마우스로 가리키면 오른쪽 상단에 작업 메뉴가 표시됩니다.

1.  링크를 클릭하고 **편집**을 선택하세요.

    키보드 단축키를 사용하여 패널을 열려면 패널 위로 마우스를 가져가서 **e**를 누르세요.

    패널이 편집 모드로 열립니다.

## 패널에 제목 및 설명 추가
<a name="v9-panels-add-title-description"></a>

 패널에 제목과 설명을 추가하여 시각화에 대한 중요한 정보를 사용자와 공유합니다. 예를 들어 설명을 사용하여 시각화의 목적을 문서화합니다.

1.  패널을 편집하세요.

1.  패널 표시 옵션 창에서 **패널 옵션** 섹션을 찾으세요.

1.  **제목**을 입력하세요.

    이 필드에 입력한 텍스트는 패널 편집기 및 대시보드의 툴팁에 표시됩니다.

1.  표시하려는 패널과 데이터에 대한 설명을 작성하세요.

    이 필드에 입력한 텍스트는 패널의 왼쪽 상단에 있는 툴팁에 나타납니다.

    **제목** 및 **설명** 필드에 [정의한 변수](v9-dash-variables.md)를 사용할 수 있지만 [전역 변수](v9-dash-variable-add.md#v9-dash-variable-add-global)는 사용할 수 없습니다.

    

## 패널 JSON 모델 보기
<a name="v9-panels-json-model"></a>

 패널, 패널 데이터 및 데이터 프레임 JSON 모델을 탐색하고 내보내세요.

1.  패널이 포함된 대시보드를 여세요.

1.  패널의 아무 부분이나 마우스로 가리키면 오른쪽 상단에 작업 메뉴가 표시됩니다.

1.  메뉴에서 **검사 > 패널 JSON**을 선택하세요.

1.  **소스 코드** 섹션에서 다음 옵션 중 하나를 선택하세요.
   +  **패널 JSON:** 패널을 나타내는 JSON 객체를 표시합니다.
   +  **패널 데이터:** 패널에 전달된 데이터를 나타내는 JSON 객체를 표시합니다.
   +  **DataFrame 구조:** 변환, 필드 구성 및 재정의 구성이 적용된 원시 결과 세트를 표시합니다.

1.  JSON을 탐색하려면 **>**를 클릭하여 JSON 모델의 일부를 확장하거나 축소하세요.

## 반복 패널 구성
<a name="v9-panels-configure-repeating-panels"></a>

 대시보드에 패널 또는 행을 동적으로 추가하도록 Grafana를 구성할 수 있습니다. 동적 패널은 시스템에서 변수의 값을 기반으로 생성하는 패널입니다. 변수는 대시보드의 모든 패널에서 쿼리를 동적으로 변경합니다.

**참고**  
패널을 반복하려면 변수에서 하나 이상의 항목을 선택해야 합니다. 패널을 0회 반복하여 숨길 수 없습니다.

 **시작하기 전:** 
+  쿼리에 다중 값 변수가 포함되어 있는지 확인합니다.

 **반복 패널을 구성하는 방법:** 

1. 반복하려는 패널을 편집하세요.

1.  표시 옵션 창에서 **패널 옵션 > 반복 옵션**을 클릭하세요.

1.  **방향**을 선택하세요.
   +  패널을 나란히 정렬하려면 **가로**를 선택하세요. Grafana에서는 반복 패널의 너비를 조정합니다. 현재 행의 다른 패널을 반복 패널과 혼합할 수 없습니다.
   +  **세로**를 선택하여 열에 패널을 정렬하세요. 반복 패널의 너비는 원본 반복 패널과 동일합니다.

1.  모든 패널에 변경 사항을 전파하려면 대시보드를 다시 로드하세요.

# 표준 옵션 구성
<a name="v9-panels-configure-standard-options"></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에서 데이터를 표시하는 방식을 변경합니다. 옵션을 변경하면 모든 필드, 즉 모든 시리즈 또는 열에 적용됩니다. 예를 들어 단위를 백분율로 변경하면 숫자 값이 있는 모든 필드가 백분율로 표시됩니다.

 필드 형식 지정 옵션의 전체 목록은 [표준 옵션 정의](#v9-panels-standard-options-definitions)를 참조하세요.

**참고**  
 대부분의 기본 제공 Grafana 패널에 표준 옵션을 적용할 수 있습니다. 새 패널 및 데이터 모델로 업데이트되지 않은 일부 이전 패널 및 커뮤니티 패널에서는 이러한 필드 옵션의 전부 또는 일부가 누락됩니다.

1.  대시보드를 열고 패널 제목을 클릭한 다음, **편집**을 클릭하세요.

1.  패널 표시 옵션 창에서 **표준 옵션** 섹션을 찾으세요.

1.  적용할 표준 옵션을 선택하세요.

1.  변경 내용을 미리 보려면 편집하려는 필드 옵션 상자 외부를 클릭하거나 **Enter**를 누르세요.

## 표준 옵션 정의
<a name="v9-panels-standard-options-definitions"></a>

 이 섹션에서는 사용 가능한 모든 표준 옵션을 설명합니다.

 대부분의 기본 제공 Grafana 패널에 표준 옵션을 적용할 수 있습니다. 새 패널 및 데이터 모델로 업데이트되지 않은 일부 이전 패널 및 커뮤니티 패널에서는 이러한 필드 옵션의 전부 또는 일부가 누락됩니다.

 편집하려는 필드 옵션 상자 외부를 클릭하거나 Enter를 누를 때까지 대부분의 필드 옵션은 시각화에 영향을 주지 않습니다.

**참고**  
 모든 시각화에 대한 옵션을 추가하고 확장하기 위해 지속적으로 노력하고 있으므로 모든 시각화에 대해 모든 옵션을 사용하지 못할 수도 있습니다.

### 단위
<a name="v9-panels-standard-options-unit"></a>

 필드에서 사용해야 하는 단위를 선택할 수 있습니다. **단위** 필드를 클릭한 다음, 원하는 단위를 찾을 때까지 드릴다운합니다. 선택한 단위는 시간을 제외한 모든 필드에 적용됩니다.

#### 사용자 지정 단위
<a name="v9-panels-standard-options-custom-units"></a>

 단위 드롭다운을 사용하여 사용자 지정 단위, 사용자 지정 접두사 또는 접미사 및 날짜 시간 형식을 지정할 수도 있습니다.

 사용자 지정 단위를 선택하려면 단위를 입력하고 드롭다운에서 마지막 **사용자 지정: xxx** 옵션을 선택합니다.
+  **suffix:<suffix>** - 값 다음에 와야 하는 사용자 지정 단위.
+  **prefix:<prefix>** - 값보다 이전이어야 하는 사용자 지정 단위.
+  **time:<format>** - 사용자 지정 날짜 시간 형식(예: **time:YYYY-MM-DD**). 형식 구문 및 옵션은 [형식](https://momentjs.com/docs/#/displaying/)을 참조하세요.
+  **si:<base scale><unit characters>** - 사용자 지정 SI 단위. 예: **si: mF**. 단위와 소스 데이터 스케일을 모두 지정할 수 있으므로 조금 더 고급입니다. 따라서 소스 데이터가 밀리 단위(천 단위)로 표시되는 경우 SI 스케일 문자를 단위의 접두사로 추가합니다.
+  **count:<unit>** - 사용자 지정 개수 단위.
+  **currency:<unit>** - 사용자 지정 통화 단위.

 단위 선택기에 기본 이모티콘을 붙여넣고 사용자 지정 단위로 선택할 수도 있습니다.

#### 문자열 단위
<a name="v9-panels-standard-options-string-units"></a>

 Grafana에서는 문자열을 구문 분석하고 숫자로 표시하는 데 있어 때때로 너무 공격적일 수 있습니다. 원본 문자열 값을 표시하도록 Grafana를 구성하려면 필드 재정의를 생성하고 **문자열** 단위로 단위 속성을 추가합니다.

### 최소
<a name="v9-panels-standard-options-min"></a>

 백분율 임계치 계산에 사용되는 최솟값을 설정할 수 있습니다. 모든 시리즈 및 필드를 기반으로 자동 계산하려면 비워 둡니다.

### 최대
<a name="v9-panels-standard-options-max"></a>

 백분율 임계치 계산에 사용되는 최댓값을 설정할 수 있습니다. 모든 시리즈 및 필드를 기반으로 자동 계산하려면 비워 둡니다.

### 소수점
<a name="v9-panels-standard-options-decimals"></a>

 Grafana에서 렌더링된 값에 포함하는 소수점 수를 지정합니다. 이 필드를 비워 두면 Grafana에서는 값을 기반으로 소수점 숫자를 자동으로 잘라냅니다. 예를 들어 1.1234는 1.12로 표시되고 100.456은 100으로 표시됩니다.

 모든 소수점을 표시하려면 단위를 **문자열**로 설정합니다.

### 표시 명칭
<a name="v9-panels-standard-options-displayname"></a>

 모든 필드의 표시 제목을 설정할 수 있습니다. [변수](v9-dash-variables.md)를 사용할 수 있습니다.

 여러 통계, 필드 또는 시리즈가 표시되면 이 필드는 각 통계의 제목을 제어합니다. **\$1\$1\$1\$1field.name\$1**과 같은 표현식을 사용하여 제목에 시리즈 이름 또는 필드 이름만 사용할 수 있습니다.

 이름이 Temp이고 레이블이 \$1"Loc"="PBI", "Sensor"="3"\$1인 필드의 경우 


|  표현식 구문  |  예제  |  렌더링 대상  |  설명  | 
| --- | --- | --- | --- | 
|  \$1\$1\$1\$1field.displayName\$1  |  구문과 동일  |  Temp \$1Loc="PBI", Sensor="3"\$1  |  \$1\$1에 필드 이름과 레이블(있는 경우)을 표시합니다. 응답에 레이블 키가 하나만 있는 경우 레이블 부분에서 Grafana는 묶는 괄호 없이 레이블 값을 표시합니다. | 
|  \$1\$1\$1\$1field.name\$1  |  구문과 동일  |  임시 파일   |  필드 이름을 표시합니다(레이블 제외). | 
|  \$1\$1\$1\$1field.labels\$1  |  구문과 동일  |  Loc="PBI", Sensor="3" |  이름 없이 레이블을 표시합니다. | 
|  \$1\$1\$1\$1field.labels.X\$1  |  \$1\$1\$1\$1field.labels.Loc\$1  |  PBI  |  지정된 레이블 키의 값을 표시합니다. | 
|  \$1\$1\$1\$1field.labels.\$1\$1values\$1  |  구문과 동일  |  PBI, 3  |  쉼표로 구분된 레이블의 값을 표시합니다(레이블 키 없음). | 

 특정 필드에 대한 표현식을 렌더링한 후 값이 빈 문자열인 경우 기본 표시 방법이 사용됩니다.

### 색상 체계
<a name="v9-panels-standard-options-color-scheme"></a>

 색상 옵션과 시각화에 미치는 영향은 작업 중인 시각화에 따라 달라집니다. 일부 시각화에는 다양한 색상 옵션이 있습니다.

 값을 기준으로 단일 색상을 지정하거나 연속(그라데이션) 색상 체계를 선택할 수 있습니다. 연속 색상은 최소 및 최대를 기준으로 값의 백분율을 사용하여 색상을 보간합니다.

 다음 팔레트 중 하나를 선택합니다.


|  색상 모드  |  설명  | 
| --- | --- | 
|  단일 색상  |  재정의 규칙에 유용한 단일 색상 지정  | 
|  시작 임계치  |  Grafana에 일치하는 임계치에서 색상을 가져오도록 알림  | 
|  클래식 팔레트  |  Grafana에서는 시리즈 인덱스별로 팔레트의 색상을 검색하여 색상을 할당합니다. 그래프 및 파이 차트와 기타 범주형 데이터 시각화에 유용합니다. | 
|  녹색-노란색-빨간색(값 기준)  |  연속 색상 체계  | 
|  파란색-노란색-빨간색(값 기준)  |  연속 색상 체계  | 
|  파란색(값 기준)  |  연속 색상 체계(패널 배경에서 파란색으로)  | 
|  빨간색(값 기준)  |  연속 색상 체계(패널 배경 색상에서 파란색으로)  | 
|  녹색(값 기준)  |  연속 색상 체계(패널 배경 색상에서 파란색으로)  | 
|  보라색(값 기준)  |  연속 색상 체계(패널 배경 색상에서 파란색으로)  | 

### 값 없음
<a name="v9-panels-standard-options-no-value"></a>

 필드 값이 비어 있거나 null인 경우 Grafana에서 표시할 값을 입력하세요. 기본값은 하이픈(-)입니다.

# 데이터 쿼리 및 변환
<a name="v9-panels-query-xform"></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는 다양한 유형의 [데이터 소스](AMG-data-sources.md)를 지원합니다. 데이터 소스 *쿼리*는 Grafana에서 *변환*하고 시각화할 수 있는 데이터를 반환합니다. 각 데이터 소스는 자체 쿼리 언어를 사용하며, 데이터 소스 플러그인은 각각 쿼리 편집기라고 하는 쿼리 빌드 사용자 인터페이스를 구현합니다.

## 쿼리 정보
<a name="v9-panels-query-xform-about"></a>

Grafana 패널은 시각화를 위한 데이터를 검색하는 쿼리를 통해 데이터 소스와 통신합니다. 쿼리는 데이터 소스에서 사용하는 쿼리 언어로 작성된 질문입니다.

패널의 데이터 소스 옵션에서 쿼리 빈도 및 데이터 수집 제한을 구성할 수 있습니다. Grafana는 패널당 최대 26개의 쿼리를 지원합니다.

각 데이터 소스의 쿼리 언어에 대한 자세한 내용은 [데이터 소스](AMG-data-sources.md) 섹션에서 확인할 수 있습니다.

**쿼리 편집기**

각 데이터 소스의 *쿼리 편집기*는 고유한 기능을 활용하는 쿼리를 작성하는 데 도움이 되는 사용자 지정 사용자 인터페이스를 제공합니다.

쿼리 언어 간의 차이로 인해 각 데이터 소스 쿼리 편집기는 모양과 기능이 다릅니다. 데이터 소스에 따라 쿼리 편집기는 자동 완성 기능, 지표 이름, 변수 제안 또는 시각적 쿼리 빌드 인터페이스를 제공할 수 있습니다.

특정 데이터 소스의 고유한 쿼리 편집기 기능에 대한 자세한 내용은 해당 설명서를 참조하세요.
+ Grafana에 포함된 데이터 소스는 [기본 제공 데이터 소스](AMG-data-sources-builtin.md)를 참조하세요.
+ Grafana Enterprise 버전에 포함된 데이터 소스는 [Enterprise 데이터 소스에 연결](AMG-data-sources-enterprise.md) 섹션을 참조하세요.

**쿼리 구문**

데이터 소스는 다양한 쿼리 언어를 사용하여 데이터를 요청합니다. 특정 데이터 소스의 고유한 쿼리 언어에 대한 자세한 내용은 해당 설명서를 참조하세요.

**PostgreSQL 예제:**

```
SELECT hostname FROM host WHERE region IN($region)
```

**PromQL 예제:**

```
query_result(max_over_time(<metric>[${__range_s}s]) != <state>)
```

**특수 데이터 소스**

또한 Grafana에는 **Grafana**, **혼합**, **대시보드**와 같은 세 가지 특수 데이터 소스도 포함되어 있습니다. 자세한 내용은 데이터 소스를 참조하세요.

## 쿼리 탭 탐색
<a name="v9-panels-query-xform-navigate"></a>

패널의 **쿼리** 탭은 다음 요소로 구성됩니다.
+ **데이터 소스 선택기** - 쿼리할 데이터 소스를 선택합니다.
+ **쿼리 옵션:** 최대 데이터 검색 파라미터 및 쿼리 실행 시간 간격을 설정합니다.
+ **쿼리 검사기 버튼:** 쿼리를 보고 최적화할 수 있는 쿼리 검사기 패널을 엽니다.
+ **쿼리 편집기 목록:** 작성한 쿼리를 나열합니다.
+ **표현식:** 표현식 빌더를 사용하여 경고 표현식을 생성합니다. 표현식에 대한 자세한 내용은 [표현식 쿼리 쓰기](v9-panels-query-xform-expressions.md) 섹션을 참조하세요.

## 쿼리 추가
<a name="v9-panels-query-xform-add"></a>

쿼리는 Grafana가 대시보드 패널에서 시각화하는 데이터를 반환합니다. 패널을 생성하면 Grafana에서 기본 데이터 소스를 자동으로 선택합니다.

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

1. 쿼리를 추가할 패널을 편집하세요.

1. **쿼리(Query)** 탭을 선택합니다.

1. **데이터 소스** 드롭다운 메뉴를 선택하고 데이터 소스를 선택하세요.

1. **쿼리 옵션**을 선택하여 필요한 최대 데이터 포인트 수를 구성하세요. 기타 옵션에 대한 자세한 내용은 [쿼리 옵션](#v9-panels-query-xform-options) 섹션을 참조하세요.

1. 쿼리 편집기를 사용하여 쿼리를 작성하세요.

1. **적용**을 선택합니다.

Grafana에서 데이터 소스를 쿼리하고 데이터를 시각화합니다.

## 쿼리 관리
<a name="v9-panels-query-xform-manage"></a>

Grafana에서는 축소 가능한 쿼리 행으로 쿼리를 구성합니다. 각 쿼리 행에는 쿼리 편집기가 포함되어 있으며 문자(A, B, C 등)로 식별됩니다.

쿼리를 관리하기 위해 쿼리를 복사하고, 쿼리를 숨기며, 쿼리를 제거하고, 쿼리를 재정렬하며, 쿼리 편집기에 대한 도움말을 전환할 수 있습니다.

## 쿼리 옵션
<a name="v9-panels-query-xform-options"></a>

선택한 데이터 소스에 대한 설정을 보려면 데이터 소스 선택기 옆에 있는 **쿼리 옵션**을 선택합니다. 여기서 변경한 내용은 이 패널에서 수행된 쿼리에만 영향을 줍니다.

Grafana는 어두운 회색 텍스트로 표시되는 기본값을 설정합니다. 변경 사항은 흰색 텍스트로 표시됩니다. 필드를 기본 설정으로 되돌리려면 필드에서 흰색 텍스트를 삭제합니다.

패널 데이터 소스 쿼리 옵션은 다음을 포함합니다.
+ **최대 데이터 포인트** - 데이터 소스가 지원하는 경우 반환되는 각 시리즈의 최대 데이터 포인트 수를 설정합니다. 쿼리가 최대 데이터 포인트 설정보다 더 많은 데이터 포인트를 반환하는 경우 데이터 소스는 평균, 최대 또는 다른 함수별로 집계하여 반환되는 포인트 수를 줄입니다.

  포인트 수를 제한하여 쿼리 성능을 개선하거나 시각화된 라인을 평활화할 수 있습니다. 기본값은 그래프의 너비 또는 픽셀 수입니다. 그래프 패널에 표시할 공간이 있는 만큼의 데이터 포인트만 시각화할 수 있기 때문입니다.

  스트리밍 데이터에서 Grafana는 롤링 버퍼에 최대 데이터 포인트 값을 사용합니다. 스트리밍은 데이터의 지속적인 흐름이며 버퍼링은 스트림을 청크로 나눕니다. 예를 들어 Loki에서는 라이브 테일링 모드에서 데이터를 스트리밍합니다.
+ **최소 간격** - 자동으로 계산된 간격의 최소 한도(보통 최소 스크레이프 간격)을 설정합니다. 데이터 포인트를 15초마다 저장하는 경우 간격을 이보다 짧게 설정하지 않아도 됩니다. 또한 보다 대략적이지만 잘 작동하는 쿼리를 가져오기 위해 이 값을 스크레이프 간격보다 더 높은 최솟값으로 설정할 수 있습니다.
+ **간격** - 데이터 포인트를 시간별로 집계하거나 그룹화할 때 사용할 수 있는 시간 범위를 설정합니다.

  Grafana는 템플릿 쿼리에서 변수로 사용할 수 있는 적절한 간격을 자동으로 계산합니다. 변수는 초(`$__interval`) 또는 밀리초(`$__interval_ms`)로 측정됩니다.

  간격은 일반적으로 합계 또는 평균과 같은 집계 함수에 사용됩니다. 예를 들어 간격 변수(`rate(http_requests_total[$__interval])`)를 사용하는 Prometheus 쿼리입니다.

  이 자동 간격은 그래프의 너비를 기준으로 계산됩니다. 사용자가 시각화를 축소하면 간격이 증가하고 대략적인 집계가 생성됩니다. 마찬가지로 사용자가 확대하면 간격이 감소하고 보다 세분화된 집계가 생성됩니다.

  자세한 내용은 [전역 변수](v9-dash-variable-add.md#v9-dash-variable-add-global) 단원을 참조하십시오.
+ **상대 시간** - 대시보드의 오른쪽 상단에 있는 대시보드 시간 선택기에서 선택한 것과 다르게 개별 패널의 상대 시간 범위를 재정의합니다. 이를 사용하여 동일한 대시보드에 서로 다른 기간 또는 일수의 지표를 표시할 수 있습니다.
**참고**  
대시보드의 시간 범위가 절대값인 경우 패널 시간 재정의가 영향을 미치지 않습니다.    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/grafana/latest/userguide/v9-panels-query-xform.html)
+ **시간 전환** - 시간 선택기에 상대적인 시작 및 종료를 전환하여 개별 패널의 시간 범위를 재정의합니다. 예를 들어 패널의 시간 범위를 대시보드 시간 선택기보다 2시간 빠르게 전환할 수 있습니다.
**참고**  
대시보드의 시간 범위가 절대값인 경우 패널 시간 재정의가 영향을 미치지 않습니다.    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/grafana/latest/userguide/v9-panels-query-xform.html)
+ **캐시 제한 시간** - *(데이터 소스에서 사용할 수 있는 경우에만 표시됨)* 시계열 저장소에 쿼리 캐시가 있는 경우 기본 캐시 제한 시간을 재정의합니다. 이 값을 초 단위의 숫자 값으로 지정합니다.

# 표현식 쿼리 쓰기
<a name="v9-panels-query-xform-expressions"></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-panels-query-about"></a>

서버 측 표현식을 사용하면 수학 및 기타 연산을 사용하여 쿼리에서 반환된 데이터를 조작할 수 있습니다. 표현식에 데이터를 허용 가능한 입력으로 사용할 수 있도록 일부 사소한 데이터 구조 조정을 제외하고 표현식에서는 새 데이터를 생성하고 데이터 소스에서 반환하는 데이터를 조작하지 않습니다.

**표현식 사용**

표현식은 주로 [Grafana 알림](v9-alerts.md)에서 사용됩니다. 처리는 서버 측에서 수행되므로 표현식은 브라우저 세션 없이 작동할 수 있습니다. 그러나 표현식은 백엔드 데이터 소스 및 시각화와 함께 사용할 수도 있습니다.

**참고**  
표현식은 레거시 대시보드 알림에서 작동하지 않습니다.

표현식은 서로 다른 데이터 소스의 쿼리를 결합할 수 있도록 하거나 데이터 소스에서 사용할 수 없는 작업을 제공하여 데이터 소스를 보강하기 위한 기능입니다.

**참고**  
가능하면 데이터 소스 내에서 데이터 처리를 수행해야 합니다. 처리를 위해 스토리지에서 Grafana 서버로 데이터를 복사하는 것은 비효율적이므로 표현식은 경량 데이터 처리를 목표로 합니다.

표현식은 시계열 또는 숫자 데이터를 반환하는 데이터 소스 쿼리와 함께 작동합니다. 또한 [다차원 데이터](getting-started-grafanaui.md#time-series-dimensions)에서도 작동합니다. 예를 들어 여러 시리즈를 반환하는 쿼리가 있으며 여기에서는 각 시리즈가 레이블 또는 태그로 식별됩니다.

개별 표현식은 하나 이상의 쿼리 또는 기타 표현식을 입력으로 사용하여 데이터를 결과에 추가합니다. 각 개별 표현식 또는 쿼리는 RefID로 알려진 이름 지정된 식별자(예: 기본 문자 `A` 또는 `B`)인 변수로 표시됩니다.

개별 표현식의 출력 또는 다른 표현식의 데이터 소스 쿼리를 참조하기 위해 이 식별자는 변수로 사용됩니다.

**표현식 유형**

표현식은 두 가지 유형의 데이터에서 작동합니다.
+ 시계열 컬렉션.
+ 각 번호가 항목인 숫자 컬렉션.

각 컬렉션은 단일 데이터 소스 쿼리 또는 표현식에서 반환되며 RefID로 표시됩니다. 각 컬렉션은 하나의 세트로,세트의 각 항목은 [레이블](getting-started-grafanaui.md#labels) 또는 키-값 페어로 저장되는 차원으로 고유하게 식별됩니다.

**데이터 소스 쿼리**

서버 측 표현식은 백엔드 데이터 소스에 대한 데이터 소스 쿼리만 지원합니다. 데이터는 일반적으로 레이블 지정된 시계열 데이터로 간주됩니다. 이후에 표현식에서 오류를 더 잘 처리할 수 있도록 쿼리 반환 유형(숫자 또는 시계열) 데이터의 어설션을 추가했습니다.

표현식과 함께 사용되는 데이터 소스 쿼리는 표현식 엔진에서 실행됩니다. 이렇게 하면 데이터를 데이터 프레임당 하나의 시계열 또는 하나의 숫자로 재구성합니다. 예를 들어 테이블 보기에서 한 프레임에 여러 시리즈를 반환하는 데이터 소스를 사용하는 경우 표현식으로 실행할 때 다르게 보일 수 있습니다.

현재 시간, 문자열 열 및 하나의 숫자 열이 없는 데이터 프레임을 사용할 때 시계열 이외의 숫자 형식만 지원됩니다.


| Loc | Host | Avg\$1CPU | 
| --- | --- | --- | 
|  MIA  |  A  |  1  | 
|  NYC  |  B  |  2  | 

위의 예제에서는 표현식에서 작동하는 숫자를 생성합니다. 문자열 열은 레이블이 되고 숫자 열은 해당 값이 됩니다. 예를 들어 값이 1인 `{"Loc": "MIA", "Host": "A"}`가 있습니다.

**운영**

표현식에서 수학, 축소 및 리샘플링 연산을 사용할 수 있습니다.

**수학 연산**

수학은 시계열 또는 숫자 데이터의 자유 형식 수학 공식에 사용됩니다. 수학 연산은 숫자와 시계열을 입력으로 가져와 다른 숫자와 시계열로 변경합니다.

다른 쿼리 또는 표현식의 데이터는 `$A`와 같이 달러 기호가 붙은 RefID 접두사로 참조됩니다. 변수의 이름에 공백이 있는 경우 `${my variable}`과 같은 괄호 구문을 사용할 수 있습니다.

숫자 상수는 십진수(`2.24`), 8진수(선행 0 포함, 예: `072`) 또는 16진수(선행 0x 포힘, 예: `0x2A`)일 수 있습니다. 지수 및 기호도 지원됩니다(예: `-0.8e-2`).

**연산자**

산술(`+`, 바이너리 및 단항 `-`, `*`, `/`, `%`, 지수 `**`), 관계형(`<`, `>`, `==`, `!=`, `>=`, `<=`), 논리(`&&`, `||` 및 단항 `!`) 연산자가 지원됩니다.

연산에서 데이터 동작 방식은 데이터가 숫자인지 시계열 데이터인지에 따라 달라집니다.

`$A + $B` 또는 `$A || $B`와 같은 바이너리 연산에서 연산자는 데이터 유형에 따라 다음과 같은 방식으로 적용됩니다.
+ `$A` 및 `$B`가 모두 숫자인 경우 두 숫자 사이에서 연산이 수행됩니다.
+ 한 변수가 숫자이고 다른 변수가 시계열인 경우 시계열에서 각 포인트 값과 숫자 사이의 연산이 수행됩니다.
+ `$A` 및 `$B`가 모두 시계열 데이터인 경우 두 시리즈의 각 값 사이에서 연산은 `$A` 및 `$B`에 모두 존재하는 각 타임스탬프에 수행됩니다. `Resample` 연산을 사용하여 타임스탬프를 정렬할 수 있습니다.

요약:
+ 번호 OP 번호 = 번호
+ 숫자 OP 시리즈 = 시리즈
+ 시리즈 OP 시리즈 = 시리즈

표현식은 단일 변수로 표시되는 여러 시리즈 또는 숫자와 함께 작동하므로 바이너리 연산도 두 변수 간에 합집합(조인)을 수행합니다. 각 개별 시리즈 또는 숫자와 연결된 식별 레이블을 기반으로 수행됩니다.

따라서 `$A`에서 `{host=web01}`과 같은 레이블을 포함하는 숫자와 `$B`의 다른 숫자가 있는 경우 각 변수 내 두 항목 사이에서 연산이 수행되고 결과에서는 동일한 레이블을 공유합니다. 이 합집합의 동작 규칙은 다음과 같습니다.
+ 레이블이 없는 항목은 모든 항목에 조인됩니다.
+ `$A` 및 `$B`에 각각 하나의 항목(시리즈 하나 또는 숫자 하나)만 포함된 경우 조인됩니다.
+ 레이블이 정확히 일치하는 경우 조인됩니다.
+ 레이블이 다른 레이블의 하위 세트인 경우(예: `$A`의 항목에 `{host=A,dc=MIA}` 레이블이 지정되고 `$B`의 항목에 `{host=A}` 레이블이 지정된 경우) 조인됩니다.
+ `$A`와 같은 변수 내에서 각 항목에 대해 태그 키가 서로 다르면 조인 도작은 정의되지 않습니다.

관계형 연산자와 논리 연산자는 거짓인 경우 0, 참인 경우 1을 반환합니다.

**수학 함수**

대부분의 함수는 자체 표현식 연산에 존재하지만 수학 연산에는 수학 연산자 또는 기호와 유사한 일부 함수가 있습니다. 함수가 숫자 또는 시리즈를 가져올 수 있는 경우 인수와 동일한 유형이 반환됩니다. 시리즈인 경우 시리즈의 각 포인트 값에 대해 연산이 수행됩니다.

*abs*

abs는 인수의 절댓값을 반환하며, 이는 숫자 또는 시리즈일 수 있습니다. 예를 들면 `abs(-1)` 또는 `abs($A)`입니다.

*is\$1inf*

is\$1inf는 숫자 또는 시리즈를 가져와 `Inf` 값에 대해 `1`(음수 또는 양수), 기타 값에 대해 `0`을 반환합니다. 예: `is_inf($A)`.

**참고**  
예를 들어 특별히 음의 무한대를 확인해야 하는 경우 `$A == infn()`과 같은 비교를 수행할 수 있습니다.

*is\$1nan*

is\$1nan은 숫자 또는 시리즈를 가져와 `NaN` 값에 대해 `1`, 기타 값에 대해 `0`을 반환합니다. 예: `is_nan($A)`. 이 함수는 `NaN`이 `NaN`과 같지 않으므로 존재합니다.

*is\$1null*

is\$1null은 숫자 또는 시리즈를 가져와 `null` 값에 대해 `1`, 기타 값에 대해 `0`을 반환합니다. 예: `is_null($A)`.

*is\$1number*

is\$1number는 숫자 또는 시리즈를 가져와 모든 실수 값에 대해 `1`, 기타 값((`null`, `Inf+`, `Inf-`, `NaN`)에 대해 `0`을 반환합니다. 예: `is_number($A)`.

*log*

Log는 인수의 자연 로그를 반환하며, 이는 숫자 또는 시리즈일 수 있습니다. 값이 0보다 작으면 `NaN`이 반환됩니다. 예를 들면 `log(-1)` 또는 `log($A)`입니다.

*inf, infn, nan, null*

inf, infn, nan 및 null 함수는 모두 이름의 단일 값을 반환합니다. 주로 테스트용으로 존재합니다. 예시: `null()`.

*round*

Round는 반올림된 정수 값을 반환합니다. 예: `round(3.123)` 또는 `round($A)`.

**ceil

Ceil은 숫자를 가장 가까운 정수 값으로 올림합니다. 예를 들어, `ceil(3.123)`은 `4`을 반환합니다.

**floor

Floor는 숫자를 가장 가까운 정수 값으로 내림합니다. 예를 들어, `floor(3.123`)은 `3`을 반환합니다.

**축소**

축소는 쿼리 또는 표현식에서 반환된 하나 이상의 시계열을 가져와 각 시리즈를 단일 숫자로 바꿉니다. 시계열의 레이블은 출력된 각 축소된 번호에서 레이블로 유지됩니다.

*필드:*
+ **함수** - 사용할 축소 함수
+ **입력** - 리샘플링할 변수(refID, 예: `A`)
+ **모드** - 시리즈에 숫자가 아닌 값(null, NaN, \$1-Inf)이 포함된 경우 축소 함수의 제어 동작 허용

**축소 함수**

*개수*

Count는 각 시리즈의 포인트 수를 반환합니다.

*Mean*

Mean은 각 시리즈에서 모든 값의 합계를 해당 시리즈의 포인트 수로 나눈 값을 반환합니다. `strict` 모드에서 시리즈의 값이 null 또는 nan이거나 시리즈가 비어 있는 경우 NaN이 반환됩니다.

**Min 및 Max

Min 및 Max는 각각 시리즈의 최솟값 또는 최댓값을 반환합니다. `strict` 모드에서 시리즈의 값이 null 또는 nan이거나 시리즈가 비어 있는 경우 NaN이 반환됩니다.

*합계*

Sum은 시리즈에 있는 모든 값의 합계를 반환합니다. 시리즈 길이가 0인 경우 합계는 0입니다. `strict` 모드에서 시리즈에 NaN 또는 Null 값이 있는 경우 NaN이 반환됩니다.

**Last

Last는 시리즈의 마지막 숫자를 반환합니다. 시리즈에 값이 없는 경우 NaN을 반환합니다.

**축소 모드**

*Strict*

Strict 모드인 경우 입력 시리즈는 그대로 처리됩니다. 시리즈의 값이 숫자가 아닌 경우(null, NaN 또는 \$1-Inf) NaN이 반환됩니다.

*숫자 이외 항목 삭제*

이 모드에서 축소 함수를 실행하기 전에 입력 시리즈의 숫자가 아닌 모든 값(null, NaN 또는 \$1-Inf)은 필터링됩니다.

*숫자 이외 항목 대체*

이 모드에서 숫자가 아닌 모든 값은 사전 정의된 값으로 대체됩니다.

**Resample**

Resample은 각 시계열의 타임스탬프를 일관된 시간 간격으로 변경합니다. 기본 사용 사례는 동일한 타임스탬프를 공유하지 않는 시계열을 리샘플링하여 이들 사이에서 수학 연산을 수행할 수 있도록 하는 것입니다. 두 시리즈 각각을 리샘플링한 다음, 리샘플링된 변수를 참조하는 수학 연산에서 수행할 수 있습니다.

*필드:*
+ **입력** - 리샘플링할 시계열 데이터의 변수(refID, 예: `A`)
+ **리샘플링 대상** - 리샘플링할 시간의 지속 시간(예: `10s.`). 단위는 `s`(초의 경우), `m`(분의 경우), `h`(시간의 경우), `d`(일의 경우), `w`(주의 경우), `y`(년의 경우)일 수 있습니다.
+ **다운샘플링** - 기간 샘플당 데이터 포인트가 두 개 이상 있을 때 사용할 축소 함수. 동작 세부 정보는 축소 연산을 참조하세요.
+ **업샘플링** - 데이터 포인트가 없는 기간 샘플을 채우는 데 사용하는 방법.
  + **pad**는 알려진 마지막 값으로 채움
  + **backfill**은 알려진 다음 값을 사용함
  + **fillna**는 NaN으로 빈 샘플 기간을 채움

## 표현식 작성
<a name="v9-panels-query-write"></a>

데이터 소스가 지원하는 경우 Grafana는 **표현식** 버튼을 표시하고 쿼리 편집기 목록에 기존 표현식을 표시합니다.

**표현식을 작성하는 방법**

1. 패널을 여세요.

1. 쿼리 아래에서 **표현식**을 선택하세요.

1. **연산** 필드에서 작성할 표현식 유형을 선택하세요.

1. 표현식을 작성하세요.

1. **적용**을 선택합니다.

## 특수 사례
<a name="v9-panels-query-special"></a>

쿼리된 데이터 소스에서 시리즈 또는 숫자를 반환하지 않으면 표현식 엔진은 `NoData`를 반환합니다. 예를 들어 요청에 표현식으로 병합되는 두 개의 데이터 소스 쿼리가 포함된 경우 데이터 소스 쿼리 중 하나 이상에서 `NoData`가 반환되면 전체 쿼리에 대해 반환된 결과는 `NoData`입니다. Grafana 알림이 `NoData` 결과를 처리하는 방법에 대한 자세한 내용은 [데이터 없음 또는 오류 사례 처리](v9-alerting-managerules-grafana.md#v9-alerting-rule-no-data-error) 섹션을 참조하세요.

# 쿼리 결과를 다른 패널과 공유
<a name="v9-panels-query-share"></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는 하나의 쿼리를 전송하고 다른 패널은 쿼리 결과를 사용하여 시각화를 구성합니다.

이 전략은 예를 들어 동일한 데이터를 시각화하는 여러 패널이 있을 때 발생하는 쿼리 수를 크게 줄일 수 있습니다.

**쿼리 결과를 공유하는 방법**

1. [대시보드를 생성하세요](v9-dash-creating.md).

1. 제목을 `Source panel`로 변경하세요. 이 패널을 다른 패널의 소스로 사용합니다.

1. 공유하려는 쿼리를 정의하세요.

   데이터 소스를 사용할 수 없는 경우 테스트에 사용할 수 있는 무작위 시계열을 반환하는 **TestData** 데이터 소스를 사용할 수 있습니다.

1. 두 번째 패널을 추가한 다음, 쿼리 편집기에서 **대시보드** 데이터 소스를 선택하세요.

1. **패널 목록의 결과 사용**에서 생성한 첫 번째 패널을 선택하세요.

이제 소스 패널에 정의된 모든 쿼리를 새 패널에서 사용할 수 있습니다. 소스 패널에서 만든 쿼리는 여러 패널과 공유할 수 있습니다.

쿼리 중 하나를 클릭하여 정의된 패널로 이동할 수 있습니다.

# 데이터 변환
<a name="v9-panels-xform"></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-panels-xform-types"></a>

Grafana에서는 데이터를 변환할 수 있는 다양한 방법을 제공합니다. 다음은 변환 함수의 전체 목록입니다.

## 변환 순서
<a name="v9-panels-xform-order"></a>

변환이 여러 개 있는 경우 Grafana는 나열된 순서대로 변환을 적용합니다. 각 변환은 결과 세트를 생성한 다음, 처리 파이프라인의 다음 변환으로 전달합니다.

Grafana에서 변환을 적용하는 순서는 결과에 직접적인 영향을 미칩니다. 예를 들어 축소 변환을 사용하여 한 열의 모든 결과를 단일 값으로 압축하는 경우 해당 단일 값에만 변환을 적용할 수 있습니다.

## 데이터에 변환 함수 추가
<a name="v9-panels-xform-add"></a>

다음 단계에서는 데이터에 변환을 추가하는 방법을 안내합니다.

**패널에 변환을 추가하는 방법**

1. 하나 이상의 변환을 추가하려는 패널로 이동하세요.

1. 패널 제목을 선택하고 **편집**을 클릭하세요.

1. [**변환(Transform)**] 탭을 선택합니다.

1. 변환을 선택하세요. 변환 행이 나타납니다. 여기서 변환 옵션을 구성합니다.

1. 다른 변환을 적용하려면 **변환 추가**를 선택하세요. 이 변환은 이전 변환에서 반환된 결과 세트에 따라 작동한다는 점에 유의하세요.

## 변환 디버깅
<a name="v9-panels-xform-debug"></a>

변환의 입력 및 출력 결과 세트를 보려면 변환 행 오른쪽에 있는 버그 아이콘을 선택합니다.

입력 및 출력 결과 세트는 변환을 디버깅하는 데 도움이 될 수 있습니다.

## 변환 삭제
<a name="v9-panels-xform-delete"></a>

필요하지 않은 변환은 제거하는 것이 좋습니다. 변환을 삭제하면 시각화에서 데이터가 제거됩니다.

사전 조건:

변환에 의존하는 모든 대시보드를 식별하고 영향을 받는 대시보드 사용자에게 알립니다.

**변환을 삭제하는 방법**

1. 편집하도록 패널을 여세요.

1. [**변환(Transform)**] 탭을 선택합니다.

1. 삭제하려는 변환 옆에 있는 휴지통 아이콘을 선택하세요.

## 변환 함수
<a name="v9-panels-xform-functions"></a>

데이터에서 다음 변환을 수행할 수 있습니다.

**계산에서 필드 추가**

이 변환을 사용하여 두 개의 다른 필드에서 계산된 새 필드를 추가합니다. 각 변환을 통해 하나의 새 필드를 추가할 수 있습니다.
+ **모드** - 모드를 선택합니다.
  + **행 축소** - 선택한 필드의 각 행에서 선택한 계산을 독립적으로 적용합니다.
  + **바이너리 옵션** - 선택한 두 필드의 단일 행 값에 기본 수학 작업(덧셈, 곱셈 등)을 적용합니다.
+ **필드 이름** - 새 필드의 계산에 사용할 필드 이름을 선택합니다.
+ **계산** - **행 축소** 모드를 선택하면 **계산** 필드가 나타납니다. 필드를 클릭하면 새 필드를 생성하는 데 사용할 수 있는 계산 선택 사항 목록이 표시됩니다. 사용 가능한 계산에 대한 자세한 내용은 [계산 유형](v9-panels-calculation-types.md)을 참조하세요.
+ **연산** - **바이너리 옵션** 모드를 선택하면 **연산** 필드가 나타납니다. 이러한 필드를 사용하면 선택한 두 필드의 단일 행에 있는 값에 대해 기본 수학 연산을 수행할 수 있습니다. 바이너리 연산에 숫자 값을 사용할 수도 있습니다.
+ **별칭** – (선택 사항) 새 필드의 이름을 입력합니다. 이 항목을 비워 두면 계산과 일치하도록 필드 이름이 지정됩니다.
+ **모든 필드 바꾸기** - (선택 사항) 다른 모든 필드를 숨기고 시각화에 계산된 필드만 표시하려면 이 옵션을 선택합니다.

**필드 연결**

이 변환은 모든 프레임의 모든 필드를 하나의 결과로 결합합니다. 이 두 쿼리를 고려하세요.

쿼리 A:


| 임시 파일  | 가동 시간 | 
| --- | --- | 
|  15.4  |  1230233  | 

쿼리 B:


| AQI | 오류 | 
| --- | --- | 
|  3.2  |  5  | 

필드를 연결하면 데이터 프레임은 다음과 같습니다.


| 임시 파일  | 가동 시간 | AQI | 오류 | 
| --- | --- | --- | --- | 
|  15.4  |  1230233  |  3.2  |  5  | 

**쿼리 결과에서 구성**

이 변환을 사용하면 쿼리 하나를 선택하고 여기에서 **최소**, **최대**, **단위** 및 **임계치**와 같은 표준 옵션을 추출하여 다른 쿼리 결과에 적용할 수 있습니다. 그러면 동적 쿼리 기반 시각화 구성을 지원합니다.

구성 쿼리 결과의 모든 행에 대해 고유한 구성을 추출하려면 행에서 필드로 변환을 시도합니다.

**옵션**
+ **구성 쿼리** - 구성으로 사용할 데이터를 반환하는 쿼리를 선택합니다.
+ **적용 대상** - 구성을 적용할 필드 또는 시리즈를 선택합니다.
+ **옵션에 적용** - **적용 대상**에서 선택한 항목에 따라 필드 유형 또는 필드 이름 정규식.

**필드 유형 변환**

이 변환은 지정된 필드의 필드 유형을 변경합니다.
+ **필드** - 사용 가능한 필드 중에서 선택
+ **유형** - 변환할 FieldType 선택
  + **숫자** - 값 번호를 만들려고 시도
  + **문자열** - 값을 문자열로 구성
  + **시간** - 값을 시간으로 구문 분석하려고 시도
    + yyyy-mm-dd 또는 DD MM YYYY hh:mm:ss와 같은 문자열에 의한 입력으로 DateFormat을 지정하는 옵션을 표시합니다.
  + **부울** - 값을 부울로 구성

예를 들어 다음 쿼리에서는 시간 필드를 시간으로 선택하고 날짜 형식을 YYYY로 선택하여 수정할 수 있습니다.


| Time | 표시 | 값 | 
| --- | --- | --- | 
|  7/1/2017  |  위  |  25  | 
|  8/2/2018  |  아래  |  22  | 
|  9/2/2019  |  아래  |  29  | 
|  10/4/2020  |  위  |  22  | 

결과:


| Time | 표시 | 값 | 
| --- | --- | --- | 
|  1/1/2017  |  위  |  25  | 
|  1/1/2018  |  아래  |  22  | 
|  1/1/2019  |  아래  |  29  | 
|  1/1/2020  |  위  |  22  | 

**이름을 기준으로 데이터 필터링**

이 변환을 사용하여 쿼리 결과의 일부를 제거합니다.

Grafana에서는 **식별자** 필드와 이 다음에 다음 쿼리에서 반환된 필드를 표시합니다.

다음 두 가지 방법 중 하나로 필터를 적용할 수 있습니다.
+ 정규식을 입력합니다.
+ 필드를 선택하여 해당 필드에서 필터링을 전환합니다. 필터링된 필드는 어두운 회색 텍스트로 표시되고 필터링되지 않은 필드는 흰색 텍스트로 표시됩니다.

**쿼리를 기준으로 데이터 필터링**

하나 이상의 쿼리를 숨기려면 여러 쿼리가 있는 패널에서 이 변환을 사용합니다.

Grafana에서는 쿼리 식별 문자를 어두운 회색 텍스트로 표시합니다. 쿼리 식별자를 클릭하여 필터링을 전환합니다. 쿼리 문자가 흰색이면 결과가 표시됩니다. 쿼리 문자가 어두운 색이면 결과가 숨겨집니다.

**참고**  
이 데이터 소스는 반환된 데이터와 쿼리의 상관 관계를 지원하지 않으므로 Graphite에서는 이 변환을 사용할 수 없습니다.

**값을 기준으로 데이터 필터링**

이 변환을 통해 Grafana에서 직접 데이터를 필터링하고 쿼리 결과에서 일부 데이터 포인트를 제거할 수 있습니다. 정의한 하나 이상의 조건과 일치하는 데이터를 포함하거나 제외할 수 있습니다. 조건은 선택한 필드에 적용됩니다.

이 변환은 기본적으로 값을 기준으로 데이터 소스를 필터링하지 않는 경우에 유용합니다. 공유 쿼리를 사용하는 경우 이 변환을 사용하여 값을 좁혀 표시할 수도 있습니다.

모든 필드에 대해 사용할 수 있는 조건은 다음과 같습니다.
+ **정규식** - 정규식과 일치
+ **Null임** - 값이 null인 경우 일치
+ **Null이 아님** - 값이 null이 아닌 경우 일치
+ **같음** - 값이 지정된 값과 같은 경우 일치
+ **다름** - 값이 지정된 값과 다른 경우 일치

숫자 필드에 대해 사용할 수 있는 조건은 다음과 같습니다.
+ **초과** - 값이 지정된 값보다 큰 경우 일치
+ **미만** - 값이 지정된 값보다 낮은 경우 일치
+ **이상** - 값이 크거나 같은 경우 일치
+ **이하** - 값이 작거나 같은 경우 일치
+ **범위** - 지정된 최솟값과 최댓값 사이의 범위(경계 포함) 일치

다음 데이터세트를 고려합니다.


| Time | Temperature | Altitude | 
| --- | --- | --- | 
|  7/7/2020 오전 11:34:23  |  32  |  101  | 
|  7/7/2020 오전 11:34:22  |  28  |  125  | 
|  7/7/2020 오전 11:34:21  |  26  |  110  | 
|  7/7/2020 오전 11:34:20  |  23  |  98  | 
|  7/7/2020 오전 10:32:24  |  31  |  95  | 
|  7/7/2020 오전 10:31:22  |  20  |  85  | 
|  7/7/2020 오전 9:30:57  |  19  |  101  | 

온도가 30°C 미만인 데이터 포인트를 **포함**하면 구성은 다음과 같이 표시됩니다.
+ **필터 유형** - `Include`
+ **조건** - `Temperature`가 `Lower Than 30`과 일치하는 행

그리고 30°C 미만의 온도만 포함된 다음과 같은 결과를 얻을 수 있습니다.


| Time | Temperature | Altitude | 
| --- | --- | --- | 
|  7/7/2020 오전 11:34:22  |  28  |  125  | 
|  7/7/2020 오전 11:34:21  |  26  |  110  | 
|  7/7/2020 오전 11:34:20  |  23  |  98  | 
|  7/7/2020 오전 10:31:22  |  20  |  85  | 
|  7/7/2020 오전 9:30:57  |  19  |  101  | 

필터에 둘 이상의 조건을 추가할 수 있습니다. 예를 들어 고도가 100보다 큰 경우에만 데이터를 포함할 수 있습니다. 이렇게 하려면 다음 구성에 해당 조건을 추가합니다.
+ 필터 유형 - 조건과 `Match All`하는 `Include` 행
+ 조건 1 - `Temperature` 항목이 `30` `Lower` 조건에 일치하는 행
+ 조건 2 - `Altitude` 항목이 `100` `Greater` 조건에 일치하는 행

조건이 둘 이상인 경우 추가한 조건과 **임의 일치** 또는 **모두 일치** 조건을 충족하는 행에 작업(포함/제외)을 적용할지 여부를 선택할 수 있습니다.

위의 예제에서는 30 미만의 온도 및(AND) 100을 초과하는 고도에 해당하는 행을 포함하기 때문에 **모두 일치**를 선택했습니다. 대신 30 미만의 온도 또는(OR) 100을 초과하는 고도에 해당하는 행을 포함하려면 **임의 일치**를 선택합니다. 여기에는 온도가 32°C지만(첫 번째 조건과 일치하지 않음) 고도가 101인(두 번째 조건과 일치함) 경우 포함되므로, 원본 데이터의 첫 번째 행이 포함됩니다.

유효하지 않거나 불완전하게 구성된 조건은 무시됩니다.

**그룹화 기준**

이 변환은 지정된 필드(열) 값을 기준으로 데이터를 그룹화하고 각 그룹에 대한 계산을 처리합니다. 계산 선택 목록을 보려는 경우에 클릭합니다.

다음은 원본 데이터 예제입니다.


| Time | 서버 ID | CPU 온도 | 서버 상태 | 
| --- | --- | --- | --- | 
|  7/7/2020 오전 11:34:20  |  server 1  |  80  |  Shutdown  | 
|  7/7/2020 오전 11:34:20  |  server 3  |  62  |  정상  | 
|  7/7/2020 오전 10:32:20  |  server 2  |  90  |  Overload  | 
|  7/7/2020 오전 10:31:22  |  server 3  |  55  |  정상  | 
|  7/7/2020 오전 9:30:57  |  server 3  |  62  |  Rebooting  | 
|  7/7/2020 오전 9:30:05  |  server 2  |  88  |  정상  | 
|  7/7/2020 오전 9:28:06  |  server 1  |  80  |  정상  | 
|  7/7/2020 오전 9:25:05  |  server 2  |  88  |  정상  | 
|  7/7/2020 오전 9:23:07  |  server 1  |  86  |  정상  | 

이 변환은 두 단계로 구성됩니다. 먼저 데이터를 그룹화할 기준이 되는 하나 이상의 필드를 지정합니다. 그러면 정렬한 것처럼 해당 필드의 모든 동일한 값이 함께 그룹화됩니다. 예를 들어 서버 ID 필드를 기준으로 그룹화하면 다음과 같이 데이터를 그룹화합니다.


| Time | 서버 ID | CPU 온도 | 서버 상태 | 
| --- | --- | --- | --- | 
|  7/7/2020 오전 11:34:20  |  server 1  |  80  |  Shutdown  | 
|  7/7/2020 오전 9:28:06  |  server 1  |  80  |  정상  | 
|  7/7/2020 오전 9:23:07  |  server 1  |  86  |  정상  | 
|  7/7/2020 오전 10:32:20  |  server 2  |  90  |  Overload  | 
|  7/7/2020 오전 9:30:05  |  server 2  |  88  |  정상  | 
|  7/7/2020 오전 9:25:05  |  server 2  |  88  |  정상  | 
|  7/7/2020 오전 11:34:20  |  server 3  |  62  |  정상  | 
|  7/7/2020 오전 10:31:22  |  server 3  |  55  |  정상  | 
|  7/7/2020 오전 9:30:57  |  server 3  |  62  |  Rebooting  | 

서버 ID의 동일한 값을 가진 모든 행이 함께 그룹화됩니다.

데이터를 그룹화할 기준이 되는 필드를 선택한 후 다른 필드에 다양한 계산을 추가할 수 있으며 계산을 각 행 그룹에 적용합니다. 예를 들어 각 서버의 평균 CPU 온도를 계산할 수 있습니다. 따라서 CPU 온도 필드에 적용된 *평균* 계산을 추가하여 다음을 얻을 수 있습니다.


| 서버 ID | CPU 온도(평균) | 
| --- | --- | 
|  server 1  |  82  | 
|  server 2  |  88.6  | 
|  server 3  |  59.6  | 

그리고 둘 이상의 계산을 추가할 수 있습니다. 예를 들면 다음과 같습니다.
+ 시간 필드의 경우 *마지막* 값을 계산하여 각 서버에 마지막 데이터 포인트가 수신된 시기를 알 수 있습니다.
+ 서버 상태 필드의 경우 *마지막* 값을 계산하여 각 서버에 대한 마지막 상태 값을 알 수 있습니다.
+ 온도 필드의 경우 *마지막* 값을 계산하여 각 서버에 대해 모니터링되는 최신 온도를 알 수도 있습니다.

그러면 다음을 얻을 수 있습니다.


| 서버 ID | CPU 온도(평균) | CPU 온도(마지막) | 시간(마지막) | 서버 상태(마지막) | 
| --- | --- | --- | --- | --- | 
|  server 1  |  82  |  80  |  7/7/2020 오전 11:34:20  |  Shutdown  | 
|  server 2  |  88.6  |  90  |  7/7/2020 오전 10:32:20  |  Overload  | 
|  server 3  |  59.6  |  62  |  7/7/2020 오전 11:34:20  |  정상  | 

이 변환을 통해 시계열에서 키 정보를 추출하여 편리한 방식으로 표시할 수 있습니다.

**필드로 조인**

이 변환을 사용하여 여러 결과를 단일 테이블에 조인합니다. 여러 시계열 결과를 공유 시간 필드가 있는 단일 와이드 테이블로 변환하는 데 특히 유용합니다.

*내부 조인*

내부 조인은 모든 테이블이 선택한 필드와 동일한 값을 공유하는 여러 테이블의 데이터를 병합합니다. 이 유형의 조인에는 모든 결과에서 값이 일치하지 않는 데이터가 제외됩니다.

이 변환을 사용하여 여러 쿼리의 결과를 하나의 결과로 결합하고(통과된 조인 필드 또는 첫 번째 열에서 결합) 조인에 실패한 행을 삭제합니다.

다음 예제에서는 두 쿼리에서 테이블 데이터를 반환합니다. 내부 조인 변환을 적용하기 전에 두 개의 개별 테이블로 시각화됩니다.

쿼리 A:


| Time | 작업 | 가동 시간 | 
| --- | --- | --- | 
|  7/7/2020 오전 11:34:20  |  노드  |  25260122  | 
|  7/7/2020 오전 11:24:20  |  postgre  |  123001233  | 
|  7/7/2020 오전 11:14:20  |  postgre  |  345001233  | 

쿼리 B:


| Time | Server | 오류 | 
| --- | --- | --- | 
|  7/7/2020 오전 11:34:20  |  server 1  |  15  | 
|  7/7/2020 오전 11:24:20  |  server 2  |  5  | 
|  7/7/2020 오전 11:04:20  |  server 3  |  10  | 

내부 조인 변환을 적용한 후 결과는 다음과 같습니다.


| Time | 작업 | 가동 시간 | Server | 오류 | 
| --- | --- | --- | --- | --- | 
|  7/7/2020 오전 11:34:20  |  노드  |  25260122  |  server 1  |  15  | 
|  7/7/2020 오전 11:24:20  |  postgre  |  123001233  |  server 2  |  5  | 

*외부 조인*

외부 조인에는 내부 조인의 모든 데이터와 값이 모든 입력에서 일치하지 않는 행이 포함됩니다. 내부 조인은 시간 필드에서 쿼리 A와 쿼리 B를 조인하지만 외부 조인은 시간 필드에서 일치하지 않는 모든 행을 포함합니다.

다음 예제에서는 두 쿼리에서 테이블 데이터를 반환합니다. 외부 조인 변환을 적용하기 전에 두 테이블로 시각화됩니다.

쿼리 A:


| Time | 작업 | 가동 시간 | 
| --- | --- | --- | 
|  7/7/2020 오전 11:34:20  |  노드  |  25260122  | 
|  7/7/2020 오전 11:24:20  |  postgre  |  123001233  | 
|  7/7/2020 오전 11:14:20  |  postgre  |  345001233  | 

쿼리 B:


| Time | Server | 오류 | 
| --- | --- | --- | 
|  7/7/2020 오전 11:34:20  |  server 1  |  15  | 
|  7/7/2020 오전 11:24:20  |  server 2  |  5  | 
|  7/7/2020 오전 11:04:20  |  server 3  |  10  | 

외부 조인 변환을 적용한 후 결과는 다음과 같습니다.


| Time | 작업 | 가동 시간 | Server | 오류 | 
| --- | --- | --- | --- | --- | 
|  7/7/2020 오전 11:04:20  |    |    |  server 3  |  10  | 
|  7/7/2020 오전 11:14:20  |  postgre  |  345001233  |    |    | 
|  7/7/2020 오전 11:34:20  |  노드  |  25260122  |  server 1  |  15  | 
|  7/7/2020 오전 11:24:20  |  postgre  |  123001233  |  server 2  |  5  | 

**레이블에서 필드로**

이 변환은 레이블 또는 태그를 포함하는 시계열 결과를 각 레이블 키 및 값이 테이블 결과에 포함된 테이블로 변경합니다. 레이블은 열 또는 행 값으로 표시될 수 있습니다.

두 시계열의 쿼리 결과가 있는 경우:
+ 시리즈 1 – labels Server=Server A, Datacenter=EU
+ 시리즈 2 – labels Server=Server B, Datacenter=EU

**열** 모드에서 결과는 다음과 같습니다.


| Time | Server | 데이터 센터 | 값 | 
| --- | --- | --- | --- | 
|  7/7/2020 오전 11:34:20  |  Server A  |  EU  |  1  | 
|  7/7/2020 오전 11:34:20  |  Server B  |  EU  |  2  | 

'행' 모드에서 결과에는 각 시리즈에 대한 테이블이 있으며 다음과 같은 각 레이블 값이 표시됩니다.


| 레이블 | 값 | 
| --- | --- | 
|  Server  |  Server A  | 
|  데이터 센터  |  EU  | 


| 레이블 | 값 | 
| --- | --- | 
|  Server  |  Server B  | 
|  데이터 센터  |  EU  | 

*값 필드 이름*

**값 필드 이름**으로 서버를 선택한 경우 서버 레이블의 모든 값에 대해 하나의 필드를 가져옵니다.


| Time | 데이터 센터 | Server A | Server B | 
| --- | --- | --- | --- | 
|  7/7/2020 오전 11:34:20  |  EU  |  1  |  2  | 

*병합 동작*

레이블에서 필드 변환기는 내부적으로 두 개의 개별 변환입니다. 첫 번째는 단일 시리즈에 작동하고 레이블을 필드로 추출합니다. 두 번째는 모든 결과를 단일 테이블로 조인하는 병합 변환입니다. 병합 변환은 일치하는 모든 필드에서 조인을 시도합니다. 이 병합 단계는 필수이며 끌 수 없습니다.

**참고**  
*병합* 변환은 자체적으로 사용할 수 있으며 아래에 자세히 설명됩니다.

이를 설명하기 위해 중복 레이블이 없는 시계열을 반환하는 두 개의 쿼리가 있는 예제가 나와 있습니다.
+ 시리즈 1 – labels Server=ServerA
+ 시리즈 2 – labels Datacenter=EU

그러면 먼저 다음 두 테이블이 생성됩니다.


| Time | Server | 값 | 
| --- | --- | --- | 
|  7/7/2020 오전 11:34:20  |  ServerA  |  10  | 


| Time | 데이터 센터 | 값 | 
| --- | --- | --- | 
|  7/7/2020 오전 11:34:20  |  EU  |  20  | 

병합 후:


| Time | Server | 값 | 데이터 센터 | 
| --- | --- | --- | --- | 
|  7/7/2020 오전 11:34:20  |  ServerA  |  10  |    | 
|  7/7/2020 오전 11:34:20  |    |  20  |  EU  | 

**Merge**

이 변환을 사용하여 여러 쿼리의 결과를 단일 결과로 결합합니다. 이 방식은 테이블 패널 시각화를 사용할 때 유용합니다. 병합할 수 있는 값은 동일한 행에 결합됩니다. 공유 필드에 동일한 데이터가 포함된 경우 값을 병합할 수 있습니다.

아래 예제에는 테이블 데이터를 반환하는 두 개의 쿼리가 있습니다. 변환을 적용하기 전에 두 개의 개별 테이블로 시각화됩니다.

쿼리 A:


| Time | 작업 | 가동 시간 | 
| --- | --- | --- | 
|  7/7/2020 오전 11:34:20  |  노드  |  25260122  | 
|  7/7/2020 오전 11:24:20  |  postgre  |  123001233  | 

쿼리 B:


| Time | 작업 | 오류 | 
| --- | --- | --- | 
|  7/7/2020 오전 11:34:20  |  노드  |  15  | 
|  7/7/2020 오전 11:24:20  |  postgre  |  5  | 

다음은 병합 변환을 적용한 후 결과입니다.


| Time | 작업 | 오류 | 가동 시간 | 
| --- | --- | --- | --- | 
|  7/7/2020 오전 11:34:20  |  노드  |  15  |  25260122  | 
|  7/7/2020 오전 11:24:20  |  postgre  |  5  |  123001233  | 

**필드 구성**

이 변환을 사용하여 쿼리에서 반환된 필드의 이름을 바꾸거나, 순서를 바꾸거나, 숨깁니다.

**참고**  
이 변환은 단일 쿼리가 있는 패널에서만 작동합니다. 패널에 여러 쿼리가 있는 경우 외부 조인 변환을 적용하거나 추가 쿼리를 제거해야 합니다.

Grafana에서는 쿼리에서 반환된 필드 목록을 표시합니다. 다음을 수행할 수 있습니다.
+ 필드 위에 커서를 가져가서 필드 순서를 변경합니다. 커서가 손 모양으로 바뀌면 필드를 새 위치로 끌 수 있습니다.
+ 필드 이름 옆에 있는 눈 아이콘을 클릭하여 필드를 숨기거나 표시합니다.
+ 이름 바꾸기 상자에 새 이름을 입력하여 필드의 이름을 바꿉니다.

**값별 파티션**

이러한 변환을 통해 여러 시리즈를 그래프로 표시할 때 서로 다른 `WHERE` 절을 사용하는 동일한 데이터 소스에 대한 여러 쿼리가 필요하지 않을 수 있습니다. 다음 데이터가 포함된 지표 SQL 테이블을 고려합니다.


| Time | 리전 | 값 | 
| --- | --- | --- | 
|  10/20/2022 오후 12:00:00  |  US  |  1520  | 
|  10/20/2022 오후 12:00:00  |  EU  |  2936  | 
|  10/20/2022 오전 1:00:00  |  US  |  1327  | 
|  10/20/2022 오전 1:00:00  |  EU  |  912  | 

v9.3 이전에는 동일한 시계열 패널에서 미국의 경우 빨간색 추세선, EU의 경우 파란색 추세선을 작성하려는 경우 이를 두 개의 쿼리로 분할해야 할 수 있습니다.

```
SELECT Time, Value FROM metrics WHERE Time > '2022-10-20' AND Region='US'
SELECT Time, Value FROM metrics WHERE Time > '2022-10-20' AND Region='EU'
```

또한 지표 테이블에 실제로 존재하는 리전을 미리 알아야 합니다.

*값별 파티션* 변환기를 사용하면 단일 쿼리를 실행하고 선택한 하나 이상의 열(`fields`)에서 고유한 값으로 결과를 분할할 수 있습니다. 다음 예에는 `Region`가 사용됩니다.

```
SELECT Time, Region, Value FROM metrics WHERE Time > '2022-10-20'
```


| Time | 리전 | 값 | 
| --- | --- | --- | 
|  10/20/2022 오후 12:00:00  |  US  |  1520  | 
|  10/20/2022 오전 1:00:00  |  US  |  1327  | 


| Time | 리전 | 값 | 
| --- | --- | --- | 
|  10/20/2022 오후 12:00:00  |  EU  |  2936  | 
|  10/20/2022 오전 1:00:00  |  EU  |  912  | 

**축소**

*축소* 변환을 사용하면 프레임의 각 필드에 계산을 적용하고 단일 값을 반환합니다. 이 변환을 적용하면 시간 필드가 제거됩니다.

다음 입력을 고려합니다.

쿼리 A:


| Time | 임시 파일  | 가동 시간 | 
| --- | --- | --- | 
|  7/7/2020 오전 11:34:20  |  12.3  |  256122  | 
|  7/7/2020 오전 11:24:20  |  15.4  |  1230233  | 

쿼리 B:


| Time | AQI | 오류 | 
| --- | --- | --- | 
|  7/7/2020 오전 11:34:20  |  6.5  |  15  | 
|  7/7/2020 오전 11:24:20  |  3.2  |  5  | 

축소 변환기에는 두 가지 모드가 있습니다.
+ **시리즈에서 행으로** - 각 필드에 대한 행과 각 계산에 대한 열을 생성합니다.
+ **필드 축소** - 기존 프레임 구조를 유지하지만 각 필드를 단일 값으로 축소합니다.

예를 들어, **시리즈에서 행으로** 변환과 함께 **첫 번째** 및 **마지막** 계산을 사용하는 경우 결과는 다음과 같습니다.


| Field | 첫 번째 | Last | 
| --- | --- | --- | 
|  임시 파일   |  12.3  |  15.4  | 
|  가동 시간  |  256122  |  1230233  | 
|  AQI  |  6.5  |  3.2  | 
|  오류  |  15  |  5  | 

마지막 계산과 함께 필드 축소를 수행하면 각각 하나의 행을 포함하는 두 개의 프레임이 생성됩니다.

쿼리 A:


| 임시 파일  | 가동 시간 | 
| --- | --- | 
|  15.4  |  1230233  | 

쿼리 B:


| AQI | 오류 | 
| --- | --- | 
|  3.2  |  5  | 

**정규식으로 이름 바꾸기**

이 변환을 사용하여 정규식 및 대체 패턴을 사용하여 쿼리 결과의 일부 이름을 바꿉니다.

역참조를 지원하는 대체 패턴과 함께 일치에만 적용되는 정규식을 지정할 수 있습니다. 예를 들어 호스트당 CPU 사용량을 시각화하며 이때 도메인 이름을 제거하려고 한다고 가정합니다. 정규식을 `([^\.]+)\..+`로 설정하고 대체 패턴을 `$1`로 설정하면 `web-01.example.com`이 `web-01`이 됩니다.

**행에서 필드로**

행에서 필드로 변환은 행을 별도의 필드로 변환합니다. 필드를 개별적으로 스타일 지정하고 구성할 수 있으므로 유용할 수 있습니다. 또한 추가 필드를 동적 필드 구성의 소스로 사용하거나 필드 레이블에 매핑할 수도 있습니다. 그런 다음, 추가 레이블을 사용하여 결과 필드에 대한 더 나은 표시 이름을 정의할 수 있습니다.

이 변환에는 구성 쿼리에서 반환된 데이터의 모든 필드를 나열하는 필드 테이블이 포함됩니다. 이 테이블을 통해 각 구성 속성에 매핑해야 하는 필드를 제어할 수 있습니다(\$1다음으로 사용\$1\$1 옵션). 반환된 데이터에 여러 행이 있는 경우 선택할 값을 선택할 수도 있습니다.

이 변환에는 다음이 필요합니다.
+ 필드 이름의 소스로 사용할 하나의 필드.

  기본적으로 변환은 첫 번째 문자열 필드를 소스로 사용합니다. 대신 사용하려는 필드의 **다음으로 사용** 열에서 **필드 이름**을 선택하여 이 기본 설정을 재정의할 수 있습니다.
+ 값의 소스로 사용할 하나의 필드.

  기본적으로 변환은 첫 번째 숫자 필드를 소스로 사용합니다. 그러나 대신 사용하려는 필드의 **다음으로 사용** 열에서 **필드 값**을 선택하여 이 기본 설정을 재정의할 수 있습니다.

다음 경우에 데이터를 시각화할 때 유용합니다.
+ Gauge
+ Stat
+ 파이 차트

*레이블에 추가 필드 매핑*

필드가 구성 속성에 매핑되지 않는 경우 Grafana는 출력 필드의 레이블에 대한 소스로 해당 필드를 자동으로 사용합니다.

예제:


| 이름 | 데이터 센터 | 값 | 
| --- | --- | --- | 
|  ServerA  |  US  |  100  | 
|  ServerB  |  EU  |  200  | 

출력:


| ServerA(레이블: DataCenter: US) | ServerB(레이블: DataCenter: EU) | 
| --- | --- | 
|  10  |  20  | 

이제 필드 표시 이름에 추가 레이블을 사용하여 더 완전한 필드 이름을 제공할 수 있습니다.

한 쿼리에서 구성을 추출하여 다른 쿼리에 적용하려면 쿼리 결과에서 구성 변환을 사용해야 합니다.

*예제*

입력:


| 이름 | 값 | 최대 | 
| --- | --- | --- | 
|  ServerA  |  10  |  100  | 
|  ServerB  |  20  |  200  | 
|  ServerC  |  30  |  300  | 

출력:


| ServerA(구성: 최대=100) | ServerB(구성: 최대=200) | ServerC(구성: 최대=300) | 
| --- | --- | --- | 
|  10  |  20  |  30  | 

소스 데이터의 각 행은 별도의 필드가 됩니다. 이제 각 필드에는 최대 구성 옵션 세트도 있습니다. 최소, 최대, 단위 및 임계치와 같은 옵션은 모두 필드 구성의 일부이며 이와 같이 설정된 경우 패널 편집기 옵션 창에서 수동으로 구성된 옵션 대신 시각화에서 사용됩니다.

**시계열 데이터 준비**

시계열 변환 준비는 데이터 소스가 사용하려는 패널에서 지원하지 않는 형식으로 시계열 데이터를 반환할 때 유용합니다.

이 변환을 통해 시계열 데이터를 와이드 형식에서 긴 형식 또는 반대로 변환하여 이 문제를 해결할 수 있습니다.

**다중 프레임 시계열** 옵션을 선택하여 시계열 데이터 프레임을 와이드 형식에서 긴 형식으로 변환합니다.

**와이드 시계열** 옵션을 선택하여 시계열 데이터 프레임을 긴 형식에서 와이드 형식으로 변환합니다.

**시리즈에서 행으로**

이 변환을 사용하여 여러 시계열 데이터 쿼리의 결과를 단일 결과로 결합합니다. 이 방식은 테이블 패널 시각화를 사용할 때 유용합니다.

이 변환의 결과에는 시간, 지표 및 값과 같은 세 가지 열이 포함됩니다. 지표가 생성된 쿼리를 확인할 수 있도록 지표 열이 추가됩니다. 소스 쿼리에서 레이블을 정의하여 이 값을 사용자 지정합니다.

아래 예제에는 시계열 데이터를 반환하는 두 개의 쿼리가 있습니다. 변환을 적용하기 전에 두 개의 개별 테이블로 시각화됩니다.

쿼리 A:


| Time | Temperature | 
| --- | --- | 
|  7/7/2020 오전 11:34:20  |  25  | 
|  7/7/2020 오전 10:31:22  |  22  | 
|  7/7/2020 오전 9:30:05  |  19  | 

쿼리 B:


| Time | 습도 | 
| --- | --- | 
|  7/7/2020 오전 11:34:20  |  24  | 
|  7/7/2020 오전 10:32:20  |  29  | 
|  7/7/2020 오전 9:30:57  |  33  | 

다음은 시리즈를 행으로 변환을 적용한 후 결과입니다.


| Time | 지표 | 값 | 
| --- | --- | --- | 
|  7/7/2020 오전 11:34:20  |  Temperature  |  25  | 
|  7/7/2020 오전 11:34:20  |  습도  |  22  | 
|  7/7/2020 오전 10:32:20  |  습도  |  29  | 
|  7/7/2020 오전 10:31:22  |  Temperature  |  22  | 
|  7/7/2020 오전 9:30:57  |  습도  |  33  | 
|  7/7/2020 오전 9:30:05  |  Temperature  |  19  | 

**정렬 기준**

이 변환은 구성된 필드를 기준으로 각 프레임을 정렬합니다. `reverse`를 선택하면 값이 반대 순서로 반환됩니다.

**제한**

이 변환을 사용하여 표시되는 행 수를 제한합니다.

아래 예제에서는 데이터 소스에서 다음과 같은 응답을 받습니다.


| Time | 지표 | 값 | 
| --- | --- | --- | 
|  7/7/2020 오전 11:34:20  |  Temperature  |  25  | 
|  7/7/2020 오전 11:34:20  |  습도  |  22  | 
|  7/7/2020 오전 10:32:20  |  습도  |  29  | 
|  7/7/2020 오전 10:31:22  |  Temperature  |  22  | 
|  7/7/2020 오전 9:30:57  |  습도  |  33  | 
|  7/7/2020 오전 9:30:05  |  Temperature  |  19  | 

다음은 값이 '3'인 제한 변환을 추가한 후의 결과입니다.


| Time | 지표 | 값 | 
| --- | --- | --- | 
|  7/7/2020 오전 11:34:20  |  Temperature  |  25  | 
|  7/7/2020 오전 11:34:20  |  습도  |  22  | 
|  7/7/2020 오전 10:32:20  |  습도  |  29  | 

# 쿼리 문제 해결
<a name="v9-panels-query-troubleshoot"></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에서 버그 또는 시각화 문제처럼 보이지만 거의 대부분 데이터 소스 쿼리 또는 데이터 소스 응답 관련 문제입니다. 먼저 패널 쿼리 및 응답을 검사합니다.

자세한 내용은 [요청 및 응답 데이터 검사](v9-panels-panel-inspector.md)를 참조하세요.

**쿼리가 느림**

쿼리에서 반환하는 데이터 포인트는 몇 개인가요? 많은 데이터 포인트를 반환하는 쿼리는 속도가 느립니다. 다음 방법을 시도하세요.
+ **쿼리 옵션**에서 반환되는 **최대 데이터 포인트**를 제한합니다.
+ **쿼리 옵션**에서 **최소 간격** 시간을 늘립니다.
+ 쿼리에서 `group by` 함수를 사용합니다.

# 임계치 구성
<a name="v9-panels-configure-thresholds"></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-panels-thresholds-about"></a>

 임계치는 임계치가 충족되거나 초과되는 시점에 대시보드에 시각적으로 반영되는 지표와 관련하여 지정하는 값입니다.

 임계치는 쿼리 결과를 기반으로 조건에 따라 시각화의 스타일 및 색상을 지정할 수 있는 한 가지 방법입니다. 모든 시각화가 아닌 대부분의 시각화에 임계치를 적용할 수 있습니다. 시각화에 대한 자세한 내용은 [시각화 패널](v9-panels.md)을 참조하세요.

 임계치를 사용하여 다음을 수행할 수 있습니다.
+  [시계열 시각화](v9-panels-time-series.md)에서 그리드 선 또는 그리드 영역 색상 지정 
+  [시계열 시각화](v9-panels-time-series.md)에서 선 색상 지정 
+  [통계 시각화](v9-panels-stat.md)에서 배경 또는 값 텍스트 색상 지정 
+  [게이지 시각화](v9-panels-gauge.md)에서 게이지 및 임계치 마커 색상 지정 
+  [Geomap 시각화](v9-panels-geomap.md)에서 마커 색상 지정 
+  [테이블 시각화](v9-panels-table.md)에서 셀 텍스트 또는 배경 색상 지정 
+  [상태 타임라인 시각화](v9-panels-state-timeline.md)에서 리전 및 리전 색상 정의 

 임계치에는 두 가지 유형이 있습니다.
+  **절대** 임계치는 숫자로 정의됩니다. 예를 들어, 1\$1150의 스케일에서 80과 같습니다.
+  **백분율** 임계치는 최소 또는 최대를 기준으로 정의됩니다. 예를 들어 80%입니다.

### 기본 임계치
<a name="v9-panels-thresholds-default"></a>

 이를 지원하는 시각화에서 Grafana는 다음과 같은 기본 임계치를 설정합니다.
+  80 = 빨간색 
+  기본 = 녹색 
+  모드 = 절대 

 **기본** 값은 마이너스 무한대를 나타냅니다. 일반적으로 '양호한' 색상입니다.

## 임계치 추가 또는 삭제
<a name="v9-panels-thresholds-add-delete"></a>

 원하는 만큼 패널에 많은 임계치를 추가할 수 있습니다. Grafana는 임계치를 최곳값에서 최젓값으로 자동 정렬합니다.

 더 이상 비즈니스 운영과 관련이 없는 임계치를 삭제합니다. 임계치를 삭제하면 임계치를 포함하는 모든 시각화에서 임계치가 제거됩니다.

1.  임계치를 추가하는 방법: 

   1.  임계치를 추가할 패널을 편집하세요.

   1.  옵션 측면 창에서 **임계치** 섹션을 찾아 **\$1 임계치 추가**를 클릭하세요.

   1.  임계치 색상, 숫자 및 모드를 선택하세요. 임계치 모드는 이 패널의 모든 임계치에 적용됩니다.

   1.  시계열 패널에서 **임계치 표시** 옵션을 선택합니다.

1.  임계치를 삭제하려면 임계치가 포함된 패널로 이동하여 제거하려는 임계치 옆에 있는 휴지통 아이콘을 클릭하세요.

## 레거시 그래프 패널에 임계치 추가
<a name="v9-panels-thresholds-legacy-graph"></a>

 그래프 패널 시각화에서 임계치를 사용하면 그래프에 선 또는 섹션을 추가하여 그래프가 임계치를 넘을 때 더 쉽게 인식할 수 있습니다.

1.  임계치를 추가할 그래프 패널로 이동하세요.

1.  **패널** 탭에서 **임계치**를 클릭하세요.

1.  **임계치 추가**를 클릭하세요.

1.  다음 작업을 완료합니다.
   +  **T1** - 두 값 모두 임계치를 표시하는 데 필요합니다.
     +  **lt** 또는 **gt** - 미만의 경우 **lt**, 초과의 경우 **gt**를 선택하여 임계치가 적용되는 부분을 나타냅니다.
     +  **값** - 임계치를 입력합니다. Grafana는 해당 값에서 Y축을 따라 임계치 선을 그립니다.
   +  **색상** - 색상에 해당하는 조건을 선택하거나 고유한 색상을 정의합니다.
     +  **사용자 지정** - 채우기 색상과 선 색상을 정의합니다.
     +  **위험** - 채우기 및 선 색상은 빨간색입니다.
     +  **경고** - 채우기 및 선 색상은 노란색입니다.
     +  **확인** - 채우기 및 선 색상은 녹색입니다.
   +  **채우기** - 임계치 채우기를 표시할지 여부를 선택합니다.
   +  **선** - 임계치 선을 표시할지 여부를 선택합니다.
   +  **Y축** - **왼쪽** 또는 **오른쪽**을 선택합니다.

1.  **저장**을 클릭하여 대시보드에 변경 사항을 저장하세요.

# 데이터 링크 구성
<a name="v9-panels-configure-data-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) 섹션을 참조하세요.

 데이터 링크 변수 또는 데이터 링크를 사용하여 패널 사이에서 링크를 생성할 수 있습니다.

## 데이터 링크 변수
<a name="v9-panels-data-link-variables"></a>

 데이터 링크의 변수를 사용하여 시리즈 필드, 레이블 및 값을 참조할 수 있습니다. 데이터 링크에 대한 자세한 내용은 [데이터 링크](#v9-panels-data-links) 섹션을 참조하세요.

 사용 가능한 변수 목록을 보려면 데이터 링크 **URL** 필드에 **\$1**를 입력하여 사용할 수 있는 변수 목록을 확인합니다.

**참고**  
 이러한 변수는 6.4에서 변경되었으므로 이전 버전의 Grafana가 있는 경우 버전 선택기를 사용하여 이전 버전의 Grafana에 대한 문서를 선택합니다.

 데이터 링크 URL에서 템플릿 변수를 사용할 수도 있습니다. [대시보드 변수 추가 및 관리](v9-dash-variables.md) 섹션을 참조하세요.

## 시간 범위 패널 변수
<a name="v9-panels-time-range-panel-variables"></a>

 이러한 변수를 사용하면 데이터 링크 URL에 현재 시간 범위를 포함할 수 있습니다.
+  **\$1\$1url\$1time\$1range** - 현재 대시보드의 시간 범위(즉, **?from=now-6h&to=now**) 
+  **\$1\$1\$1from 및 \$1\$1\$1to** - 자세한 내용은 [전역 변수](v9-dash-variable-add.md#v9-dash-variable-add-global) 섹션을 참조하세요.

## 시리즈 변수
<a name="v9-panels-series-variables"></a>

 시리즈별 변수는 **\$1\$1series** 네임스페이스에서 사용할 수 있습니다.
+  **\$1\$1series.name** - URL에 대한 시리즈 이름 

## 필드 변수
<a name="v9-panels-field-variables"></a>

 필드별 변수는 **\$1\$1field** 네임스페이스에서 사용할 수 있습니다.
+  **\$1\$1field.name** - 필드 이름 
+  **\$1\$1field.labels.<LABEL>** - URL에 대한 레이블의 값. 레이블에 점이 포함된 경우 **\$1\$1field.labels["<LABEL>"]** 구문을 사용합니다.

## 변수 값
<a name="v9-panels-value-variables"></a>

 값별 변수는 **\$1\$1value** 네임스페이스에서 사용할 수 있습니다.
+  **\$1\$1value.time** - URL에 대한 값의 타임스탬프(Unix 밀리초 에포크 단위)(즉, **?time=1560268814105**) 
+  **\$1\$1value.raw** - 원시 값 
+  **\$1\$1value.numeric** - 값의 숫자 표현 
+  **\$1\$1value.text** - 값의 텍스트 표현 
+  **\$1\$1value.calc** - 값이 계산 결과인 경우 계산 이름 

## 템플릿 변수
<a name="v9-panels-template-variables"></a>

 템플릿 변수를 사용하는 다른 대시보드에 연결할 때 링크를 클릭하는 사람의 변수 값을 선택합니다.

 **\$1\$1var-myvar:queryparam\$1** - 여기서 **var-myvar**은 사용하려는 현재 대시보드의 템플릿 변수와 일치하는 템플릿 변수의 이름입니다.


|  변수 상태  |  생성된 URL의 결과  | 
| --- | --- | 
|  하나의 값을 선택함  |  var-myvar=value1  | 
|  다중 값을 선택함  |  var-myvar=value1&var-myvar=value2  | 
|  모두를 선택함  |  var-myvar=All  | 

 URL에 현재 대시보드의 변수를 모두 추가하려면 **\$1\$1\$1\$1all\$1variables\$1**를 사용합니다.

## 데이터 링크
<a name="v9-panels-data-links"></a>

 데이터 링크를 사용하면 링크에 보다 세분화된 컨텍스트를 제공할 수 있습니다. 시리즈 이름 또는 커서 아래 값도 포함하는 링크를 생성할 수 있습니다. 예를 들어 시각화에 네 개의 서버가 표시되는 경우 하나 또는 두 개의 서버에 데이터 링크를 추가할 수 있습니다.

 링크 자체는 시각화에 따라 다양한 방식으로 액세스할 수 있습니다. 그래프의 경우 데이터 포인트 또는 줄을 클릭해야 하며, 통계, 게이지 또는 막대 게이지와 같은 패널의 경우 시각화의 아무 곳이나 클릭하여 컨텍스트 메뉴를 열 수 있습니다.

 데이터 링크의 변수를 사용하여 보존된 데이터 필터가 있는 세부 대시보드로 사용자를 보낼 수 있습니다. 예를 들어 변수를 사용하여 시간 범위, 시리즈 및 변수 선택을 지정할 수 있습니다. 자세한 내용은 [데이터 링크 변수](#v9-panels-data-link-variables) 단원을 참조하십시오.

### 미리 입력 제안
<a name="v9-panels-typeahead-suggestions"></a>

 데이터 링크를 생성하거나 업데이트할 때 URL에 변수를 쉽게 추가하도록 키보드에서 Cmd\$1Space 또는 Ctrl\$1Space를 눌러 미리 입력 제안을 여세요.

### 데이터 링크 추가
<a name="v9-panels-add-a-datalink"></a>

1.  링크를 추가하려는 패널 위에 커서를 놓고 **e**를 누르세요. 또는 패널 제목 옆의 드롭다운 화살표를 선택한 다음, **편집**을 클릭하세요.

1.  필드 탭에서 아래로 스크롤하여 데이터 링크 섹션으로 이동하세요.

1.  데이터 링크를 확장한 다음, **링크 추가**를 클릭하세요.

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

1.  연결할 **URL**을 입력하세요.

    대시보드에 정의된 템플릿 변수 중 하나도 추가할 수 있습니다. **URL** 필드를 클릭한 다음, **\$1**를 입력하거나 Ctrl\$1Space 또는 Cmd\$1Space를 눌러 사용 가능한 변수 목록을 확인하세요. 패널 링크에 템플릿 변수를 추가하면 링크는 관련 변수가 이미 설정된 올바른 컨텍스트로 사용자를 보냅니다. 자세한 내용은 [데이터 링크 변수](#v9-panels-data-link-variables) 단원을 참조하십시오.

1.  새 탭에서 링크를 열려면 **새 탭에서 열기**를 선택하세요.

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

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

### 데이터 링크 업데이트
<a name="v9-panels-update-a-datalink"></a>

1.  필드 탭에서 변경하려는 링크를 찾으세요.

1.  편집(연필) 아이콘을 클릭하여 링크 편집 창을 여세요.

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

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

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

### 데이터 링크 삭제
<a name="v9-panels-delete-a-datalink"></a>

1.  필드 탭에서 삭제할 링크를 찾으세요.

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

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

# 필드 재정의 구성
<a name="v9-panels-configure-overrides"></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) 섹션을 참조하세요.

 재정의를 사용하면 특정 필드 또는 시리즈에 대한 시각화 설정을 사용자 지정할 수 있습니다. 이는 특정 필드 세트를 대상으로 하고 각각 여러 옵션을 정의할 수 있는 재정의 규칙을 추가하여 수행됩니다.

 예를 들어 **이름 일치 정규식을 사용하는 필드** 매처를 사용하여 재정의를 추가해 'bytes' 텍스트를 포함하는 모든 필드에 단위를 설정한 후 재정의 규칙에 단위 옵션을 추가합니다.

## 예제 1: 온도 형식 지정
<a name="v9-panels-overrides-format-temperature"></a>

 결과 세트가 시간과 온도라는 두 필드로 구성된 데이터 프레임이라고 가정합니다.


|  시간  |  temperature  | 
| --- | --- | 
|  2020-01-02 03:04:00  |  45.0  | 
|  2020-01-02 03:05:00  |  47.0  | 
|  2020-01-02 03:06:00  |  48.0  | 

 이 구조의 각 필드(열)에는 값이 표시되는 방식을 변경하는 방식으로 필드 옵션이 적용될 수 있습니다. 즉, 예를 들어 단위를 온도 > 섭씨로 설정하면 다음 표가 표시됩니다.


|  시간  |  temperature  | 
| --- | --- | 
|  2020-01-02 03:04:00  |  45.0°C  | 
|  2020-01-02 03:05:00  |  47.0°C  | 
|  2020-01-02 03:06:00  |  48.0°C  | 

 또한 소수점 자리는 필요하지 않으므로 제거할 수 있습니다. 소수점을 **자동**에서 **0**으로 변경하면 다음 표가 생성됩니다.


|  시간  |  temperature  | 
| --- | --- | 
|  2020-01-02 03:04:00  |  45°C  | 
|  2020-01-02 03:05:00  |  47°C  | 
|  2020-01-02 03:06:00  |  48°C  | 

## 예제 2: 온도 및 습도 형식 지정
<a name="v9-panels-overrides-format-humidity"></a>

 결과 세트가 시간, 고온, 저온, 습도와 같은 4개 필드로 구성된 데이터 프레임이라고 가정합니다.


|  시간  |  고온  |  저온  |  습도  | 
| --- | --- | --- | --- | 
|  2020-01-02 03:04:00  |  45.0  |  30.0  |  67  | 
|  2020-01-02 03:05:00  |  47.0  |  34.0  |  68  | 
|  2020-01-02 03:06:00  |  48.0  |  31.0  |  68  | 

 섭씨 단위를 추가하고 소수점을 제거합니다. 그러면 다음 표가 생성됩니다.


|  시간  |  고온  |  저온  |  습도  | 
| --- | --- | --- | --- | 
|  2020-01-02 03:04:00  |  45°C  |  30°C  |  67°C  | 
|  2020-01-02 03:05:00  |  47°C  |  34°C  |  68°C  | 
|  2020-01-02 03:06:00  |  48°C  |  31°C  |  68°C  | 

 온도 필드는 양호해 보이지만 이제 습도를 변경해야 합니다. 습도 필드에 필드 옵션 재정의를 적용하고 단위를 기타 > 백분율(0\$1100)로 변경하면 이 문제를 해결할 수 있습니다.


|  시간  |  고온  |  저온  |  습도  | 
| --- | --- | --- | --- | 
|  2020-01-02 03:04:00  |  45°C  |  30°C  |  67%  | 
|  2020-01-02 03:05:00  |  47°C  |  34°C  |  68%  | 
|  2020-01-02 03:06:00  |  48°C  |  31°C  |  68%  | 

## 필드 재정의 추가
<a name="v9-panels-overrides-add-a-field"></a>

 필드 재정의 규칙은 특정 필드 또는 시리즈에 대한 시각화 설정을 사용자 지정할 수 있습니다.

1.  재정의를 추가할 패널을 편집하세요.

1.  패널 옵션 측면 창에서 창 하단의 **필드 재정의 추가**를 클릭하세요.

1.  재정의 규칙을 적용할 필드를 선택하세요.
   +  **다음 이름의 필드:** 사용 가능한 모든 필드 목록에서 필드를 선택합니다 이 선택기를 사용하여 규칙에 추가하는 속성은 이 단일 필드에만 적용됩니다.
   +  **정규식과 일치하는 이름의 필드:** 정규식으로 재정의할 필드를 지정합니다. 이 선택기를 사용하여 규칙에 추가하는 속성은 필드 이름이 정규식과 일치하는 모든 필드에 적용됩니다.
   +  **다음 유형의 필드:** 문자열, 숫자 등 유형별로 필드를 선택합니다. 이 선택기를 사용하여 규칙에 추가하는 속성은 선택한 유형과 일치하는 모든 필드에 적용됩니다.
   +  **쿼리로 반환된 필드:** A, B 또는 C와 같이 특정 쿼리에서 반환된 모든 필드를 선택합니다. 이 선택기를 사용하여 규칙에 추가하는 속성은 선택한 쿼리로 반환된 모든 필드에 적용됩니다.

1.  **재정의 속성 추가**를 클릭하세요.

1.  적용할 필드 옵션을 선택하세요.

1.  필드에 값을 추가하여 옵션을 입력하세요. 옵션을 기본값으로 되돌리려면 필드에서 흰색 텍스트를 삭제하세요.

1.  **재정의 속성 추가**를 클릭하여 이 필드에 재정의를 계속 추가하거나 **재정의 추가**를 클릭하고 재정의를 추가할 다른 필드를 선택할 수 있습니다.

1.  완료되면 **저장**을 클릭하여 모든 패널 편집을 대시보드에 저장합니다.

## 필드 재정의 삭제
<a name="v9-panels-overrides-delete-a-field"></a>

 필드 재정의가 더 이상 필요하지 않은 경우 필드 재정의를 삭제합니다. 재정의를 삭제하면 값의 모양은 기본적으로 원본 형식으로 설정됩니다. 이 변경 사항은 영향을 받는 패널에 의존하는 대시보드 및 대시보드 사용자에게 영향을 미칩니다.

1.  삭제하려는 재정의가 포함된 패널을 편집하세요.

1.  패널 옵션 측면 창에서 재정의가 나타날 때까지 아래로 스크롤하세요.

1.  삭제할 재정의를 클릭한 다음, 연결된 휴지통 아이콘을 클릭하세요.

## 필드 재정의 보기
<a name="v9-panels-overrides-view"></a>

 패널 표시 옵션에서 필드 재정의를 볼 수 있습니다.

1.  보려는 재정의가 포함된 패널을 편집하세요.

1.  패널 옵션 측면 창에서 재정의가 나타날 때까지 아래로 스크롤하세요.

 **모두** 탭에 표시되는 재정의 설정은 **재정의** 탭에 표시되는 설정과 동일합니다.

## 필드 재정의 편집
<a name="v9-panels-overrides-edit-a-field"></a>

 재정의 설정을 변경하려는 경우 필드 재정의를 편집합니다. 변경 사항이 즉시 적용됩니다.

1.  편집하려는 재정의가 포함된 패널을 편집하세요.

1.  패널 옵션 측면 창에서 재정의가 나타날 때까지 아래로 스크롤하세요.

1.  변경하려는 재정의를 찾으세요.

1.  다음 중 하나를 수행하세요.
   +  기존 재정의 또는 필드 선택 파라미터에 대한 설정을 편집하세요.
   +  속성 옆에 있는 **X**를 클릭하여 기존 재정의 속성을 삭제하세요.
   +  **재정의 속성 추가**를 클릭하여 재정의 속성을 추가하세요.

# 값 매핑 구성
<a name="v9-panels-configure-value-mappings"></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는 패널 편집기의 측면 창에 요약을 표시합니다.

**참고**  
 새 값 매핑은 그래프(이전), 텍스트 및 히트맵과 같은 일부 시각화와 호환되지 않습니다.

## 값 매핑 유형
<a name="v9-panels-value-mappings-types"></a>

 Grafana에서는 다음 값 매핑을 지원합니다.
+  **값:** 텍스트 값을 색상 또는 다른 표시 텍스트에 매핑합니다. 예를 들어 값 **10**의 모든 인스턴스가 숫자가 아닌 **Perfection\$1**으로 표시되도록 값 매핑을 구성할 수 있습니다.
+  **범위:** 숫자 범위를 표시 텍스트 및 색상에 매핑합니다. 예를 들어 값이 특정 범위 내에 있는 경우 숫자 대신 **낮음** 또는 **높음**을 표시하도록 범위 값 매핑을 구성할 수 있습니다.
+  **정규식:** 정규식을 대체 텍스트 및 색상에 매핑합니다. 예를 들어 값이 **www.example.com**인 경우 Grafana가 **www**를 표시하고 도메인을 자르도록 정규식 값 매핑을 구성할 수 있습니다.
+  **특수** - **Null**, **NaN**(숫자가 아님)과 같은 특수 값과 **true** 및 **false**와 같은 부울 값을 표시 텍스트 및 색상에 매핑합니다. 예를 들어 **null** 값이 **N/A**로 표시되도록 특수 값 매핑을 구성할 수 있습니다.

 왼쪽의 점을 사용하여 목록에서 값 매핑을 끌어 재정렬할 수도 있습니다.

## 값 매핑
<a name="v9-panels-value-mappings-map-a-value"></a>

 단일 값 형식을 지정하려는 경우 값을 매핑합니다.

1.  값을 매핑할 패널을 여세요.

1.  패널 표시 옵션에서 **값 매핑** 섹션을 찾아 **값 매핑 추가**를 클릭하세요.

1.  **새 매핑 추가**를 클릭한 다음, **값**을 선택하세요.

1.  일치시킬 Grafana 값을 입력합니다.

1.  (선택 사항) 표시 텍스트를 입력하세요.

1.  (선택 사항) 색상을 설정하세요.

1.  **업데이트를** 클릭하여 값 매핑을 저장하세요.

## 범위 매핑
<a name="v9-panels-value-mappings-map-a-range"></a>

 여러 연속 값 형식을 지정하려는 경우 값의 범위를 매핑합니다.

1.  값 범위를 매핑할 패널을 편집하세요.

1.  패널 표시 옵션의 **값 매핑** 섹션에서 **값 매핑 추가**를 클릭하세요.

1.  **새 매핑 추가**를 클릭한 다음, **범위**를 선택하세요.

1.  Grafana에서 일치시킬 범위의 시작 및 종료 값을 입력합니다.

1.  (선택 사항) 표시 텍스트를 입력하세요.

1.  (선택 사항) 색상을 설정하세요.

1.  **업데이트를** 클릭하여 값 매핑을 저장하세요.

## 정규식 매핑
<a name="v9-panels-value-mappings-map-a-regex"></a>

 정규식 값의 텍스트와 색상 형식을 지정하려는 경우 정규식을 매핑합니다.

1.  정규식을 매핑할 패널을 편집하세요.

1.  패널 표시 옵션의 **값 매핑** 섹션에서 **값 매핑 추가**를 클릭하세요.

1.  **새 매핑 추가**를 클릭한 다음, **정규식**을 선택하세요.

1.  Grafana에서 일치시킬 정규식 패턴을 입력합니다.

1.  (선택 사항) 표시 텍스트를 입력하세요.

1.  (선택 사항) 색상을 설정하세요.

1.  **업데이트를** 클릭하여 값 매핑을 저장하세요.

## 특수 값 매핑
<a name="v9-panels-value-mappings-map-a-special-value"></a>

 일반적이지 않은 값, 부울 값 또는 빈 값의 형식을 지정하려면 특수 매핑을 사용합니다.

1.  특수 값을 매핑할 패널을 편집하세요.

1.  패널 표시 옵션에서 **값 매핑** 섹션을 찾아 **값 매핑 추가**를 클릭하세요.

1.  **새 매핑 추가**를 클릭한 다음, **특수**를 선택하세요.

1.  Grafana에서 일치시킬 특수 값을 선택합니다.

1.  (선택 사항) 표시 텍스트를 입력하세요.

1.  (선택 사항) 색상을 설정하세요.

1.  **업데이트를** 클릭하여 값 매핑을 저장하세요.

## 값 매핑 편집
<a name="v9-panels-value-mappings-edit-a-value"></a>

 언제든지 값 매핑을 변경할 수 있습니다.

1.  편집하려는 값 매핑이 포함된 패널을 편집하세요.

1.  패널 표시 옵션의 **값 매핑** 섹션에서 **값 매핑 편집**을 클릭하세요.

1.  변경하고 **업데이트**를 클릭하세요.

# 범례 구성
<a name="v9-panels-configure-legend"></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-panels-legend-isolate"></a>

시각화는 종종 시각적으로 복잡할 수 있으며 많은 데이터 시리즈를 포함할 수 있습니다. 시각화에서 시리즈 데이터를 제거하여 보기를 단순화할 수 있습니다. 그러면 보려는 데이터를 격리합니다. Grafana는 **재정의** 탭에서 자동으로 새 재정의를 생성합니다.

변경 사항을 적용하면 패널의 모든 사용자에게 시각화 변경 사항이 표시됩니다.

**시각화에서 시리즈 데이터를 분리하는 방법**

1. 패널을 여세요.

1. 범례에서 격리하려는 시리즈의 레이블을 선택하세요.

   시스템은 다른 모든 시리즈 데이터를 보기에서 제거합니다.

1. 격리된 시리즈에 시리즈 데이터를 점진적으로 추가하려면 **Ctrl** 또는 **Command** 키를 누르고 추가하려는 시리즈의 레이블을 선택하세요.

1. 모든 데이터가 포함된 기본 보기로 되돌리려면 시리즈 레이블을 두 번 클릭하세요.

1. 패널의 모든 최종 사용자에게 표시되도록 변경 사항을 저장하려면 **적용**을 선택하세요.

이 주제는 현재 다음 시각화에 적용됩니다.
+ [막대 차트](v9-panels-bar-chart.md)
+ [Histogram](v9-panels-histogram.md)
+ [파이 차트](v9-panels-piechart.md)
+ [상태 타임라인](v9-panels-state-timeline.md)
+ [상태 기록](v9-panels-status-history.md)
+ [시계열](v9-panels-time-series.md)

## 범례에 값 추가
<a name="v9-panels-legend-add-values"></a>

시각화에 컨텍스트를 더 추가하는 방법으로 범례에 시리즈 데이터 값을 추가할 수 있습니다. 원하는 만큼 값을 추가할 수 있습니다. 변경 사항을 적용한 후 범례를 가로로 스크롤하여 모든 값을 볼 수 있습니다.

**범례에 값을 추가하는 방법**

1. 패널을 편집하세요.

1. 패널 표시 옵션 창에서 **범례** 섹션을 찾으세요.

1. **범례 값** 필드에서 범례에 표시할 값을 선택하세요.

1. **적용**을 선택하여 변경 사항을 저장하고 대시보드로 돌아가세요.

## 시리즈 색상 변경
<a name="v9-panels-legend-change-color"></a>

기본적으로 Grafana는 시리즈 데이터의 색상을 지정합니다. 이 색상은 사용자가 변경할 수 있습니다.

**시리즈 색상을 변경하는 방법**

1. 패널을 편집하세요.

1. 범례에서 시리즈와 연결된 색상 막대를 선택하세요.

1. 색상 팔레트에서 사전 설정된 색상 또는 사용자 지정 색상을 선택하세요.

1. **적용**을 선택하여 변경 사항을 저장하고 대시보드로 돌아가세요.

## 시리즈 정렬
<a name="v9-panels-legend-sort"></a>

범례 모드를 **테이블**로 변경하고 범례에 표시하도록 [계산 유형](v9-panels-calculation-types.md)을 선택할 수 있습니다. 범례 테이블에서 계산 이름 헤더를 선택하여 테이블의 값을 오름차순 또는 내림차순으로 정렬하세요.

정렬 순서는 막대 차트 패널의 막대 위치와 시계열 및 막대 차트 패널의 스택 시리즈 순서에 영향을 줍니다.

**참고**  
이 기능은 막대 차트, 히스토그램, 시계열, XY 차트와 같은 패널에서만 지원됩니다.

# 계산 유형
<a name="v9-panels-calculation-types"></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에서 수행할 수 있는 계산 목록이 포함되어 있습니다. **변환** 탭과 막대 게이지, 게이지 및 통계 시각화에서 이러한 계산을 확인할 수 있습니다.


|  계산  |  설명  | 
| --- | --- | 
|  모든 null  |  모든 값이 null인 경우 True  | 
|  모두 0  |  모든 값이 0인 경우 True  | 
|  변경 횟수  |  필드의 값이 변경되는 횟수  | 
|  개수  |  필드에 있는 값 수  | 
|  델타  |  값의 누적 변화, 증분만 포함  | 
|  차이  |  필드의 첫 번째 값과 마지막 값의 차이  | 
|  차이 백분율  |  필드의 첫 번째 값과 마지막 값의 백분율 변화  | 
|  고유한 개수  |  필드에 있는 고유한 값 수  | 
|  첫 번째(null 아님)  |  필드에서 null이 아닌 첫 번째 값  | 
|  최대  |  필드의 최댓값  | 
|  평균  |  필드에 있는 모든 값의 평균 값  | 
|  분산  |  필드에 있는 모든 값의 편차  | 
|  StdDev  |  필드에 있는 모든 값의 표준 편차  | 
|  최소  |  필드의 최솟값  | 
|  최소(0 초과)  |  필드의 최소 양수 값  | 
|  Range  |  필드의 최댓값과 최솟값의 차이  | 
|  단계  |  필드의 값 사이에서 최소 간격  | 
|  합계  |  필드에 있는 모든 값의 합계  | 

# 시각화 주석 달기
<a name="v9-panels-annotate-visualizations"></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에는 기본 주석 저장소와 그래프 패널 또는 HTTP API를 통해 직접 주석 이벤트를 추가할 수 있는 기능이 함께 제공됩니다.

**주석 추가**

1. 대시보드에서 **시계열** 패널을 클릭하세요. 컨텍스트 메뉴가 나타납니다.

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

1. 주석 설명과 선택적으로 태그를 추가하세요.

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

또는 주석을 추가하려면 **시계열** 패널에서 `Ctrl+Click` 또는 `Cmd+Click`를 누르세요. **주석 추가** 팝업이 나타납니다.

**리전 주석 추가**

1. 대시보드에의 **시계열** 패널에서 `Ctrl+Click` 또는 `Cmd+Click`를 클릭하세요.

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

1. 주석 설명과 선택적으로 태그를 추가하세요.

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

**주석 편집**

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

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

1. 설명 및 태그(선택 사항)를 수정하세요.

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

**주석 삭제**

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

1. 주석 툴팁에서 휴지통 아이콘을 클릭하세요.

**기본 제공 쿼리**

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

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

**태그별 쿼리**

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

Grafana v8.1 이상 버전에서는 기존 태그의 미리 입력 기능도 지원하고 하나 이상의 태그를 제공합니다.

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

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

**기타 데이터 소스 쿼리**

주석 이벤트는 주석 쿼리를 사용하여 가져옵니다. 대시보드에 새 주석 쿼리를 추가하려면 대시보드 설정 메뉴를 열고 **주석**을 선택하세요. 그러면 대시보드 주석 설정 보기가 열립니다. 새 주석 쿼리를 생성하려면 **새로 만들기** 버튼을 누르세요.

주석 쿼리의 이름을 지정하세요. 이 이름은 토글(확인란)에 지정되며, 이를 통해 이 쿼리에서 주석 이벤트 표시를 활성화하거나 비활성화할 수 있습니다. 예를 들어 `Deploys` 및 `Outages`라는 두 개의 주석 쿼리가 있을 수 있습니다. 토글을 사용하면 표시할 주석을 결정할 수 있습니다.

**주석 쿼리 세부 정보**

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

# 패널 검사 보기
<a name="v9-panels-panel-inspector"></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 패널에서 원시 데이터를 검사하고, 해당 데이터를 쉼표로 구분된 값(CSV) 파일로 내보내며, 쿼리 요청을 보고, 패널 및 데이터 JSON을 내보낼 수 있습니다.

**참고**  
 모든 패널 유형에 모든 탭이 포함되는 것은 아닙니다. 예를 들어 대시보드 목록 패널에는 검사할 원시 데이터가 없으면 통계, 데이터 또는 쿼리 탭이 표시되지 않습니다.

 패널 검사기는 다음 옵션으로 구성됩니다.

1.  패널 검사기는 창 상단에 **검사: [NameOfPanelBeingInspected]**를 표시합니다. 오른쪽 상단의 화살표를 클릭하여 창을 확장하거나 줄입니다.

1.  **데이터 탭** - 변환이 적용된 상태로 쿼리에서 반환된 원시 데이터를 표시합니다. 재정의 및 값 매핑과 같은 필드 옵션은 기본적으로 적용되지 않습니다.

1.  **통계 탭** - 쿼리에 걸리는 시간과 반환되는 양을 보여줍니다.

1.  **JSON 탭** - 패널 JSON, 패널 데이터 JSON 및 데이터 프레임 구조 JSON을 보고 복사할 수 있습니다. Grafana를 프로비저닝하거나 관리하는 경우에 유용합니다.

1.  **쿼리 탭** - Grafana에서 데이터 소스를 쿼리할 때 서버로 전송된 요청을 표시합니다.

1.  **오류 탭** - 오류를 표시합니다. 쿼리가 오류를 반환할 때만 표시됩니다.

## 원시 쿼리 결과 다운로드
<a name="v9-panels-raw-query-results"></a>

 Grafana에서는 해당 데이터에 대한 변환을 포함하여 데이터가 포함된 CSV 파일을 생성합니다. 패널이 필드 옵션 또는 필드 옵션 재정의를 적용하기 전 또는 후에 데이터를 보도록 선택할 수 있습니다.

1.  다운로드하려는 쿼리 데이터가 포함된 패널을 편집하세요.

1.  쿼리 편집기에서 **쿼리 검사기**를 클릭하세요.

1.  **데이터**를 클릭하세요.

    패널에 여러 쿼리가 포함되어 있거나 여러 노드를 쿼리하는 경우 추가 옵션이 있습니다.
   +  **결과 선택**: 보려는 결과 세트 데이터를 선택합니다.
   +  **데이터 변환** 
   +  **시간별 조인**: 열당 하나의 결과 세트로 모든 쿼리의 원시 데이터를 한 번에 확인합니다. 열 제목을 클릭하여 데이터를 재정렬합니다.

1.  시스템이 필드 재정의를 적용하기 전에 데이터를 보려면 **형식이 지정된 데이터** 토글을 클릭하세요.

1.  Excel 전용 형식의 CSV 파일을 다운로드하려면 **Excel용 다운로드** 토글을 클릭하세요.

1.  **CSV 다운로드**를 클릭하세요.

## 쿼리 성능 검사
<a name="v9-panels-query-performance"></a>

 **통계** 탭에는 쿼리 소요 시간, 전송한 쿼리 수, 반환된 행 수를 알려주는 통계가 표시됩니다. 이 정보는 특히 예상치 못하게 높거나 낮은 숫자가 있는 경우 쿼리 문제를 해결하는 데 도움이 될 수 있습니다.

1.  검사하려는 성능의 쿼리가 포함된 패널을 편집하세요.

1.  쿼리 편집기에서 **쿼리 검사기**를 클릭하세요.

1.  **상태**를 클릭하세요.

 통계는 읽기 전용 형식으로 표시됩니다.

## 쿼리 요청 및 응답 검사
<a name="v9-panels-query-request-response"></a>

 예상치 못한 결과를 반환하거나 예상 결과를 반환하지 못하는 쿼리 문제를 해결하려는 경우 쿼리 요청 및 응답 데이터를 검사합니다.

1.  내보내려는 쿼리가 포함된 패널을 편집하세요.

1.  쿼리 편집기에서 **쿼리 검사기**를 클릭하세요.

1.  **새로 고침**을 클릭하세요.

    패널은 응답 데이터로 채워집니다.

1.  필요에 따라 조정하고 쿼리를 다시 실행하세요.

1.  쿼리 요청 및 응답 데이터를 다운로드하려면 **클립보드에 복사** 아이콘을 클릭하고 결과를 다른 애플리케이션에 붙여넣으세요.

# Grafana 버전 9에서 사용 가능한 시각화
<a name="v9-panels-viz"></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에서는 여러 사용 사례를 지원하는 다양한 시각화를 제공합니다. 설명서의 이 섹션에서는 기본 제공 패널, 옵션 및 일반적인 사용을 강조합니다.

처음에 시작하고 패널 사용의 기본 사항을 배우기 위한 일반적인 패널은 [시계열 패널](v9-panels-time-series.md) 패널입니다.

**Topics**
+ [알림 목록 패널](v9-panels-alert-list.md)
+ [주석 패널](v9-panels-annotations.md)
+ [막대 차트 패널](v9-panels-bar-chart.md)
+ [막대 게이지](v9-panels-bar-gauge.md)
+ [캔들스틱 패널](v9-panels-candlestick.md)
+ [캔버스 패널](v9-panels-canvas.md)
+ [시계 패널](v9-panels-clock.md)
+ [대시보드 목록](v9-panels-dashboard-list.md)
+ [게이지 패널](v9-panels-gauge.md)
+ [Geomap 패널](v9-panels-geomap.md)
+ [그래프 패널](v9-panels-graph.md)
+ [히트맵 패널](v9-panels-heatmap.md)
+ [히스토그램 패널](v9-panels-histogram.md)
+ [로그 패널](v9-panels-logs.md)
+ [뉴스 패널](v9-panels-news.md)
+ [노드 그래프 패널](v9-panels-node-graph.md)
+ [파이 차트 패널](v9-panels-piechart.md)
+ [Plotly 패널](v9-panels-plotly.md)
+ [Sankey 패널](v9-panels-sankey.md)
+ [분산형 패널](v9-panels-scatter.md)
+ [통계 패널](v9-panels-stat.md)
+ [상태 타임라인 패널](v9-panels-state-timeline.md)
+ [상태 기록 패널](v9-panels-status-history.md)
+ [테이블 패널](v9-panels-table.md)
+ [텍스트 패널](v9-panels-text.md)
+ [시계열 패널](v9-panels-time-series.md)
+ [추적 패널(베타)](v9-panels-traces.md)
+ [WindRose](v9-panels-windrose.md)

# 알림 목록 패널
<a name="v9-panels-alert-list"></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 버전 9에서의 알림](v9-alerts.md) 섹션을 참조하세요.

이러한 설정을 사용하여 시각화를 세분화합니다.

## 옵션
<a name="v9-panels-alert-list-options"></a>
+  **그룹 모드** - **기본 그룹화**(알림 규칙별로 그룹화된 알림 인스턴스 표시) 또는 **사용자 지정 그룹화**(사용자 지정 레이블 세트별로 알림 인스턴스를 그룹화)를 선택합니다.
+  **최대 항목** - 나열할 최대 알림 수를 설정합니다.
+  **정렬 순서** - 표시되는 알림 정렬 방법을 선택합니다.
  +  **사전순(오름차순)** - 사전순
  +  **사전순(내림차순)** - 사전의 역순
  +  **중요도** - 다음 값에 따라 중요도에 기반합니다(1이 가장 높음).
    + `alerting` 또는 `firing`: 1
    + `no_data`: 2
    + `pending`: 3
    + `ok`: 4
    + `paused` 또는 `inactive`: 5
+  **이 대시보드의 알림** - 알림 목록에 있는 대시보드의 알림만 표시합니다.

## 필터
<a name="v9-panels-alert-filter"></a>

다음 옵션을 사용하여 선택한 쿼리, 폴더 또는 태그와 일치하도록 알림을 필터링합니다.
+  **알림 이름** - 알림 이름 쿼리를 입력합니다.
+  **알림 인스턴스 레이블** - 레이블 쿼리를 사용하여 알림 인스턴스를 필터링합니다. 예를 들어 `{severity="critical", instance=~"cluster-us-.+"}`입니다.
+  **폴더** - 폴더를 선택합니다. 선택한 폴더에 있는 대시보드의 알림만 표시됩니다.
+  **데이터 소스** - 선택한 데이터 소스에서 알림을 필터링합니다.

## 상태 필터
<a name="v9-panels-alert-state-filter"></a>

이 패널에 표시할 알림 상태를 선택하세요.
+ 알림/실행
+ 보류중
+ 데이터 없음
+ 정상
+ 오류

# 주석 패널
<a name="v9-panels-annotations"></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-panels-annotations-query"></a>

다음 옵션은 주석 목록에 대한 소스 쿼리를 제어합니다.

**쿼리 필터**

쿼리 필터를 사용하여 조직의 모든 대시보드 또는 이 패널이 위치한 현재 대시보드에서 주석 목록을 생성합니다. 다음과 같은 옵션이 있습니다.
+ 모든 대시보드 - 현재 조직의 모든 대시보드에서 주석을 나열합니다.
+ 이 대시보드 - 목록을 현재 대시보드의 주석으로 제한합니다.

**시간 범위**

시간 범위 옵션을 사용하여 목록을 현재 시간 범위로 제한해야 하는지 여부를 지정합니다. 다음과 같은 옵션이 있습니다.
+ 없음 - 주석 쿼리에 대한 시간 범위 제한이 없습니다.
+ 이 대시보드 - 주석 목록 패널을 사용할 수 있는 대시보드의 시간 범위로 목록을 제한합니다.

**Tags**

태그 옵션을 사용하여 태그별로 주석을 필터링합니다. 목록을 세분화하기 위해 여러 태그를 추가할 수 있습니다.

**참고**  
필요에 따라 태그 목록을 비워 두고 패널 자체에 결과의 일부로 나열된 태그를 선택하여 즉시 필터링합니다.

*제한*

제한 옵션을 사용하여 반환되는 결과 수를 제한합니다.

## 표시
<a name="v9-panels-annotations-display"></a>

이러한 옵션은 주석 패널 표시에 포함된 추가 메타데이터를 제어합니다.

**사용자 표시**

이 옵션을 사용하여 주석을 생성한 사용자를 표시하거나 숨깁니다.

**시간 표시**

이 옵션을 사용하여 주석 생성 시간을 표시하거나 숨깁니다.

**태그 표시**

이 옵션을 사용하여 주석과 연결된 태그를 표시하거나 숨깁니다. *NB*: 태그를 사용하여 패널 자체에서 주석 목록을 라이브로 필터링할 수 있습니다.

## 링크 동작
<a name="v9-panels-annotations-links"></a>

**링크 대상**

주석이 달린 데이터를 보는 방법을 선택하려면 이 옵션을 사용합니다. 여기에는 다음 옵션이 있습니다.
+ 패널 - 이 옵션을 사용하면 해당 주석이 있는 패널의 전체 화면 보기로 바로 이동합니다.
+ 대시보드 - 이 옵션은 전체 대시보드의 컨텍스트에서 주석에 초점을 맞춥니다.

**다음 이전 시간**

이 옵션을 사용하여 주석 이전의 시간 범위를 설정합니다. "1h" = 1시간, "10m" = 10분 등의 기간 문자열 값을 사용합니다.

**다음 이후 시간**

이 옵션을 사용하여 주석 이후의 시간 범위를 설정합니다.

# 막대 차트 패널
<a name="v9-panels-bar-chart"></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-panels-bar-chart-formats"></a>

하나의 데이터 프레임만 지원되며 X 또는 Y축의 카테고리로 사용할 하나 이상의 문자열 필드와 하나 이상의 숫자 필드가 있어야 합니다. 다음은 데이터 형식 예제입니다.


|  브라우저  |  시장 점유율  | 
| --- | --- | 
|  Chrome  |  50  | 
|  Internet Explorer  |  17.5  | 

숫자 필드가 두 개 이상인 경우 패널에 그룹화된 막대가 표시됩니다.

### 시계열 또는 여러 결과 세트 시각화
<a name="v9-panels-bar-chart-visualization"></a>

시계열이나 테이블이 여러 개 있는 경우 먼저 조인 또는 축소 변환을 사용하여 조인해야 합니다. 예를 들어 시계열이 여러 개이고 마지막 값과 최댓값을 비교하려면 **축소** 변환을 추가하고 **계산**에서 **최대** 및 **마지막**을 옵션으로 지정합니다.

## 막대 차트 옵션
<a name="v9-panels-bar-chart-options"></a>

다음 옵션을 사용하여 시각화를 세분화합니다.

**Orientation(방향)**
+  **자동** – Grafana는 패널 차원을 기반으로 막대 방향을 결정합니다.
+  **가로** - X축을 카테고리 축으로 설정합니다.
+  **세로** - Y축을 카테고리 축으로 설정합니다.

**X축 틱 레이블 최대 길이**에서는 막대 차트 레이블의 최대 길이를 설정합니다. 최대 길이보다 긴 레이블은 줄임표로 잘립니다.

**막대 레이블 최소 간격**에서는 막대 레이블 간 최소 간격을 설정합니다.

**값 표시**

값이 막대의 상단에 표시되는지 또는 왼쪽에 표시되는지 여부를 제어합니다.
+  **자동** - 공백이 있는 경우 값이 표시됩니다.
+  **항상** - 항상 값을 표시합니다.
+  **안 함** - 값을 표시하지 않습니다.

**스택**

막대 차트 스택을 제어합니다.
+  **끄기** - 막대가 스택되지 않습니다.
+  **일반** - 막대가 서로 위에 스택됩니다.
+  **백분율** - 막대는 서로 위에 스택되며 각 막대의 높이는 스택의 총 높이에 대한 백분율에 기반합니다(모든 막대 스택은 높이가 동일하며, 합계는 최대 100%임).

**그룹 너비**는 그룹의 너비를 제어합니다. 0=최소 너비 및 1=최대 너비.

**막대 너비**는 막대의 너비를 제어합니다. 0=최소 너비 및 1=최대 너비.

**막대 반경**에서는 막대의 반경을 제어합니다. 0 = 최소 반경, 0.5 = 최대 반경.

**가리킬 때 전체 영역 강조 표시**에서는 막대 위로 마우스를 가져갈 때 막대의 주변 영역이 강조 표시되는지 여부를 제어합니다

**선 너비**에서는 막대의 선 너비를 제어합니다.

**채우기 불투명도**에서는 막대의 채우기 불투명도를 제어합니다.

**그라데이션 모드**에서는 그라데이션 채우기 모드를 설정합니다. 채우기 그라데이션은 선 색상을 기반으로 합니다. 색상을 변경하려면 표준 색상 체계 필드 옵션을 사용합니다. 그라데이션 모양은 **채우기 불투명도** 설정의 영향을 받습니다.
+  **없음** - 그라데이션 채우기를 적용하지 않습니다. 기본 설정입니다.
+  **불투명도** - 그라데이션 투명도는 y축의 값을 기반으로 계산됩니다. Y축의 값에 따라 채우기 불투명도가 증가합니다.
+  **색조** - 그라데이션 색상은 선 색상의 색조에 기반하여 생성됩니다.

**툴팁 모드** - 시각화 위에 커서를 놓으면 Grafana에서 툴팁을 표시할 수 있습니다. 툴팁 동작을 선택합니다.
+  **단일** - 가리키기 툴팁에는 시각화에서 가리키고 있는 시리즈인 단일 시리즈만 표시됩니다.
+  **모두** - 가리키기 툴팁에는 그래프의 모든 시리즈가 표시됩니다. Grafana는 툴팁의 시리즈 목록에서 가리킨 시리즈를 굵게 강조 표시합니다.
+  **숨김** - 시각화와 상호 작용할 때 툴팁을 표시하지 않습니다.

**참고**  
재정의를 사용하여 툴팁에서 개별 시리즈를 숨길 수 있습니다.

**범례 모드** - 이러한 설정을 사용하여 시각화에 범례가 표시되는 방식을 세분화합니다. 자세한 내용은 [범례 구성](v9-panels-configure-legend.md) 단원을 참조하십시오.
+  **목록** - 범례를 목록으로 표시합니다. 범례의 기본 표시 모드입니다.
+  **테이블** - 범례를 테이블로 표시합니다.
+  **숨김** - 범례를 숨깁니다.

**범례 배치** - 범례를 배치할 위치를 선택합니다.
+  **하단** - 그래프 아래.
+  **오른쪽** - 그래프의 오른쪽.

**범례 계산** - 범례에 표시할 표준 계산 중에서 선택합니다. 둘 이상을 보유할 수 있습니다.

**텍스트 크기** - 막대 차트의 텍스트 크기를 변경하려면 값을 입력합니다.

**축** - 다음 필드 설정을 사용하여 축 표시 방식을 세분화합니다. 편집하려는 필드 옵션 상자 외부를 클릭하거나 Enter를 누를 때까지 일부 필드 옵션은 시각화에 영향을 주지 않습니다.
+  **배치** - Y축의 배치를 설정합니다.
+  **자동** – Grafana는 시리즈에 Y축을 자동으로 할당합니다. 단위가 서로 다른 시리즈가 둘 이상 있는 경우 Grafana는 왼쪽 축을 첫 번째 단위에 할당하고 오른쪽을 다음 단위에 할당합니다.
+  **왼쪽** - 왼쪽에 모든 Y축을 표시합니다.
+  **오른쪽** - 오른쪽에 모든 Y축을 표시합니다.
+  **숨김** - 모든 Y축을 숨깁니다.
+  **레이블** - Y축 텍스트 레이블을 설정합니다. Y축이 둘 이상인 경우 재정의를 통해 다른 레이블을 할당할 수 있습니다.
+  **너비** - 축의 고정 너비를 설정합니다. 기본적으로 Grafana는 축의 너비를 동적으로 계산합니다.

  축의 너비를 설정하면 축 유형이 다른 데이터가 동일한 표시 비율을 공유할 수 있습니다. 이렇게 하면 축이 서로 시각적으로 근접하여 이동 또는 확장되지 않기 때문에 데이터에 대한 둘 이상의 그래프에서 의미를 더 쉽게 비교할 수 있습니다.
+  **소프트 최소 및 소프트 최대** - Y축 제한을 더 잘 제어할 수 있도록 소프트 최소 및 소프트 최대 옵션을 설정합니다. 기본적으로 Grafana는 데이터세트를 기반으로 Y축의 범위를 자동으로 설정합니다.

  소프트 최소 및 소프트 최대 설정은 데이터가 대부분 평탄할 때 일시적 변화가 크게 확대되는 것을 방지할 수 있습니다. 표준 최소 및 최대 필드 옵션에서 파생된 하드 최소 또는 최대는 정의된 지점을 지나 스파이크를 클리핑하여 간헐적인 스파이크가 유용한 세부 정보를 평탄화하는 것을 방지할 수 있습니다.

  표준 최소/최대 옵션을 설정하여 Y축의 하드 제한을 정의할 수 있습니다.

# 막대 게이지
<a name="v9-panels-bar-gauge"></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에서 축소를 계산하는 방법을 선택합니다.

이 패널은 쿼리가 반환하는 시리즈, 행 또는 열 수에 따라 하나 이상의 막대 게이지를 표시할 수 있습니다.

## 값 옵션
<a name="v9-panels-bar-gauge-value"></a>

다음 옵션을 사용하여 시각화가 값을 표시하는 방법을 세분화합니다.

**표시** - Grafana에서 데이터를 표시하는 방법을 선택합니다.

**계산** - 모든 행을 기반으로 계산된 값을 표시합니다.
+ **계산** - Grafana에서 여러 필드를 단일 값으로 줄이는 데 사용할 축소기 함수를 선택합니다. 사용 가능한 계산 목록은 계산 유형을 참조하세요.
+ **필드** - 패널에 표시할 필드를 선택합니다.

**모든 값** - 모든 행에 대해 별도의 통계를 표시합니다. 이 옵션을 선택하면 표시할 행 수를 제한할 수도 있습니다.
+ **제한** - 표시할 최대 행 수. 기본값은 5,000입니다.
+ **필드** - 패널에 표시할 필드를 선택합니다.

## 막대 게이지 옵션
<a name="v9-panels-bar-gauge-options"></a>

막대 게이지가 표시되는 방식을 조정합니다.

**방향** - 스택 방향을 선택합니다.
+ **자동** - Grafana에서 최적의 방향이라고 생각하는 항목을 선택합니다.
+ **가로** - 막대가 가로로 확장됩니다(왼쪽에서 오른쪽 방향).
+ **세로** - 막대가 세로로 확장됩니다(위에서 아래 방향).

**표시 모드** - 표시 모드를 선택합니다.
+ **그라데이션** - 임계치 수준에서는 그라데이션을 정의합니다.
+ **레트로 LCD** - 게이지는 켜지거나 켜지지 않은 작은 셀로 분할됩니다.
+ **기본** - 일치하는 임계치를 기반으로 한 단일 색상.

**채워지지 않은 영역 표시** - 막대의 채워지지 않은 리전을 짙은 회색으로 렌더링하려면 이 옵션을 선택합니다. 레트로 LCD 표시 모드에는 적용되지 않습니다.

**최소 너비**

세로 방향으로 막대 열의 최소 너비를 제한합니다.

데이터가 많으면 x축 스크롤바를 자동으로 표시합니다.

**최소 높이**

가로 방향으로 막대 행의 최소 높이를 제한합니다.

데이터가 많으면 y축 스크롤바를 자동으로 표시합니다.

# 캔들스틱 패널
<a name="v9-panels-candlestick"></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) 섹션을 참조하세요.

캔들스틱 패널을 사용하면 가격 변동에 초점을 맞춘 여러 가지 일관된 차원이 포함된 데이터를 시각화할 수 있습니다. 캔들스틱 패널에는 공개-높음-낮음-마감(OHLC) 모드와 시계열 데이터를 기반으로 한 추가 차원 지원이 포함됩니다.

캔들스틱 패널은 [시계열 패널](v9-panels-time-series.md)을 기반으로 빌드되며 많은 공통 구성 설정을 포함합니다.

**Mode(모드)**

모드 옵션을 사용하면 시각화에 사용되는 차원을 전환할 수 있습니다.
+ **캔들**에서는 캔들스틱 시각화에 사용되는 개방, 높음, 낮음, 닫힘 차원으로 패널 차원을 제한합니다.
+ **볼륨**에서는 패널 차원을 볼륨 차원으로 제한합니다.
+ **둘 다**는 캔들스틱 패널의 기본 동작입니다. 여기에는 캔들스틱 및 볼륨 시각화가 모두 포함됩니다.

**캔들 스타일**
+ **캔들**은 기본 표시 스타일로, 공개 차원과 마감 차원 간에 캔들 스타일 시각화를 생성합니다.
+ **OHLC 막대**는 네 가지 핵심 차원(공개, 높음, 낮음, 마감) 값을 표시합니다.

**색상 전략**
+ **공개 이후**가 기본 동작입니다. 이 모드는 기간 사이 가격 변동이 양수이면 *위쪽* 색상(아래)을 사용합니다. 즉, 마감 시 값이 공개 시 값 이상이면 *위쪽* 색상이 사용됩니다.
+ **마감 이전 이후** - 캔들 색상이 기간 내 가격 변동 또는 값 변화를 기반으로 하는 대체 표시 방법입니다. 즉, 공개 시 값이 마감 시 이전 값보다 크면 *위쪽* 색상이 사용됩니다. 공개 시 값이 마감 시 이전 값보다 작으면 *아래쪽* 색상이 사용됩니다. *또한 이 옵션은 빈 캔들스틱 시각화 모드를 트리거합니다*. 빈 캔들스틱은 기간 사이 변동이 양수임을 나타내고(마감 시 값이 공개 시 값보다 높음), 채워진 캔들스틱은 기간 사이 변동이 음수임을 나타냅니다(마감 시 값이 공개 시 값보다 작음). 자세한 내용은 [explanation of the differences](https://thetradingbible.com/how-to-read-hollow-candlesticks)를 참조하세요.

**위쪽 및 아래쪽 색상**

**위쪽 색상** 및 **아래쪽 색상** 옵션은 가격 변동이 높거나 낮을 때 사용할 색상을 선택합니다. 위의 *색상 전략*은 캔들 또는 OHLC 막대 색상을 선택하는 데 기간 내 또는 기간 사이 가격 변동이 사용되는지 여부를 결정합니다.

**공개, 높음, 낮음, 마감**

캔들스틱 패널은 필드를 적절한 차원에 매핑하려고 시도합니다. **공개** **높음**, **낮음** 및 **마감** 옵션은 패널에서 이러한 차원에 데이터를 매핑할 수 없는 경우 이 매핑 작업을 수행하도록 지원합니다.

**참고**  
이러한 값은 범례에서 숨겨집니다.
+ **공개**는 지정된 기간의 시작 값에 해당합니다.
+ **높음**은 지정된 기간의 최곳값에 해당합니다.
+ **낮음**은 지정된 기간의 최젓값에 해당합니다.
+ **닫기**는 지정된 기간의 최종(종료) 값에 해당합니다.
+ **볼륨**은 지정된 기간의 샘플 수에 해당합니다(예: 거래 수).

**추가 필드**

캔들스틱 패널은 시계열 패널을 기반으로 합니다. 공개, 높음, 낮음, 마감 및 볼륨 외에도 추가 데이터 차원을 시각화할 수 있습니다. **포함** 및 **무시** 옵션을 사용하면 [시계열 패널](v9-panels-time-series.md)에서 사용할 수 있는 것과 동일한 스타일과 구성을 사용하여 단순 이동 평균, Bollinger 밴드 등과 같은 다른 포함된 데이터를 시각화할 수 있습니다.

# 캔버스 패널
<a name="v9-panels-canvas"></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의 UI 내에서 표준 Grafana 패널로는 불가능한 방식으로 사용자 지정 시각화를 설계하고 데이터를 오버레이할 수 있습니다. 인기 있는 UI 및 웹 설계 도구를 사용하는 경우 캔버스 패널 설계도 익숙하게 사용할 수 있습니다.

## 요소
<a name="v9-panels-canvas-elements"></a>

**지표 값**

지표 값 요소를 사용하면 캔버스에 표시할 데이터를 쉽게 선택할 수 있습니다. 이 요소에는 컨텍스트 메뉴 '편집' 옵션을 통해 또는 두 번 클릭하여 트리거할 수 있는 고유한 '편집' 모드가 있습니다. 편집 모드에서 표시할 필드 데이터를 선택할 수 있습니다.

**텍스트**

텍스트 요소를 사용하면 캔버스에 텍스트를 쉽게 추가할 수 있습니다. 또한 요소는 컨텍스트 메뉴의 두 번 클릭 또는 편집 메뉴 옵션을 통해 트리거되는 편집 모드를 지원합니다.

**직사각형**

직사각형 요소를 사용하면 캔버스에 기본 직사각형을 추가할 수 있습니다. 직사각형 요소는 텍스트(고정 및 필드 데이터 모두) 표시를 지원하며 데이터 임계치에 따라 배경 색상을 변경할 수 있습니다.

**아이콘**

아이콘 요소를 사용하면 지원되는 아이콘을 캔버스에 추가할 수 있습니다. 아이콘은 임계치 또는 값 매핑을 기반으로 색상이 설정될 수 있습니다.

## 캔버스 편집
<a name="v9-panels-canvas-editing"></a>

**인라인 편집기**

캔버스에서는 새로운 편집 환경을 도입합니다. 이제 대시보드 모드의 컨텍스트에서 캔버스 패널을 인라인으로 편집할 수 있습니다.

**컨텍스트 메뉴**

컨텍스트 메뉴를 사용하면 일반적인 태스크에 액세스할 수 있습니다. 지원되는 기능으로 인라인 편집기 열기 및 닫기, 요소 복제, 요소 삭제 등이 있습니다.

컨텍스트 메뉴는 패널 또는 지정된 캔버스 요소에 대한 오른쪽 클릭 작업에 의해 트리거됩니다. 패널을 오른쪽 클릭하면 배경 이미지를 설정하고 캔버스에 요소를 쉽게 추가할 수 있습니다.

요소를 오른쪽 클릭하면 요소를 편집, 삭제 및 복제하거나 요소의 계층 위치를 수정할 수 있습니다.

## 캔버스 옵션
<a name="v9-panels-canvas-options"></a>

**인라인 편집**

인라인 편집 토글을 사용하면 캔버스 패널을 잠그거나 잠금 해제할 수 있습니다. 이 기능을 끄면 캔버스 패널이 *잠기고* 요소가 제자리에 고정되며 의도하지 않은 수정을 방지합니다.

# 시계 패널
<a name="v9-panels-clock"></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초마다 업데이트됩니다.
+ **모드** - 기본값은 **시간**입니다. **카운트다운**을 선택하는 경우 **카운트다운 마감 시간**을 설정하여 카운트다운을 시작합니다.
+ **12시간 또는 24시간** - 시간을 표시하는 옵션은 12시간 형식과 24시간 형식입니다.
+ **시간대** - 시간대는 순간 시간대 라이브러리에서 제공됩니다. 기본값은 컴퓨터의 시간대입니다.
+ **카운트다운 마감 시간** - **모드**를 카운트다운으로 설정한 경우 **카운트다운**을 적용할 시간과 날짜를 지정합니다.
+ **카운트다운 종료 텍스트** - 카운트다운이 종료될 때 표시할 텍스트를 지정합니다.
+ **날짜/시간 형식 지정 옵션** - 글꼴 크기, 가중치 및 날짜/시간 형식을 사용자 지정합니다. 카운트다운을 표시하고 초의 카운트다운을 표시하지 않으려면 시간 형식을 24시간 시계의 경우 `hh:mm`으로, 12시간 시계의 경우 `h:mm A`로 변경합니다. 전체 옵션 목록은 [표시](https://momentjs.com/docs/#/displaying/)를 참조하세요.
+ **배경 색상** - 시계의 배경 색상을 선택합니다.

# 대시보드 목록
<a name="v9-panels-dashboard-list"></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) 섹션을 참조하세요.

대시보드 목록 시각화를 사용하면 다른 대시보드에 대한 동적 링크를 표시할 수 있습니다. 별표가 지정된 대시보드, 최근 조회한 대시보드, 검색 쿼리 및 대시보드 태그를 사용하도록 목록을 구성할 수 있습니다.

대시보드를 로드할 때마다 이 패널은 대시보드 목록을 쿼리하여 항상 최신 결과를 제공합니다.

**옵션**

다음 옵션을 사용하여 시각화를 세분화합니다.
+ **별표** - 별표가 지정된 대시보드를 사전순으로 표시합니다.
+ **최근 조회** - 최근 조회한 대시보드를 사전순으로 표시합니다.
+ **검색** - 검색 쿼리 또는 태그별로 대시보드를 표시합니다. **쿼리** 또는 **태그**에 하나 이상의 값을 입력해야 합니다. **쿼리** 및 **태그** 필드의 경우 `$my_var` 또는 `${my_var}`과 같은 변수 보간이 지원됩니다.
+ **제목 표시** - 선택한 목록 선택(별표, 최근 조회, 검색)이 제목으로 표시됩니다.
+ **최대 항목** - 섹션당 나열할 최대 항목 수를 설정합니다. 예를 들어 기본값(10)으로 두고 별표가 지정된 대시보드 및 최근 조회한 대시보드를 표시하는 경우 패널에는 최대 20개의 총 대시보드(섹션당 10개)가 표시됩니다.

**검색**

이러한 옵션은 **검색** 옵션을 선택한 경우에만 적용됩니다.
+ **쿼리** - 검색하려는 쿼리를 입력합니다. 쿼리는 대소문자를 구분하지 않으며 부분 값이 허용됩니다.
+ **폴더** - 표시할 대시보드 폴더를 선택합니다.
+ **태그** - 여기에 검색하려는 태그를 입력합니다. 기존 태그는 입력할 때 표시되지 않으며 대소문자를 *구분*합니다.

**참고**  
여러 태그와 문자열이 나타나면 대시보드 목록에 *모든* 조건과 일치하는 태그와 문자열이 표시됩니다.

# 게이지 패널
<a name="v9-panels-gauge"></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에서 여러 필드를 단일 값으로 줄이는 데 사용할 축소기 함수를 선택합니다. 사용 가능한 계산 목록은 [계산 유형](v9-panels-calculation-types.md) 섹션을 참조하세요.
+ **필드** - 패널에 표시할 필드를 선택합니다.

**모든 값**

모든 행에 대해 별도의 통계를 표시합니다. 이 옵션을 선택하면 표시할 행 수를 제한할 수도 있습니다.
+ **제한** - 표시할 최대 행 수. 기본값은 5,000입니다.
+ **필드** - 패널에 표시할 필드를 선택합니다.

**Gauge**

게이지가 표시되는 방식을 조정합니다.
+ **임계치 레이블 표시** - 임계치가 표시되는지 여부를 제어합니다.
+ **임계치 마커 표시** - 내부 게이지 값 밴드 외부에 임계치 밴드가 표시되는지 여부를 제어합니다.

**텍스트 크기**

게이지 텍스트의 크기를 조정합니다.
+ **제목** - 게이지 제목 크기의 숫자 값을 입력합니다.
+ **값** - 게이지 값 크기의 숫자 값을 입력합니다.

# Geomap 패널
<a name="v9-panels-geomap"></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) 섹션을 참조하세요.

Geomap 패널 시각화를 사용하면 지리 공간 데이터를 사용하여 세계 지도를 보고 사용자 지정할 수 있습니다. 데이터의 중요한 위치 기반 특성에 쉽게 초점을 맞추도록 다양한 오버레이 스타일과 맵 보기 설정을 구성할 수 있습니다.

## 맵 보기
<a name="v9-panels-geomap-view"></a>

맵 보기는 대시보드가 로드될 때 맵의 초기 보기를 제어합니다.

**초기 보기**

초기 보기는 패널을 처음 로드할 때 GeoMap 패널이 렌더링되는 방법을 구성합니다.
+ **보기**는 패널이 처음 로드될 때 맵의 중심을 설정합니다.
  + **데이터에 맞춤**에서는 맵 계층의 데이터 범위를 기반으로 맵 보기에 맞추며 데이터가 변경될 때 업데이트합니다.
    + **데이터** 옵션을 사용하면 '모든 계층', '단일 계층' 또는 선택한 계층의 '마지막 값'의 데이터를 기반으로 범위를 선택할 수 있습니다.
    + 단일 '계층' 또는 계층의 '마지막 값'에서 데이터를 맞추는 경우 **계층**을 선택할 수 있습니다.
    + **채움**에서는 데이터 범위를 초과하는 상대적 백분율로 채움을 설정합니다('마지막 값'만 보는 경우 사용할 수 없음).
    + **최대 확대/축소**에서는 데이터를 맞출 때 최대 확대/축소 수준을 설정합니다.
  + **좌표**에서는 다음을 기반으로 맵 보기를 설정합니다.
    + **위도**
    + **경도**
  + 다음을 포함하여 기본 보기도 사용할 수 있습니다.
    + **(0°, 0°)**
    + **북미**
    + **남미**
    + **유럽**
    + **아프리카**
    + **서아시아**
    + **남아시아**
    + **동남아시아**
    + **동아시아**
    + **오스트레일리아**
    + **오세아니아**
+ **확대/축소**에서는 초기 확대/축소 수준을 설정합니다.

## 맵 계층
<a name="v9-panels-geomap-layers"></a>

Geomap 시각화에서는 여러 계층 표시를 지원합니다. 각 계층에서는 기본 맵 위에 지리 공간 데이터를 시각화하는 방법을 결정합니다.

**유형**

Geomap 시각화에는 선택할 수 있는 세 가지 맵 계층 유형이 있습니다.
+ [마커 계층](#v9-panels-geomap-markers)에서는 각 데이터 포인트에서 마커를 렌더링합니다.
+ [히트맵 계층](#v9-panels-geomap-heatmap)에서는 데이터의 히트맵을 시각화합니다.
+ [GeoJSON 계층](#v9-panels-geomap-geojson)에서는 GeoJSON 파일에서 정적 데이터를 렌더링합니다.

또한 현재 알파로 표시되는 다섯 가지 계층 유형도 있습니다.
+ [야간/주간 계층(알파)](#v9-panels-geomap-nightday)에서는 야간 또는 주간 리전을 렌더링합니다.
+ **마지막 포인트의 아이콘(알파)**에서는 마지막 데이터 포인트에서 아이콘을 렌더링합니다.
+ **동적 GeoJSON(알파)**에서는 쿼리 결과를 기반으로 GeoJSON 파일 스타일을 지정합니다.
+ **라우팅(알파)**에서는 데이터 포인트를 경로로 렌더링합니다.
+ [사진 계층(알파)](#v9-panels-geomap-photos)에서는 각 데이터 포인트에서 사진을 렌더링합니다.

**계층 제어**

계층 제어를 사용하면 계층을 생성하고, 이름을 변경하며, 계층의 순서를 바꾸고, 삭제할 수 있습니다.
+ **계층 추가**에서는 Geomap 시각화에 대해 구성 가능한 추가 데이터 계층을 생성합니다. 계층을 추가하면 계층 유형을 선택하라는 메시지가 표시됩니다. 패널 구성 중 언제든지 계층 유형을 변경할 수 있습니다. 각 계층 유형에 대한 자세한 내용은 위의 **계층 유형** 섹션을 참조하세요.
+ 계층 제어를 사용하면 패널의 계층 이름을 바꾸고, 삭제하며, 순서를 바꿀 수 있습니다.
  + **계층 이름 편집**(연필 아이콘)은 계층의 이름을 변경합니다.
  + **휴지통**은 계층을 삭제합니다.
  + **재정렬**(점 6개/손잡이 핸들)을 사용하면 계층 순서를 변경할 수 있습니다. 상위 계층의 데이터는 하위 계층의 데이터 위에 표시됩니다. 패널은 끌어다 놓을 때 계층 순서를 업데이트하여 계층 순서를 쉽게 선택할 수 있습니다.

풍부하고 세부적인 시각화를 생성하기 위해 단일 Geomap 패널에 여러 계층의 데이터를 추가할 수 있습니다.

**위치**

Geomap 패널에는 지리적 데이터 소스가 필요합니다. 이 데이터는 데이터베이스 쿼리에서 가져오며, 데이터에 대한 네 가지 매핑 옵션이 있습니다.
+ **자동**은 위치 데이터를 자동으로 검색합니다. 쿼리가 데이터 필드의 다음 이름 중 하나를 기반으로 하는 경우 이 옵션을 사용합니다.
  + geohash: “geohash”
  + latitude: “latitude”, “lat”
  + longitude: “longitude”, “lng”, “lon”
  + lookup: “lookup”
+ **Coords**에서는 쿼리에서 좌표 데이터를 보유하도록 지정합니다. 데이터베이스 쿼리에서 위도 및 경도에 대한 숫자 데이터 필드를 선택하라는 프롬프트가 표시됩니다.
+ **Geohash**에서는 쿼리에서 지리적 해시 데이터를 보유하도록 지정합니다. 데이터베이스 쿼리에서 지오해시의 문자열 데이터 필드를 선택하라는 프롬프트가 표시됩니다.
+ **Lookup**에서는 쿼리에서 값에 매핑해야 하는 위치 이름 데이터를 보유하도록 지정합니다. 데이터베이스 쿼리 및 gazetteer에서 조회 필드를 선택하라는 프롬프트가 표시됩니다. gazetteer는 쿼리된 데이터를 지리적 지점에 매핑하는 데 사용되는 디렉터리입니다.

## 마커 계층
<a name="v9-panels-geomap-markers"></a>

마커 계층을 사용하면 데이터 포인트를 원, 사각형, 삼각형, 별 등과 같은 다양한 마커 모양으로 표시할 수 있습니다.

마커에는 많은 사용자 지정 옵션이 있습니다.
+ **마커 색상**에서는 마커의 색상을 구성합니다. 기본 `Single color`에서는 모든 지점을 단일 색상으로 유지합니다. 데이터 포인트 값과 `Thresholds` 섹션에 설정된 임계치에 따라 여러 색상을 사용할 수 있는 대체 옵션이 있습니다.
+ **마커 크기**에서는 마커의 크기를 구성합니다. 기본값은 `Fixed size`이며, 데이터 포인트에 관계없이 모든 마커 크기가 동일합니다. 그러나 원을 해당 데이터 포인트로 조정하는 옵션도 있습니다. 마커 계층이 이 범위 내에서 조정할 수 있도록 `Min` 및 `Max` 마커 크기를 설정해야 합니다.
+ **마커 모양**을 사용하면 도형, 아이콘 또는 그래픽을 선택하여 데이터에 시각적 컨텍스트를 추가로 제공할 수 있습니다. 간단한 형태 또는 Unicon 라이브러리와 같이 Grafana에 포함된 자산 중에서 선택합니다. 이미지 자산이 포함된 URL을 지정할 수도 있습니다. 이미지는 Scalable Vector Graphic(SVG)이어야 합니다.
+ **채우기 불투명도**에서는 각 마커의 투명도를 구성합니다.

## 히트맵 계층
<a name="v9-panels-geomap-heatmap"></a>

히트맵 계층은 다양한 데이터 포인트를 클러스터화하여 밀도가 다른 위치를 시각화합니다. 히트맵 계층을 추가하는 방법:

데이터 계층에서 드롭다운 메뉴를 클릭하고 `Heatmap`을 선택하세요.

`Markers`와 마찬가지로 시각화할 데이터 포인트와 시각화 방법을 결정하는 옵션이 표시됩니다.
+ **가중치 값**에서는 히트맵 클러스터의 강도를 구성합니다. `Fixed value`는 모든 데이터 포인트에서 일정한 가중치 값을 유지합니다. 이 값은 0\$11 범위여야 합니다. 마커와 마찬가지로 드롭다운에는 데이터 값에 따라 가중치 값을 자동으로 조정하는 대체 옵션이 있습니다.
+ **반경**에서는 히트맵 클러스터의 크기를 구성합니다.
+ **블러**에서는 각 클러스터의 블러 양을 구성합니다.

## GeoJSON 계층
<a name="v9-panels-geomap-geojson"></a>

GeoJSON 계층을 사용하면 파일 시스템에서 정적 GeoJSON 파일을 선택 및 로드할 수 있습니다.
+ **GeoJSON URL**에서는 Grafana와 함께 제공되는 GeoJSON 파일의 선택 사항을 제공합니다.
+ **기본 스타일**에서는 위의 규칙이 일치하지 않을 때 적용할 스타일을 제어합니다.
  + **색상**에서는 기본 스타일의 색상을 구성합니다.
  + **불투명도**에서는 기본 불투명도를 구성합니다.
+ **스타일 규칙**에서는 특성 속성에 따라 스타일을 적용합니다.
  + **규칙**을 사용하면 GeoJSON 파일에서 *특성*, *조건* 및 *값*을 선택하여 규칙을 정의할 수 있습니다. 휴지통 아이콘을 사용하여 현재 규칙을 삭제할 수 있습니다.
  + **색상**에서는 현재 규칙에 대한 스타일 색상을 구성합니다.
  + **불투명도**에서는 현재 규칙의 투명도 수준을 구성합니다.
+ **스타일 추가 규칙**은 추가 스타일 규칙을 생성합니다.

## CARTO 계층
<a name="v9-panels-geomap-carto"></a>

CARTO 계층은 [CARTO](https://carto.com/about-us/) Raster 기본 맵에서 가져옵니다.

**옵션**
+ **테마**

   테마(**밝은** 테마, **어두운** 테마 또는 **자동** 테마)를 선택합니다.
+ **레이블 표시**에서는 맵 상단에 국가 세부 정보를 표시합니다.
+ **불투명도**에서는 0(투명)에서 1(불투명)의 범위를 지원합니다.

## XYZ 타일 계층
<a name="v9-panels-geomap-xyz"></a>

XYZ 타일 계층은 일반 타일 계층의 맵입니다.

**참고**  
일반 타일 계층에 대한 자세한 내용은 [Tiled Web Maps](https://en.wikipedia.org/wiki/Tiled_web_map) 및 [List of Open Street Map Tile Servers](https://wiki.openstreetmap.org/wiki/Tile_servers)를 참조하세요.

**옵션**
+ **URL 템플릿**
**참고**  
유효한 제목 서버 URL 설정, \$1z\$1/\$1x\$1/\$1y\$1 포함, 예: `https://tile.openstreetmap.org/{z}/{x}/{y}.png`.
+ **어트리뷰션**에서는 [맵 제어](#v9-panels-geomap-controls)에 표시되는 경우 계층의 참조 문자열을 설정합니다.
+ **불투명도**에서는 0(투명)에서 1(불투명)의 범위를 지원합니다.

## Open Street Map 계층 열기
<a name="v9-panels-geomap-osm"></a>

전 세계 공동의 무료 지리 데이터베이스인 [Open Street Map](https://www.openstreetmap.org/about)의 맵.

**옵션**
+ **불투명도**에서는 0(투명)에서 1(불투명)의 범위를 지원합니다.

## ArcGIS 계층
<a name="v9-panels-geomap-arcgis"></a>

[ArcGIS](https://services.arcgisonline.com/arcgis/rest/services) 계층은 [ESRI](https://www.esri.com/en-us/about/about-esri/overview) ArcGIS MapServer의 계층입니다.

**옵션**
+ 다음 맵 유형에서 선택할 **서버 인스턴스**.
  + 전 세계 거리 지도
  + 전 세계 이미지
  + 전 세계 물리적 지도
  + 지형
  + 미국 지형
  + 전 세계 바다
  + 사용자 지정 MapServer(형식 지정은 [XYZ](#v9-panels-geomap-xyz) 참조)
    + URL 템플릿
    + 어트리뷰션
+ **불투명도**에서는 0(투명)에서 1(불투명)의 범위를 지원합니다.

## 야간/주간 계층(알파)
<a name="v9-panels-geomap-nightday"></a>

야간/주간 계층에서는 현재 시간 범위를 기반으로 야간 및 주간 리전을 표시합니다.

**참고**  
자세한 내용은 [Extensions for OpenLayers - DayNight](https://viglino.github.io/ol-ext/examples/layer/map.daynight.html)를 참조하세요.

**옵션**
+ **표시**에서는 패널 시간 범위에서 시간 소스를 전환합니다.
+ **야간 리전 색상**에서는 야간 리전의 색상을 선택합니다.
+ **태양 표시**에서는 태양 아이콘을 전환합니다.
+ **불투명도**에서는 0(투명)에서 1(불투명)의 범위를 지원합니다.

## 사진 계층(알파)
<a name="v9-panels-geomap-photos"></a>

사진 계층에서는 각 데이터 포인트에서 사진을 렌더링합니다.

**참고**  
자세한 내용은 [Extensions for OpenLayers - Image Photo Style](http://viglino.github.io/ol-ext/examples/style/map.style.photo.html)을 참조하세요.

**옵션**
+ **이미지 소스 필드**

  다음 형식 중 하나로 이미지 데이터가 포함된 문자열 필드를 선택합니다.
  + **이미지 URL**
  + **Base64 인코딩** 이미지 바이너리(`data:image/png;base64,…`)
+ **종류**

   이미지 주변의 프레임 스타일을 선택합니다.
  + **Square**
  + **Circle(원)**
  + **고정됨**
  + **폴리오**
+ **잘라내기**에서는 이미지를 맞게 자르는지 여부를 전환합니다.
+ **그림자**에서는 이미지 뒤에 있는 상자 그림자를 전환합니다.
+ **테두리**에서는 이미지의 테두리 크기를 설정합니다.
+ **테두리 색상**에서는 이미지 주위의 테두리 색상을 설정합니다.
+ **반경**에서는 이미지의 전체 크기를 픽셀 단위로 설정합니다.

## 맵 제어
<a name="v9-panels-geomap-controls"></a>

맵 제어 인터페이스에는 맵 정보 및 도구 오버레이에 대한 다음 옵션이 포함되어 있습니다.

**확대/축소**

이 섹션에서는 각 확대/축소 제어를 설명합니다.

*확대/축소 제어 표시*

왼쪽 상단에 확대/축소 제어를 표시합니다.

*마우스 휠 확대/축소*

확대 또는 축소를 위해 마우스 휠을 사용하여 이 기능을 켜거나 끕니다.

**어트리뷰션 표시**

맵의 기본 맵 계층에 대한 속성을 표시합니다.

**스케일 표시**

왼쪽 하단에 스케일 정보를 표시합니다.

**참고**  
단위를 [m]/[km] 단위로 표시합니다.

**측정 도구 표시**

오른쪽 상단에 측정 도구를 표시합니다. 측정은 이 제어가 열려 있는 경우에만 표시됩니다.
+ **클릭**: 측정 시작
+ **연속 클릭**: 연속 측정
+ **두 번 클릭**: 측정 종료

**참고**  
측정 유형 또는 단위를 변경하면 이전 측정이 맵에서 제거됩니다.  
제어를 닫고 다시 열면 최근 측정이 표시됩니다.  
측정을 클릭하고 끌어서 수정할 수 있습니다.

*길이*

지오메트리의 구형 길이를 가져옵니다. 이 길이는 좌표 간 큰 원의 거리에 대한 합계입니다. 다중 파트 지오메트리의 경우 길이는 각 파트 길이의 합계입니다. 지오메트리는 'EPSG:3857'로 가정됩니다.

길이 측정을 위해 다음 단위를 선택할 수 있습니다.
+ **미터(m/km)**
+ **피트(ft)**
+ **마일(mi)**
+ **노티컬 마일(nmi)**

*영역*

지오메트리의 구체 영역을 가져옵니다. 이 영역은 다각형 엣지가 구체에서 큰 원의 세그먼트라고 가정하여 계산됩니다. 지오메트리는 'EPSG:3857'로 가정됩니다.

영역 측정을 위해 다음 단위를 선택할 수 있습니다.
+ **평방 미터(m2)**
+ **평방 킬로미터(km2)**
+ **평방 피트(ft2)**
+ **평방 마일(mi2)**
+ **에이커(acre)**
+ **헥타르(ha)**

**디버그 표시**

맵의 오른쪽 상단에 디버그 정보를 표시합니다. 데이터 소스를 디버깅하거나 검증하는 데 유용할 수 있습니다.
+ **확대/축소**에서는 맵의 현재 확대/축소 수준을 표시합니다.
+ **중심**에는 맵 중심의 현재 **경도** 및 **위도**가 표시됩니다.

**Tooltip**
+ **없음**에서는 데이터 포인트를 클릭한 경우에만 툴팁을 표시합니다.
+ **세부 정보**에서는 커서를 데이터 포인트 위에 가져간 경우 툴팁을 표시합니다.

# 그래프 패널
<a name="v9-panels-graph"></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-panels-graph-data-and-field-options"></a>

그래프 시각화를 사용하는 경우 다음 옵션을 적용할 수 있습니다.
+  [데이터 변환](v9-panels-xform.md) 
+ 알림. 알림을 설정할 수 있는 유일한 시각화 유형입니다. 자세한 내용은 [Grafana 버전 9에서의 알림](v9-alerts.md) 단원을 참조하십시오.
+  [임계치 구성](v9-panels-configure-thresholds.md) 

## 표시 옵션
<a name="v9-panels-graph-display-options"></a>

시각화를 구체화하려면 다음 설정을 사용합니다.
+  **막대** - 값을 막대 차트로 표시합니다.
+  **선** - 값을 선 그래프로 표시합니다.
+  **선 너비** - 시리즈의 선 너비를 지정합니다. 기본값은 1입니다.
+  **계단식** - 인접한 포인트를 계단식으로 그립니다.
+  **영역 채우기** - 시리즈의 색상 채우기 양을 지정합니다. 기본값은 1이며, 0인 경우 지정하지 않습니다.
+  **채우기 그라데이션** - 영역 채우기에서 그라데이션 수준을 지정합니다. 기본값은 0(그라데이션 없음)이며, 10인 경우 그라데이션 수준이 매우 높습니다.
+  **포인트** - 값에 대한 포인트를 표시합니다.
+  **포인트 반경** - 포인트의 크기를 제어합니다.
+  **알림 임계치** - 패널에 알림 임계치 및 리전을 표시합니다.

### 스택 및 null 값
<a name="v9-panels-graph-stacking-and-null-value"></a>
+  **스택** - 각 시리즈가 다른 시리즈 위에 스택됩니다.
+  **백분율** - 각 시리즈가 모든 시리즈의 합계에 대한 백분율로 그려집니다. 이 옵션은 **스택**을 선택한 경우 사용할 수 있습니다.
+  **Null 값** - null 값이 표시되는 방법을 지정합니다. *중요한 설정입니다.* 아래 참고 사항을 참조하세요.
  +  **연결됨** - 시리즈에 하나 이상의 null 값을 의미하는 갭이 있는 경우 선은 갭을 건너뛰고 null이 아닌 다음 값에 연결됩니다.
  +  **null** - 시리즈에 null 값을 의미하는 갭이 있는 경우 그래프의 선이 끊어지고 갭이 표시됩니다. 기본 설정입니다.
  +  **null을 0으로 설정** - 시리즈에 null 값을 의미하는 갭이 있는 경우 그래프 패널에 0으로 표시됩니다.

**중요**  
서버의 CPU 부하를 모니터링하고 부하가 100%에 도달하면 서버가 잠기고 에이전트 전송 통계가 부하 통계를 수집할 수 없습니다. 이로 인해 지표에 갭이 발생하고 기본 *null* 설정을 사용하면 Amazon Managed Grafana에서 갭을 표시하고 문제가 있음을 나타냅니다. *연결됨*으로 설정된 경우 이 신호를 놓치기 쉽습니다.

### 가리키기 툴팁
<a name="v9-panels-graph-hover-tooltip"></a>

이러한 설정을 사용하여 그래프 시각화를 일시 중지할 때 나타나는 툴팁의 모양을 변경합니다.
+  **모드** - 가리키기 툴팁에서 표시하는 시리즈 수를 결정합니다.
  +  **모든 시리즈** - 가리키기 툴팁에는 그래프의 모든 시리즈가 표시됩니다. 툴팁의 시리즈 목록에서 Grafana 워크스페이스는 일시 중지한 시리즈를 굵게 강조 표시합니다.
  +  **단일** - 가리키기 툴팁에는 그래프에서 일시 중지한 시리즈인 단일 시리즈만 표시됩니다.
+  **정렬 순서** - **모든 시리즈** 모드를 선택한 경우 가리키기 툴팁에서 시리즈의 순서를 정렬합니다. 그래프에서 일시 중지하면 Amazon Managed Grafana에 선과 연결된 값이 표시됩니다. 일반적으로 사용자는 가장 높은 값 또는 가장 낮은 값에 가장 관심이 많습니다. 이러한 값을 정렬하면 원하는 데이터를 훨씬 더 쉽게 찾을 수 있습니다.
  +  **없음** - 툴팁의 시리즈 순서는 쿼리의 정렬 순서에 따라 결정됩니다. 예를 들어 시리즈 이름별로 시리즈를 사전순으로 정렬할 수 있습니다.
  +  **증가** - 가리키기 툴팁에서 시리즈가 값을 기준으로 오름차순으로 정렬됩니다(목록 맨 위에 가장 낮은 값).
  +  **감소** - 가리키기 툴팁에서 시리즈가 값을 기준으로 내림차순으로 정렬됩니다(목록 맨 위에 가장 높은 값).

## 시리즈 재정의
<a name="v9-panels-graph-series-overrides"></a>

시리즈 재정의를 사용하면 그래프 패널의 시리즈를 다른 시리즈와 다르게 렌더링할 수 있습니다. 시리즈별로 또는 정규식 규칙을 사용하여 표시 옵션을 사용자 지정할 수 있습니다. 예를 들어 한 시리즈의 선 너비를 두껍게 설정하거나 해당 시리즈를 오른쪽 Y축으로 이동할 수 있습니다.

여러 시리즈 재정의를 추가할 수 있습니다.

**시리즈 재정의를 추가하는 방법**

1. **시리즈 재정의 추가**를 선택하세요.

1. **별칭 또는 정규식**에서 시리즈를 입력하거나 선택하세요. 필드를 선택하여 사용 가능한 시리즈 목록을 확인하세요.

   예를 들어 `/Network.*/`는 `Network out` 및 `Network in`이라는 두 시리즈와 일치합니다.

1. **\$1**를 선택하고 시리즈에 적용할 스타일을 선택하세요. 각 항목에 여러 스타일을 추가할 수 있습니다.
+  **막대** - 시리즈를 막대 그래프로 표시합니다.
+  **선** - 시리즈를 선 그래프로 표시합니다.
+  **선 채우기** - 영역 채우기가 있는 선 그래프를 표시합니다.
+  **채우기 그라데이션** - 영역 채우기 그라데이션 수준을 지정합니다.
+  **선 너비** - 선 너비를 설정합니다.
+  **Null 포인트 모드** - 이 옵션을 사용하여 null 값을 무시하거나 0으로 바꿉니다. 데이터의 갭을 무시하려는 경우 중요합니다.
+  **다음 아래 채우기** - 두 시리즈 사이의 영역을 채웁니다.
+  **계단식 선** - 시리즈를 계단식 선으로 표시합니다.
+  **대시** - 대시가 있는 선을 표시합니다.
+  **숨긴 시리즈** - 시리즈를 숨깁니다.
+  **대시 길이** - 선의 대시 길이를 설정합니다.
+  **대시 공백** - 선의 대시 간 공백 길이를 설정합니다.
+  **포인트** - 시리즈를 별도의 포인트로 표시합니다.
+  **포인트 반경** - 포인트 렌더링의 반경을 설정합니다.
+  **스택** - 시리즈의 스택 그룹을 설정합니다.
+  **색상** - 시리즈 색상을 설정합니다.
+  **Y축** - 시리즈 y축을 설정합니다.
+  **Z-인덱스** - 시리즈 z-인덱스(렌더링 순서)를 설정합니다. 이 옵션은 막대 차트 및 영역 차트와 같은 다양한 스타일을 오버레이할 때 중요합니다.
+  변환 - 값을 음수로 변환하여 y축 아래를 렌더링합니다.
+  **범례** - 시리즈가 범례에 표시되는지 여부를 제어합니다.
+  **툴팁에서 숨기기** - 그래프 툴팁에 시리즈가 표시되는지 여부를 제어합니다.

## 축
<a name="v9-panels-graph-axes"></a>

이러한 옵션을 사용하여 시각화에서 축 표시를 제어합니다.

### 왼쪽 Y/오른쪽 Y
<a name="v9-panels-graph-left-yright-y"></a>

옵션은 두 y축 모두에서 동일합니다.
+  **표시** - 축을 표시하거나 숨기도록 선택합니다.
+  **단위** - y 값의 표시 단위를 선택합니다.
+  **조정** - y 값에 사용할 조정 방식(**선형** 또는 **대수**)을 선택합니다. 기본값은 **선형**입니다.
+  **Y-최소** - 최소 y 값. 기본값은 **자동**입니다.
+  **Y-최대** - 최대 Y 값. 기본값은 **자동**입니다.
+  **소수점** - y 값에 표시되는 소수점 수를 정의합니다. 기본값은 **자동**입니다.
+  **레이블** - y축 레이블을 지정합니다. 기본값은 ""입니다.

### Y축
<a name="v9-panels-graph-y-axes"></a>
+  **정렬** - 값을 기준으로 왼쪽 및 오른쪽 y축을 정렬합니다. 기본값은 선택 취소된 상태(false)입니다.
+  **수준** - Y=0부터 시작하여 왼쪽 및 오른쪽 y축 정렬에 사용할 값을 입력합니다. 기본값은 0입니다. 이 옵션은 **정렬**을 선택한 경우에 사용할 수 있습니다.

### X축
<a name="v9-panels-graph-x-axis"></a>
+  **표시** - 축을 표시하거나 숨기도록 선택합니다.
+  **모드** - 표시 모드는 그래프 패널의 시각화를 완전히 변경합니다. 한 곳에 세 개의 패널이 있는 것과 같습니다. 기본 모드는 x축에 시간이 있는 시계열 모드입니다. 다른 두 모드는 x축에 시간 대신 시리즈가 있는 기본 막대 차트 모드와 히스토그램 모드입니다.
  +  **시간**(기본값) - x축은 시간을 나타내며 데이터는 시간(예: 시간 또는 분)별로 그룹화됩니다.
  +  **시리즈** - 데이터는 시간이 아닌 시리즈별로 그룹화됩니다. y축은 여전히 값을 나타냅니다.
    +  **값** - 값에 사용할 집계 유형입니다. 기본값은 **합계**입니다(모든 값 합산).
  +  **히스토그램** - 이 옵션은 그래프를 히스토그램으로 변환합니다. 히스토그램은 숫자를 범위로 그룹화하는 일종의 막대 차트로, 버킷 또는 빈이라고도 합니다. 막대가 길면 더 많은 데이터가 해당 범위에 속함을 보여줍니다.

    히스토그램에 대한 자세한 내용은 [히스토그램 및 히트맵 소개](getting-started-grafanaui.md#introduction-to-histograms-and-heatmaps) 섹션을 참조하세요.
    +  **버킷** - 값을 그룹화할 버킷 수를 설정합니다. 비워 두면 Amazon Managed Grafana에서 적당한 수의 버킷을 계산하려고 합니다.
    +  **X-최소** - 히스토그램에서 이 최소 한도보다 작은 값을 필터링합니다.
    +  **X-최대** - 이 최대 한도보다 큰 값을 필터링합니다.

## 범례
<a name="v9-panels-graph-legend"></a>

이러한 설정을 사용하여 시각화에 범례가 표시되는 방식을 세분화합니다.

### 옵션
<a name="v9-panels-graph-legends-options"></a>
+  **표시** - 범례를 숨기려면 지웁니다. 기본값이 선택된 상태(true)입니다.
+  **테이블 형식** - 테이블에 범례를 표시하려면 선택합니다. 기본값은 확인(true)됩니다.
+  **오른쪽** - 오른쪽에 범례를 표시하려면 선택합니다.
+  너비 - 범례의 최소 너비를 픽셀 단위로 입력합니다. 이 옵션은 **오른쪽으로**를 선택한 경우에 사용할 수 있습니다.

### 값
<a name="v9-panels-graph-values"></a>

범례 이름과 함께 추가 값을 표시할 수 있습니다.
+  **최소** - 지표 쿼리에서 반환된 최솟값.
+  **최대** - 지표 쿼리에서 반환된 최댓값.
+  **평균** - 지표 쿼리에서 반환된 평균 값.
+  **현재** - 지표 쿼리에서 반환된 마지막 값.
+  **합계** - 지표 쿼리에서 반환된 모든 값의 합계.
+  **소수점** - 범례 값 및 그래프 가리키기 툴팁에 표시되는 소수점 수.

Amazon Managed Grafana는 클라이언트 측에서 범례 값을 계산합니다. 이러한 범례 값은 지표 쿼리가 사용하는 집계 또는 포인트 통합 유형에 따라 달라집니다. 위의 모든 범례 값은 동시에 정확할 수 없습니다.

예를 들어, 평균을 집계기로 사용할 수 있는 이러한 초당 요청 비율을 작성하는 경우 범례의 합계에서는 총 요청 수를 나타내지 않습니다. 단지 Amazon Managed Grafana에서 수신한 모든 데이터 포인트의 합계입니다.

### 시리즈 숨기기
<a name="v9-panels-graph-hide-series"></a>

지표 쿼리에서 시리즈의 모든 값이 특정 값에 해당하는 경우 시리즈를 숨깁니다.
+  **null만 포함** – 값=null(기본값은 선택 취소된 상태)
+  **0만 포함** - 값=0(기본값은 선택 취소된 상태)

### 시간 리전
<a name="v9-panels-graph-time-regions"></a>

그래프에서 특정 시간대를 강조 표시하여 주말, 근무 시간, 근무 외 시간 등을 더 쉽게 볼 수 있습니다. 구성된 모든 시간 리전은 UTC 시간을 참조합니다.

# 히트맵 패널
<a name="v9-panels-heatmap"></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) 섹션을 참조하세요.

히트맵 패널 시각화를 사용하면 시간 경과에 따른 히스토그램을 볼 수 있습니다. 히스토그램에 대한 자세한 내용은 [히스토그램 및 히트맵 소개](getting-started-grafanaui.md#introduction-to-histograms-and-heatmaps) 섹션을 참조하세요.

## 데이터에서 계산
<a name="v9-panels-heatmap-calculate"></a>

이 설정은 데이터가 데이터 소스/변환기에서 이미 계산된 히트맵인지 아니면 패널에서 계산해야 하는지 여부를 결정합니다.

**X 버킷**

이 설정은 X축이 버킷으로 분할되는 방법을 결정합니다. **크기** 입력에서 시간 간격을 지정할 수 있습니다. 예를 들어 `1h`의 시간 범위는 X축에서 1시간 너비의 셀을 만듭니다.

**Y 버킷**

이 설정은 Y축이 버킷으로 분할되는 방법을 결정합니다.

**Y 버킷 스케일**

다음 Y축 값 스케일 중 하나를 선택합니다.
+ **선형** - 선형 스케일.
+ **로그(밑 2)** - 밑 2를 사용하는 로그 스케일.
+ **로그(밑 10)** - 밑 10을 사용하는 로그 스케일.

## Y축
<a name="v9-panels-heatmap-y-axes"></a>

Y축 표시 방법을 정의합니다.

 **배치**
+ **왼쪽** - 왼쪽에서
+ **오른쪽** - 오른쪽에서
+ **숨김** - 숨김

**단위**

단위 구성

**소수점**

이 설정은 소수점 구성을 결정합니다.

**최솟값/최댓값**

이 설정은 축 범위를 구성합니다.

**역방향**

이 옵션을 선택하면 축이 역방향으로 나타납니다.

## 색상
<a name="v9-panels-heatmap-colors"></a>

색상 스펙트럼은 각 버킷 내 값 수 및 각 버킷에 할당된 색상 간 매핑을 제어합니다. 스펙트럼의 가장 왼쪽 색상은 최소 개수를 나타내고 가장 오른쪽 색상은 최대 개수를 나타냅니다. 일부 색상 체계는 밝은 테마를 사용할 때 자동으로 반전됩니다.

색상 모드를 불투명도로 변경할 수도 있습니다. 이 경우 색상은 변경되지 않지만 버킷 수에 따라 불투명도가 변경됩니다.
+ **Mode(모드)**
  + **색상 체계** - 셀 색상으로 표시되는 버킷 값.
    + **색상 체계** - 모드가 **색상 체계**인 경우 색상 체계를 선택합니다.
  + **불투명도** - 셀 불투명도로 표시되는 버킷 값. 불투명한 셀은 최댓값을 의미합니다.
    + **색상** - 셀 기본 색상.
    + **스케일** - 버킷 값을 불투명도에 매핑하기 위한 스케일.
      + **선형** - 선형 스케일. 버킷 값은 불투명도에 선형으로 매핑됩니다.
      + **sqrt** – 제곱 크기. 셀 불투명도는 `value ^ k`로 계산됩니다. 여기서 `k`는 구성된 **지수** 값입니다. 지수가 `1`보다 작으면 로그 스케일을 사용합니다. 지수가 `1`보다 크면 지수 스케일을 사용합니다. `1`의 경우 스케일은 선형과 동일합니다.
    + **지수** - `0`보다 큰 지수의 값.

**값의 시작/종료 색상**

기본적으로 Grafana는 최소 및 최대 버킷 값을 기반으로 셀 색상을 계산합니다. 최소 및 최대에서는 해당 값을 덮어쓸 수 있습니다. 버킷 값을 Z축으로, 최소 및 최대를 각각 Z-최소 및 Z-최대로 간주합니다.
+ **시작** - 셀 색상 계산에 사용하는 최솟값. 버킷 값이 최소보다 작으면 '최소' 색상으로 매핑됩니다. 시리즈 최솟값이 기본값입니다.
+ **종료** - 셀 색상 계산에 사용하는 최댓값. 버킷 값이 최대보다 크면 '최대' 색상으로 매핑됩니다. 시리즈 최댓값이 기본값입니다.

## 셀 표시
<a name="v9-panels-heatmap-cell"></a>

셀 표시 설정을 사용하여 히트맵에서 셀 시각화를 세분화합니다.

## 추가 표시 옵션
<a name="v9-panels-heatmap-options"></a>

**Tooltip**
+ **툴팁 표시** - 히트맵 툴팁을 표시합니다.
+ **히스토그램 표시** - 툴팁에 Y축 히스토그램을 표시합니다. 히스토그램은 특정 타임스탬프에 대한 버킷 값의 분포를 나타냅니다.

**범례**

시각화에서 히트맵 범례를 표시할지 여부를 선택합니다.

**예시**

예시 데이터를 표시하는 데 사용되는 색상을 설정합니다.

# 히스토그램 패널
<a name="v9-panels-histogram"></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) 섹션을 참조하세요.

히스토그램 시각화는 값의 분포를 계산하여 막대 차트로 표시합니다. Y축과 각 막대의 높이는 각 괄호에 포함된 값의 수를 나타내는 반면, X축은 값 범위를 나타냅니다.

히스토그램 시각화는 하나 이상의 숫자 필드를 포함하는 시계열 및 테이블 결과를 지원합니다.

## 지원되는 형식
<a name="v9-panels-histogram-formats"></a>

히스토그램 시각화는 하나 이상의 숫자 필드를 포함하는 시계열 및 테이블 결과를 지원합니다.

## 표시 옵션
<a name="v9-panels-histogram-options"></a>

다음 옵션을 사용하여 시각화를 세분화합니다.

**버킷 크기**

버킷의 크기. 자동 버킷 크기 조정(전체 범위의 \$110%)을 위해 이 값을 비워 둡니다.

**버킷 오프셋**

첫 번째 버킷을 0에서 시작해서는 안 되는 경우 0이 아닌 오프셋이 집계 기간을 전환합니다. 예를 들어 기본 오프셋이 0인 0\$15, 5\$110, 10\$115와 같은 5개 크기의 버킷이 오프셋이 2인 2\$17, 7\$112, 12\$117이 됩니다. 0, 5 또는 10의 오프셋은 이 경우 아무런 효과가 없습니다. 일반적으로 이 옵션은 자동이 아닌 명시적으로 정의된 버킷 크기와 함께 사용됩니다. 이 설정을 유효하게 적용하려면 오프셋 양이 0보다 크고 버킷 크기보다 작아야 합니다. 이 범위를 벗어난 값은 이 범위 내의 값과 동일한 영향을 미칩니다.

**시리즈 결합**

이를 통해 모든 시리즈 및 필드가 결합된 히스토그램으로 병합됩니다.

**선 너비**에서는 막대의 선 너비를 제어합니다.

**채우기 불투명도**에서는 막대의 채우기 불투명도를 제어합니다.

**그라데이션 모드**에서는 그라데이션 채우기 모드를 설정합니다. 채우기 그라데이션은 선 색상을 기반으로 합니다. 색상을 변경하려면 표준 색상 체계 필드 옵션을 사용합니다. 그라데이션 모양은 채우기 불투명도 설정의 영향을 받습니다.
+  **없음** - 그라데이션 채우기를 적용하지 않습니다. 기본 설정입니다.
+  **불투명도** - 그라데이션 투명도는 Y축의 값을 기반으로 계산됩니다. Y축의 값에 따라 채우기 불투명도가 증가합니다.
+  **색조** - 그라데이션 색상은 선 색상의 색조에 기반하여 생성됩니다.

**툴팁 모드** - 그래프 위에 커서를 놓으면 Grafana에서 툴팁을 표시할 수 있습니다. 툴팁 동작을 선택합니다.
+  **단일** - 가리키기 툴팁에는 가리키고 있는 시리즈만 표시됩니다.
+  **모두** - 가리키기 툴팁에는 그래프의 모든 시리즈가 표시됩니다. Grafana는 툴팁의 시리즈 목록에서 가리킨 시리즈를 굵게 강조 표시합니다.
+  **숨김** - 툴팁을 표시하지 않습니다.

**참고**  
재정의를 사용하여 툴팁에서 개별 시리즈를 숨깁니다.

## 범례 옵션
<a name="v9-panels-histogram-legend"></a>

범례 옵션이 활성화되면 값 매핑 또는 임계치 괄호를 표시할 수 있습니다. 범례에 값 매핑을 표시하려면 표준 옵션 아래 색상 체계 옵션을 단일 색상 또는 클래식 팔레트로 설정해야 합니다. 범례에서 임계치 괄호를 보려면 색상 체계를 시작 임계치로 설정하세요.

**범례 모드** 이러한 설정을 사용하여 시각화에 범례가 표시되는 방식을 세분화합니다.
+  **목록** - 범례를 목록으로 표시합니다. 범례의 기본 표시 모드입니다.
+  **테이블** - 범례를 테이블로 표시합니다.
+  **숨김** - 범례를 숨깁니다.

**범례 배치** - 범례를 배치할 위치를 선택합니다.
+  **하단** - 그래프 아래.
+  **오른쪽** - 그래프의 오른쪽.

**범례 값**

범례에 표시할 표준 계산을 선택합니다. 둘 이상을 보유할 수 있습니다. 자세한 내용은 [계산 유형](v9-panels-calculation-types.md) 단원을 참조하십시오.

**범례 계산**

범례에 표시할 계산을 선택합니다. 둘 이상을 선택할 수 있습니다.

# 로그 패널
<a name="v9-panels-logs"></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) 섹션을 참조하세요.

로그 패널 시각화에는 Elastic, Influx, Loki와 같은 로그를 지원하는 데이터 소스의 로그 줄이 표시됩니다. 일반적으로 그래프 패널 옆에 있는 이 패널을 사용하여 관련 프로세스의 로그 출력을 표시합니다.

로그 패널에는 **쿼리** 탭에 입력된 쿼리의 결과가 표시됩니다. 여러 쿼리의 결과가 병합되어 시간별로 정렬됩니다. 데이터 소스가 표시할 수 있는 것보다 더 많은 줄을 반환하는 경우 패널 내에서 스크롤할 수 있습니다.

렌더링되는 줄 수를 제한하려면 **쿼리 옵션**에서 **최대 데이터 포인트** 설정을 사용할 수 있습니다. 설정하지 않으면 데이터 소스는 일반적으로 기본 제한을 적용합니다.

## 로그 수준
<a name="v9-panels-logs-level"></a>

**수준** 레이블이 지정된 로그의 경우 레이블 값을 사용하여 로그 수준을 결정하고 그에 따라 색상을 업데이트합니다. 로그에 수준 레이블이 지정되지 않은 경우 해당 콘텐츠가 지원되는 표현식과 일치하는지 확인합니다(자세한 내용은 아래 참조). 로그 수준은 항상 첫 번째 일치에 의해 결정됩니다. Grafana에서 로그 수준을 확인할 수 없는 경우 **알 수 없음** 로그 수준으로 시각화됩니다. 자세한 내용은 [데이터 시각화](v9-explore-logs.md#v9-explore-logs-viz) 단원을 참조하십시오.

## 로그 세부 정보
<a name="v9-panels-logs-details"></a>

각 로그 행에는 보다 강력한 상호 작용을 위해 레이블 및 감지된 필드를 포함하는 확장 가능한 영역이 있습니다. 각 필드 또는 레이블에는 표시된 모든 로그와 관련된 통계를 표시하는 통계 아이콘이 있습니다.

**데이터 링크**

데이터 링크를 사용하면 로그 메시지 중 임의의 부분을 내부 또는 외부 링크로 전환할 수 있습니다. 생성된 링크는 **로그 세부 정보** 보기의 **링크** 섹션에서 버튼으로 표시됩니다.

**표시 옵션**

다음 설정을 사용하여 시각화를 세분화합니다.
+  **시간** - 시간 열을 표시하거나 숨깁니다. 데이터 소스에서 보고된 로그 줄과 연결된 타임스탬프입니다.
+  **고유 레이블** - 공통되지 않은 레이블만 표시하는 고유 레이블 열을 표시하거나 숨깁니다.
+ **일반 레이블** - 공통 레이블을 표시하거나 숨깁니다.
+  **줄 바꿈** - 줄 바꿈 기능을 전환합니다.
+ **JSON 정리** - 모든 JSON 로그를 정리 인쇄하려면 이 옵션을 `true`로 설정합니다. 이 설정은 JSON 이외 형식의 로그에는 영향을 주지 않습니다.
+ **로그 세부 정보 활성화** - 각 로그 행에 대한 로그 세부 정보 보기를 보려면 옵션을 전환합니다. 기본 설정은 `true`입니다.
+  **순서** - 결과를 내림차순 또는 오름차순으로 표시합니다. 기본값은 **내림차순**이며 최신 로그가 먼저 표시됩니다. **오름차순**으로 설정하여 가장 오래된 로그 줄을 먼저 표시합니다.

# 뉴스 패널
<a name="v9-panels-news"></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) 섹션을 참조하세요.

이 패널에는 RSS 피드가 표시됩니다. 기본적으로 Grafana Labs 블로그의 문서가 표시됩니다.

**표시** 섹션에 RSS의 URL을 입력합니다. 이 패널 유형은 다른 쿼리를 수락하지 않습니다.

**참고**  
RSS 피드는 프록시 없이 Grafana 프론트엔드에서 로드됩니다. 따라서 적절한 [CORS 헤더](https://developer.mozilla.org/en-US/docs/Web/HTTP/CORS)로 구성된 RSS 피드만 로드됩니다. 표시하려는 RSS 피드가 로드되지 않는 경우 RSS 피드를 다시 호스팅하거나 자체 프록시를 생성하는 것이 좋습니다.

# 노드 그래프 패널
<a name="v9-panels-node-graph"></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-panels-node-graph-requirements"></a>

노드 그래프 패널에는 노드와 엣지를 표시할 수 있는 데이터의 특정 형태가 필요합니다. 이 패널에서 모든 데이터 소스 또는 쿼리를 시각화할 수 있는 것은 아닙니다.

노드 그래프 시각화는 *노드* 및 *엣지*로 구성됩니다.
+ *노드*는 원으로 표시됩니다. 노드는 애플리케이션, 서비스 또는 애플리케이션 관점에서 관련된 모든 항목을 나타낼 수 있습니다.
+ *엣지*는 두 노드를 연결하는 선으로 표시됩니다. 연결은 요청, 작업 또는 두 노드 간의 기타 관계일 수 있습니다.

노드와 엣지 모두 연결된 메타데이터 또는 통계가 있을 수 있습니다. 데이터 소스는 표시되는 정보와 값을 정의하므로 데이터 소스가 다르면 서로 다른 유형의 값을 표시하거나 일부 값을 표시하지 않을 수 있습니다.

## Nodes(노드)
<a name="v9-panels-node-graph-nodes"></a>

일반적으로 노드는 노드 내에 두 개의 통계 값과 노드 바로 아래에 두 개의 식별자(일반적으로 이름과 유형)를 표시합니다. 노드는 노드 주변의 색상 원으로 다른 값 세트를 표시할 수도 있습니다. 색상이 다른 섹션은 최대 1의 값을 더해야 하는 서로 다른 값을 나타냅니다. 예를 들어, 원의 빨간색 부분으로 오류 비율을 표시할 수 있습니다.

추가 세부 정보는 컨텍스트 메뉴에 표시될 수 있으며, 노드를 선택할 때 표시됩니다. 컨텍스트 메뉴에는 Grafana 워크스페이스의 다른 부분 또는 외부 링크를 대상으로 할 수 있는 추가 링크가 있을 수도 있습니다.

**참고**  
노드 그래프에서는 1,500개의 노드만 표시할 수 있습니다. 이 한도를 초과하면 오른쪽 상단에 경고가 표시되고 일부 노드는 숨겨집니다. 그래프에서 **숨겨진 노드** 마커를 클릭하여 그래프의 숨겨진 부분을 확장할 수 있습니다.

## 엣지
<a name="v9-panels-node-graph-edges"></a>

엣지 위에 마우스를 가져가면 엣지에 통계가 표시될 수도 있습니다. 노드와 마찬가지로 엣지를 선택하여 추가 세부 정보 및 링크가 포함된 컨텍스트 메뉴를 열 수 있습니다.

이 시각화를 지원하는 첫 번째 데이터 소스는 서비스 맵 기능의 AWS X-Ray 데이터 소스입니다. 자세한 내용은 [AWS X-Ray 데이터 소스에 연결](x-ray-data-source.md) 단원을 참조하십시오.

## 노드 그래프 탐색
<a name="v9-panels-node-graph-navigation"></a>

노드 또는 엣지 외부를 선택하고 포인터를 끌어 노드 그래프 내에서 이동할 수 있습니다.

노드 그래프의 왼쪽 상단에 있는 버튼을 사용해 확대/축소할 수 있습니다.

**숨겨진 노드**

지정된 시간에 표시되는 노드 수는 합리적인 성능을 유지하기 위해 제한됩니다. 이 제한을 벗어나는 노드는 클릭 가능한 마커 뒤에 숨겨집니다. 이 마커에서는 해당 엣지에 연결된 대략적인 숨겨진 노드 수를 보여줍니다. 마커를 선택하여 해당 노드 주변의 그래프를 확장할 수 있습니다.

**그리드 보기**

그리드 보기로 전환하여 그래프에서 가장 관심 있는 노드의 더 나은 개요를 제공할 수 있습니다. 그리드 보기에서는 엣지가 없는 그리드에서 노드를 표시하며 노드 내부에 표시된 통계 또는 노드의 색상 지정된 테두리로 표시된 통계를 기준으로 정렬할 수 있습니다.

노드를 정렬하려면 범례 내부의 통계를 선택합니다. 통계 이름 옆의 마커에서는 현재 정렬 및 정렬 방향에 사용되는 통계를 보여줍니다.

노드를 선택한 다음, **그래프 레이아웃에 표시** 옵션을 선택하여 선택한 노드에 초점을 맞춘 그래프 레이아웃으로 다시 전환해 전체 그래프의 컨텍스트로 표시합니다.

## 데이터 API
<a name="v9-panels-node-graph-data-api"></a>

이 시각화를 올바르게 표시하려면 데이터 소스에서 반환할 데이터의 특정 형태가 필요합니다.

노드 그래프에는 최소한 그래프의 엣지를 설명하는 데이터 프레임이 필요합니다. 기본적으로 노드 그래프는 이 데이터 프레임을 기반으로 노드 및 모든 통계를 계산합니다. 선택적으로 노드를 설명하는 두 번째 데이터 프레임은 노드별 메타데이터를 더 많이 표시해야 하는 경우에 전송할 수 있습니다. 노드 그래프를 렌더링하려면 두 데이터 프레임에서 `frame.meta.preferredVisualisationType = 'nodeGraph'`를 설정하거나 각 이름을 `nodes` 및 `edges`으로 지정해야 합니다.

**구조에서 데이터 엣지**

필수 필드:


| 필드 이름 | Type | 설명 | 
| --- | --- | --- | 
|  id  |  문자열  |  엣지의 고유 식별자.  | 
|  source  |  문자열  |  소스 노드의 ID.  | 
|  대상  |  문자열  |  대상의 ID.  | 

선택적 필드:


| 필드 이름 | Type | 설명 | 
| --- | --- | --- | 
|  메인스탯  |  문자열/숫자  |  엣지 위로 마우스를 가져갈 때 오버레이에 표시된 첫 번째 통계. 값을 있는 그대로 표시하는 문자열이거나 숫자일 수 있습니다. 숫자인 경우 해당 필드와 연결된 모든 단위도 표시됩니다.  | 
|  secondarystat  |  문자열/숫자  |  mainStat과 동일하지만 바로 아래에 표시됩니다.  | 
|  detail\$1\$1\$1  |  문자열/숫자  |  `detail__` 접두사를 사용하는 필드는 엣지를 클릭하면 컨텍스트 메뉴의 헤더에 표시됩니다. 레이블의 가독성을 더 개선하려면 `config.displayName`을 사용합니다.  | 

**구조의 노드 데이터**

필수 필드:


| 필드 이름 | Type | 설명 | 
| --- | --- | --- | 
|  id  |  문자열  |  노드의 고유한 식별자. 이 ID는 소스 및 대상 필드의 엣지에서 참조됩니다.  | 

선택적 필드:


| 필드 이름 | Type | 설명 | 
| --- | --- | --- | 
|  제목  |  문자열  |  노드 바로 아래에 표시되는 노드의 이름.  | 
|  subtitle  |  문자열  |  제목 아래에 표시된 추가, 이름, 유형 또는 기타 식별자.  | 
|  메인스탯  |  문자열/숫자  |  노드 자체 내에 표시된 첫 번째 통계. 값을 있는 그대로 표시하는 문자열 또는 숫자일 수 있습니다. 숫자인 경우 해당 필드와 연결된 모든 단위도 표시됩니다.  | 
|  secondarystat  |  문자열/숫자  |  mainStat과 동일하지만 노드 내부 아래에 표시됩니다.  | 
|  arc\$1\$1\$1  |  number  |  `arc__` 접두사를 사용하는 모든 필드는 노드 주위에 색상이 지정된 원을 생성하는 데 사용됩니다. 이러한 필드의 모든 값은 최대 1이어야 합니다. `config.color.fixedColor`를 사용하여 색상을 지정할 수 있습니다.  | 
|  detail\$1\$1\$1  |  문자열/숫자  |  `detail__` 접두사를 사용하는 필드는 노드를 클릭하면 컨텍스트 메뉴의 헤더에 표시됩니다. 레이블의 가독성을 더 개선하려면 `config.displayName`을 사용합니다.  | 

# 파이 차트 패널
<a name="v9-panels-piechart"></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-panels-piechart-value"></a>

다음 옵션을 사용하여 시각화에서 값을 세분화합니다.

**표시**

표시할 정보의 양을 선택합니다.
+ **계산** - 각 값을 시리즈당 단일 값으로 축소합니다.
+ **모든 값** - 단일 시리즈의 모든 값을 표시합니다.

**계산**

계산을 선택하여 계산을 선택할 때 각 시리즈를 축소합니다. 사용 가능한 계산에 대한 자세한 내용은 [계산 유형](v9-panels-calculation-types.md)을 참조하세요.

**제한**

단일 시리즈의 모든 값을 표시할 때 표시되는 값 수를 제한합니다.

**필드**

시각화에 표시할 하나 이상의 필드를 선택합니다. 목록에서 각 필드 이름을 사용할 수 있거나 다음 옵션 중 하나를 선택할 수 있습니다.
+ **숫자 필드** - 숫자 값이 있는 모든 필드.
+ **모든 필드** - 변환으로 제거되지 않은 모든 필드.
+ **시간** - 시간 값이 있는 모든 필드.

## 파이 차트 옵션
<a name="v9-panels-piechart-options"></a>

이러한 옵션을 사용하여 시각화의 모양을 세분화합니다.

**파이 차트 유형**

파이 차트 표시 스타일을 선택합니다. 다음 중 하나일 수 있습니다.
+ **파이** - 표준 파이 차트
+ **도넛** – 가운데 구멍이 있는 파이 차트

**레이블**

파이 차트에 표시할 레이블을 선택합니다. 둘 이상을 선택할 수 있습니다.
+ **이름** - 시리즈 또는 필드 이름.
+ **백분율** - 전체의 백분율.
+ **값** - 원시 숫자 값.

레이블은 기본적으로 차트 본문 위에 흰색으로 표시됩니다. 더 잘 보이도록 더 어두운 차트 색상을 선택해야 할 수도 있습니다. 긴 이름이나 숫자는 잘릴 수 있습니다.

**툴팁 모드**

시각화 위에 커서를 놓으면 Grafana에서 툴팁을 표시할 수 있습니다. 툴팁 동작을 선택합니다.
+ **단일** - 가리키기 툴팁에는 시각화에서 가리키고 있는 시리즈인 단일 시리즈만 표시됩니다.
+ **모두** - 가리키기 툴팁에는 그래프의 모든 시리즈가 표시됩니다. Grafana는 툴팁의 시리즈 목록에서 가리킨 시리즈를 굵게 강조 표시합니다.
+ **숨김** - 시각화와 상호 작용할 때 툴팁을 표시하지 않습니다.

재정의를 사용하여 툴팁에서 개별 시리즈를 숨깁니다.

**범례 모드**

이러한 설정을 사용하여 시각화에 범례가 표시되는 방식을 정의합니다. 범례에 대한 자세한 내용은 [범례 구성](v9-panels-configure-legend.md)을 참조하세요.
+ **목록** - 범례를 목록으로 표시합니다. 범례의 기본 표시 모드입니다.
+ **테이블** - 범례를 테이블로 표시합니다.
+ **숨김** - 범례를 숨깁니다.

**범례 배치**

범례를 표시할 위치를 선택합니다.
+ **하단** - 그래프 아래.
+ **오른쪽** - 그래프의 오른쪽.

**범례 값**

범례에 표시할 [표준 계산](v9-panels-calculation-types.md)을 선택합니다. 둘 이상을 보유할 수 있습니다.

범례에 표시할 값을 선택합니다. 둘 이상을 선택할 수 있습니다.
+ **백분율** - 전체의 백분율.
+ **값** - 원시 숫자 값.

범례에 대한 자세한 내용은 [범례 구성](v9-panels-configure-legend.md)을 참조하세요.

# Plotly 패널
<a name="v9-panels-plotly"></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) 섹션을 참조하세요.

Plotly 패널은 오픈 소스 javascript 그래프 라이브러리인 [Plotly](https://plotly.com/javascript/)를 사용하여 차트를 렌더링합니다.

**데이터**, **레이아웃** 및 **구성** 필드는 [Plotly 설명서](https://plotly.com/javascript/plotlyjs-function-reference/)에 설명된 공통 파라미터와 일치합니다. JSON 형식이어야 합니다.

데이터 소스에서 제공하는 데이터는 Plotly 차트에 삽입하기 전에 사용자 정의 스크립트를 통해 변환할 수 있습니다. 스크립트에는 2개의 인수가 포함되어 있습니다.
+ `data` - 데이터 소스에서 반환한 데이터.
+ `variables` - 현재 대시보드에 [Grafana 변수](templates-and-variables.md)(사용자 변수 및 `__from`, `__to`, `__interval`, `__interval_ms`와 같은 몇 가지 전역 변수)가 포함된 객체.

스크립트는 `data`, `layout`, `config` 및 `frames` 속성 중 하나 이상을 포함한 객체를 반환해야 합니다. 다음은 예입니다.

```
let x  = data.series[0].fields[0].values.buffer
let y  = data.series[0].fields[1].values.buffer
let serie = {
    x : x,
    y : y,
    name : variables.project //where project is the name of a Grafana’s variable
}

return {
    data : [serie],
    config : {
    displayModeBar: false
    }
}
```

*데이터*, *레이아웃* 및 *구성* 필드에 제공된 스크립트 및 JSON에서 반환된 객체가 병합됩니다(심층 병합).

스크립트가 제공되지 않으면 패널은 *데이터*, *레이아웃* 및 *구성* 필드만 사용합니다.

# Sankey 패널
<a name="v9-panels-sankey"></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) 섹션을 참조하세요.

Sankey 패널에는 흐름 데이터를 시각화하는 데 적합한 Sankey 다이어그램이 표시되며, 흐름의 너비는 선택한 지표에 비례합니다. 다음 이미지는 소스 및 대상의 두 그룹을 포함하는 Sankey 다이어그램을 보여줍니다.

![\[Sankey diagram showing flow between source organizations, science disciplines, and projects.\]](http://docs.aws.amazon.com/ko_kr/grafana/latest/userguide/images/sankey-panel.png)


**작동 방식**

Sankey 패널에는 흐름의 소스와 대상과 같은 2개 이상의 데이터 열이 필요합니다. 쿼리에서는 데이터를 둘 이상의 그룹으로 그룹화해야 합니다. 패널은 쿼리 순서대로 데이터 포인트의 첫 번째 열부터 마지막 열로 링크를 그립니다. 링크의 두께는 쿼리의 지표에 의해 할당된 값에 비례합니다.

**사용자 지정**
+ **링크** - 현재 링크 색상에는 두 가지 옵션(다중 또는 단일)이 있습니다. 기본적으로 여러 색상으로 표시됩니다. 링크에 대해 단일 색상을 선택하려면 **단일 링크 색상 전용** 옵션을 전환하고 Grafana의 색상 선택기에서 색상을 선택합니다.
+ **노드** - **노드 색상** 옵션을 변경하여 직사각형 노드의 색상을 변경할 수 있습니다.
+ **노드 너비** - **노드 너비** 슬라이더를 사용하거나 입력 상자에 숫자를 입력하여 노드의 너비를 조정할 수 있습니다. 이 숫자는 정수여야 합니다.
+ **노드 채움** - **노드 채움** 슬라이더를 사용하거나 입력 상자에 숫자를 입력하여 노드 간의 세로 채움을 조정할 수 있습니다. 이 숫자는 정수여야 합니다. 링크가 너무 얇으면 이 숫자를 조정합니다.
+ **헤더** - 편집기 패널에서 **표시 이름** 재정의를 사용하여 열 헤더를 변경할 수 있습니다. **텍스트 색상**에 대해 선택한 색상과 동일합니다.
+ **Sankey 레이아웃** - **레이아웃 반복** 슬라이더를 사용하여 Sankey 링크의 레이아웃을 약간 조정할 수 있습니다. 이 숫자는 정수여야 하며 레이아웃을 생성하는 데 사용되는 완화 반복 횟수입니다.

# 분산형 패널
<a name="v9-panels-scatter"></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) 섹션을 참조하세요.

분산형 패널은 다른 그래프 패널보다 인터페이스가 더 간단한 테이블 데이터에 대한 X/Y 산점도를 보여줍니다. 그래프 패널과 달리 분산형 패널에는 데이터가 시계열 형식이 아니어도 됩니다. 분산형 패널에는 둘 이상의 숫자 데이터 열이 있는 테이블 형식의 데이터세트가 필요합니다.

이 중 하나를 X축에 할당할 수 있습니다. 하나 이상을 일련의 Y축 값에 할당하고 결과 데이터를 일련의 점으로 표시할 수 있습니다. 선택적으로 각 시리즈는 여러 통계적 최적 항목 중 하나를 사용하여 회귀선을 표시할 수도 있습니다.

**분산형 패널 생성**

다음 절차에서는 분산형 패널을 사용하여 산점도를 생성하는 방법을 설명합니다. 이 예제에서는 다음 `HEIGHT` 표에서와 같이 숫자 값(`Age`, `Boys`, `Girls`)을 사용하는 세 개의 열을 포함하는 데이터가 있다고 가정합니다. 여기에서는 연령별 남아와 여아의 평균 키를 보여줍니다.


| 나이 | 남아의 키 | 여아의 키 | 
| --- | --- | --- | 
|  5  |  109.7  |  109.5  | 
|  6  |  115.6  |  115.4  | 
|  7  |  121.1  |  120.8  | 
|  8  |  126.3  |  126  | 
|  9  |  131.3  |  131.3  | 
|  10  |  136.2  |  137.1  | 
|  11  |  141.2  |  143.2  | 
|  12  |  147  |  148.7  | 
|  13  |  153.6  |  152.6  | 
|  14  |  159.9  |  155.1  | 
|  15  |  164.4  |  156.7  | 
|  16  |  167.3  |  157.6  | 
|  17  |  169  |  158  | 
|  18  |  170  |  158.3  | 
|  19  |  170.8  |  158.6  | 

**분산형 패널을 사용하여 산점도를 생성하는 방법**

1. Grafana 대시보드에서 **패널 추가**를 선택하세요.

1. 쿼리에서 필요한 데이터를 반환하는 쿼리를 작성하세요. 이 경우 `SELECT * FROM HEIGHT`와 같은 쿼리를 사용합니다.

1. **분산형** 시각화를 선택하세요.

이렇게 하면 첫 번째 열을 X축으로 사용하고 다른 숫자 열을 Y축으로 사용하여 산점도가 생성됩니다.

**구성 옵션**

분산형 패널은 다음과 같은 네 가지 사용자 지정 구성 옵션을 제공합니다.
+ **X축** - X축으로 사용할 필드와 축의 범위 및 제목과 표시 정보를 선택할 수 있습니다.
+ **Y축** - 각 필드의 표시 옵션, 축의 범위 및 제목 정보를 포함하여 Y축에 표시할 필드를 선택할 수 있습니다. 각 필드에 대한 회귀선을 표시하도록 선택할 수도 있습니다. 회귀선 구성에 대한 자세한 내용은 다음 정보를 참조하세요.
+ **범례** - 패널의 범례를 켜거나 끌 수 있으며 범례에서 텍스트 크기를 선택할 수 있습니다.
+ **표시** - 그리드 색상 및 테두리 스타일을 포함하여 차트에 대한 다른 옵션을 설정할 수 있습니다.

**회귀선 구성**

각 Y축 데이터세트는 개별 점 외에도 선을 표시할 수 있습니다. 선 유형에는 다섯 가지 옵션이 있습니다.
+ **없음** - 회귀선을 표시하지 않습니다.
+ **단순** - 데이터세트 포인트를 연결하는 회귀선을 표시합니다.
+ **선형** - 최소 제곱, 최적 메서드를 사용하여 직선을 표시합니다.
+ **지수** - 지수 최적 회귀선을 표시합니다.
+ **멱** - 멱 최적 회귀선을 표시합니다.

# 통계 패널
<a name="v9-panels-stat"></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-panels-stat-automatic-adjust"></a>

패널은 대시보드에서 사용 가능한 너비와 높이에 따라 레이아웃을 자동으로 조정합니다. 패널이 너무 작아지면 그래프(스파크라인)를 자동으로 숨깁니다.

## 값 옵션
<a name="v9-panels-stat-value"></a>

다음 옵션을 사용하여 시각화가 값을 표시하는 방법을 세분화합니다.

**표시**

Grafana에서 데이터를 표시하는 방법을 선택합니다.

**계산**

모든 행을 기반으로 계산된 값을 표시합니다.
+ **계산** - Grafana에서 여러 필드를 단일 값으로 줄이는 데 사용할 축소기 함수를 선택합니다. 사용 가능한 계산 목록은 [표준 계산](v9-panels-calculation-types.md)을 참조하세요.
+ **필드** - 패널에 표시할 필드를 선택합니다.

**모든 값**

모든 행에 대해 별도의 통계를 표시합니다. 이 옵션을 선택하면 표시할 행 수를 제한할 수도 있습니다.
+ **제한** - 표시할 최대 행 수. 기본값은 5,000입니다.
+ **필드** - 패널에 표시할 필드를 선택합니다.

## 통계 스타일
<a name="v9-panels-stat-styles"></a>

시각화 스타일을 지정합니다.

**Orientation(방향)**

스택 방향을 선택합니다.
+ **자동** - Grafana에서 최적의 방향이라고 생각하는 항목을 선택합니다.
+ **가로** - 막대가 가로로 확장됩니다(왼쪽에서 오른쪽 방향).
+ **세로** - 막대가 세로로 확장됩니다(위에서 아래 방향).

**텍스트 모드**

텍스트 모드 옵션을 사용하여 패널에서 렌더링하는 텍스트를 제어할 수 있습니다. 값이 중요하지 않고 이름 및 색상만 중요한 경우 **텍스트 모드**를 **이름**으로 변경합니다. 값은 색상을 결정하는 데 계속 사용되며 툴팁에 표시됩니다.
+ **자동** - 데이터에 여러 시리즈 또는 필드가 포함된 경우 이름 및 값을 모두 표시합니다.
+ **값** - 값만 표시하고 이름은 표시하지 않습니다. 대신 가리키기 툴팁에 이름이 표시됩니다.
+ **값 및 이름** - 항상 값 및 이름을 표시합니다.
+ **이름** - 값 대신 이름을 표시합니다. 값은 가리키기 툴팁에 표시됩니다.
+ **없음** - 아무것도 표시하지 않습니다(비어 있음). 이름 및 값은 가리키기 툴팁에 표시됩니다.

**색상 모드**

색상 모드를 선택합니다.
+ **값** - 값 및 그래프 영역만 색상으로 지정합니다.
+ **배경** - 배경의 색상도 지정합니다.

**그래프 모드**

그래프 및 스파크라인 모드를 선택합니다.
+ **없음** - 그래프를 숨기고 값만 표시합니다.
+ **영역** - 값 아래에 영역 그래프를 표시합니다. 이 경우 쿼리에서 시간 열을 반환해야 합니다.

**텍스트 정렬**

정렬 모드를 선택합니다.
+ **자동** - 단일 값만 표시되는 경우(반복 없음) 값이 가운데 배치됩니다. 여러 시리즈 또는 행이 표시되면 값이 왼쪽 정렬됩니다.
+ **가운데** - 통계 값이 가운데 배치됩니다.

텍스트 크기

게이지 텍스트의 크기를 조정합니다.
+ **제목** - 게이지 제목 크기의 숫자 값을 입력합니다.
+ **값** - 게이지 값 크기의 숫자 값을 입력합니다.

# 상태 타임라인 패널
<a name="v9-panels-state-timeline"></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-panels-state-timeline-options"></a>

다음 옵션을 사용하여 시각화를 세분화합니다.

**동일한 연속 값 병합**

Grafana가 동일한 값이 서로 근접한 경우 병합할지 여부를 제어합니다.

**값 표시**

값이 상태 리전 내에서 렌더링되는지 여부를 제어합니다. 자동인 경우 공간이 충분하면 값을 렌더링합니다.

**값 정렬**

상태 리전 내에서 값 정렬을 제어합니다.

**행 높이**

행 사이의 공간을 제어합니다. 1 = 공간 없음, 0.5 = 50% 공백.

**선 너비**

상태 리전의 선 너비를 제어합니다.

**채우기 불투명도**

상태 리전의 불투명도를 제어합니다.

## 값 매핑
<a name="v9-panels-state-timeline-valuemap"></a>

부울 또는 문자열 값에 색상을 할당하려면 [값 매핑 구성](v9-panels-configure-value-mappings.md)을 사용합니다.

## 임계치가 있는 시계열 데이터
<a name="v9-panels-state-timeline-threshold"></a>

패널은 시계열 데이터와도 함께 사용할 수 있습니다. 이 경우 임계치를 사용하여 시계열을 색상이 지정된 개별 상태 리전으로 전환합니다.

## 범례 옵션
<a name="v9-panels-state-timeline-legend"></a>

범례 옵션이 활성화되면 값 매핑 또는 임계치 괄호를 표시할 수 있습니다. 범례에 값 매핑을 표시하려면 표준 옵션 아래 색상 체계 옵션을 단일 색상 또는 클래식 팔레트로 설정해야 합니다. 범례에서 임계치 괄호를 보려면 색상 체계를 시작 임계치로 설정하세요.

**범례 모드** 이러한 설정을 사용하여 시각화에 범례가 표시되는 방식을 세분화합니다.
+  **목록** - 범례를 목록으로 표시합니다. 범례의 기본 표시 모드입니다.
+  **테이블** - 범례를 테이블로 표시합니다.
+  **숨김** - 범례를 숨깁니다.

**범례 배치** - 범례를 배치할 위치를 선택합니다.
+  **하단** - 그래프 아래.
+  **오른쪽** - 그래프의 오른쪽.

**범례 값**

범례에 표시할 [표준 계산](v9-panels-calculation-types.md)을 선택합니다. 둘 이상을 보유할 수 있습니다.

# 상태 기록 패널
<a name="v9-panels-status-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) 섹션을 참조하세요.

상태 기록 시각화에는 시간 경과에 따른 주기적 상태가 표시됩니다. 각 필드 또는 시리즈는 가로 행으로 렌더링됩니다. 상자는 각 값을 중심으로 렌더링되고 가운데 배치됩니다.

상태 기록 시각화는 문자열, 부울 및 숫자 필드 또는 시계열에서 작동합니다. 시간 필드는 필수 항목입니다. 값 매핑을 사용하여 문자열의 색상을 지정하거나 숫자 범위에 텍스트 값을 할당할 수 있습니다.

## 표시 옵션
<a name="v9-panels-status-history-timeline-options"></a>

다음 옵션을 사용하여 시각화를 세분화합니다.

**값 표시**

값 상자 내에서 값이 렌더링되는지 여부를 제어합니다. 자동인 경우 공간이 충분하면 값을 렌더링합니다.

**열 너비**는 상자 너비를 제어합니다. 1=최대 너비 및 0=최소 너비.

**선 너비**에서는 상태 리전의 선 너비를 제어합니다.

**채우기 불투명도**에서는 상태 리전의 채우기 불투명도를 제어합니다.

## 값 매핑
<a name="v9-panels-status-history-valuemap"></a>

부울 또는 문자열 값에 색상을 할당하려면 [값 매핑 구성](v9-panels-configure-value-mappings.md)을 사용합니다.

## 임계치가 있는 시계열 데이터
<a name="v9-panels-status-history-threshold"></a>

패널은 시계열 데이터와도 함께 사용할 수 있습니다. 이 경우 임계치를 사용하여 상자 색상을 지정합니다. 그라데이션 색상 체계를 사용하여 값 색상을 지정할 수도 있습니다.

## 범례 옵션
<a name="v9-panels-status-history-legend"></a>

범례 옵션이 활성화되면 값 매핑 또는 임계치 괄호를 표시할 수 있습니다. 범례에 값 매핑을 표시하려면 표준 옵션 아래 색상 체계 옵션을 단일 색상 또는 클래식 팔레트로 설정해야 합니다. 범례에서 임계치 괄호를 보려면 색상 체계를 시작 임계치로 설정하세요.

**범례 모드** 이러한 설정을 사용하여 시각화에 범례가 표시되는 방식을 세분화합니다.
+  **목록** - 범례를 목록으로 표시합니다. 범례의 기본 표시 모드입니다.
+  **테이블** - 범례를 테이블로 표시합니다.
+  **숨김** - 범례를 숨깁니다.

**범례 배치** - 범례를 배치할 위치를 선택합니다.
+  **하단** - 그래프 아래.
+  **오른쪽** - 그래프의 오른쪽.

**범례 값**

범례에 표시할 [표준 계산](v9-panels-calculation-types.md)을 선택합니다. 둘 이상을 보유할 수 있습니다.

# 테이블 패널
<a name="v9-panels-table"></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 데이터에 대한 여러 모드를 지원합니다. 이 패널은 날짜 형식, 값 형식 및 색상 지정 옵션도 제공합니다.

## 열 정렬
<a name="v9-panels-table-sort"></a>

정렬 순서를 기본에서 오름차순, 내림차순으로 변경하려면 열 제목을 클릭합니다. 클릭할 때마다 정렬 순서가 주기의 다음 옵션으로 변경됩니다. 열은 한 번에 하나만 정렬할 수 있습니다.

## 테이블 옵션
<a name="v9-panels-table-options"></a>

**헤더 표시**

데이터 소스에서 가져온 열 이름을 표시하거나 숨깁니다.

## 열 너비
<a name="v9-panels-table-width"></a>

기본적으로 Grafana는 테이블 크기와 최소 열 너비를 기반으로 열 너비를 자동으로 계산합니다. 이 필드 옵션에서는 설정을 재정의하고 모든 열의 너비를 픽셀 단위로 정의할 수 있습니다.

예를 들어 필드에 `100`을 입력하는 경우 필드 외부를 클릭하면 모든 열이 100픽셀 너비로 설정됩니다.

## 최소 열 너비
<a name="v9-panels-table-min"></a>

기본적으로 테이블 열의 최소 너비는 150픽셀입니다. 이 필드 옵션은 기본값을 재정의할 수 있으며 테이블 패널의 새 최소 열 너비를 픽셀 단위로 정의합니다.

예를 들어 필드에 `75`을 입력하는 경우 필드 외부를 선택하면 모든 열이 75픽셀 이상의 너비로 조정됩니다.

스마트폰이나 태블릿과 같은 소형 화면의 디바이스인 경우 기본 `150` 픽셀 값을 `50`으로 줄여 테이블 기반 패널을 대시보드에서 올바르게 렌더링하도록 지원합니다.

## 열 정렬
<a name="v9-panels-table-alignment"></a>

Grafana에서 셀 콘텐츠를 정렬하는 방법을 선택합니다.
+ Auto(기본값)
+ 나감
+ Center
+ 오른쪽

## 셀 유형
<a name="v9-panels-table-cell-type"></a>

기본적으로 Grafana는 자동으로 표시 설정을 선택합니다. 다음 옵션 중 하나를 선택하고 모든 필드에 대한 기본값을 설정하여 설정을 재정의할 수 있습니다. 일부 셀 유형에서는 추가 구성을 사용할 수 있습니다.

**참고**  
**필드** 탭에서 이를 설정하면 시간 필드를 포함한 모든 필드에 해당 유형이 적용됩니다. **재정의** 탭에서 변경 사항을 하나 이상의 필드에 적용하도록 설정할 수 있습니다.

**텍스트 색상 지정**

임계치가 설정된 경우 필드 텍스트가 적절한 임계치 색상으로 표시됩니다.

**배경 색상 지정(그라데이션 또는 단색)**

임계치가 설정된 경우 필드 배경이 적절한 임계치 색상으로 표시됩니다.

**Gauge**

셀은 여러 가지 프레젠테이션 유형에서 그래픽 게이지로 표시할 수 있습니다.

**기본**

기본 모드에서는 게이지 색상을 정의하는 임계치 수준과 함께 간단한 게이지를 표시합니다.

**그라데이션**

임계치 수준에서는 그라데이션을 정의합니다.

**LCD**

게이지가 켜지거나 켜지지 않은 작은 셀로 분할됩니다.

**JSON 보기**

코드 형식의 값을 표시합니다. 값이 객체인 경우 JSON 객체를 검색할 수 있는 JSON 보기가 가리킬 때 표시됩니다.

## 셀 값 검사
<a name="v9-panels-table-cell-value"></a>

테이블 셀에서 값 검사를 활성화합니다. 원시 값은 모달 창에 표시됩니다.

**참고**  
셀 값 검사는 셀 표시 모드가 자동, 텍스트 색상 지정, 배경 색상 지정 또는 JSON 보기로 설정된 경우에만 사용할 수 있습니다.

## 열 필터
<a name="v9-panels-table-col-filter"></a>

열 데이터가 표시되는 방식을 일시적으로 변경할 수 있습니다. 예를 들어 값을 가장 높은 값에서 가장 낮은 값으로 정렬하거나 특정 값을 숨길 수 있습니다. 자세한 내용은 아래의 [테이블 열 필터링](#v9-panels-table-filter)을 참조하세요.

## 페이지 매김
<a name="v9-panels-table-pagination"></a>

페이지 매김을 활성화하거나 비활성화하려면 이 옵션을 사용합니다. 쿼리에 영향을 주지 않는 프론트엔드 옵션입니다. 활성화되면 페이지 크기가 테이블 높이에 맞게 자동으로 조정됩니다.

## 테이블 열 필터링
<a name="v9-panels-table-filter"></a>

**열 필터**를 켜면 테이블 옵션을 필터링할 수 있습니다.

**열 필터링을 켜는 방법**

1. Grafana에서 필터링하려는 열이 있는 테이블이 있는 대시보드로 이동하세요.

1. 필터링하려는 테이블 패널에서 패널 편집기를 여세요.

1. **필드** 탭을 선택하세요.

1. **테이블** 옵션에서 **열 필터** 옵션을 켜세요.

필터 아이콘이 각 열 제목 옆에 나타납니다.

**열 값 필터링**

열 값을 필터링하려면 열 제목 옆에 있는 필터(깔대기) 아이콘을 선택합니다. Grafana에서는 해당 열에 대한 필터 옵션을 표시합니다.

표시할 값 옆에 있는 확인란을 선택하세요. 상단의 검색 필드에 텍스트를 입력하여 해당 값을 화면에 표시합니다. 그러면 해당 값을 찾기 위해 스크롤하지 않고 선택할 수 있습니다.

**열 필터 지우기**

필터가 적용된 열에는 제목 옆에 파란색 깔때기가 표시됩니다.

필터를 제거하려면 파란색 깔대기 아이콘을 선택한 다음, 필터 지우기를 선택합니다.

## 테이블 바닥글
<a name="v9-panels-table-footer"></a>

테이블 바닥글을 사용하여 필드에 [계산](v9-panels-calculation-types.md)을 표시할 수 있습니다.

테이블 바닥글을 활성화한 후 **계산**을 선택한 다음, 계산하려는 **필드**를 선택할 수 있습니다.

필드를 선택하지 않으면 모든 숫자 필드에 계산이 적용됩니다.

**행 수**

선택한 필드의 값 수 대신 데이터세트의 행 수를 표시하려면 **개수** 계산을 선택하고 **행 수**를 활성화합니다.

# 텍스트 패널
<a name="v9-panels-text"></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) 섹션을 참조하세요.

텍스트 패널을 사용하면 대시보드에서 텍스트 또는 HTML을 직접 포함할 수 있습니다. 컨텍스트 정보 및 설명을 추가하거나 복잡한 HTML을 임베드하는 데 사용할 수 있습니다.

**Mode(모드)**

모드는 임베드된 콘텐츠를 표시하는 방식을 결정합니다. 다음과 같은 옵션이 있습니다.
+ **마크다운** - 이 옵션은 콘텐츠를 마크다운 형식으로 지정합니다.
+ **HTML** - 이 설정은 콘텐츠를 새니타이징 처리된 HTML로 렌더링합니다.
+ **코드** - 이 설정은 읽기 전용 코드 편집기 내에서 콘텐츠를 렌더링합니다. 임베드된 텍스트에 구문 강조 표시를 적용할 적절한 언어를 선택합니다.

**변수**

표시되도록 콘텐츠의 변수가 확장됩니다.

# 시계열 패널
<a name="v9-panels-time-series"></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-time-series-panel-tooltip.md)
+ [범례 옵션](v9-time-series-panel-legend.md)
+ [그래프 스타일 옵션](v9-time-series-graph.md)
+ [축 옵션](v9-time-series-axis.md)
+ [색상 옵션](v9-time-series-color.md)

# 툴팁 옵션
<a name="v9-time-series-panel-tooltip"></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는 툴팁의 시리즈 목록에서 가리킨 시리즈를 굵게 강조 표시합니다.
+  **숨김** - 툴팁을 표시하지 않습니다.

# 범례 옵션
<a name="v9-time-series-panel-legend"></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) 섹션을 참조하세요.

**범례 모드** - 범례 표시 방식을 선택합니다.
+  **목록** - 범례를 목록으로 표시합니다. 기본값입니다.
+  **테이블** - 범례를 테이블로 표시합니다.
+  **숨김** - 범례를 숨깁니다.

**범례 배치** - 범례를 표시할 위치를 선택합니다.
+  **하단** - 그래프 아래.
+  **오른쪽** - 그래프의 오른쪽.

**범례 계산**

범례에 표시할 계산을 선택하세요. 자세한 내용은 [계산 유형](v9-panels-calculation-types.md) 단원을 참조하십시오.

# 그래프 스타일 옵션
<a name="v9-time-series-graph"></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) 섹션을 참조하세요.

**그래프 스타일**

이 옵션을 사용하여 시계열 데이터를 표시하는 방법을 정의합니다. 재정의를 사용하여 동일한 그래프에서 여러 스타일을 결합할 수 있습니다. 여기에는 세 가지 스타일 옵션이 있습니다. 다른 스타일 옵션 중 일부는 특정 그래프 스타일에만 적용됩니다.
+ **선** - 시계열을 그래프에서 선으로 표시합니다.
+ **막대** - 시계열을 각 데이터 포인트에 대해 하나씩 그래프에서 일련의 막대로 표시합니다.
+ **포인트** - 시계열을 각 데이터 포인트에 대해 하나씩 그래프에서 일련의 점으로 표시합니다.

**막대 정렬**

막대 그래프의 경우 그래프에서 포인트를 그리는 위치를 기준으로 막대의 위치를 설정합니다. 막대에는 너비가 있으므로 포인트 앞, 뒤 또는 가운데에 배치할 수 있습니다. 이 옵션의 선택 사항은 **이전**, **가운데** 또는 **이후**입니다.

**선 너비**

선 그래프의 선 두께 또는 막대 그래프의 각 막대에 대한 윤곽 두께를 설정합니다.

**채우기 불투명도**

채우기 색상의 불투명도를 설정합니다. 채우기는 예를 들어 선 그래프의 선 아래 영역을 표시하거나 막대 그래프의 막대 색상으로 표시하는 데 사용됩니다.

**그라데이션 모드**

그라데이션 모드는 시리즈 색상을 기반으로 그라데이션 채우기를 지정합니다. 색상을 변경하려면 표준 색상 체계 필드 옵션을 사용합니다. 자세한 내용은 [색상 체계](v9-panels-configure-standard-options.md#v9-panels-standard-options-color-scheme) 단원을 참조하십시오. 그라데이션 모드 옵션은 다음과 같습니다.
+ **없음** - 그라데이션 채우기를 적용하지 않습니다.
+ **불투명도** - Y축 값이 증가함에 따라 채우기의 불투명도가 증가하는 불투명도 그라데이션.
+ **색조** - 시리즈 색상의 색조를 기반으로 하는 약간의 그라데이션.
+ **색상 체계** - 색상 체계에 정의된 색상 그라데이션. 이 설정은 채우기 및 선에서 사용할 수 있습니다. 자세한 내용은 [색상 옵션](v9-time-series-color.md) 단원을 참조하십시오.

그라데이션 모양은 **채우기 불투명도** 설정에 의해서도 수정됩니다.

**포인트 표시**

시각화를 구성하여 선 또는 막대 그래프에 포인트를 추가할 수 있습니다. **항상**, **안 함** 또는 **자동**을 선택할 수 있습니다. **자동**을 사용하는 경우 Grafana는 데이터의 밀도를 기반으로 포인트를 표시할지 여부를 결정합니다. 데이터의 밀도가 충분히 낮으면 포인트가 표시됩니다.

**포인트 크기**

그린 포인트 크기를 직경 1\$140픽셀로 설정합니다.

**선 보간**

Grafana에서 시리즈 선을 보간하는 방법을 선택합니다. 선택 항목은 **선형**, **평활**, **이전 단계** 및 **이후 단계**입니다.

**선 스타일**

선의 스타일을 설정합니다. 색상을 변경하려면 표준 색상 체계 필드 옵션을 사용합니다.

선 스타일 모양은 **선 너비** 및 **채우기 불투명도** 설정의 영향을 받습니다.

선 스타일의 선택 항목은 **실선**, **대시**, **점선**입니다.

**null 값 연결**

null 값(데이터의 갭)이 그래프에 표시되는 방식을 선택합니다. Null 값을 연결하여 연속 선을 형성하거나 선택적으로 데이터의 갭이 더 이상 연결되지 않도록 임계치를 설정할 수 있습니다. 데이터 포인트를 갭과 연결하지 않거나(**안 함**), 데이터 포인트를 **항상** 갭과 연결하도록 선택하거나 데이터의 갭이 더 이상 연결되지 않아야 하는 **임계치**를 설정할 수 있습니다.

**시리즈 스택**

*스택*을 사용하면 Grafana가 시리즈를 서로 위에 표시할 수 있습니다. 시각화에서 스택을 사용할 때 잘못 이해할 수 있는 그래프를 쉽게 생성할 수 있으므로 주의해야 합니다. 스택이 최선의 접근 방식이 아닌 이유를 알아보려면 [The Issue with Stacking](https://www.data-to-viz.com/caveat/stacking.html)을 참조하세요.

스택에 대한 옵션은 다음과 같습니다.
+ **끄기** - 시리즈 스택을 끕니다.
+ **일반** - 시리즈를 서로 위에 스택합니다.
+ **100%** - 비율에 따라 스택합니다. 모든 시리즈가 합쳐져 100%까지 누적됩니다.

**그룹에서 시리즈 스택**

스택 동작을 재정의하여 시리즈를 그룹으로 스택할 수 있습니다. 재정의 AMI 생성에 대한 자세한 내용은 [필드 재정의 구성](v9-panels-configure-overrides.md) 섹션을 참조하세요. 재정의를 생성할 때 시리즈가 속할 스택 그룹의 이름을 지정합니다.

**다음 아래 채우기**

**다음 아래 채우기** 옵션에서는 두 시리즈 사이의 영역을 채웁니다. 이 옵션은 시리즈 또는 필드 재정의로만 사용할 수 있습니다. 이 옵션을 사용하면 시리즈 선에서 0까지 채우는 대신 두 시리즈 사이의 영역을 채울 수 있습니다. 예를 들어 *Max* 및 *Min*이라는 두 개의 시리즈가 있는 경우 **Max** 시리즈를 선택하고 **Min** 시리즈에 **다음 아래 채우기**를 적용하도록 재정의할 수 있습니다. 이렇게 하면 두 시리즈 선 사이의 영역만 채워집니다.

# 축 옵션
<a name="v9-time-series-axis"></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) 섹션을 참조하세요.

축 범주 아래의 옵션은 X축 및 Y축이 렌더링되는 방식을 변경합니다. 편집 중인 필드 옵션 상자 외부를 클릭할 때까지 일부 옵션은 적용되지 않습니다. `Enter`를 눌러도 됩니다.

**배치**

Y축의 배치를 선택합니다. 다음과 같은 옵션이 있습니다.
+ **자동** – Grafana는 시리즈에 Y축을 자동으로 할당합니다. 단위가 서로 다른 시리즈가 둘 이상 있는 경우 Grafana는 왼쪽 축을 첫 번째 단위에 할당하고 오른쪽 축을 다음 단위에 할당합니다.
+ **왼쪽** - 왼쪽에 모든 Y축을 표시합니다.
+ **오른쪽** - 오른쪽에 모든 Y축을 표시합니다.
+ **숨김** - 모든 Y축을 숨깁니다.

각 필드 또는 시리즈에 축을 할당하려면 [필드 재정의를 추가](v9-panels-configure-overrides.md)합니다.

**Label**

Y축 텍스트 레이블을 설정합니다. Y축이 둘 이상인 경우 재정의를 사용하여 다른 레이블을 할당할 수 있습니다.

**Width(너비)**

축의 고정 너비를 설정합니다. 기본적으로 Grafana는 축의 너비를 동적으로 계산합니다.

축의 너비를 설정하면 축 유형이 다른 데이터가 동일한 표시 비율을 공유할 수 있습니다. 이 설정을 사용하면 축이 서로 시각적으로 근접하여 이동 또는 확장되지 않기 때문에 데이터에 대한 둘 이상의 그래프에서 의미를 더 쉽게 비교할 수 있습니다.

**소프트 최소 및 소프트 최대**

Y축 제한을 더 잘 제어할 수 있도록 **소프트 최소** 또는 **소프트 최대** 옵션을 설정합니다. 기본적으로 Grafana는 데이터세트를 기반으로 Y축의 범위를 자동으로 설정합니다.

소프트 최소 및 소프트 최대 설정을 사용하면 큰 변경 사항이 없을 때 작은 변경 사항을 볼 수 있습니다. 표준 최소 및 최대 필드 옵션에서 파생된 하드 최소 또는 최대는 특정 포인트를 지나 스파이크를 잘라내 간헐적 스파이크에서 유용한 세부 정보를 평탄화하는 것을 방지할 수 있습니다.

Y축의 하드 제한을 정의하기 위해 표준 최소/최대 옵션을 설정할 수 있습니다. 자세한 내용은 [표준 옵션 구성](v9-panels-configure-standard-options.md)을 참조하세요.

**크기 조정**

Y축의 규모 조정 방식을 설정합니다. 선택 항목은 **선형** 또는 **대수**입니다. 로그를 선택하는 경우 밑 2 또는 밑 10 로그 스케일 중에서 추가로 선택할 수 있습니다.

**변환**

시리즈를 재정의하여 그래프의 값에 변환을 적용할 수 있습니다(기본 값 또는 툴팁의 값, 컨텍스트 메뉴 또는 범례에는 영향을 주지 않음). 두 가지 변환 옵션이 있습니다.
+ **음수 Y 변환** - 결과를 Y축의 음수 값으로 뒤집습니다.
+ **상수** - 첫 번째 값을 상수 선으로 표시합니다.

# 색상 옵션
<a name="v9-time-series-color"></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) 섹션을 참조하세요.

기본적으로 그래프는 표준 [색상 체계](v9-panels-configure-standard-options.md#v9-panels-standard-options-color-scheme) 옵션을 사용하여 시리즈 색상을 할당합니다. 범례를 사용하여 범례 시리즈 색상 아이콘을 클릭해 색상 선택기를 열 수도 있습니다. 이렇게 색상을 설정하면 특정 시리즈의 특정 색상을 설정하는 재정의 규칙이 자동으로 생성됩니다.

다음은 시리즈 색상 기본값을 재정의하는 데 사용할 수 있는 추가 옵션입니다.

**클래식 팔레트**

가장 일반적인 설정은 그래프에 대해 **클래식 팔레트**를 사용하는 것입니다. 이 색상 체계는 순서에 따라 각 필드 또는 시리즈에 색상을 자동으로 할당합니다. 쿼리에서 필드 순서가 변경되면 색상도 변경됩니다. 재정의 규칙을 사용하여 특정 필드의 색상을 수동으로 구성할 수 있습니다.

**단일 색상**

이 모드를 사용하여 색상을 지정합니다. 범례에서 각 시리즈 옆에 있는 색상 지정된 선 아이콘을 클릭하여 색상 선택기를 열 수도 있습니다. 그러면 색상 체계를 단일 색상 및 선택한 색상으로 설정하는 새 재정의가 자동으로 생성됩니다.

**값 색상 체계별**

**시작 임계치(값 기준)** 또는 **녹색-노란색-빨간색(값 기준)**과 같은 값 기준 색상 체계를 선택하면 **시리즈 색상 지정 기준** 옵션이 나타납니다. 이 옵션은 시리즈에 색상을 할당하는 데 사용할 값(마지막, 최소, 최대)을 제어합니다.

**색상 체계 그라데이션 모드**

**그래프 스타일** 아래에 있는 **그라데이션 모드** 옵션에는 **색상 체계**라는 모드가 있습니다. **색상 체계**를 활성화하면 선 또는 막대가 선택한 **색상 체계**에 정의된 그라데이션 색상을 수신합니다.

**시작 임계치**

**색상 체계**가 **시작 임계치(값 기준)**로 설정되고 **그라데이션 모드**가 **체계**로 설정된 경우, 정의된 임계치 초과 시 선 또는 막대 색상이 변경됩니다. 색상 체계에서 선택된 정확한 색상만 표시됩니다.

**그라데이션 색상 체계**

**그라데이션 모드**를 **색상 체계**로 설정하지 *않고* 그라데이션 색상 체계를 사용하면 시리즈의 값이 설정된 임계치 사이를 이동할 때 선택한 색상이 선택한 색상 사이에서 그라데이션을 형성합니다.

# 추적 패널(베타)
<a name="v9-panels-traces"></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) 섹션을 참조하세요.

*추적*은 인프라에서 서비스를 통과할 때 요청을 추적하고 로깅할 수 있는 시각화입니다.

추적에 대한 자세한 내용은 [탐색에서의 추적](v9-explore-tracing.md) 섹션을 참조하세요.

# WindRose
<a name="v9-panels-windrose"></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) 섹션을 참조하세요.

WindRose 패널은 원시 시계열 데이터를 수신하여 데이터를 변환하며 WindRose 차트에 매핑합니다.

![\[WindRose panel with two circular charts showing wind direction and speed data distribution.\]](http://docs.aws.amazon.com/ko_kr/grafana/latest/userguide/images/windrose.png)


## 옵션
<a name="v9-panels-windrose-options"></a>

WindRose 템플릿은 다음 옵션을 지원합니다.
+ 축 빈도
+ 축 스타일(각도 또는 나침반)
+ 스케일(선형, 사각형, 로그)

# Grafana 버전 9에서의 탐색
<a name="v9-explore"></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의 대시보드 UI는 시각화를 위한 대시보드를 구축하는 기능을 제공합니다. *탐색*에서는 쿼리에 집중할 수 있도록 대시보드 및 패널 옵션이 사라집니다. 작업 중인 쿼리가 있을 때까지 반복한 다음, 쿼리에서 대시보드를 빌드할 수 있습니다.

**참고**  
데이터를 탐색하고 대시보드를 생성하지 않으려는 경우 탐색을 사용하면 훨씬 더 쉬워집니다. 데이터 소스가 그래프 및 테이블 데이터를 지원하는 경우 탐색은 결과를 그래프와 테이블로 표시합니다. 이렇게 하면 데이터의 추세와 세부 정보를 동시에 확인할 수 있습니다.

## 탐색 시작
<a name="v9-explore-start"></a>

**참고**  
탐색에 액세스하려면 편집자 또는 관리자 역할이 있어야 합니다.

**탐색에 액세스하는 방법**

1. Grafana 워크스페이스의 왼쪽 메뉴 표시줄에서 탐색 메뉴 항목을 선택하세요.

   빈 탐색 탭이 열립니다.

   또는 패널의 기존 쿼리를 시작하려면 패널 메뉴에서 탐색 옵션을 선택하세요. 그러면 패널의 쿼리가 포함된 탐색 탭이 열리고 대시보드 외부에 있는 쿼리에서 조정하거나 반복할 수 있습니다.

1. 왼쪽 상단의 드롭다운에서 데이터 소스를 선택하세요. [Prometheus](prometheus-data-source.md)에는 사용자 지정 탐색 구현이 있으며 다른 데이터 소스는 표준 쿼리 편집기를 사용합니다.

1. 쿼리 필드에서 쿼리를 작성하고 데이터를 탐색하세요. 쿼리 필드 옆에는 지우기 버튼(X), 쿼리 추가 버튼(\$1) 및 쿼리 제거 버튼(-)와 같은 3개의 버튼이 있습니다. 일반 쿼리 편집기와 마찬가지로 여러 쿼리를 추가하고 제거할 수 있습니다.

   쿼리에 대한 자세한 내용은 [데이터 쿼리 및 변환](v9-panels-query-xform.md) 섹션을 참조하세요.

## 분할 및 비교
<a name="v9-explore-compare"></a>

분할 보기에서는 그래프 및 테이블을 나란히 비교하거나 한 페이지에서 관련 데이터를 함께 보는 방법을 제공합니다.

**상단에서 분할 보기 열기**

1. 탐색 보기에서 **분할** 버튼을 선택하여 현재 쿼리를 복제하고 페이지를 나란히 두 개의 쿼리로 분할합니다.
**참고**  
예를 들어 두 개의 서로 다른 서버에 대해 동일한 쿼리를 비교하거나 스테이징 환경을 프로덕션 환경과 비교할 수 있도록 새 쿼리에 대해 다른 데이터 소스를 선택할 수 있습니다.

   분할 보기에서는 시간 선택기 중 하나에 연결된 시간 동기화 버튼 중 하나를 선택하여 두 패널의 시간 선택기를 연결할 수 있습니다(하나를 변경하면 다른 항목도 변경됨). 시간 선택기를 연결하면 분할 보기 쿼리의 시작 시간과 종료 시간을 동기화한 상태로 유지합니다. 이를 통해 두 분할 패널 모두에서 동일한 시간 간격을 확인할 수 있습니다.

1. 새로 생성된 쿼리를 닫으려면 분할 닫기 버튼을 클릭합니다.

## 단축 링크 공유
<a name="v9-explore-share"></a>

단축 링크 공유 기능을 사용하면 쿼리 파라미터와 함께 더 긴 URL을 사용하는 대신 /goto/:uid 형식의 더 작고 간단한 URL을 생성할 수 있습니다. 쿼리 결과에 대한 단축 링크를 생성하려면 탐색 도구 모음에서 **공유** 옵션을 선택합니다. 사용되지 않는 단축 링크는 7일 후에 자동으로 삭제됩니다.

# 탐색에서의 쿼리 관리
<a name="v9-explore-manage"></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) 섹션을 참조하세요.

쿼리 디버깅을 지원하기 위해 탐색에서는 쿼리 검사기를 통해 쿼리 요청 및 응답과 쿼리 통계를 조사할 수 있습니다. 이 기능은 패널 검사기 태스크 [쿼리 성능 검사](v9-panels-panel-inspector.md#v9-panels-query-performance) 및 [쿼리 요청 및 응답 데이터 검사](v9-panels-panel-inspector.md#v9-panels-query-request-response)와 유사합니다.

## 쿼리 기록
<a name="v9-explore-manage-history"></a>

쿼리 기록은 탐색에서 사용한 쿼리 목록입니다. 기록은 Grafana 데이터베이스에 저장되며 다른 사용자와 공유되지 않습니다. 기록에서 쿼리 보존 기간은 2주입니다. 2주가 지난 쿼리는 자동으로 삭제됩니다. 기록을 열고 상호 작용하려면 탐색에서 **쿼리 기록** 버튼을 선택합니다.

**참고**  
별표로 표시된(즐겨찾는) 쿼리에는 2주 보존 기간이 적용되지 않으며 해당 쿼리는 삭제되지 않습니다.

**쿼리 기록 보기**

쿼리 기록을 사용하면 쿼리 기록을 볼 수 있습니다. 각 개별 쿼리에 대해 다음을 수행할 수 있습니다.
+ 쿼리를 실행합니다.
+ 설명을 생성 및/또는 편집합니다.
+ 쿼리를 클립보드에 복사합니다.
+ 쿼리가 포함된 단축 링크를 클립보드에 복사합니다.
+ 쿼리에 별표(즐겨찾기)를 지정합니다.

**즐겨찾기 쿼리 관리**

쿼리 기록 탭에서 별표가 지정된 모든 쿼리는 별표 목록에 표시됩니다. 이를 통해 자주 사용하는 쿼리에 더 빠르게 액세스하고 처음부터 입력하지 않고 이러한 쿼리를 재사용할 수 있습니다.

**쿼리 기록 정렬**

기본적으로 쿼리 기록에는 최신 쿼리가 표시됩니다. 날짜 또는 데이터 소스 이름을 기준으로 오름차순 또는 내림차순으로 기록을 정렬할 수 있습니다.

**쿼리 기록을 정렬하는 방법**

1. **쿼리 정렬 기준** 필드를 선택하세요.

1. 다음 옵션 중 하나를 선택합니다.
   + 최신 항목 우선
   + 가장 오래된 항목 우선

**쿼리 기록 필터링**

쿼리 기록 및 별표 탭에서 쿼리 기록을 특정 데이터 소스로 필터링할 수 있습니다.

**데이터 소스로 기록 필터링**

1. **특정 데이터 소스에 대한 쿼리 필터링** 필드를 선택하세요.

1. 기록을 필터링할 데이터 소스를 선택하세요. 여러 데이터 소스를 선택할 수 있습니다.

**쿼리 기록** 탭에서 슬라이더를 사용하여 날짜별로 쿼리를 필터링할 수도 있습니다.
+ 세로 슬라이더를 사용하여 날짜별로 쿼리를 필터링하세요.
+ 상단 핸들을 끌어 시작 날짜를 조정하세요.
+ 상단 핸들을 끌어 종료 날짜를 조정하세요.

**쿼리 기록에서 검색**

기록의 쿼리 및 설명에서 검색할 수 있습니다. 쿼리 기록 탭 및 별표 탭에서 쿼리를 검색할 수 있습니다.

**쿼리 기록에서 검색하는 방법**

1. **쿼리 검색** 필드를 선택하세요.

1. 검색하려는 용어를 검색 필드에 입력하세요.

**쿼리 편집기 설정**

설정 탭에서 쿼리 기록을 사용자 지정할 수 있습니다. 옵션은 다음 표에 설명되어 있습니다.


| 설정 | 기본값  | 
| --- | --- | 
| 기본 활성 탭 변경 | 쿼리 기록 탭 | 

**참고**  
쿼리 기록 설정은 전역적이며 분할 모드의 두 패널에 적용됩니다.

## Prometheus별 기능
<a name="v9-explore-manage-prometheus"></a>

탐색에서는 Prometheus에 대한 사용자 지정 쿼리 환경을 제공합니다. 쿼리를 실행할 때 실제로 그래프에 대한 일반 Prometheus 쿼리 및 테이블에 대한 *인스턴스 쿼리*라는 두 가지 쿼리를 실행합니다. 인스턴트 쿼리는 각 시계열의 마지막 값을 반환하며, 이는 그래프에 표시된 데이터의 좋은 요약 정보를 보여줍니다.

**지표 탐색기**

쿼리 필드 왼쪽에서 **지표**를 선택하여 지표 탐색기를 엽니다. 그러면 지표가 접두사별로 그룹화된 계층적 메뉴가 표시됩니다. 예를 들어 모든 Alertmanager 지표는 `alertmanager` 접두사 아래에 그룹화됩니다. 이는 사용 가능한 지표만 탐색하려는 경우 좋은 출발점입니다.

**쿼리 필드**

쿼리 필드는 지표 이름 및 함수에 대한 자동 완성을 지원하며 이는 표준 Prometheus 쿼리 편집기와 비슷합니다. Enter 키를 눌러 새 줄을 생성하고 Shift\$1Enter를 눌러 쿼리를 실행할 수 있습니다.

자동 완성 메뉴는 Ctrl\$1Space를 눌러 트리거할 수 있습니다. 자동 완성 메뉴에는 최근에 실행된 쿼리 목록이 포함된 새 기록 섹션이 포함되어 있습니다.

제안은 쿼리 필드 아래에 표시될 수 있습니다. 제안된 변경 사항으로 쿼리를 업데이트하려면 제안을 선택합니다.
+ 카운터(단조적으로 증가하는 지표)의 경우 비율 함수가 제안됩니다.
+ 버킷의 경우 히스토그램 함수가 제안됩니다.
+ 기록 규칙의 경우 규칙을 확장할 수 있습니다.

**테이블 필터**

테이블 패널의 **레이블** 열에서 필터 버튼을 선택하여 쿼리 표현식에 필터를 추가합니다. 여러 쿼리에 대한 필터를 추가할 수도 있습니다. 모든 쿼리에 대해 필터가 추가됩니다.

# 탐색에서의 로그
<a name="v9-explore-logs"></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) 섹션을 참조하세요.

지표와 함께 탐색을 사용하면 다음 데이터 소스에서 로그를 조사할 수 있습니다.
+ [OpenSearch](using-opensearch-in-AMG.md)
+ [InfluxDB](using-influxdb-in-AMG.md)
+ [Loki](using-loki-in-AMG.md)

인프라 모니터링 및 인시던트 대응 중에 지표와 로그를 더 깊이 검토하여 원인을 찾을 수 있습니다. 또한 탐색을 사용하면 지표 및 로그를 나란히 보면서 상관시킬 수 있습니다. 이렇게 하면 새 디버깅 워크플로가 생성됩니다.

1. 알림을 수신하세요.

1. 지표를 드릴다운하고 검사하세요.

1. 다시 드릴다운하고 지표 및 시간 간격(및 향후 분산 추적)과 관련된 로그를 검색하세요.

## 데이터 시각화
<a name="v9-explore-logs-viz"></a>

로그 쿼리 결과는 그래프에 히스토그램으로 표시되고 개별 로그는 다음 섹션에 설명되어 있습니다.

데이터 소스가 전체 범위 로그 볼륨 히스토그램을 지원하는 경우 입력한 모든 로그 쿼리에 대한 로그 분포가 있는 그래프가 자동으로 표시됩니다. 이 기능은 현재 OpenSearch 및 Loki 데이터 소스에서 지원됩니다.

**참고**  
Loki에서 이 전체 로그 볼륨 히스토그램은 쿼리된 시간 범위에 따라 지표 쿼리로 렌더링됩니다(이 방법은 비용이 많이 들 수 있음). 이 쿼리는 소규모 Loki 설치에서 특히 처리하기 어려울 수 있습니다. 이를 완화하기 위해 Loki 앞에 [nginx](https://www.nginx.com/)와 같은 프록시를 사용하여 이러한 쿼리에 대한 사용자 지정 제한 시간(예: 10초)을 설정하는 것이 좋습니다. 로그 볼륨 히스토그램 쿼리는 값이 `Source=logvolhist`인 HTTP 헤더 `X-Query-Tags`를 사용하여 쿼리를 찾아 식별할 수 있습니다. 이러한 헤더는 Grafana에서 모든 로그 볼륨 히스토그램 쿼리에 추가됩니다.

데이터 소스가 전체 범위 로그 볼륨 히스토그램 로드를 지원하지 않는 경우 로그 모델은 자동으로 계산된 시간 간격으로 버킷화된 로그 행 수를 기반으로 시계열을 계산합니다. 그러면 첫 번째 로그 행의 타임스탬프가 결과에서 히스토그램의 시작을 고정합니다. 시계열의 끝은 시계 선택기의 **종료** 범위에 고정됩니다.

**로그 수준**

수준 레이블이 지정된 로그의 경우 Grafana에서는 레이블 값을 사용하여 로그 수준을 결정하고 그에 따라 색상을 업데이트합니다. 로그에 수준 레이블이 지정되지 않은 경우 해당 콘텐츠가 지원되는 표현식과 일치하는지 확인합니다(자세한 내용은 아래 참조). 로그 수준은 항상 첫 번째 일치에 의해 결정됩니다. Grafana에서 로그 수준을 확인할 수 없는 경우 알 수 없음 로그 수준으로 시각화됩니다.

**작은 정보**  
Loki 데이터 소스를 사용하고 `level`이 로그 줄의 일부인 경우 구문 분석기(JSON, logfmt, 정규식,..)를 사용하여 로그 수준을 결정하는 데 사용되는 수준 레이블로 수준 정보를 추출할 수 있습니다. 이렇게 하면 히스토그램에서 다양한 로그 수준을 별도의 막대로 표시할 수 있습니다.

**지원되는 로그 수준 및 로그 수준 약어와 표현식 매핑:**


| 지원되는 표현식 | 로그 수준 | 색상 | 
| --- | --- | --- | 
| 긴급 | 심각 | 보라색 | 
| fatal | 심각 | 보라색 | 
| 알림 | 심각 | 보라색 | 
| crit | 심각 | 보라색 | 
| 심각 | 심각 | 보라색 | 
| err | 오류 | red | 
| 오류 | 오류 | red | 
| 오류 | 오류 | red | 
| warn | warning | yellow | 
| warning | warning | yellow | 
| info | info | green | 
| 정보 | info | green | 
| notice | info | green | 
| dbug | debug | blue | 
| debug | debug | blue | 
| 추적 | 추적 | 하늘색 | 
| \$1 | 알 수 없음 | 회색 | 

## 로그 탐색
<a name="v9-explore-logs-nav"></a>

로그 줄 옆에 있는 로그 탐색 인터페이스를 사용하여 더 많은 로그를 요청할 수 있습니다. 탐색 하단의 **이전 로그** 버튼을 선택하여 이 작업을 수행할 수 있습니다. 줄 제한에 도달한 경우 더 많은 로그를 보려면 이 기능을 사용하여 더 많은 로그를 가져올 수 있습니다. 각 요청은 탐색에서 별도의 페이지로 표시됩니다. 모든 페이지에는 수신 로그 줄의 시작 및 시작 타임스탬프가 표시됩니다. 보려는 페이지를 클릭하면 이전 결과를 볼 수 있습니다. 탐색은 로그 탐색에서 실행되는 마지막 5개의 요청을 캐싱합니다. 이를 통해 해당 페이지를 클릭할 때 동일한 쿼리를 다시 실행하지 않습니다.

## 시각화 옵션
<a name="v9-explore-logs-vis-options"></a>

로그가 표시되는 방법을 사용자 지정하고 표시되는 열을 선택할 수 있습니다.

**Time**

시간 열을 표시하거나 숨깁니다. 데이터 소스에서 보고된 로그 줄과 연결된 타임스탬프입니다.

**고유 레이블**

공통 레이블이 아닌 레이블만 포함하는 고유 레이블 열을 표시하거나 숨깁니다. 모든 공통 레이블은 위에 표시됩니다.

**줄 바꿈**

표시에서 줄 바꿈을 사용하려면 이를 True로 설정합니다. False로 설정하면 가로 스크롤 기능이 생성됩니다.

**JSON 정리**

모든 JSON 로그를 정리 인쇄하려면 이 옵션을 `true`로 설정합니다. 이 설정은 JSON 이외 형식의 로그에는 영향을 주지 않습니다.

**중복 제거**

로그 데이터는 매우 반복적일 수 있으며 탐색에서 중복 로그 줄을 숨기면 도움이 될 수 있습니다. 사용할 수 있는 몇 가지 중복 제거 알고리즘이 있습니다.
+ **정확** - 정확한 일치는 날짜 필드를 제외한 전체 줄에서 수행됩니다.
+ **숫자** - 기간, IP 주소 등과 같은 숫자를 제거한 후 줄에서 일치시킵니다.
+ **서명** - 가장 공격적인 중복 제거 기능으로, 모든 문자와 숫자를 제거하고 나머지 공백 및 구두점으로 일치시킵니다.

**결과 순서 뒤집기**

수신된 로그의 순서를 기본 내림차순(최신 항목 우선)에서 오름차순(가장 오래된 항목 우선)으로 변경할 수 있습니다.

**레이블 및 감지된 필드**

각 로그 행에는 보다 강력한 상호 작용을 위해 레이블 및 감지된 필드를 포함하는 확장 가능한 영역이 있습니다. 모든 레이블에 대해 선택한 레이블을 기준으로 필터링하여 해당 레이블을 포함(긍정 필터)하거나 제외(부정 필터)하는 기능을 추가했습니다. 또한 각 필드 또는 레이블에는 표시된 모든 로그와 관련된 통계를 표시하는 통계 아이콘이 있습니다.

**새 줄 이스케이프 처리**

탐색에서는 새 줄(`\n`, `\r`) 또는 탭(`\t`)과 같이 로그 줄에서 잘못 이스케이프 처리된 일부 시퀀스를 자동으로 감지합니다. 이러한 시퀀스를 감지하면 탐색에서는 '새 줄 이스케이프 처리' 옵션을 제공합니다.

탐색에서는 감지된 잘못 이스케이프 처리된 시퀀스를 자동으로 수정할 수 있습니다.

**이스케이프 시퀀스를 자동으로 수정하는 방법**

1. 시퀀스를 바꾸려면 **새 줄 이스케이프 처리**를 선택하세요.

1. 올바른지 확인하기 위해 수동으로 대체한 내용을 검토하세요.

탐색에서는 이러한 시퀀스를 대체합니다. 이렇게 하면 옵션이 **새 줄 이스케이프 처리**에서 **이스케이프 처리 제거**로 변경됩니다. 수신된 입력에 따라 구문 분석이 정확하지 않을 수 있으므로 변경 사항을 평가합니다. **이스케이프 처리 제거**를 선택하여 대체 작업을 되돌릴 수 있습니다.

**데이터 링크**

데이터 링크를 사용하면 로그 메시지 중 임의의 부분을 내부 또는 외부 링크로 전환할 수 있습니다. 생성된 링크는 **로그 세부 정보** 보기의 **링크** 섹션에서 버튼으로 표시됩니다.

**필드 표시 여부 전환**

로그 줄을 확장한 다음, 눈 아이콘을 클릭하여 필드를 표시하거나 숨깁니다.

## Loki 특정 기능
<a name="v9-explore-logs-loki"></a>

Loki는 Grafana Labs의 오픈 소스 로그 집계 시스템입니다. Loki는 로그의 콘텐츠를 인덱싱하지 않고 각 로그 스트림에 대한 레이블 세트를 인덱싱하기 때문에 비용 효율적입니다. Loki의 로그는 Prometheus의 레이블 선택기로 쿼리하는 것과 유사한 방식으로 쿼리됩니다. 레이블을 사용하여 Prometheus 레이블과 일치하도록 구성할 수 있는 로그 스트림을 그룹화합니다. Grafana Loki에 대한 자세한 내용은 [Grafana Loki](https://github.com/grafana/loki) Github를 참조하세요.

로그 데이터를 쿼리하는 방법에 대한 자세한 내용은 [Loki](using-loki-in-AMG.md)를 참조하세요.

**지표에서 로그로 전환**

Prometheus 쿼리에서 로그 쿼리로 전환하는 경우(먼저 지표와 로그를 나란히 배치하기 위해 분할을 수행할 수 있음) 로그에 있는 쿼리의 레이블을 유지하고 로그 스트림을 쿼리하는 데 사용할 수 있습니다. 예를 들어 다음 Prometheus 쿼리가 있는 경우:

```
grafana_alerting_active_alerts{job="grafana"}
```

Logs 데이터 소스로 전환하면 다음으로 변경됩니다.

```
{job="grafana"}
```

이 경우 선택한 시간 범위에 있는 로그 청크를 반환합니다. 이를 통해 검색할 수 있습니다.

## 로그 샘플
<a name="v9-explore-logs-sample"></a>

선택한 데이터 소스에서 로그 샘플을 구현하고 로그 및 지표 쿼리를 모두 지원하는 경우 지표 쿼리에서는 시각화된 지표에 기여하는 로그 줄의 샘플을 자동으로 볼 수 있습니다. 이 기능은 현재 Loki 데이터 소스에서 지원됩니다.

**라이브 테일링**

라이브 테일링 기능을 사용하여 지원되는 데이터 소스에 대한 실시간 로그를 확인합니다.

탐색 도구 모음에서 **라이브** 버튼을 선택하여 라이브 테일 보기로 전환하세요.

라이브 테일 보기에 있는 동안 화면 하단에 새 로그가 나타나고 대비되는 희미한 배경을 사용하여 새로운 내용을 쉽게 추적할 수 있습니다. **일시 중지** 버튼을 선택하거나 로그 보기를 스크롤하여 라이브 테일링을 일시 중지하고 중단 없이 이전 로그를 탐색합니다. **재개** 버튼을 선택하여 라이브 테일링을 재개하거나 **중지** 버튼을 선택하여 라이브 테일링을 종료하고 표준 탐색 보기로 돌아갑니다.

# 탐색에서의 추적
<a name="v9-explore-tracing"></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) 섹션을 참조하세요.

탐색을 사용하면 추적 데이터 소스의 추적을 시각화할 수 있습니다.

지원되는 데이터 소스는 다음과 같습니다.
+ [Jaeger](jaeger-data-source.md)
+ [Tempo](tempo-data-source.md)
+ [AWS X-Ray](x-ray-data-source.md)
+ [Zipkin](zipkin-data-source.md)

위에 나열된 데이터 소스에 대한 쿼리를 구성하는 방법에 대한 자세한 내용은 특정 데이터 소스에 대한 설명서를 참조하세요.

## 추적 보기 설명
<a name="v9-explore-trace-view"></a>

이 섹션에서는 추적 보기 대시보드의 요소를 설명합니다.

**헤더**

추적 보기의 헤더에는 다음과 같은 요소가 있습니다.
+ 헤더 제목: 루트 범위의 이름과 추적 ID를 표시합니다.
+ 검색: 검색된 텍스트가 포함된 범위를 강조 표시합니다.
+ 메타데이터: 추적에 대한 다양한 메타데이터.

**미니맵**

요약 보기 또는 추적 타임라인을 표시합니다. 미니맵 위로 포인터를 끌어 더 작은 시간 범위로 확대합니다. 확대/축소는 기본 타임라인도 업데이트하므로 더 짧은 기간을 쉽게 볼 수 있습니다. 확대된 상태에서 미니맵 위로 마우스를 가져가면 선택 재설정 버튼이 표시됩니다. 이 버튼을 누르면 확대 상태가 재설정됩니다.

**타임라인**

추적 내 범위 목록을 표시합니다. 각 범위 행은 다음과 같은 구성 요소로 이루어집니다.
+ 하위 확장 버튼: 선택한 범위의 모든 하위 범위 확장 또는 축소.
+ 서비스 이름: 범위를 로깅하는 서비스의 이름.
+ 작업 이름: 이 범위가 나타내는 작업의 이름.
+ 범위 기간 막대: 추적 내 작업 기간의 시각적 표시.

**범위 세부 정보**

범위 행의 아무 곳이나 클릭하면 다음을 포함하여 범위 세부 정보가 표시됩니다.
+ 작업 이름
+ 범위 메타데이터
+ 태그: 이 범위와 연결된 모든 태그.
+ 프로세스 메타데이터: 이 범위를 로깅하는 프로세스에 대한 메타데이터.
+ 로그: 이 범위 및 연결된 키 값으로 로깅된 로그 목록입니다. Zipkin 로그의 경우 섹션에 Zipkin 주석이 표시됩니다.

**노드 그래프**

선택적으로 표시된 추적에 대한 노드 그래프를 확장할 수 있습니다. 데이터 소스에 따라 그래프에 추적의 범위를 노드로 표시하거나 현재 추적을 기반으로 한 서비스 그래프를 포함하여 몇 가지 컨텍스트를 추가할 수 있습니다.

**로그에 대한 추적**

추적 보기의 범위로부터 해당 범위와 관련된 로그로 직접 이동할 수 있습니다. 이는 Tempo, Jaeger 및 Zipkin 데이터 소스에서 사용할 수 있습니다. 각 데이터 소스를 구성하는 방법에 대한 지침은 관련 설명서를 참조하세요.

문서 아이콘을 클릭하여 구성된 데이터 소스로 탐색에서 분할 보기를 열고 해당 범위에 대한 관련 로그를 쿼리합니다.

## 서비스 그래프 보기
<a name="v9-explore-trace-graph"></a>

서비스 그래프 보기는 범위 지표(속도, 오류 비율 및 기간(RED)에 대한 추적 데이터)와 서비스 그래프를 시각화합니다. 요구 사항이 설정되면 이 사전 구성된 보기를 즉시 사용할 수 있습니다.

자세한 내용은 [Tempo](tempo-data-source.md) 데이터 소스 페이지를 참조하세요. *Tempo 설명서*의 [service graph view page](https://grafana.com/docs/tempo/latest/metrics-generator/service-graph-view/)를 확인할 수도 있습니다.

# 탐색에서의 검사기
<a name="v9-explore-inspector"></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) 섹션을 참조하세요.

검사기는 쿼리를 이해하고 문제를 해결하는 데 도움이 됩니다. 원시 데이터를 검사하고, 해당 데이터를 쉼표로 구분된 값(CSV) 파일로 내보내며, 로그 결과를 TXT 형식으로 내보내고, 쿼리 요청을 볼 수 있습니다.

## 검사기 UI
<a name="v9-explore-inspector-ui"></a>

검사기에는 다음 탭이 있습니다.
+ **통계 탭** - 쿼리에 걸리는 시간과 반환되는 양을 보여줍니다.
+ **쿼리 탭** - Grafana에서 데이터 소스를 쿼리할 때 서버로 전송된 요청을 표시합니다.
+ **JSON 탭** - 데이터 JSON 및 데이터 프레임 구조 JSON을 보고 복사할 수 있습니다.
+ **데이터 탭** - 쿼리에서 반환된 원시 데이터를 표시합니다.
+ **오류 탭** - 오류를 표시합니다. 쿼리가 오류를 반환할 때만 표시됩니다.

## 검사기 태스크
<a name="v9-explore-inspector-tasks"></a>

탐색 검사기에서 다양한 태스크를 수행할 수 있습니다.

**검사기 열기**

검사하려는 쿼리를 실행한 후 **검사기** 버튼을 선택합니다.

화면 하단에 검사기 창이 열립니다.

*원시 쿼리 결과 검사*

원시 쿼리 결과(즉 쿼리에서 반환한 데이터)를 테이블에서 볼 수 있습니다.

**검사기** 탭에서 **데이터** 탭을 클릭합니다.

여러 쿼리 또는 여러 노드 쿼리의 경우 추가 옵션이 있습니다.
+ **데이터 프레임 표시:** 보려는 결과 세트 데이터를 선택합니다.
+ **시간별로 조인된 시리즈:** 열당 하나의 결과 세트로 모든 쿼리의 원시 데이터를 한 번에 확인합니다. 열 제목을 클릭하여 데이터를 정렬할 수 있습니다.

**원시 쿼리 결과를 CSV로 다운로드**

원시 쿼리 결과를 본 후에 결과의 CSV 파일을 생성할 수 있습니다. 표시되는 결과의 CSV 파일을 받게 되므로 CSV 파일을 생성하기 전에 원하는 결과를 얻도록 결과를 세분화해야 합니다.

CSV 파일을 생성하려면 **검사기** 탭에서 **CSV 다운로드**를 선택합니다.

특별히 Excel에 대해 형식화된 CSV 파일을 다운로드하려면 **CSV 다운로드**를 선택하기 전에 **데이터 옵션** 패널을 확장하고 **Excel용 다운로드** 토글을 켜세요.

*TXT로 로그 결과 다운로드*

**검사기** 탭에서 **로그 다운로드**를 선택하여 현재 보고 있는 로그의 TXT 파일을 생성할 수 있습니다.

**추적 결과 다운로드**

Grafana는 데이터 소스 유형에 따라 추적 결과에 대한 JSON 파일을 Jaeger, Zipkin 또는 OTLP 형식 중 하나로 생성할 수 있습니다.

추적을 다운로드하려면 **검사기** 탭에서 **추적 다운로드**를 선택하세요.

**쿼리 성능 검사**

**통계** 탭에는 쿼리 소요 시간, 전송한 쿼리 수, 반환된 행 수를 알려주는 통계가 표시됩니다. 이 정보는 특히 예상치 못하게 높거나 낮은 숫자가 있는 경우 쿼리 문제를 해결하는 데 도움이 될 수 있습니다.

통계는 읽기 전용입니다.

**JSON 모델 보기**

데이터 프레임 JSON 모델뿐만 아니라 데이터를 탐색하고 내보낼 수 있습니다.

**JSON 모델을 보는 방법**

1. 검사기 패널에서 **JSON** 탭을 클릭하세요.

1. **소스 선택** 섹션에서 다음 옵션 중 하나를 선택하세요.
   + **데이터** - 탐색으로 반환된 데이터를 나타내는 JSON 객체를 표시합니다.
   + **DataFrame 구조** - 원시 결과 세트를 표시합니다.

1. JSON의 일부를 확장하거나 축소하여 별도의 섹션을 볼 수 있습니다. **클립보드에 복사** 옵션을 선택하여 JSON 본문을 복사하여 다른 애플리케이션에 붙여넣을 수도 있습니다.

**데이터 소스에 대한 원시 요청 및 응답 보기**

탐색 및 검사기 탭에서 작업하는 경우 쿼리로 생성하는 원시 요청 및 응답 데이터를 볼 수 있습니다. 검사기에서 **쿼리** 탭을 선택하고 **새로 고침**을 선택하여 원시 데이터를 확인합니다.

Grafana는 서버로 쿼리를 전송하고 결과를 표시합니다. 쿼리의 특정 부분을 드릴다운하거나, 모든 쿼리를 확장 또는 축소하거나, 다른 애플리케이션에서 사용할 클립보드에 데이터를 복사할 수 있습니다.

# Grafana 버전 9에서의 알림
<a name="v9-alerts"></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 알림은 시스템 문제가 발생한 후 바로 문제를 파악하여 서비스 중단을 최소화하는 데 도움이 되는 강력하고 실행 가능한 알림을 제공합니다.

Amazon Managed Grafana에는 검색 가능한 단일 보기에서 알림 정보를 중앙 집중화하는 업데이트된 알림 시스템인 *Grafana 알림*에 대한 액세스가 포함되어 있습니다. 다음 기능이 포함되어 있습니다.
+ 중앙 집중식 보기에서 Grafana 알림을 생성하고 관리합니다.
+ 단일 인터페이스를 통해 Cortex 및 Loki 관리형 알림을 생성하고 관리합니다.
+ Prometheus, Amazon Managed Service for Prometheus 및 기타 Alertmanager 호환 데이터 소스의 알림 정보를 확인합니다.

Amazon Managed Grafana 워크스페이스를 생성할 때 Grafana 알림 또는 [클래식 대시보드 알림](old-alerts-overview.md)을 사용할 수 있습니다. 이 섹션에서는 Grafana 알림을 다룹니다.

**참고**  
클래식 알림이 활성화된 워크스페이스를 생성하고 Grafana 알림으로 전환하려는 경우 [두 알림 시스템 사이를 전환](v9-alerting-use-grafana-alerts.md)할 수 있습니다.

## Grafana 알림 제한 사항
<a name="v9-alert-limitations"></a>
+ Grafana 알림 시스템은 사용 가능한 모든 Amazon Managed Service for Prometheus, Prometheus, Loki 및 Alertmanager 데이터 소스에서 규칙을 검색할 수 있습니다. 지원되는 다른 데이터 소스에서 규칙을 가져오지 못할 수 있습니다.
+ Prometheus가 아닌 Grafana에 정의된 알림 규칙에서 여러 알림을 연락 지점으로 전송합니다. 기본 Grafana 알림을 사용하는 경우 클래식 대시보드 알림을 유지하고 새 Grafana 알림 기능을 활성화하지 않는 것이 좋습니다. Prometheus 데이터 소스에 정의된 알림을 보려면 Grafana 알림을 활성화하는 것이 좋습니다. Grafana 알림은 Prometheus Alertmanager에서 생성된 알림에 대해 단일 알림만 전송합니다.
**참고**  
이 제한 사항은 Grafana v10.4 이상을 지원하는 Amazon Managed Grafana 워크스페이스에서 적용되지 않습니다.

**Topics**
+ [Grafana 알림 제한 사항](#v9-alert-limitations)
+ [개요](v9-alerting-overview.md)
+ [알림 탐색](v9-alerting-explore.md)
+ [알림 설정](v9-alerting-setup.md)
+ [Grafana 알림으로 클래식 대시보드 알림 마이그레이션](v9-alerting-use-grafana-alerts.md)
+ [알림 규칙 관리](v9-alerting-managerules.md)
+ [알림 전달 관리](v9-alerting-managenotifications.md)

# 개요
<a name="v9-alerting-overview"></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 알림의 작동 방식에 대한 개요를 제공하고 유연하고 강력한 알림 엔진의 핵심을 구성하고 이와 함께 작동하는 몇 가지 주요 개념을 소개합니다.

1. **데이터 원본**

   알림에 사용할 데이터에 연결합니다. 이 데이터는 종종 알림에 대한 시계열 데이터이며 모니터링 및 분석할 시스템의 세부 정보를 보여줍니다. 자세한 내용은 [데이터 소스](AMG-data-sources-builtin.md)를 참조하세요.

1. **알림 규칙**

   알림 실행 여부를 결정하는 평가 기준를 설정합니다. 알림 규칙은 데이터 소스에서 데이터를 가져오기 위한 하나 이상의 쿼리 및 표현식, 알림의 필요성, 평가 빈도 및 선택적으로 알림 실행을 위해 조건을 충족해야 하는 기간을 설명하는 조건으로 구성됩니다.

   Grafana 관리형 알림은 다차원 알림을 지원하므로 각 알림 규칙이 여러 알림 인스턴스를 생성할 수 있습니다. 이는 단일 표현식에서 여러 시리즈를 관찰하는 경우 매우 유용합니다.

1. **레이블**

   알림 규칙 및 해당 인스턴스를 알림 정책 및 무음과 일치시킵니다. 또한 심각도별로 알림을 그룹화하는 데 사용할 수 있습니다.

1. **알림 정책**

   알림이 실행될 때 팀에 알리기 위해 알림이 라우팅되는 위치, 시간 및 방법을 설정합니다. 각 알림 정책은 담당하고 있는 알림을 나타내는 레이블 매처 세트를 지정합니다. 알림 정책에는 하나 이상의 알림으로 구성된 연락 지점에 할당되어 있습니다.

1. **연락 지점**

   알림 규칙이 실행될 때 연락처에 알림을 보내는 방법을 정의합니다. 팀에 알림을 보낼 수 있도록 다양한 ChatOps 도구가 지원됩니다.

## 특성
<a name="v9-alerting-features"></a>

**모든 알림에 대해 한 페이지 지원**

단일 Grafana 알림 페이지는 Grafana 관리형 알림과 Prometheus 호환 데이터 소스에 있는 알림을 모두 한 곳에 통합합니다.

**다차원 알림**

알림 규칙은 다차원 알림이라고 하는 알림 규칙당 여러 개의 개별 알림 인스턴스를 생성할 수 있으므로 단일 알림으로 전체 시스템에 대한 가시성을 확보할 수 있는 기능과 유연성을 제공합니다.

**알림 라우팅**

정의한 레이블에 따라 각 알림 인스턴스를 특정 연락 지점으로 라우팅합니다. 알림 정책은 알림이 연락 지점으로 라우팅되는 위치, 시간 및 방법에 대한 규칙 세트입니다.

**알림 무음**

무음을 사용하면 하나 이상의 알림 규칙에서 영구 알림 수신을 중지할 수 있습니다. 특정 기준에 따라 알림을 부분적으로 일시 중지할 수도 있습니다. 무음에는 조직 및 가시성을 높이기 위한 전용 섹션이 있으므로 기본 알림 보기를 어수선하게 하지 않고도 일시 중지된 알림 규칙을 스캔할 수 있습니다.

**음소거 타이밍**

음소거 타이밍을 사용하면 새 알림을 생성하거나 전송하지 않으려는 시간 간격을 지정할 수 있습니다. 또한 유지 관리 기간과 같이 반복 기간에 알림 전달을 동결할 수 있습니다.

# 알림 탐색
<a name="v9-alerting-explore"></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 알림에서 제공하는 다양한 알림 규칙 유형을 살펴봅니다.

## 알림 규칙 유형
<a name="v9-alerting-explore-rule-types"></a>

**Grafana 관리형 규칙**

Grafana 관리형 규칙은 가장 유연한 알림 규칙 유형입니다. 이를 통해 지원되는 데이터 소스의 데이터에 대해 작업을 취할 수 있는 알림을 생성할 수 있습니다. 여러 데이터 소스를 지원하는 것 외에도 표현식을 추가하여 데이터를 변환하고 알림 조건을 설정할 수도 있습니다. 단일 규칙 정의에서 여러 데이터 소스의 알림을 허용하는 유일한 유형의 규칙입니다.

**Mimir 및 Loki 규칙**

Mimir 또는 Loki 알림을 생성하려면 호환되는 Prometheus 또는 Loki 데이터 소스가 있어야 합니다. 데이터 소스를 테스트하고 눈금자 API가 지원되는지 관찰하여 데이터 소스가 Grafana를 통한 규칙 생성을 지원하는지 확인할 수 있습니다.

**기록 규칙**

기록 규칙은 호환되는 Prometheus 또는 Loki 데이터 소스에만 사용할 수 있습니다. 기록 규칙을 사용하면 자주 필요하거나 계산 비용이 많이 드는 표현식을 미리 계산하고, 해당 결과를 새로운 시계열 세트로 저장할 수 있습니다. 집계된 데이터에 대해 알림을 실행하거나 계산 비용이 많이 드는 표현식을 반복적으로 쿼리하는 대시보드가 있는 경우에 유용합니다.

## 주요 개념 및 기능
<a name="v9-alerting-explore-features"></a>

다음 표에는 Grafana 알림을 최대한 활용하는 데 도움이 되도록 설계된 주요 개념, 기능 및 정의 목록이 포함되어 있습니다.


| 주요 개념 또는 기능 | 정의 | 
| --- | --- | 
|  알림에 대한 데이터 소스  |  지표, 로그 및 추적을 쿼리하고 시각화할 데이터 소스를 선택합니다.  | 
|  알림에 대한 프로비저닝  |  알림 리소스를 관리하고 파일 프로비저닝 또는 Terraform을 사용하여 Grafana 시스템으로 프로비저닝합니다.  | 
|  Alertmanager  |  알림 인스턴스의 라우팅 및 그룹화를 관리합니다.  | 
|  알림 규칙  |  알림 규칙을 실행해야 하는 시점에 대한 평가 기준 세트. 알림 규칙은 하나 이상의 쿼리와 표현식, 조건, 평가 빈도 및 조건이 충족되는 기간으로 구성됩니다. 알림 규칙은 여러 개의 알림 인스턴스를 생성할 수 있습니다.  | 
|  알림 인스턴스  |  알림 인스턴스는 알림 규칙의 인스턴스입니다. 단일 차원 알림 규칙에는 하나의 알림 인스턴스가 있습니다. 다차원 알림 규칙에는 하나 이상의 알림 인스턴스가 있습니다. 10개 VM의 CPU와 같이 여러 결과와 일치하는 단일 알림 규칙은 여러 알림 인스턴스(이 경우 10개)로 계산됩니다. 이 숫자는 시간에 따라 달라질 수 있습니다. 예를 들어 시스템의 모든 VM에 대한 CPU 사용량을 모니터링하는 알림 규칙에는 VM 개수만큼 알림 인스턴스가 추가됩니다. 알림 인스턴스 할당량에 대한 자세한 내용은 [할당량에 도달함 오류](v9-alerting-managerules-grafana.md#v9-alerting-rule-quota-reached) 섹션을 참조하세요.  | 
|  알림 그룹  |  Alertmanager는 루트 알림 정책의 레이블을 사용하여 기본적으로 알림 인스턴스를 그룹화합니다. 이를 통해 연락 지점으로 전송되는 알림 인스턴스의 중복 제거 및 그룹을 제어합니다.  | 
|  연락 지점  |  알림 규칙이 실행될 때 연락처에 알림을 보내는 방법을 정의합니다.  | 
|  메시지 템플릿 지정  |  재사용 가능한 사용자 지정 템플릿을 생성하고 연락 지점에서 사용합니다.  | 
|  알림 정책  |  알림이 그룹화되고 연락 지점으로 라우팅되는 위치, 시간 및 방법에 대한 규칙 세트.  | 
|  레이블 및 레이블 매처  |  레이블을 통해 알림 규칙을 고유하게 식별합니다. 알림 규칙을 알림 정책 및 무음에 연결하여 어떤 정책이 이를 처리해야 하는지, 어떤 알림 규칙을 무음 처리해야 하는지 결정합니다.  | 
|  무음  |  하나 이상의 알림 인스턴스에서 알림을 중지합니다. 무음과 음소거 타이밍의 차이는 무음은 일정 기간만 지속되지만, 음소거 타이밍은 반복 일정에서 수행된다는 점입니다. 레이블 매처를 사용하여 알림 인스턴스를 무음으로 설정합니다.  | 
|  음소거 타이밍  |  새 알림을 생성하거나 전송하지 않으려는 시간 간격을 지정합니다. 또한 유지 관리 기간과 같이 반복 기간에 알림 전달을 동결할 수 있습니다. 기존 알림 정책에 연결되어야 합니다.  | 

# 데이터 소스
<a name="v9-alerting-explore-datasources"></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 알림과 호환되는 여러 [데이터 소스](AMG-data-sources-builtin.md)가 있습니다. 각 데이터 소스는 플러그인에 의해 지원됩니다. 아래 나열된 기본 제공 데이터 소스 중 하나를 사용할 수 있습니다.

Amazon Managed Grafana와 호환되고 Amazon Managed Grafana에서 지원하는 데이터 소스입니다.
+ [Alertmanager 데이터 소스에 연결](data-source-alertmanager.md)
+ [Amazon CloudWatch 데이터 소스에 연결](using-amazon-cloudwatch-in-AMG.md)
+ [Amazon OpenSearch Service 데이터 소스에 연결](using-Amazon-OpenSearch-in-AMG.md)
+ [AWS IoT SiteWise 데이터 소스에 연결](using-iotsitewise-in-AMG.md)
+ [an AWS IoT TwinMaker 데이터 소스에 연결](AMG-iot-twinmaker.md)
+ [Amazon Managed Service for Prometheus 및 오픈 소스 Prometheus 데이터 소스에 연결](prometheus-data-source.md)
+ [Amazon Timestream 데이터 소스에 연결](timestream-datasource.md)
+ [Amazon Athena 데이터 소스에 연결](AWS-Athena.md)
+ [Amazon Redshift 데이터 소스에 연결](AWS-Redshift.md)
+ [AWS X-Ray 데이터 소스에 연결](x-ray-data-source.md)
+ [Azure Monitor 데이터 소스에 연결](using-azure-monitor-in-AMG.md)
+ [Google Cloud Monitoring 데이터 소스에 연결](using-google-cloud-monitoring-in-grafana.md)
+ [Graphite 데이터 소스에 연결](using-graphite-in-AMG.md)
+ [InfluxDB 데이터 소스에 연결](using-influxdb-in-AMG.md)
+ [Loki 데이터 소스에 연결](using-loki-in-AMG.md)
+ [Microsoft SQL Server 데이터 소스에 연결](using-microsoft-sql-server-in-AMG.md)
+ [MySQL 데이터 소스에 연결](using-mysql-in-AMG.md)
+ [OpenTSDB 데이터 소스에 연결](using-opentsdb-in-AMG.md)
+ [PostgreSQL 데이터 소스에 연결](using-postgresql-in-AMG.md)
+ [Jaeger 데이터 소스에 연결](jaeger-data-source.md)
+ [Zipkin 데이터 소스에 연결](zipkin-data-source.md)
+ [Tempo 데이터 소스에 연결](tempo-data-source.md)
+ [테스트를 위한 TestData 데이터 소스 구성](testdata-data-source.md)

# 알림 규칙 정보
<a name="v9-alerting-explore-rules"></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) 섹션을 참조하세요.

알림 규칙은 알림 인스턴스 실행 여부를 결정하는 평가 기준 세트입니다. 규칙은 하나 이상의 쿼리와 표현식, 조건, 평가 빈도 및 조건이 충족되는 기간(선택 사항)으로 구성됩니다.

쿼리 및 표현식에서는 평가할 데이터세트를 선택하는 반면, 조건은 알림을 생성하기 위해 알림에서 충족하거나 초과해야 하는 임계치를 설정합니다.

간격은 알림 규칙이 평가되는 빈도를 지정합니다. 기간을 구성하면 조건을 충족해야 하는 기간을 나타냅니다. 또한 알림 규칙은 데이터가 없는 경우 알림 동작을 정의할 수 있습니다.

**Topics**
+ [알림 규칙 유형](v9-alerting-explore-rules-types.md)
+ [알림 인스턴스](v9-alerting-rules-instances.md)
+ [네임스페이스 및 그룹](v9-alerting-rules-grouping.md)
+ [알림 템플릿 지정](v9-alerting-rules-notification-templates.md)

# 알림 규칙 유형
<a name="v9-alerting-explore-rules-types"></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 관리형 규칙

Grafana 관리형 규칙은 가장 유연한 알림 규칙 유형입니다. 이를 통해 기존 데이터 소스의 데이터에 대해 작업을 취할 수 있는 알림을 생성할 수 있습니다.

모든 데이터 소스를 지원하는 것 외에도 [표현식](v9-panels-query-xform-expressions.md)을 추가하여 데이터를 변환하고 알림 조건을 표현할 수 있습니다.

Mimir, Loki 및 Cortex 규칙

Mimir, Loki 또는 Cortex 알림을 생성하려면 호환되는 Prometheus 데이터 소스가 있어야 합니다. 데이터 소스를 테스트하고 눈금자 API가 지원되는지 세부 정보를 확인하여 데이터 소스가 호환되는지 확인할 수 있습니다.

기록 규칙

기록 규칙은 Mimir, Loki 및 Cortex와 같은 호환되는 Prometheus 데이터 소스에만 사용할 수 있습니다.

기록 규칙을 사용하면 표현식의 결과를 새 시계열 세트로 저장할 수 있습니다. 집계된 데이터에 대해 알림을 실행하거나 동일한 표현식을 반복적으로 쿼리하는 대시보드가 있는 경우에 유용합니다.

Prometheus에서 [기록 규칙](https://prometheus.io/docs/prometheus/latest/configuration/recording_rules/)에 대해 자세히 알아보세요.

# 알림 인스턴스
<a name="v9-alerting-rules-instances"></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 관리형 알림은 다차원 알림을 지원합니다. 각 알림 규칙은 여러 개의 알림 인스턴스를 생성할 수 있습니다. 이는 단일 표현식에서 여러 시리즈를 관찰하는 경우 매우 유용합니다.

다음 PromQL 표현식을 고려합니다.

```
sum by(cpu) (
  rate(node_cpu_seconds_total{mode!="idle"}[1m])
)
```

이 표현식을 사용하는 규칙은 평가 중 관찰된 CPU 양만큼 많은 알림 인스턴스를 생성합니다. 이를 통해 단일 규칙에서 각 CPU의 상태를 보고할 수 있습니다.

# 네임스페이스 및 그룹
<a name="v9-alerting-rules-grouping"></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) 섹션을 참조하세요.

알림은 Mimir, Loki 또는 Prometheus 규칙 및 그룹 이름의 네임스페이스와 Grafana 관리형 규칙에 대한 폴더를 사용하여 구성할 수 있습니다.

**네임스페이스**

Grafana 관리형 규칙을 생성할 때 폴더를 사용하여 액세스 제어를 수행하고 특정 폴더 내 모든 규칙에 대한 액세스 권한을 부여하거나 거부할 수 있습니다.

**그룹**

그룹 내의 모든 규칙은 동일한 **간격**으로 평가됩니다.

그룹 내 알림 규칙 및 기록 규칙은 항상 **순차적으로** 평가됩니다. 즉, 규칙은 동시에 그리고 표시 순서대로 평가되지 않습니다.

**작은 정보**  
규칙을 서로 다른 간격으로 동시에 평가하려면 규칙을 서로 다른 그룹에 저장하는 것이 좋습니다.

# 알림 템플릿 지정
<a name="v9-alerting-rules-notification-templates"></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의 기본 템플릿은 [Go 템플릿 지정 시스템](https://golang.org/pkg/text/template)을 기반으로 합니다. 여기서 일부 필드는 텍스트로 평가되고 다른 필드는 HTML(이스케이핑에 영향을 미칠 수 있음)로 평가됩니다.

기본 템플릿 [default\$1template.go](https://github.com/grafana/alerting/blob/main/templates/default_template.go)는 사용자 지정 템플릿에 유용한 참조입니다.

대부분의 연락 지점 필드는 템플릿 지정 가능하므로 재사용 가능한 사용자 지정 템플릿을 생성하고 여러 연락 지점에서 사용할 수 있습니다. 템플릿을 사용한 사용자 지정 알림에 대한 자세한 내용은 [알림 사용자 지정](v9-alerting-notifications.md) 섹션을 참조하세요.

**중첩된 템플릿**

다른 템플릿 내에 템플릿을 포함할 수 있습니다.

예를 들어 `define` 키워드를 사용하여 템플릿 조각을 정의할 수 있습니다.

```
{{ define "mytemplate" }}
  {{ len .Alerts.Firing }} firing. {{ len .Alerts.Resolved }} resolved.
{{ end }}
```

그런 다음, `template` 키워드를 사용하여 이 조각 내에 사용자 지정 템플릿을 포함할 수 있습니다. 예제:

```
Alert summary:
{{ template "mytemplate" . }}
```

다음 기본 제공 템플릿 옵션을 사용하여 사용자 지정 템플릿을 포함할 수 있습니다.


| 이름 | 참고 | 
| --- | --- | 
|  `default.title`  |  개요 수준의 상태 정보를 표시합니다.  | 
|  `default.message`  |  실행 알림 및 해결된 알림의 형식이 지정된 요약을 제공합니다.  | 
|  `teams.default.message`  |  Microsoft Teams에 대해 서식 지정된 `default.messsage`와 비슷합니다.  | 

**알림 템플릿의 HTML**

알림 템플릿의 HTML이 이스케이프 처리됩니다. 결과 알림에서는 HTML 렌더링을 지원하지 않습니다.

일부 알림은 결과 알림의 모양과 느낌을 변경하는 대체 방법을 지원합니다. 예를 들어 Grafana에서는 `<grafana-install-dir>/public/emails/ng_alert_notification.html`에 이메일 알림을 전달하기 위한 기본 템플릿을 설치합니다. 이 파일을 편집하여 모든 알림 이메일의 모양을 변경할 수 있습니다.

# 숫자 데이터에 대한 알림
<a name="v9-alerting-explore-numeric"></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가 시계열 데이터가 아닌 숫자에 대한 알림을 처리하는 방법을 설명합니다.

특정 데이터 소스 중에서 시계열이 아닌 숫자 데이터는 서버 측 표현식(SSE)로 전달되거나 직접 알림이 전달될 수 있습니다. 이렇게 하면 데이터 소스 내에서 처리와 결과 효율성을 개선할 수 있으며 알림 규칙을 단순화할 수도 있습니다. 시계열 데이터 대신 숫자 데이터에 대한 알림을 전달할 때 레이블이 지정된 각 시계열을 단일 숫자로 줄이지 않아도 됩니다. 대신 레이블이 지정된 번호가 대신 Grafana로 반환됩니다.

**테이블 형식 데이터**

이 기능은 테이블 형식의 데이터를 쿼리하는 백엔드 데이터 소스에서 지원됩니다.
+ MySQL, Postgres, MSSQL 및 Oracle과 같은 SQL 데이터 소스.
+ Azure Kusto 기반 서비스: Azure Monitor(Logs), Azure Monitor(Azure Resource Graph), Azure Data Explorer.

Grafana 관리형 알림 또는 SSE를 사용하는 쿼리는 다음과 같은 경우 이러한 데이터 소스에서 숫자로 간주됩니다.
+ 데이터 소스 쿼리에서 '형식' 옵션이 '테이블'로 설정됩니다.
+ 쿼리에서 Grafana로 반환된 테이블 응답에는 숫자(예: int, double, float) 열 하나와 선택적으로 추가 문자열 열이 포함됩니다.

문자열 열이 있는 경우 해당 열은 레이블이 됩니다. 열 이름은 레이블 이름이 되고 각 행의 값은 해당 레이블의 값이 됩니다. 여러 행이 반환되는 경우 각 행은 레이블로 고유하게 식별되어야 합니다.

**예제**

'DiskSpace'라는 MySQL 테이블의 경우:


| Time | Host | 디스크 | PercentFree | 
| --- | --- | --- | --- | 
|  2021-June-7  |  web1  |  /etc  |  3  | 
|  2021-June-7  |  web2  |  /var  |  4  | 
|  2021-June-7  |  web3  |  /var  |  8  | 
|  ...  |  ...  |  ...  |  ...  | 

시계열을 Grafana에 반환하지 않고 데이터 필터링을 정시에 쿼리할 수 있습니다. 예를 들어 여유 공간이 5% 미만일 때 호스트, 디스크당 트리거되는 알림은 다음과 같습니다.

```
SELECT Host , Disk , CASE WHEN PercentFree  < 5.0 THEN PercentFree  ELSE 0 END FROM ( 
   SELECT
      Host, 
      Disk, 
      Avg(PercentFree) 
   FROM DiskSpace
   Group By
      Host, 
      Disk 
   Where __timeFilter(Time)
```

이 쿼리는 Grafana에 대한 다음 테이블 응답을 반환합니다.


| Host | 디스크 | PercentFree | 
| --- | --- | --- | 
|  web1  |  /etc  |  3  | 
|  web2  |  /var  |  4  | 
|  web3  |  /var  |  0  | 

이 쿼리를 알림 규칙의 **조건**으로 사용하면 0이 아닌 값에서 알림을 보냅니다. 따라서 다음 세 가지 알림 인스턴스가 생성됩니다.


| 레이블 | Status | 
| --- | --- | 
|  \$1Host=web1,disk=/etc\$1  |  알림  | 
|  \$1Host=web2,disk=/var\$1  |  알림  | 
|  \$1Host=web3,disk=/var\$1  |  정상  | 

# 레이블 및 주석
<a name="v9-alerting-explore-labels"></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) 섹션을 참조하세요.

레이블 및 주석에는 알림에 대한 정보가 포함되어 있습니다. 레이블 및 주석은 모두 이름이 지정된 값 세트라는 동일한 구조를 사용하지만, 용도는 다릅니다. 레이블 또는 이와 동등한 주석의 예로 `alertname="test"`가 있습니다.

레이블 및 주석의 주요 차이는 레이블은 알림을 다른 모든 알림과 구분하는 데 사용되는 반면 주석은 기존 알림에 추가 정보를 추가하는 데 사용된다는 점입니다.

예를 들어 두 개의 높은 CPU 알림이 있습니다. `server1`에 대한 알림과 `server2`에 대한 알림입니다. 이 예제에서는 `server`라는 레이블을 사용합니다. 첫 번째 알림의 레이블은 `server="server1"`이고 두 번째 알림의 레이블은 `server="server2"`입니다. 그러나 `"The CPU usage for server1 is above 75%."`와 같이 각 알림에 대한 설명을 추가할 수 있습니다. 여기서 `server1` 및 `75%`는 서버의 이름 및 CPU 사용량으로 대체됩니다(이 방법을 알아보려면 [레이블 및 주석 템플릿 지정](v9-alerting-explore-labels-templating.md)의 설명서 참조). 이러한 종류의 설명은 주석으로 더 적합합니다.

## 레이블
<a name="v9-alerting-explore-labels-labels"></a>

레이블에는 알림을 식별하는 정보가 포함되어 있습니다. 레이블의 예로 `server=server1`이 있습니다. 각 알림에는 둘 이상의 레이블이 있을 수 있으며, 알림에 대한 전체 레이블 세트를 레이블 세트라고 합니다. 알림을 식별하는 레이블 세트입니다.

예를 들어 알림에 레이블 세트 `{alertname="High CPU usage",server="server1"}`이 있고, 다른 알림에 레이블 세트 `{alertname="High CPU usage",server="server2"}`가 있을 수 있습니다. `alertname` 레이블은 동일하지만 `server` 레이블은 다르기 때문에 이는 두 개의 개별 알림입니다.

알림에 대한 레이블 세트는 데이터 소스의 레이블, 알림 규칙의 사용자 지정 레이블 및 `alertname`과 같은 여러 예약 레이블의 조합입니다.

**사용자 지정 레이블**

사용자 지정 레이블은 알림 규칙의 추가 레이블입니다. 주석과 마찬가지로 사용자 지정 레이블에는 이름이 있어야 하며, 해당 값에는 알림이 실행될 때 평가되는 텍스트와 템플릿 코드의 조합이 포함될 수 있습니다. 사용자 지정 레이블을 템플릿으로 지정하는 방법에 대한 설명서는 [여기](v9-alerting-explore-labels-templating.md)에서 확인할 수 있습니다.

템플릿과 함께 사용자 지정 레이블을 사용하는 경우 알림 규칙의 연속 평가 사이에서 레이블 값이 변경되지 않도록 하는 것이 중요합니다. 변경될 경우 많은 수의 고유한 알림이 생성되기 때문입니다. 그러나 템플릿이 다른 알림에 대해 다른 레이블 값을 생성하는 것은 괜찮습니다. 예를 들어 사용자 지정 레이블에 쿼리 값을 넣지 마세요. 그러면 값이 변경될 때마다 새 알림 세트가 생성됩니다. 대신 주석을 사용합니다.

또한 알림에 대한 레이블 세트에 이름이 같은 레이블이 둘 이상 없는지 확인하는 것도 중요합니다. 사용자 지정 레이블의 이름이 데이터 소스의 레이블과 동일한 경우 해당 레이블을 대체합니다. 그러나 사용자 지정 레이블의 이름이 예약 레이블과 동일한 경우 사용자 지정 레이블은 알림에서 생략됩니다.

## Annotations
<a name="v9-alerting-explore-labels-annotations"></a>

주석은 기존 알림에 추가 정보를 추가하는 이름 지정된 페어입니다. Grafana에는 `description`, `summary`, `runbook_url`, `dashboardUId`, `panelId`와 같은 여러 추천 주석이 있습니다. 사용자 지정 레이블과 마찬가지로 주석에는 이름이 있어야 하며, 해당 값에는 알림이 실행될 때 평가되는 텍스트와 템플릿 코드의 조합이 포함될 수 있습니다. 주석에 템플릿 코드가 포함된 경우 알림이 실행되면 템플릿이 한 번 평가됩니다. 알림이 해결되더라도 재평가되지 않습니다. 주석을 템플릿으로 지정하는 방법에 대한 설명서는 [여기](v9-alerting-explore-labels-templating.md)에서 확인할 수 있습니다.

# 레이블 일치 작동 방식
<a name="v9-alerting-explore-labels-matching"></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) 섹션을 참조하세요.

레이블 및 레이블 매처를 사용하여 알림 규칙을 알림 정책 및 무음에 연결합니다. 이를 통해 매우 유연하게 알림 인스턴스를 관리하고, 이를 처리해야 하는 정책과 무음 알림을 지정할 수 있습니다.

레이블 매처는 **레이블**, **값** 및 **연산자**와 같은 세 개의 개별 부분으로 구성됩니다.
+ **레이블** 필드는 일치시킬 레이블의 이름입니다. 레이블 이름과 정확히 일치해야 합니다.
+ **값** 필드는 지정된 **레이블** 이름의 해당 값과 일치합니다. 일치 여부는 **연산자** 값에 따라 다릅니다.
+ **연산자** 필드는 레이블 값과 일치하는 연산자입니다. 사용 가능한 연산자는 다음과 같습니다.


| 연산자 | 설명 | 
| --- | --- | 
|  `=`  |  값과 정확히 같은 레이블을 선택합니다.  | 
|  `!=`  |  값과 같지 않은 레이블을 선택합니다.  | 
|  `=~`  |  값과 정규식으로 일치하는 레이블을 선택합니다.  | 
|  `!~`  |  값과 정규식으로 일치하지 않는 레이블을 선택합니다.  | 

여러 레이블 매처를 사용하는 경우 AND 논리 연산자를 사용하여 결합됩니다. 즉, 규칙을 정책에 연결하려면 모든 매처가 일치해야 합니다.

**예제 시나리오**

알림에 대해 다음 레이블 세트를 정의하는 경우:

```
{ foo=bar, baz=qux, id=12 }
```

다음과 같습니다.
+ `foo=bar`로 정의된 레이블 매처가 이 알림 규칙과 일치합니다.
+ `foo!=bar`로 정의된 레이블 매처가 이 알림 규칙과 일치하지 *않습니다*.
+ `id=~[0-9]+`로 정의된 레이블 매처가 이 알림 규칙과 일치합니다.
+ `baz!~[0-9]+`로 정의된 레이블 매처가 이 알림 규칙과 일치합니다.
+ `foo=bar` 및 `id=~[0-9]+`로 정의된 레이블 매처 두 개가 이 알림 규칙과 일치합니다.

# Grafana 알림의 레이블
<a name="v9-alerting-explore-labels-alerting"></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 알림 내에서 알림을 고유하게 식별합니다.
+ Alertmanager는 레이블을 사용하여 알림 정책의 무음 및 알림 그룹에 대한 알림을 매칭합니다.
+ 알림 UI에는 해당 규칙 평가 중에 생성된 모든 알림 인스턴스의 레이블이 표시됩니다.
+ 연락 지점에서는 레이블에 액세스하여 알림을 생성시키는 알림 관련 정보가 포함된 알림을 동적으로 생성할 수 있습니다.
+ [알림 규칙](v9-alerting-managerules.md)에 레이블을 추가할 수 있습니다. 레이블은 수동으로 구성 가능하며 템플릿 함수를 사용하고 다른 레이블을 참조할 수 있습니다. 알림 규칙에 추가된 레이블은 레이블 간 충돌이 발생하는 경우 우선합니다(Grafana 예약 레이블의 경우 제외, 자세한 내용은 아래 참조).

**외부 Alertmanager 호환성**

Grafana의 기본 제공 Alertmanager는 유니코드 레이블 키와 값을 모두 지원합니다. 외부 Prometheus Alertmanager를 사용하는 경우 레이블 키는 해당 [데이터 모델](https://prometheus.io/docs/concepts/data_model/#metric-names-and-labels)과 호환되어야 합니다. 즉, 레이블 키에는 **ASCII 문자**, **숫자**, **밑줄** 및 일치 정규식 `[a-zA-Z_][a-zA-Z0-9_]*`만 포함되어야 합니다. 유효하지 않은 문자는 다음 규칙에 따라 외부 Alertmanager로 전송되기 전에 Grafana 알림 엔진으로 제거되거나 대체됩니다.
+ `Whitespace`는 제거됩니다.
+ `ASCII characters`는 `_`로 대체됩니다.
+ `All other characters`는 소문자 16진수 표현으로 대체됩니다. 첫 번째 문자인 경우 `_` 접두사가 붙습니다.

**참고**  
여러 레이블 키가 동일한 값으로 새니타이징 처리되는 경우 중복 항목에는 원본 레이블의 짧은 해시가 접미사로 추가됩니다.

**Grafana 예약 레이블**

**참고**  
접두사가 `grafana_`인 레이블은 Grafana에서 특별한 용도로 예약됩니다. 수동으로 구성된 레이블이 `grafana_`로 시작하는 경우 충돌 시 덮어쓸 수 있습니다.

Grafana 예약 레이블은 수동으로 구성된 레이블과 동일한 방식으로 사용할 수 있습니다. 현재 사용 가능한 예약 레이블 목록은 다음과 같습니다.


| Label | 설명 | 
| --- | --- | 
|  grafana\$1folder  |  알림이 포함된 폴더의 제목.  | 

# 레이블 및 주석 템플릿 지정
<a name="v9-alerting-explore-labels-templating"></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에서는 Prometheus에서와 마찬가지로 레이블 및 주석을 템플릿으로 지정합니다. 이전에 Prometheus를 사용한 적이 있는 경우 알림의 레이블 및 값을 포함하는 `$labels` 및 `$value` 변수에 익숙할 것입니다. 알림이 Prometheus 데이터 소스를 사용하지 않더라도 Grafana에서 동일한 변수를 사용할 수 있습니다. 이전에 Prometheus를 사용한 적이 없는 경우에도 걱정하지 마세요. 이러한 각 변수와 이를 템플릿으로 지정하는 방법은 이 페이지의 나머지 부분에서 설명합니다.

## Go의 템플릿 지정 언어
<a name="v9-alerting-explore-labels-templating-go"></a>

레이블 및 주석의 템플릿은 Go의 템플릿 지정 언어인 [text/template](https://pkg.go.dev/text/template)으로 작성됩니다.

**여는 태그 및 닫는 태그**

text/template에서 템플릿은 템플릿이 변수를 인쇄하는지 여부와 if 문과 같이 제어 구조를 실행하는지 여부에 관계없이 `{{`로 시작하고 `}}`로 끝납니다. Jinja(변수를 인쇄할 때 `{{` 및 `}}`를 사용하고 제어 구조에서 `{%` 및 `%}`를 사용함)와 같은 다른 템플릿 지정 언어와는 다릅니다.

**인쇄**

무언가의 값을 인쇄하려면 `{{` 및 `}}`를 사용합니다. 함수의 결과 또는 변수 값을 인쇄할 수 있습니다. 예를 들어 `$labels` 변수를 인쇄하려면 다음을 작성합니다.

```
{{ $labels }}
```

**레이블에 대해 반복**

`$labels`에서 각 레이블을 반복하기 위해 `range`를 사용할 수 있습니다. 여기서 `$k`는 이름, `$v`는 현재 레이블의 값을 나타냅니다. 예를 들어 쿼리에서 `instance=test` 레이블을 반환하는 경우 `$k`는 `instance`이고 `$v`는 `test`입니다.

```
{{ range $k, $v := $labels }}
{{ $k }}={{ $v }}
{{ end }}
```

## 레이블, 값 및 값 변수
<a name="v9-alerting-explore-labels-templating-variables"></a>

**레이블 변수**

`$labels` 변수에는 쿼리의 레이블이 포함됩니다. 예를 들어 인스턴스가 중단되었는지 확인하는 쿼리에서 중단된 인스턴스의 이름이 포함된 인스턴스 레이블을 반환할 수 있습니다. 예를 들어 인스턴스 중 하나가 5분 넘게 중단되었을 때 실행되는 알림 규칙이 있다고 가정합니다. 어떤 인스턴스가 중단되었는지 알려주는 요약을 알림에 추가하려고 합니다. `$labels` 변수를 사용하여 요약에서 인스턴스 레이블을 인쇄하는 요약을 생성할 수 있습니다.

```
Instance {{ $labels.instance }} has been down for more than 5 minutes
```

**점을 포함하는 레이블**

인쇄하려는 레이블이 해당 이름에서 점(마침표)을 포함하는 경우 템플릿에서 동일한 점을 사용하는 방식은 작동하지 않습니다.

```
Instance {{ $labels.instance.name }} has been down for more than 5 minutes
```

이는 템플릿이 `$labels.instance`에서 `name`이라고 하는 기존 이외 필드를 사용하려고 하기 때문입니다. 대신 `index` 함수를 사용해야 합니다. 이 함수에서는 `$labels` 변수에서 `instance.name` 레이블을 인쇄합니다.

```
Instance {{ index $labels "instance.name" }} has been down for more than 5 minutes
```

**변수 값**

`$value` 변수는 Prometheus와 다르게 작동합니다. Prometheus에서 `$value`는 표현식의 값을 포함하는 부동 소수점 숫자이지만 Grafana에서는 이 알림 규칙의 모든 임계치, 축소 및 수학 표현식, 클래식 조건의 레이블 및 값을 포함하는 문자열입니다. 쿼리 결과는 포함되지 않습니다. 10s\$110,000s의 행 또는 지표를 반환할 수 있기 때문입니다.

알림 요약에서 `$value` 변수를 사용하는 경우:

```
{{ $labels.service }} has over 5% of responses with 5xx errors: {{ $value }})
```

요약은 다음과 같을 수 있습니다.

```
api has an over 5% of responses with 5xx errors: [ var='B' labels={service=api} value=6.789 ]
```

여기에서 `var='B'`는 RefID B를 사용하는 표현식을 참조합니다. Grafana에서 모든 쿼리 및 표현식은 알림 규칙의 각 쿼리 및 표현식을 식별하는 RefID로 식별됩니다. 마찬가지로 `labels={service=api}`는 레이블을 참조하고 `value=6.789`는 값을 참조합니다.

이 경우 RefID A가 없습니다. 대부분의 알림 규칙에서 RefID A는 쿼리를 참조하고 쿼리는 `$value`에 포함되지 않은 많은 행 또는 시계열을 반환할 수 있기 때문입니다.

**변수 값**

`$value` 변수에 필요한 것보다 많은 정보가 포함된 경우 대신 `$values`를 사용하여 개별 표현식의 레이블 및 값을 인쇄할 수 있습니다. `$value`와 달리 `$values` 변수는 각 표현식의 레이블 및 부동 소수점 값을 포함하는 객체 테이블이며 해당 RefID로 인덱싱됩니다.

알림 요약에서 `B` RefID와 함께 표현식 값을 인쇄하는 경우:

```
{{ $labels.service }} has over 5% of responses with 5xx errors: {{ $values.B }}%
```

요약에는 값만 포함됩니다.

```
api has an over 5% of responses with 5xx errors: 6.789%
```

`{{ $values.B }}`는 숫자 6.789를 인쇄합니다. 하지만 실제로 B의 부동 소수점 값이 아니라 RefID B의 레이블 및 값을 모두 포함하는 객체를 인쇄할 때 이는 문자열입니다. RefID B의 부동 소수점 값을 사용하려면 `$values.B`에서 `Value` 필드를 사용해야 합니다. 알림 요약에서 부동 소수점 값을 가독 가능한 값으로 변환한 경우:

```
{{ $labels.service }} has over 5% of responses with 5xx errors: {{ humanize $values.B.Value }}%
```

**데이터 없음, 런타임 오류 및 제한 시간 초과**

알림 규칙의 쿼리에서 데이터 없음을 반환하거나 데이터 소스 오류 또는 제한 시간으로 인해 실패하는 경우 해당 쿼리를 사용하는 모든 임계치, 축소 또는 수학 표현식에서도 데이터 없음 또는 오류를 반환합니다. 이 경우 `$values`에 이러한 표현식이 없습니다. RefID를 사용하기 전에 존재 여부를 확인하는 것이 좋습니다. 그렇지 않으면 쿼리에서 데이터 없음 또는 오류를 반환하는 경우 템플릿이 중단됩니다. if 문을 사용하여 이 작업을 수행할 수 있습니다.

```
{{ if $values.B }}{{ $labels.service }} has over 5% of responses with 5xx errors: {{ humanizePercentage $values.B.Value }}{{ end }}
```

## 클래식 조건
<a name="v9-alerting-explore-labels-templating-classic"></a>

규칙이 임계치, 축소 및 수학 표현식 대신 클래식 조건을 사용하는 경우 `$values` 변수는 클래식 조건에서 조건의 참조 ID 및 위치에 의해 인덱싱됩니다. 예를 들어 두 조건을 포함하는 RefID B를 사용하는 클래식 조건이 있는 경우 `$values`에는 두 조건(`B0` 및 `B1`)이 포함됩니다.

```
The first condition is {{ $values.B0 }}, and the second condition is {{ $values.B1 }}
```

## 함수
<a name="v9-alerting-explore-labels-templating-functions"></a>

다음 함수는 레이블 및 주석을 확장히는 경우에도 사용할 수 있습니다.

**args**

`args` 함수는 객체 목록을 arg0, arg1 등의 키가 포함된 맵으로 변환합니다. 이는 여러 인수를 템플릿으로 전달할 수 있도록 제공됩니다.

**예제**

```
{{define "x"}}{{.arg0}} {{.arg1}}{{end}}{{template "x" (args 1 "2")}}
```

```
1 2
```

**externalURL**

이 `externalURL` 함수에서는 하나 이상의 ini 파일에 구성된 대로, Grafana 서버의 외부 URL을 반환합니다.

**예제**

```
{{ externalURL }}
```

```
https://example.com/grafana
```

**graphLink**

`graphLink` 함수는 지정된 표현식 및 데이터 소스에서 [Grafana 버전 9에서의 탐색](v9-explore.md)의 그래픽 보기 경로를 반환합니다.

**예제**

```
{{ graphLink "{\"expr\": \"up\", \"datasource\": \"gdev-prometheus\"}" }}
```

```
/explore?left=["now-1h","now","gdev-prometheus",{"datasource":"gdev-prometheus","expr":"up","instant":false,"range":true}]
```

**humanize**

`humanize` 함수는 십진수를 가독 가능한 값으로 변환합니다.

**예제**

```
{{ humanize 1000.0 }}
```

```
1k
```

**humanize1024**

`humanize1024`는 `humanize`와 비슷하게 작동하지만 1000이 아닌 1024를 밑으로 사용합니다.

**예제**

```
{{ humanize1024 1024.0 }}
```

```
1ki
```

**humanizeDuration**

`humanizeDuration` 함수는 초 단위로 기간을 가독 가능한 값으로 변환합니다.

**예제**

```
{{ humanizeDuration 60.0 }}
```

```
1m 0s
```

**humanizePercentage**

`humanizePercentage` 함수는 비율 값을 백분율로 표시하여 가독 가능한 값으로 변환합니다.

**예제**

```
{{ humanizePercentage 0.2 }}
```

```
20%
```

**humanizeTimestamp**

`humanizeTimestamp` 함수는 Unix 타임스탬프를 가독 가능한 값으로 변환합니다.

**예제**

```
{{ humanizeTimestamp 1577836800.0 }}
```

```
2020-01-01 00:00:00 +0000 UTC
```

**match**

`match` 함수는 정규식 패턴을 기준으로 텍스트를 일치시킵니다.

**예제**

```
{{ match "a.*" "abc" }}
```

```
true
```

**pathPrefix**

이 `pathPrefix` 함수에서는 하나 이상의 ini 파일에 구성된 대로, Grafana 서버의 경로를 반환합니다.

**예제**

```
{{ pathPrefix }}
```

```
/grafana
```

**tableLink**

`tableLink` 함수는 지정된 표현식 및 데이터 소스에서 [Grafana 버전 9에서의 탐색](v9-explore.md)의 테이블 보기 경로를 반환합니다.

**예제**

```
{{ tableLink "{\"expr\": \"up\", \"datasource\": \"gdev-prometheus\"}" }}
```

```
/explore?left=["now-1h","now","gdev-prometheus",{"datasource":"gdev-prometheus","expr":"up","instant":true,"range":false}]
```

**제목**

`title` 함수에서는 각 단어의 첫 번째 문자를 대문자로 표시합니다.

**예제**

```
{{ title "hello, world!" }}
```

```
Hello, World!
```

**toLower**

`toLower` 함수는 모든 텍스트를 소문자로 반환합니다.

**예제**

```
{{ toLower "Hello, world!" }}
```

```
hello, world!
```

**toUpper**

`toUpper` 함수는 모든 텍스트를 대문자로 반환합니다.

**예제**

```
{{ toUpper "Hello, world!" }}
```

```
HELLO, WORLD!
```

**reReplaceAll**

`reReplaceAll` 함수는 정규식과 일치하는 텍스트를 대체합니다.

**예제**

```
{{ reReplaceAll "localhost:(.*)" "example.com:$1" "localhost:8080" }}
```

```
example.com:8080
```

# 알림 규칙의 상태 조건 및 상태
<a name="v9-alerting-explore-state"></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) 섹션을 참조하세요.

알림 규칙의 상태 조건 및 상태는 알림에 대한 몇 가지 주요 상태 표시기를 이해하는 데 도움이 됩니다.

*알림 규칙 상태 조건*, *알림 인스턴스 상태*, *알림 규칙 상태*와 같은 세 가지 주요 구성 요소가 있습니다. 서로 관련되었지만 각 구성 요소는 약간 다른 정보를 전달합니다.

**알림 규칙 상태 조건**

알림 규칙은 다음 상태 중 하나일 수 있습니다.


| State | 설명 | 
| --- | --- | 
|  정상  |  평가 엔진에서 반환한 시계열 중 `Pending` 또는 `Firing` 상태의 시계열은 없습니다.  | 
|  보류중  |  평가 엔진에서 반환한 하나 이상의 시계열이 `Pending`입니다.  | 
|  실행  |  평가 엔진에서 반환한 하나 이상의 시계열이 `Firing`입니다.  | 

**참고**  
알림은 먼저 `pending`으로 전환된 다음, `firing`으로 전환되므로 알림이 실행되기까지 최소 2회의 평가 주기가 걸립니다.

**알림 인스턴스 상태**

알림 인스턴스는 다음 상태 중 하나일 수 있습니다.


| State | 설명 | 
| --- | --- | 
|  정상  |  실행 또는 보류 중 상태가 아닌 알림 상태로, 모든 것이 올바르게 작동하고 있습니다.  | 
|  보류중  |  구성된 임계치 기간 미만으로 활성화된 알림의 상태.  | 
|  알림  |  구성된 임계치 기간보다 오래 활성화된 알림의 상태.  | 
|  NoData  |  구성된 기간에 데이터가 수신되지 않았습니다.  | 
|  오류  |  알림 규칙을 평가하려고 할 때 발생한 오류.  | 

**알림 규칙 상태**

알림 규칙 상태는 다음 중 하나일 수 있습니다.


| State | 설명 | 
| --- | --- | 
|  Ok  |  알림 규칙을 평가할 때 오류가 없습니다.  | 
|  오류  |  알림 규칙을 평가할 때 오류가 발생했습니다.  | 
|  NoData  |  규칙 평가 중에 반환된 하나 이상의 시계열에 데이터가 없습니다.  | 

**`NoData` 및 `Error`에 대한 특별 알림**

알림 규칙 평가에서 `NoData` 또는 `Error` 상태가 생성되면 Grafana 알림은 다음과 같은 추가 레이블이 있는 알림 인스턴스를 생성합니다.


| Label | 설명 | 
| --- | --- | 
|  alertname  |  상태에 따라 `DatasourceNoData` 또는 `DatasourceError`.  | 
|  datasource\$1uid  |  상태의 원인이 되는 데이터 소스의 UID.  | 

무음, 연락 지점으로 라우팅 등을 추가하여 일반 알림과 동일한 방식으로 이러한 알림을 처리할 수 있습니다.

# 연락 지점
<a name="v9-alerting-explore-contacts"></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) 섹션을 참조하세요.

연락 지점을 사용하여 알림 규칙이 실행될 때 연락처에 알림을 보내는 방법을 정의합니다. 연락 지점에는 이메일, Slack, 웹후크 등과 같은 하나 이상의 연락 지점 유형이 있을 수 있습니다. 알림 규칙이 실행되면 연락 지점에 대해 나열된 모든 연락 지점 유형에 알림이 전송됩니다. Grafana Alertmanager 및 외부 Alertmanager에 대해 연락 지점을 구성할 수 있습니다.

알림 템플릿 지정 기능을 사용하여 연락 지점 유형에 대한 알림 메시지를 사용자 지정할 수도 있습니다.

**지원되는 연락 지점 유형**

다음 표에는 Grafana에서 지원하는 연락 지점 유형이 나열되어 있습니다.


| 이름 | Type | 
| --- | --- | 
|  Amazon SNS  |  `sns`  | 
|  OpsGenie  |  `opsgenie`  | 
|  PagerDuty  |  `pagerduty`  | 
|  Slack  |  `slack`  | 
|  VictorOps  |  `victorops`  | 

연락 지점에 대한 자세한 내용은 [연락 지점 작업](v9-alerting-contact-points.md) 및 [알림 사용자 지정](v9-alerting-notifications.md) 섹션을 참조하세요.

# 알림
<a name="v9-alerting-explore-notifications"></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에서는 Alertmanager를 사용하여 실행 알림 및 해결된 알림에 대한 알림을 보냅니다. Grafana에는 사용자 인터페이스에서 'Grafana'로 참조되는 자체 Alertmanager가 있지만 [Prometheus Alertmanager](https://prometheus.io/docs/alerting/latest/alertmanager/)와 같은 다른 Alertmanager에서도 알림을 보낼 수 있습니다. Grafana Alertmanager는 알림 정책 및 연락 지점을 사용하여 알림이 전송되는 방식과 위치, 알림을 보내야 하는 빈도, 알림을 동일한 알림으로 모두 보내야 하는지, 레이블 세트를 기반으로 그룹화된 알림으로 보내야 하는지, 별도의 알림으로 보내야 하는지를 구성합니다.

## 알림 정책
<a name="v9-alerting-explore-notifications-policies"></a>

알림 정책은 알림이 전송되는 시기와 위치를 제어합니다. 알림 정책은 동일한 알림에서 모든 알림을 함께 보내거나, 레이블 세트를 기반으로 그룹화된 알림으로 알림을 보내거나, 별도의 알림으로 알림을 보내도록 선택할 수 있습니다. 알림을 전송해야 하는 빈도를 제어하고 하루 중 특정 시간과 특정 요일에 알림을 금지하는 음소거 타이밍을 하나 이상 설정하도록 각 알림 정책을 구성할 수 있습니다.

알림 정책은 트리 구조로 구성되며, 트리의 루트에 루트 정책이라고 하는 알림 정책이 있습니다. 루트 정책은 하나만 있을 수 있으며 루트 정책은 삭제할 수 없습니다.

특정 라우팅 정책은 루트 정책의 하위 항목이며 일치하는 레이블 세트를 기반으로 모든 알림 또는 알림 하위 세트를 일치시키는 데 사용할 수 있습니다. 알림 정책은 일치하는 레이블이 알림의 레이블과 일치할 때 알림과 일치합니다.

특정 라우팅 정책에는 자체 하위 정책(중첩된 정책이라고 함)이 있을 수 있으므로 알림을 추가로 일치시킬 수 있습니다. 특정 라우팅 정책의 예로 인프라 알림을 Ops 팀에 보내는 경우가 있지만, 하위 정책은 높은 우선순위 알림을 PagerDuty로 보내고 낮은 우선순위 알림을 Slack으로 보낼 수 있습니다.

레이블에 관계없이 모든 알림은 기본 정책과 일치합니다. 그러나 루트 정책이 알림을 수신하면 각 특정 라우팅 정책을 살펴보고 알림과 일치하는 첫 번째 특정 라우팅 정책으로 알림을 보냅니다. 특정 라우팅 정책에 추가 하위 정책이 있는 경우 중첩된 정책 중 하나에 대해 알림을 일치시키려고 시도할 수 있습니다. 중첩된 정책이 알림과 일치하지 않으면 특정 라우팅 정책이 일치하는 정책입니다. 특정 라우팅 정책이 없거나 특정 라우팅 정책이 알림과 일치하지 않는 경우 루트 정책이 일치하는 정책입니다.

## 연락 지점
<a name="v9-alerting-explore-notifications-contacts"></a>

연락 지점에는 알림을 보내기 위한 구성이 포함되어 있습니다. 연락 지점은 통합 목록으로, 각각 특정 이메일 주소, 서비스 또는 URL로 알림을 보냅니다. 연락 지점에는 동일한 종류의 통합이 여러 개 있거나 서로 다른 통합 유형의 조합이 있을 수 있습니다. 예를 들어 연락 지점에는 PagerDuty 통합, PagerDuty 및 Slack 통합, PagerDuty 통합, Slack 통합, 두 개의 Amazon SNS 통합이 포함될 수 있습니다. 통합 없이 연락 지점을 구성할 수도 있습니다. 이 경우 알림이 전송되지 않습니다.

연락 지점은 알림 정책에 추가될 때까지 알림을 보낼 수 없습니다. 알림 정책은 하나의 연락 지점으로만 알림을 보낼 수 있지만 동시에 여러 알림 정책에 연락 지점을 추가할 수 있습니다. 알림이 알림 정책과 일치하면 해당 알림 정책의 연락 지점으로 알림이 전송되고, 그러면 해당 알림 정책이 해당 구성의 각 통합에 알림을 전송합니다.

**참고**  
연락 지점에 지원되는 통합에 대한 자세한 내용은 [연락 지점](v9-alerting-explore-contacts.md) 섹션을 참조하세요.

## 알림 템플릿 지정
<a name="v9-alerting-explore-notifications-templating"></a>

템플릿을 사용하여 알림을 사용자 지정할 수 있습니다. 예를 들어 템플릿을 사용하여 Slack으로 전송되는 알림의 제목과 메시지를 변경할 수 있습니다.

템플릿은 개별 통합 또는 연락 지점에 국한되지 않으며, 대신 동일한 연락 지점의 여러 통합에서, 서로 다른 연락 지점 간 통합에서도 사용할 수 있습니다. 예를 들어 Grafana 사용자는 `custom_subject_or_title` 템플릿을 생성하여 별도의 두 템플릿을 생성하지 않고도 PagerDuty의 템플릿 제목과 Slack 메시지 제목 모두에 사용할 수 있습니다.

모든 알림 템플릿은 [Go의 템플릿 지정 언어](https://pkg.go.dev/text/template)로 작성되며 알림 페이지의 연락 지점 탭에 있습니다.

## 무음
<a name="v9-alerting-explore-notifications-silences"></a>

무음을 사용하여 하나 이상의 실행 규칙에서 알림을 음소거할 수 있습니다. 무음으로 설정해도 알림 실행 또는 해결은 중지되지 않으며 사용자 인터페이스에서 실행 알림을 숨기지도 않습니다. 무음은 해당 지속 시간 동안 지속되며, 지속 시간은 분, 시간, 일, 개월 또는 년 단위로 구성할 수 있습니다.

# 알림 설정
<a name="v9-alerting-setup"></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) 섹션을 참조하세요.

알림을 생성 및 관리하는 데 필요한 기능과 통합을 구성합니다.

**Topics**
+ [외부 Alertmanager 추가](v9-alerting-setup-alertmanager.md)
+ [Grafana 알림 리소스 프로비저닝](v9-alerting-setup-provision.md)

# 외부 Alertmanager 추가
<a name="v9-alerting-setup-alertmanager"></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) 섹션을 참조하세요.

외부 Alertmanager를 단일 Alertmanager로 사용하여 모든 알림을 수신하도록 Grafana를 설정합니다. 그러면 Grafana 자체 내에서 이 외부 Alertmanager를 구성하고 관리할 수 있습니다.

Alertmanager를 추가한 후에는 Grafana 알림 UI를 사용하여 무음, 연락 지점 및 알림 정책을 관리할 수 있습니다. 이러한 페이지의 드롭다운 옵션을 사용하면 Alertmanager 사이를 전환할 수 있습니다.

**참고**  
Grafana 9.2부터 알림 페이지의 관리 탭에서 외부 Alertmanager의 URL 구성이 더 이상 사용되지 않습니다. 향후 릴리스에서 제거됩니다.

이제 외부 Alertmanager는 기본 Grafana 탐색 메뉴에서 Grafana 구성을 사용하여 데이터 소스로 구성되어야 합니다. 이를 통해 Grafana 내에서 외부 Alertmanager의 연락 지점 및 알림 정책을 관리할 수 있으며 URL을 기준으로 외부 Alertmanager를 구성할 때 이전에 볼 수 있었던 HTTP 기본 인증 자격 증명도 암호화할 수 있습니다.

외부 Alertmanager를 추가하려면 다음 단계를 수행하세요.

1. 구성, 데이터 소스를 차례로 클릭하세요.

1. Alertmanager를 검색하세요.

1. 구현을 선택하고 필요에 따라 페이지의 필드를 작성하세요.

   데이터 소스를 프로비저닝하는 경우 `jsonData` 필드에서 `handleGrafanaManagedAlerts` 플래그를 `true`로 설정하여 Grafana 관리형 알림을 이 Alertmanager로 보내세요.
**참고**  
Alertmanager의 Prometheus, Grafana Mimir 및 Cortex 구현이 지원됩니다. Prometheus의 경우 Grafana 알림 UI에서 연락 지점 및 알림 정책은 읽기 전용입니다.

1. 저장 및 테스트를 클릭하세요.

# Grafana 알림 리소스 프로비저닝
<a name="v9-alerting-setup-provision"></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 알림 프로비저닝을 사용하면 조직에 가장 적합한 방식으로 알림 데이터를 생성, 관리 및 유지 관리할 수 있으므로 이 프로세스가 더 쉬워집니다.

두 가지 옵션 중에서 선택할 수 있습니다.

1. 알림 프로비저닝 HTTP API를 사용하여 알림 리소스를 프로비저닝합니다.
**참고**  
일반적으로 Grafana UI에서는 API 프로비저닝 알림 규칙을 편집할 수 없습니다.  
편집을 활성화하려면 API에서 알림 규칙을 생성하거나 편집할 때 다음 요청에 x-disable-provenance 헤더를 추가합니다.  

   ```
   POST /api/v1/provisioning/alert-rules
   PUT /api/v1/provisioning/alert-rules/{UID}
   ```

1. Terraform을 사용하여 알림 리소스를 프로비저닝합니다.

**참고**  
현재 Grafana 알림에 대한 프로비저닝은 알림 규칙, 연락 지점, 음소거 타이밍 및 템플릿을 지원합니다. 파일 프로비저닝 또는 Terraform을 사용하여 프로비저닝된 알림 리소스는 Grafana 또는 기타 소스 내에서가 아니라 해당 리소스를 생성한 소스에서만 편집할 수 있습니다. 예를 들어 디스크의 파일을 사용하여 알림 리소스를 프로비저닝하는 경우 Terraform 또는 Grafana 내에서 데이터를 편집할 수 없습니다.

**Topics**
+ [Terraform을 사용하여 알림 리소스 생성 및 관리](v9-alerting-setup-provision-terraform.md)
+ [Grafana에서 프로비저닝된 알림 리소스 보기](v9-alerting-setup-provision-view.md)

# Terraform을 사용하여 알림 리소스 생성 및 관리
<a name="v9-alerting-setup-provision-terraform"></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) 섹션을 참조하세요.

Terraform의 Grafana 제공업체를 사용하여 알림 리소스를 관리하고 Grafana 시스템에 프로비저닝합니다. Grafana 알림에 대한 Terraform 제공업체 지원을 사용하면 전체 Grafana 알림 스택을 코드로 쉽게 생성, 관리 및 유지할 수 있습니다.

Terraform을 사용하여 알림 리소스를 관리하는 방법에 대한 자세한 내용은 Terraform 설명서의 [Grafana Provider](https://registry.terraform.io/providers/grafana/grafana/latest/docs) 설명서를 참조하세요.

다음 태스크를 완료하여 Terraform을 사용해 알림 리소스를 생성하고 관리하세요.

1. 프로비저닝을 위한 API 키를 생성하세요.

1. Terraform 제공업체를 구성하세요.

1. Terraform에서 알림 리소스를 정의하세요.

1. `terraform apply`를 실행하여 알림 리소스를 프로비저닝하세요.

## 사전 조건
<a name="v9-alerting-setup-provision-tf-prerequisites"></a>
+ grafana/grafana [Terraform provider](https://registry.terraform.io/providers/grafana/grafana/1.28.0) 1.27.0 이상이 있는지 확인하세요.
+ Grafana 9.1 이상을 사용하고 있는지 확인하세요. Grafana 버전 9를 사용하여 Amazon Managed Grafana 인스턴스를 생성한 경우 이에 해당합니다.

## 프로비저닝을 위한 API 키 생성
<a name="v9-alerting-setup-provision-tf-apikey"></a>

[일반 Grafana API 키를 생성](Using-Grafana-APIs.md)하여 Grafana에서 Terraform을 인증할 수 있습니다. API 키를 사용하는 대부분의 기존 도구는 새로운 Grafana 알림 지원과 함께 자동으로 작동해야 합니다. 특별히 Terraform에서 사용할 키 생성에 대한 자세한 내용은 [Using Terraform for Amazon Managed Grafana automation](https://aws-observability.github.io/observability-best-practices/recipes/recipes/amg-automation-tf/)을 참조하세요.

**프로비저닝을 위한 API 키를 생성하는 방법**

1. CI 파이프라인에 대한 새 서비스 계정을 생성하세요.

1. '알림 규칙 프로비저닝 API에 액세스' 역할을 할당하세요.

1. 새 서비스 계정 토큰을 생성하세요.

1. Terraform에서 사용할 토큰의 이름을 지정하고 저장하세요.

또는 기본 인증을 사용할 수 있습니다. 지원되는 모든 인증 형식을 보려면 Terraform 설명서의 [Grafana authentication](https://registry.terraform.io/providers/grafana/grafana/latest/docs#authentication)을 참조하세요.

## Terraform 제공업체 구성
<a name="v9-alerting-setup-provision-tf-configure"></a>

Grafana 알림 지원은 [Grafana Terraform 제공업체](https://registry.terraform.io/providers/grafana/grafana/latest/docs)의 일부로 포함됩니다.

다음은 Terraform 제공업체를 구성하는 데 사용할 수 있는 예제입니다.

```
terraform {
    required_providers {
        grafana = {
            source = "grafana/grafana"
            version = ">= 1.28.2"
        }
    }
}

provider "grafana" {
    url = <YOUR_GRAFANA_URL>
    auth = <YOUR_GRAFANA_API_KEY>
}
```

## 연락 지점 및 템플릿 프로비저닝
<a name="v9-alerting-setup-provision-tf-contacts"></a>

연락 지점은 알림 스택을 외부 환경에 연결합니다. 외부 시스템에 연결하는 방법과 알림을 전송할 위치를 Grafana에 알려줍니다. 15개가 넘는 서로 다른 [통합](https://registry.terraform.io/providers/grafana/grafana/latest/docs/resources/contact_point#optional) 중에서 선택할 수 있습니다. 이 예제에서는 Slack 연락 지점을 사용합니다.

**연락처 및 템플릿을 프로비저닝하는 방법**

1. 이 코드 블록을 로컬 시스템의 .tf 파일로 복사하세요. *<slack-webhook-url>*을 Slack 웹후크 URL(또는 기타 연락 지점 세부 정보)로 바꾸세요.

   이 예제에서는 Slack에 알림 전달을 전송하는 연락 지점을 생성합니다.

   ```
   resource "grafana_contact_point" "my_slack_contact_point" {
       name = "Send to My Slack Channel"
   
       slack {
           url = <slack-webhook-url>
           text = <<EOT
   {{ len .Alerts.Firing }} alerts are firing!
   
   Alert summaries:
   {{ range .Alerts.Firing }}
   {{ template "Alert Instance Template" . }}
   {{ end }}
   EOT
       }
   }
   ```

1. 텍스트 필드에 알림 텍스트를 입력하세요.

   `text` 필드는 [Go 스타일 템플릿 지정](https://pkg.go.dev/text/template)을 지원합니다. 이를 통해 Grafana 알림 전달 템플릿을 Terraform에서 직접 관리할 수 있습니다.

1. `terraform apply` 명령을 실행합니다.

1. Grafana UI로 이동하여 연락 지점의 세부 정보를 확인하세요.

   UI에서 Terraform을 통해 프로비저닝된 리소스를 편집할 수 없습니다. 그러면 알림 스택이 항상 코드와 동기화됩니다.

1. **테스트**를 클릭하여 연락 지점이 올바르게 작동하는지 확인하세요.

**참고**  
여러 연락 지점에서 동일한 템플릿을 재사용할 수 있습니다. 위 예제에서는 `{{ template "Alert Instance Template" . }}` 문을 사용하여 공유 템플릿이 임베드되어 있습니다.  
그런 다음, 이 조각을 Terraform에서 별도로 관리할 수 있습니다.  

```
resource "grafana_message_template" "my_alert_template" {
    name = "Alert Instance Template"

    template = <<EOT
{{ define "Alert Instance Template" }}
Firing: {{ .Labels.alertname }}
Silence: {{ .SilenceURL }}
{{ end }}
EOT
}
```

## 알림 정책 및 라우팅 프로비저닝
<a name="v9-alerting-setup-provision-tf-notifications"></a>

알림 정책은 위치가 아닌 알림 인스턴스를 라우팅하는 방법을 Grafana에 알려줍니다. 레이블 및 매처 시스템을 사용하여 이전에 정의한 연락 지점에 실행 알림을 연결합니다.

**알림 정책 및 라우팅을 프로비저닝하는 방법**

1. 이 코드 블록을 로컬 시스템의 .tf 파일로 복사하세요.

   이 예제에서는 알림이 `alertname`을 기준으로 그룹화됩니다. 즉, 동일한 이름을 공유하는 알림에서 수신되는 모든 알림이 동일한 Slack 메시지로 그룹화됩니다.

   특정 알림을 다르게 라우팅하려는 경우 하위 정책을 추가할 수 있습니다. 하위 정책을 사용하면 레이블 일치에 따라 다양한 알림에 라우팅을 적용할 수 있습니다. 이 예제에서는 a=b 레이블이 있는 모든 알림에 음소거 타이밍을 적용합니다.

   ```
   resource "grafana_notification_policy" "my_policy" {
       group_by = ["alertname"]
       contact_point = grafana_contact_point.my_slack_contact_point.name
   
       group_wait = "45s"
       group_interval = "6m"
       repeat_interval = "3h"
   
       policy {
           matcher {
               label = "a"
               match = "="
               value = "b"
           }
           group_by = ["..."]
           contact_point = grafana_contact_point.a_different_contact_point.name
           mute_timings = [grafana_mute_timing.my_mute_timing.name]
   
           policy {
               matcher {
                   label = "sublabel"
                   match = "="
                   value = "subvalue"
               }
               contact_point = grafana_contact_point.a_third_contact_point.name
               group_by = ["..."]
           }
       }
   }
   ```

1. mute\$1timings 필드에서 음소거 타이밍을 알림 정책에 연결하세요.

1. `terraform apply` 명령을 실행합니다.

1. Grafana UI로 이동하여 알림 정책의 세부 정보를 확인하세요.
**참고**  
UI를 통해 Terraform에서 프로비저닝된 리소스를 편집할 수 없습니다. 그러면 알림 스택이 항상 코드와 동기화됩니다.

1. **테스트**를 클릭하여 알림 포인트가 올바르게 작동하는지 확인하세요.

## 프로비저닝 음소거 타이밍
<a name="v9-alerting-setup-provision-tf-mutetiming"></a>

음소거 타이밍은 정의된 기간에 알림 메시지를 음소거할 수 있는 기능을 제공합니다.

**음소거 타이밍을 프로비저닝하는 방법**

1. 이 코드 블록을 로컬 시스템의 .tf 파일로 복사하세요.

   이 예제에서는 주말에 알림 전달이 음소거됩니다.

   ```
   resource "grafana_mute_timing" "my_mute_timing" {
       name = "My Mute Timing"
   
       intervals {
           times {
             start = "04:56"
             end = "14:17"
           }
           weekdays = ["saturday", "sunday", "tuesday:thursday"]
           months = ["january:march", "12"]
           years = ["2025:2027"]
       }
   }
   ```

1. `terraform apply` 명령을 실행합니다.

1. Grafana UI로 이동하여 음소거 타이밍의 세부 정보를 확인하세요.

1. `mute_timings` 필드를 사용하여 알림 정책에서 새로 생성된 음소거 타이밍을 참조하세요. 그러면 일부 또는 모든 알림에 음소거 시간이 적용됩니다.
**참고**  
UI를 통해 Terraform에서 프로비저닝된 리소스를 편집할 수 없습니다. 그러면 알림 스택이 항상 코드와 동기화됩니다.

1. **테스트**를 클릭하여 음소거 타이밍이 올바르게 작동하는지 확인하세요.

## 알림 규칙 프로비저닝
<a name="v9-alerting-setup-provision-tf-rules"></a>

[알림 규칙](v9-alerting-managerules.md)을 사용하면 Grafana 데이터 소스에 대해 경고할 수 있습니다. 이미 구성한 데이터 소스일 수도 있습니다. 아니면 알림 규칙과 함께 [Terraform에서 데이터 소스를 정의](https://registry.terraform.io/providers/grafana/grafana/latest/docs/resources/data_source)할 수도 있습니다.

**알림 규칙을 프로비저닝하는 방법**

1. 쿼리할 데이터 소스와 규칙을 저장할 폴더를 생성하세요.

   이 예제에서 [테스트를 위한 TestData 데이터 소스 구성](testdata-data-source.md) 데이터 소스가 사용됩니다.

   Grafana의 모든 백엔드 데이터 소스에 대해 알림을 정의할 수 있습니다.

   ```
   resource "grafana_data_source" "testdata_datasource" {
       name = "TestData"
       type = "testdata"
   }
   
   resource "grafana_folder" "rule_folder" {
       title = "My Rule Folder"
   }
   ```

1. 알림 규칙을 정의하세요.

   알림 규칙에 대한 자세한 내용은 [how to create Grafana-managed alerts](https://grafana.com/blog/2022/08/01/grafana-alerting-video-how-to-create-alerts-in-grafana-9/)를 참조하세요.

1. 하나 이상의 규칙이 포함된 규칙 그룹을 생성하세요.

   이 예제에서 `grafana_rule_group` 리소스 그룹이 사용됩니다.

   ```
   resource "grafana_rule_group" "my_rule_group" {
       name = "My Alert Rules"
       folder_uid = grafana_folder.rule_folder.uid
       interval_seconds = 60
       org_id = 1
   
       rule {
           name = "My Random Walk Alert"
           condition = "C"
           for = "0s"
   
           // Query the datasource.
           data {
               ref_id = "A"
               relative_time_range {
                   from = 600
                   to = 0
               }
               datasource_uid = grafana_data_source.testdata_datasource.uid
               // `model` is a JSON blob that sends datasource-specific data.
               // It's different for every datasource. The alert's query is defined here.
               model = jsonencode({
                   intervalMs = 1000
                   maxDataPoints = 43200
                   refId = "A"
               })
           }
   
           // The query was configured to obtain data from the last 60 seconds. Let's alert on the average value of that series using a Reduce stage.
           data {
               datasource_uid = "__expr__"
               // You can also create a rule in the UI, then GET that rule to obtain the JSON.
               // This can be helpful when using more complex reduce expressions.
               model = <<EOT
   {"conditions":[{"evaluator":{"params":[0,0],"type":"gt"},"operator":{"type":"and"},"query":{"params":["A"]},"reducer":{"params":[],"type":"last"},"type":"avg"}],"datasource":{"name":"Expression","type":"__expr__","uid":"__expr__"},"expression":"A","hide":false,"intervalMs":1000,"maxDataPoints":43200,"reducer":"last","refId":"B","type":"reduce"}
   EOT
               ref_id = "B"
               relative_time_range {
                   from = 0
                   to = 0
               }
           }
   
           // Now, let's use a math expression as our threshold.
           // We want to alert when the value of stage "B" above exceeds 70.
           data {
               datasource_uid = "__expr__"
               ref_id = "C"
               relative_time_range {
                   from = 0
                   to = 0
               }
               model = jsonencode({
                   expression = "$B > 70"
                   type = "math"
                   refId = "C"
               })
           }
       }
   }
   ```

1. Grafana UI로 이동하여 알림 규칙을 확인하세요.

   알림 규칙이 실행 중인지 확인할 수 있습니다. 또한 각 알림 규칙의 쿼리 단계에 대한 시각화를 볼 수 있습니다.

   알림이 실행되면 Grafana에서는 사용자가 정의한 정책을 통해 알림을 라우팅합니다.

   예를 들어 Slack을 연락 지점으로 선택하면 Grafana의 임베드된 [Alertmanager](https://github.com/prometheus/alertmanager)에서 자동으로 Slack에 메시지를 게시합니다.

# Grafana에서 프로비저닝된 알림 리소스 보기
<a name="v9-alerting-setup-provision-view"></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에서 프로비저닝된 리소스를 보는 방법**

1. Grafana 인스턴스를 여세요.

1. 알림으로 이동하세요.

1. 알림 규칙과 같은 알림 리소스 폴더를 클릭하세요.

   프로비저닝된 리소스에는 **프로비저닝됨** 레이블이 지정되므로 수동으로 생성되지 않았음을 표시합니다.

**참고**  
Grafana에서는 프로비저닝된 리소스를 편집할 수 없습니다. 프로비저닝 파일을 변경하고 Grafana를 다시 시작하거나 핫 리로드를 수행하는 경우에만 리소스 속성을 변경할 수 있습니다. 이렇게 하면 파일이 다시 프로비저닝되거나 핫 리로드가 수행되는 경우 덮어쓸 리소스가 변경되는 것을 방지할 수 있습니다.

# Grafana 알림으로 클래식 대시보드 알림 마이그레이션
<a name="v9-alerting-use-grafana-alerts"></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 알림으로 전환하려면 해당 기능을 옵트인해야 합니다.

 AWS Management Console AWS CLI, 또는 Amazon Managed Grafana API를 사용하여 Grafana 알림을 사용하도록 Amazon Managed Grafana 인스턴스를 구성할 수 있습니다. Grafana 알림 켜기 또는 끄기를 포함하여 Amazon Managed Grafana를 구성하는 방법에 대한 자세한 내용은 [Amazon Managed Grafana 워크스페이스 구성](AMG-configure-workspace.md) 섹션을 참조하세요.

**참고**  
Grafana 알림 사용 시 Prometheus가 아닌 Grafana에 정의된 알림 규칙에서 여러 알림을 연락 지점으로 전송합니다. 기본 Grafana 알림을 사용하는 경우 클래식 대시보드 알림을 유지하고 새 Grafana 알림 기능을 활성화하지 않는 것이 좋습니다. Prometheus 데이터 소스에 정의된 알림을 보려면 Grafana 알림을 활성화하는 것이 좋습니다. Grafana 알림은 Prometheus Alertmanager에서 생성된 알림에 대해 단일 알림만 전송합니다.  
이 제한 사항은 Grafana v10.4 이상을 지원하는 Amazon Managed Grafana 워크스페이스에서 제거되었습니다.

## Grafana 알림 시스템으로 마이그레이션
<a name="v9-alerting-use-grafana-alerts-opt-in"></a>

Grafana 알림이 켜져 있으면 기존 클래식 대시보드 알림이 Grafana 알림과 호환되는 형식으로 마이그레이션됩니다. Grafana 인스턴스의 알림 페이지에서 마이그레이션된 알림을 새 알림과 함께 볼 수 있습니다. Grafana 알림을 사용하면 Grafana 관리형 알림 규칙이 일치할 때 단일 알림이 아닌 여러 알림을 전송합니다.

클래식 대시보드 알림 및 Grafana 알림에 대한 읽기 및 쓰기 액세스는 해당 알림을 저장하는 폴더의 권한에 의해 제어됩니다. 마이그레이션 중에 클래식 대시보드 알림 권한은 다음과 같이 새 규칙 권한과 일치합니다.
+ 원본 알림의 대시보드에 권한이 있는 경우 마이그레이션하면 원본 대시보드의 권한(폴더의 상속된 권한 포함)과 일치하도록 이 형식의 폴더(`Migrated {"dashboardUid": "UID", "panelId": 1, "alertId": 1}`)를 생성합니다.
+ 대시보드 권한이 없고 대시보드가 폴더 아래에 있는 경우 규칙은 이 폴더에 연결되어 해당 권한을 상속합니다.
+ 대시보드 권한이 없고 대시보드가 일반 폴더 아래에 있는 경우 규칙은 일반 알림 폴더에 연결되고 규칙은 기본 권한을 상속합니다.

**참고**  
Grafana 알림에는 `NoData`에 대한 `Keep Last State` 옵션이 없으므로 이 옵션은 클래식 규칙 마이그레이션 중에 `NoData`로 표시됩니다. `Error` 처리에 대한 `Keep Last State` 옵션이 새 옵션 `Error`로 마이그레이션됩니다. `Keep Last State`의 동작과 일치시키기 위해 두 경우 모두에서 마이그레이션 중에 Amazon Managed Grafana는 1년 동안 각 알림 규칙에 대해 무음을 자동으로 생성합니다.

알림 채널은 적절한 경로 및 수신기를 사용하여 Alertmanager 구성으로 마이그레이션됩니다. 기본 알림 채널은 기본 경로에 연락 지점으로 추가됩니다. 대시보드 알림과 연결되지 않은 알림 채널은 `autogen-unlinked-channel-recv` 경로로 이동합니다.

### 제한 사항
<a name="v9-alerting-use-grafana-alerts-limitations"></a>
+ Grafana 알림 시스템은 사용 가능한 모든 Prometheus, Loki 및 Alertmanager 데이터 소스에서 규칙을 검색할 수 있습니다. 지원되는 다른 데이터 소스에서 알림 규칙을 가져오지 못할 수 있습니다.
+ Grafana 알림과 클래식 대시보드 알림 사이에서 앞뒤로 마이그레이션하면 한 시스템에서 지원되는 기능에 대한 데이터가 손실될 수 있지만 다른 시스템에서는 손실되지 않을 수 있습니다.
**참고**  
클래식 대시보드 알림으로 다시 마이그레이션하면 생성된 새 알림 규칙을 포함하여 Grafana 알림이 활성화된 상태에서 수행된 구성 알림에 대한 모든 변경 사항이 사라집니다.

# 알림 규칙 관리
<a name="v9-alerting-managerules"></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 Mimir 또는 Loki 인스턴스에 대한 알림 규칙은 편집자 또는 관리자 역할을 가진 사용자가 편집하거나 삭제할 수 있습니다.

**Topics**
+ [Grafana 관리형 알림 규칙 생성](v9-alerting-managerules-grafana.md)
+ [Grafana Mimir 또는 Loki 관리형 알림 규칙 생성](v9-alerting-managerules-mimir-loki.md)
+ [Grafana Mimir 또는 Loki 관리형 기록 규칙 생성](v9-alerting-managerules-mimir-loki-recording.md)
+ [Grafana Mimir 또는 Loki 규칙 그룹 및 네임스페이스](v9-alerting-managerules-mimir-loki-groups.md)
+ [알림 규칙 보기 및 편집](v9-alerting-managerules-view-edit.md)

# Grafana 관리형 알림 규칙 생성
<a name="v9-alerting-managerules-grafana"></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는 연락 지점에 알림을 보냅니다.

**Grafana 관리형 규칙을 추가하는 방법**

1. Grafana 콘솔의 Grafana 메뉴에서 **알림**(종 모양) 아이콘을 선택하여 기존 알림을 나열하는 **알림** 페이지를 여세요.

1. **새 알림 규칙**을 선택하세요.

1. **1단계**에서 다음과 같이 규칙 이름, 유형 및 스토리지 위치를 추가하세요.
   + **규칙 이름**에 설명이 포함된 이름을 추가하세요. 이 이름은 알림 규칙 목록에 표시됩니다. 또한 이 규칙에서 생성된 모든 알림 인스턴스에 대한 `alertname` 레이블이기도 합니다.
   + **규칙 유형** 드롭다운에서 **Grafana 관리형 알림**을 선택하세요.
   + **폴더** 드롭다운에서 규칙을 저장할 폴더를 선택하세요. 폴더를 선택하지 않으면 규칙은 `General` 폴더에 저장됩니다. 폴더를 생성하려면 드롭다운을 선택하고 새 폴더 이름을 입력하세요.

1. **2단계**에서 평가할 쿼리와 표현식을 추가하세요.
   + 기본 이름을 그대로 두거나 마우스를 위로 가져가 편집 아이콘을 선택하여 이름을 변경하세요.
   + 쿼리의 경우 드롭다운에서 데이터 소스를 선택하세요.
   + 하나 이상의 [쿼리 또는 표현식](v9-panels-query-xform-expressions.md)을 추가하세요.
   + 각 표현식에 대해 **클래식 조건**을 선택하여 단일 알림 규칙을 생성하거나 **수학**, **축소**, **리샘플링** 옵션 중에서 선택하여 각 시리즈에 대해 별도의 알림을 생성하세요. 이러한 옵션에 대한 자세한 내용은 [단일 및 다차원 규칙](#v9-alerting-single-multi-rule) 섹션을 참조하세요.
   + **쿼리 실행**을 선택하여 쿼리가 성공했는지 확인하세요.

1. **3단계**에서 조건을 추가하세요.
   + **조건** 드롭다운에서 쿼리 또는 표현식을 선택하여 알림 규칙을 시작하세요.
   + **평가 간격**에서 평가 빈도를 지정합니다. 10초의 배수여야 합니다. 예, `1m`, `30s`.
   + **평가 대상**에서 알림이 시작되기 전에 조건이 true여야 하는 기간을 지정하세요.
**참고**  
조건이 위반되면 알림이 `Pending` 상태가 됩니다. 지정된 기간에 조건이 위반된 상태로 유지되면 알림이 `Firing` 상태로 전환됩니다. 더 이상 충족되지 않으면 `Normal` 상태로 돌아갑니다.
   + **데이터 없음 및 오류 처리 구성**에서 데이터가 없는 경우 알림 동작을 구성하세요. [데이터 없음 또는 오류 사례 처리](#v9-alerting-rule-no-data-error)의 지침을 사용하세요.
   + **미리 보기**를 선택하여 현재 쿼리 실행 결과를 확인하세요. 미리 보기에서는 데이터 없음 및 오류 처리 조건이 제외됩니다.

1. **4단계**에서 규칙과 연결된 메타데이터를 추가하세요.
   + 설명과 요약을 추가하여 알림 메시지를 사용자 지정하세요. [레이블 및 주석](v9-alerting-explore-labels.md)의 지침을 사용하세요.
   + 런북 URL, 패널, 대시보드 및 알림 ID를 추가하세요.
   + 사용자 지정 레이블을 추가하세요.

1. **저장**을 선택하여 규칙을 저장하거나 **저장 및 종료**를 선택하여 규칙을 저장하고 **알림** 페이지로 돌아가세요.

규칙을 생성한 후 규칙에 대한 알림을 생성할 수 있습니다. 알림에 대한 자세한 내용은 [알림 전달 관리](v9-alerting-managenotifications.md) 섹션을 참조하세요.

## 단일 및 다차원 규칙
<a name="v9-alerting-single-multi-rule"></a>

Grafana 관리형 알림 규칙의 경우 클래식 조건의 규칙을 생성하거나 다차원 규칙을 생성할 수 있습니다.

**단일 차원 규칙(클래식 조건)**

클래식 조건 표현식을 사용하여 조건이 충족될 때 단일 알림을 시작하는 규칙을 생성합니다. 여러 시리즈를 반환하는 쿼리의 경우 Grafana에서는 각 시리즈의 알림 상태를 추적하지 않습니다. 따라서 Grafana는 여러 시리즈에 대한 알림 조건이 충족되더라도 단일 알림만 전송합니다.

표현식을 포맷하는 방법에 대한 자세한 내용은 *Grafana 설명서*의 [Expressions](https://grafana.com/docs/grafana/next/panels/query-a-data-source/)를 참조하세요.

**다차원 규칙**

쿼리에서 반환된 각 시리즈에 대해 별도의 알림 인스턴스를 생성하려면 다차원 규칙을 생성합니다.

**참고**  
다차원 규칙에 의해 생성된 각 알림 인스턴스는 총 알림 할당량에 포함됩니다. 알림 할당량에 도달하면 규칙이 평가되지 않습니다. 다차원 규칙의 할당량에 대한 자세한 내용은 [할당량에 도달함 오류](#v9-alerting-rule-quota-reached) 섹션을 참조하세요.

단일 규칙에서 여러 인스턴스를 생성하려면 `Math`, `Reduce` 또는 `Resample` 표현식을 사용하여 다차원 규칙을 생성합니다. 예를 들어, 다음을 수행할 수 있습니다.
+ 각 쿼리에 `Reduce` 표현식을 추가하여 선택한 시간 범위의 값을 단일 값으로 집계합니다. ([숫자 데이터를 사용하는 규칙](v9-alerting-explore-numeric.md)에는 필요하지 않습니다.)
+ 규칙의 조건에 `Math` 표현식을 추가합니다. 쿼리 또는 축소 표현식에서 규칙이 알림을 시작하지 않아야 하는 경우 0 또는 알림을 시작해야 하는 경우 양수를 이미 반환하는 경우 필요하지 않습니다.

  다음은 몇 가지 예제입니다.
  + `$B > 70`: B 쿼리/표현식 값이 70을 초과하는 경우 알림을 시작해야 하는지 여부.
  + `$B < $C * 100`: B 값이 C 값에 100을 곱한 값보다 작은 경우 알림을 시작해야 하는 경우. 비교 중인 쿼리의 결과에 여러 시리즈가 있는 경우 레이블이 같거나 한 쿼리가 다른 쿼리의 하위 세트인 경우 서로 다른 쿼리의 시리즈가 일치합니다.

**참고**  
Grafana에서는 템플릿 변수가 있는 알림 쿼리를 지원하지 않습니다. 자세한 내용은 커뮤니티 페이지([Template variables are not supported in alert queries while setting up Alert](https://community.grafana.com/t/template-variables-are-not-supported-in-alert-queries-while-setting-up-alert/2514))에서 확인할 수 있습니다.



**다차원 규칙에 대한 성능 고려 사항**

각 알림 인스턴스는 알림 할당량에 포함됩니다. 알림 할당량 내에서 수용할 수 있는 것보다 많은 인스턴스를 생성하는 다차원 규칙은 평가되지 않으며 할당량 오류를 반환합니다. 자세한 내용은 [할당량에 도달함 오류](#v9-alerting-rule-quota-reached) 단원을 참조하십시오.

다차원 알림은 Grafana에서 알림 규칙을 평가하기 위해 쿼리할 때 Grafana 워크스페이스의 성능뿐만 아니라 데이터 소스의 성능에도 큰 영향을 미칠 수 있습니다. 다음 고려 사항은 모니터링 시스템의 성능을 최적화하는 데 도움이 될 수 있습니다.
+ **규칙 평가 빈도** - 알림 규칙의 **평가 간격** 속성은 규칙 평가 빈도를 제어합니다. 허용되는 최조 평가 빈도를 사용하는 것이 좋습니다.
+ **결과 세트 카디널리티** - 규칙으로 생성한 알림 인스턴스 수가 성능에 영향을 미칩니다. 플릿의 모든 VM에서 모든 API 경로에 대한 API 응답 오류를 모니터링한다고 가정합니다 이 세트에는 경로 수에 VM 수를 곱한 카디널리티가 있습니다. 예를 들어, VM당 경로 기준 대신 VM당 총 오류 수를 모니터링하여 결과 세트의 카디널리티를 줄일 수 있습니다.
+ **쿼리의 복잡성** - 데이터 소스가 처리 및 응답하여 리소스를 빠르게 소비할 수 있는 쿼리. 이 고려 사항은 위에 나열된 다른 고려 사항보다 덜 중요하지만, 최대한 줄이면 개별 쿼리 성능을 살펴볼 때 차이가 나타날 수 있습니다. 또한 이러한 규칙의 평가가 데이터 소스에 미치는 성능 영향도 알고 있어야 합니다. 알림 쿼리는 데이터베이스 모니터링으로 처리되는 대부분의 쿼리이므로 Grafana 인스턴스에 영향을 미치는 동일한 부하 인자도 이에 영향을 미칩니다.

## 할당량에 도달함 오류
<a name="v9-alerting-rule-quota-reached"></a>

단일 워크스페이스에 있을 수 있는 알림 인스턴스 수에 대한 할당량이 있습니다. 해당 숫자에 도달하면 해당 워크스페이스에서 더 이상 새 알림 규칙을 생성할 수 없습니다. 다차원 알림의 경우 알림 인스턴스 수는 시간이 지남에 따라 달라질 수 있습니다.

다음은 알림 인스턴스로 작업할 때 명심해야 할 중요한 사항입니다.
+ 단일 차원 규칙만 생성하는 경우 각 규칙은 단일 알림 인스턴스입니다. 단일 워크스페이스에서 알림 인스턴스 할당량과 동일한 수의 규칙을 생성할 수 있으며 그 이상은 생성할 수 없습니다.
+ 다차원 규칙은 여러 개의 알림 인스턴스를 생성하지만, 해당 인스턴스가 평가될 때까지 수를 알 수 없습니다. 예를 들어 Amazon EC2 인스턴스의 CPU 사용량을 추적하는 알림 규칙을 생성하는 경우 생성할 때 EC2 인스턴스가 50개(따라서 알림 인스턴스 50개)일 수 있지만 일주일 후에 EC2 인스턴스를 10개 더 추가하는 경우 다음 평가에서 알림 인스턴스는 60개입니다.

  알림 인스턴스 수는 다차원 경고를 생성할 때 평가되며, 알림 인스턴스 할당량을 즉시 초과하는 알림은 생성할 수 없습니다. 알림 인스턴스 수는 변경될 수 있으므로 규칙이 평가될 때마다 할당량이 확인됩니다.
+ 규칙 평가 시 규칙으로 인해 알림 인스턴스의 할당량을 초과하면 총 알림 인스턴스 수를 서비스 할당량 미만으로 가져오는 알림 규칙을 업데이트할 때까지 해당 규칙이 평가되지 않습니다. 이 경우 할당량에 도달했음을 알리는 알림 전달을 수신합니다(알림은 평가 중인 규칙에 대한 알림 정책을 사용함). 알림에는 값이 `QuotaReachedError`인 `Error` 주석이 포함됩니다.
+ `QuotaReachedError`로 평가를 중지하는 규칙. 평가는 업데이트가 수행되고 업데이트 후 평가 자체로 인해 `QuotaReachedError`가 발생하지 않는 경우에만 재개됩니다. 평가되지 않는 규칙은 Grafana 콘솔에서 **할당량에 도달함** 오류를 표시합니다.
+ 알림 규칙을 제거하거나 다차원 알림을 편집하여 알림 인스턴스 수를 줄일 수 있습니다(예: VM의 API당 오류에 대한 하나의 알림이 아니라 VM당 오류에 대한 하나의 알림 생성).
+ 평가를 재개하려면 알림을 업데이트하고 저장합니다. 이를 업데이트하여 알림 인스턴스 수를 줄이거나 다른 변경 사항을 적용하여 알림 인스턴스 수를 줄인 경우 변경 없이 저장할 수 있습니다. 재개할 수 있는 경우 재개합니다. 다른 `QuotaReachedError`가 발생하면 저장할 수 없습니다.
+ 알림 할당량을 초과하지 않고 알림이 저장되고 평가를 재개하면 **할당량에 도달함** 오류가 Grafana 콘솔에 일정 시간 동안(평가 간격까지) 계속 표시될 수 있지만, 규칙 임계치가 충족되면 알림 규칙 평가가 시작되고 알림이 전송됩니다.
+ 알림 할당량 및 기타 할당량에 대한 자세한 내용은 [Amazon Managed Grafana 서비스 할당량](AMG_quotas.md) 섹션을 참조하세요.

## 데이터 없음 또는 오류 사례 처리
<a name="v9-alerting-rule-no-data-error"></a>

데이터가 없거나 오류가 있을 때 알림 동작을 처리하는 방법에 대한 옵션을 선택합니다.

데이터 없음 처리를 위한 옵션은 다음 표에 나열되어 있습니다.


| 데이터 없음 옵션 | 동작 | 
| --- | --- | 
|  데이터 없음  |  알림 규칙의 이름과 UID, 레이블로 데이터를 반환하지 않은 데이터 소스의 UID를 사용하여 `DatasourceNoData` 알림을 생성합니다.  | 
|  알림  |  알림 규칙 상태를 `Alerting` 상태로 설정합니다.  | 
|  정상  |  알림 규칙 상태를 `Normal` 상태로 설정합니다.  | 

오류 사례 처리 옵션은 다음 표에 나와 있습니다.


| 오류 또는 제한 시간 옵션 | 동작 | 
| --- | --- | 
|  알림  |  알림 규칙 상태를 `Alerting` 상태로 설정  | 
|  정상  |  알림 규칙 상태를 `Normal` 상태로 설정  | 
|  오류  |  알림 규칙의 이름과 UID, 레이블로 데이터를 반환하지 않은 데이터 소스의 UID를 사용하여 `DatasourceError` 알림을 생성합니다.  | 

# Grafana Mimir 또는 Loki 관리형 알림 규칙 생성
<a name="v9-alerting-managerules-mimir-loki"></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 Mimir 또는 Loki 인스턴스에 대한 알림 규칙을 생성할 수 있습니다.

**참고**  
Grafana Mimir는 Amazon Managed Service for Prometheus 및 Prometheus 데이터 소스에 연결할 수 있습니다.

**사전 조건**
+ Prometheus 데이터 소스에 대한 쓰기 권한이 있는지 확인합니다. 그렇지 않으면 Cortex 관리형 알림 규칙을 생성하거나 업데이트할 수 없습니다.
+ Grafana Mimir 및 Loki 데이터 소스의 경우 해당 서비스를 구성하여 눈금자 API를 활성화합니다.
  + **Loki** - Loki 데이터 소스의 기본값인 `local` 규칙 스토리지 유형은 규칙 보기만 지원합니다. 규칙을 편집하려면 다른 스토리지 유형 중 하나를 구성합니다.
  + **Grafana Mimir** - `/prometheus`가 아닌 레거시 `/api/prom` 접두사를 사용합니다. Prometheus 데이터 소스는 Grafana Mimir 및 Prometheus를 모두 지원하며 Grafana는 쿼리 API 및 눈금자 API가 모두 동일한 URL에 있을 것으로 예상합니다. 눈금자 API에 별도의 URL을 제공할 수 없습니다.

**참고**  
특정 Loki 또는 Prometheus 데이터 소스에 대한 알림 규칙을 관리하지 않으려면 해당 설정으로 이동하여 **알림 UI를 통해 알림 관리** 확인란의 선택을 취소합니다.

**Grafana Mimir 또는 Loki 관리형 알림 규칙을 추가하는 방법**

1. Grafana 콘솔의 Grafana 메뉴에서 **알림**(종 모양) 아이콘을 선택하여 기존 알림을 나열하는 **알림** 페이지를 여세요.

1. **알림 규칙 생성**을 선택하세요.

1. **1단계**에서 다음과 같이 규칙 유형과 세부 정보를 선택하세요.
   + **Mimir 또는 Loki 알림**을 선택하세요.
   + **규칙 이름**에 설명이 포함된 이름을 추가하세요. 이 이름은 알림 규칙 목록에 표시됩니다. 또한 이 규칙에서 생성된 모든 알림 인스턴스에 대한 `alertname` 레이블이기도 합니다.
   + **데이터 소스 선택** 드롭다운에서 Prometheus 또는 Loki 데이터 소스를 선택하세요.
   + **네임스페이스** 드롭다운에서 기존 규칙 네임스페이스를 선택하세요. 그렇지 않으면 **새로 추가**를 선택하고 이름을 입력하여 이름을 생성하세요. 네임스페이스에는 하나 이상의 규칙 그룹이 포함될 수 있으며 조직의 목적만 있을 수 있습니다. 자세한 내용은 [Cortex 또는 Loki 규칙 그룹 및 네임스페이스](alert-rules.md#alert-rule-groups) 단원을 참조하십시오.
   + **그룹** 드롭다운에서 선택한 네임스페이스 내에서 기존 그룹을 선택하세요. 그렇지 않으면 **새로 추가**를 선택하고 이름을 입력하여 이름을 생성하세요. 새로 생성된 규칙은 그룹 끝에 추가됩니다. 그룹 내 규칙은 동일한 평가 시간으로 일정한 간격에 따라 순차적으로 실행됩니다.

1. **2단계**에서 평가할 쿼리를 추가하세요.

   값은 PromQL 또는 LogQL 표현식일 수 있습니다. 평가 결과에 값이 0보다 큰 시리즈가 하나 이상 있는 경우 규칙은 알림을 시작합니다. 각 시리즈에 대한 알림이 생성됩니다.

1. **3단계**에서 알림 평가 간격을 지정하세요.

   조건의 **기간** 텍스트 상자에 알림이 시작되기 전 조건이 true여야 하는 기간을 지정하세요. `5m`을 지정하는 경우 알림이 시작되기 전에 5분 동안 조건이 true여야 합니다.
**참고**  
조건이 충족되면 알림이 `Pending` 상태가 됩니다. 지정된 기간에 조건이 활성 상태로 유지되면 알림이 `Firing` 상태로 전환됩니다. 더 이상 충족되지 않으면 `Normal` 상태로 돌아갑니다.

1. **4단계**에서 규칙과 연결된 메타데이터를 추가하세요.
   + 설명과 요약을 추가하여 알림 메시지를 사용자 지정하세요. [레이블 및 주석](v9-alerting-explore-labels.md)의 지침을 사용하세요.
   + 런북 URL, 패널, 대시보드 및 알림 ID를 추가하세요.
   + 사용자 지정 레이블을 추가하세요.

1. **알림 미리 보기**를 선택하여 규칙을 평가하고 어떤 알림을 생성할지 확인하세요. 각 알림의 상태 및 값과 함께 알림 목록을 표시합니다.

1. **저장**을 선택하여 규칙을 저장하거나 **저장 및 종료**를 선택하여 규칙을 저장하고 **알림** 페이지로 돌아가세요.

규칙을 생성한 후 규칙에 대한 알림을 생성할 수 있습니다. 알림에 대한 자세한 내용은 [알림 전달 관리](v9-alerting-managenotifications.md) 섹션을 참조하세요.

# Grafana Mimir 또는 Loki 관리형 기록 규칙 생성
<a name="v9-alerting-managerules-mimir-loki-recording"></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 Mimir 또는 Loki 인스턴스에 대한 기록 규칙을 생성 및 관리할 수 있습니다. 기록 규칙을 사용하면 자주 필요하거나 계산 비용이 많이 드는 표현식을 미리 계산하고, 해당 결과를 새로운 시계열 세트로 저장합니다. 이 새 시계열을 쿼리하는 것이 더 빠릅니다. 특히 대시보드를 새로 고칠 때마다 동일한 표현식을 쿼리하기 때문에 대시보드의 경우 더 빠릅니다.

**사전 조건**

Grafana Mimir 및 Loki 데이터 소스의 경우 해당 서비스를 구성하여 눈금자 API를 활성화합니다.
+ **Loki** - Loki 데이터 소스의 기본값인 `local` 규칙 스토리지 유형은 규칙 보기만 지원합니다. 규칙을 편집하려면 다른 스토리지 유형 중 하나를 구성합니다.
+ **Grafana Mimir** - Grafana Mimir를 가리키도록 데이터 소스를 구성할 때는 `/prometheus`가 아닌 레거시 `/api/prom` 접두사를 사용합니다. Prometheus 데이터 소스는 Grafana Mimir 및 Prometheus를 모두 지원하며 Grafana는 쿼리 API 및 눈금자 API가 모두 동일한 URL에 있을 것으로 예상합니다. 눈금자 API에 별도의 URL을 제공할 수 없습니다.

**참고**  
특정 Loki 또는 Prometheus 데이터 소스에 대한 알림 규칙을 관리하지 않으려면 해당 설정으로 이동하여 **알림 UI를 통해 알림 관리** 확인란의 선택을 취소합니다.

**Grafana Mimir 또는 Loki 관리형 기록 규칙을 추가하는 방법**

1. Grafana 콘솔의 Grafana 메뉴에서 **알림**(종 모양) 아이콘을 선택하여 기존 알림을 나열하는 **알림** 페이지를 여세요.

1. **알림 규칙 생성**을 선택하세요.

1. **1단계**에서 다음과 같이 규칙 유형, 규칙 이름 및 스토리지 위치를 추가하세요.
   + **Mimir 또는 Loki 기록 규칙** 옵션을 선택하세요.
   + **규칙 이름**에 설명이 포함된 이름을 추가하세요. 이 이름은 알림 규칙 목록에 표시됩니다. 또한 이 규칙에서 생성된 모든 알림 인스턴스에 대한 `alertname` 레이블이기도 합니다.
   + **데이터 소스 선택** 드롭다운에서 Prometheus 또는 Loki 데이터 소스를 선택하세요.
   + **네임스페이스** 드롭다운에서 기존 규칙 네임스페이스를 선택하세요. 그렇지 않으면 **새로 추가**를 선택하고 이름을 입력하여 이름을 생성하세요. 네임스페이스에는 하나 이상의 규칙 그룹이 포함될 수 있으며 조직의 목적만 있을 수 있습니다. 자세한 내용은 [Cortex 또는 Loki 규칙 그룹 및 네임스페이스](alert-rules.md#alert-rule-groups) 단원을 참조하십시오.
   + **그룹** 드롭다운에서 선택한 네임스페이스 내에서 기존 그룹을 선택하세요. 그렇지 않으면 **새로 추가**를 선택하고 이름을 입력하여 이름을 생성하세요. 새로 생성된 규칙은 그룹 끝에 추가됩니다. 그룹 내 규칙은 동일한 평가 시간으로 일정한 간격에 따라 순차적으로 실행됩니다.

1. **2단계**에서 평가할 쿼리를 추가하세요.

   값은 PromQL 또는 LogQL 표현식일 수 있습니다. 평가 결과에 값이 0보다 큰 시리즈가 하나 이상 있는 경우 규칙은 알림을 시작합니다. 각 시리즈에 대한 알림이 생성됩니다.

1. **3단계**에서 규칙과 연결된 메타데이터를 추가하세요.
   + 설명과 요약을 추가하여 알림 메시지를 사용자 지정하세요. [알림 규칙에 대한 주석 및 레이블](alert-rules.md#alert-rule-labels)의 지침을 사용하세요.
   + 런북 URL, 패널, 대시보드 및 알림 ID를 추가하세요.
   + 사용자 지정 레이블을 추가하세요.

1. **저장**을 선택하여 규칙을 저장하거나 **저장 및 종료**를 선택하여 규칙을 저장하고 **알림** 페이지로 돌아가세요.

# Grafana Mimir 또는 Loki 규칙 그룹 및 네임스페이스
<a name="v9-alerting-managerules-mimir-loki-groups"></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분입니다. Grafana Mimir 또는 Loki 네임스페이스 및 규칙 그룹의 이름을 바꾸고 규칙 그룹 평가 간격을 편집할 수 있습니다.

**규칙 그룹 네임스페이스를 편집하는 방법**

1. Grafana 콘솔의 Grafana 메뉴에서 **알림**(종 모양) 아이콘을 선택하여 **알림** 페이지를 여세요.

1. 편집하려는 규칙 그룹 또는 네임스페이스 내 규칙으로 이동하세요.

1. **편집**(펜) 아이콘을 선택하세요.

1. 규칙 그룹 또는 네임스페이스를 변경하세요.
**참고**  
네임스페이스의 경우 이름만 편집할 수 있습니다. 규칙 그룹의 경우 이름 또는 그룹의 규칙에 대한 평가 간격을 변경하세요. 예를 들어 `1m`을 선택하여 규칙을 분당 1회 평가하거나 `30s`를 선택하여 30초마다 1회 평가할 수 있습니다.

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

# 알림 규칙 보기 및 편집
<a name="v9-alerting-managerules-view-edit"></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에서 관리하는 규칙이 나열되고 **Cortex/Loki** 섹션에는 Prometheus 호환 데이터 소스에 대한 규칙이 나열됩니다. Prometheus 호환 데이터 소스에 대한 알림 규칙은 볼 수 있지만 편집할 수 없습니다.

Mimir/Cortex/Loki 규칙 섹션에는 Mimir, Cortex 또는 Loki 데이터 소스에 대한 모든 규칙이 나열됩니다. 클라우드 알림 규칙도 이 섹션에 나열되어 있습니다.

대량의 알림을 관리할 때 확장 알림 규칙 검색 기능을 사용하여 폴더, 평가 그룹 및 규칙을 필터링할 수 있습니다. 또한 레이블, 상태 조건, 유형 및 상태와 같은 속성별로 알림 규칙을 필터링할 수 있습니다.

**참고**  
프로비저닝된 알림에 대한 쿼리 정의를 볼 수 있지만 편집할 수는 없습니다. 이를 볼 수 있으면 규칙 정의를 위해 프로비저닝 리포지토리로 돌아가지 않고도 쿼리 및 규칙 정의가 올바른지 확인할 수 있습니다.

## 알림 규칙 보기
<a name="v9-alerting-managerules-view"></a>

Grafana 알림을 사용하면 한 페이지에서 모든 알림을 볼 수 있습니다.

**알림 세부 정보를 보는 방법**

1. Grafana 콘솔의 Grafana 메뉴에서 **알림**(종 모양) 아이콘을 선택하여 **알림** 페이지를 여세요. 기본적으로 규칙은 데이터 소스 유형별 그룹으로 표시됩니다. 각 알림의 현재 상태를 기준으로 볼 수도 있습니다(다음 텍스트에 자세히 설명함).

1. **보기 형식**에서 원하는 옵션을 선택하여 그룹 보기와 상태 보기 사이를 전환할 수 있습니다.

1. 해당 행에 대한 자세한 내용을 확인하려면 행 옆의 화살표를 선택합니다. 규칙의 세부 정보에는 규칙 레이블, 주석, 데이터 소스 및 쿼리와 규칙에서 생성되는 알림 인스턴스 목록이 포함됩니다.

**참고**  
알림의 세부 정보를 이해하는 방법에 대한 자세한 내용은 [알림 규칙의 상태 조건 및 상태](v9-alerting-explore-state.md) 섹션을 참조하세요.

**그룹 보기**

그룹 보기에는 폴더별로 그룹화된 Grafana 알림 규칙과 `namespace` \$1 `group`으로 그룹화된 Loki 또는 Prometheus 알림 규칙이 표시됩니다. 이는 규칙 관리를 위한 기본 규칙 목록 보기입니다. 각 그룹을 확장하여 이 그룹의 규칙 목록을 볼 수 있습니다. 규칙을 더 확장하여 세부 정보를 확인합니다. 규칙에서 생성되는 알림 및 작업 버튼을 확장하여 세부 정보를 볼 수도 있습니다.

**상태 보기**

상태 보기에는 상태별로 그룹화된 알림 규칙이 표시됩니다. 이 보기를 사용하여 어떤 규칙이 어떤 상태에 있는지에 대한 개요를 확인합니다. 각 규칙을 확장하여 세부 정보를 볼 수 있습니다. 작업 버튼 및 이 규칙에서 생성된 모든 알림과 각 알림을 추가로 확장하여 세부 정보를 볼 수 있습니다.

**알림 규칙 필터링**

알림 페이지에 표시되는 **알림** 규칙을 여러 가지 방법으로 필터링할 수 있습니다.
+ **데이터 소스 선택**을 선택하고 필터링할 데이터 소스를 선택하여 특정 데이터 소스를 쿼리하는 규칙을 표시하도록 필터링할 수 있습니다.
+ **레이블별 검색**에서 검색 기준을 선택하여 레이블별로 필터링할 수 있습니다. 예를 들어 미국 및 EU에서 프로덕션 경고를 필터링`environment=production,region=~US|EU,severity!=warning`하도록 를 입력할 수 있습니다.
+ **상태별 알림 필터링**을 선택하고 보려는 상태를 선택하여 특정 상태의 규칙을 표시하도록 필터링할 수 있습니다

## 알림 규칙 편집 또는 삭제
<a name="v9-alerting-managerules-edit"></a>

Grafana 관리형 알림 규칙은 규칙을 저장하는 폴더에 대한 편집 권한이 있는 사용자만 편집하거나 삭제할 수 있습니다. 외부 Mimir 또는 Loki 인스턴스에 대한 알림 규칙은 편집자 또는 관리자 역할의 사용자가 편집하거나 삭제할 수 있습니다.

**규칙을 편집하거나 삭제하는 방법**

1. **보기**, **편집** 및 **삭제**에 대한 규칙 제어가 표시될 때까지 규칙을 확장하세요.

1. **편집**을 선택하여 규칙 생성 페이지를 여세요. 규칙을 생성하는 것과 동일한 방식으로 업데이트하세요. 자세한 내용은 [Grafana 관리형 알림 규칙 생성](v9-alerting-managerules-grafana.md) 또는 [Grafana Mimir 또는 Loki 관리형 알림 규칙 생성](v9-alerting-managerules-mimir-loki.md)의 지침을 참조하세요.

1. 선택적으로 **삭제**를 선택하여 규칙을 삭제하세요.

## 알림 규칙 내보내기
<a name="v9-alerting-managerules-export"></a>

**내보내기**를 선택하여 Grafana 워크스페이스에서 규칙을 YAML 또는 JSON으로 내보낼 수 있습니다. 새 규칙을 정의하고 내보낼 수 있는 옵션이 제공됩니다. UI를 사용하여 규칙을 생성한 다음, 프로비저닝 API 또는 Terraform 스크립트에 사용할 수 있도록 내보낼 수 있습니다.

**참고**  
이 기능은 Grafana 워크스페이스와 프로비저닝 인터페이스 모두에서 지원됩니다.

# 알림 전달 관리
<a name="v9-alerting-managenotifications"></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) 섹션을 참조하세요.

알림 전달을 보내는 방법, 시간 및 위치를 선택하는 것은 알림 시스템 설정의 중요한 부분입니다. 이러한 결정은 문제를 빠르게 해결하고 중요한 부분을 놓치지 않는 역량에 직접적인 영향을 미칩니다.

첫 번째 단계로 알림 전달을 보낼 *연락 지점*을 정의하세요. 연락 지점은 일치하는 알림의 대상 세트일 수 있습니다. 알림에서 재사용 및 일관된 메시징을 위해 알림 템플릿을 연락 지점에 추가하세요.

그런 다음, *알림 정책*을 생성하세요. 이 정책은 알림이 연락 지점로 라우팅되는 위치, 시간 및 방법에 대한 규칙 세트입니다. 알림 정책에서 생성한 연락 지점 중 하나를 선택하여 알림 전달을 보낼 위치를 정의합니다. 알림 정책에 음소거 타이밍을 추가하세요. *음소거 타이밍*은 알림을 전송하지 않으려는 반복 시간 간격입니다.

알림 규칙이 평가되면 알림 눈금자는 알림 인스턴스를 Alertmanager로 전송합니다. 하나의 알림 규칙이 여러 개별 *알림 인스턴스*를 트리거할 수 있습니다.

Alertmanager는 이러한 알림 인스턴스를 수신한 다음, 음소거 타이밍을 처리하고 알림을 그룹화하며 알림 정책에 정의된 대로 연락 지점에 알림을 보냅니다.

**Topics**
+ [Alertmanager](v9-alerting-managenotifications-alertmanager.md)
+ [연락 지점 작업](v9-alerting-contact-points.md)
+ [알림 정책 작업](v9-alerting-notification-policies.md)
+ [알림 사용자 지정](v9-alerting-notifications.md)
+ [Prometheus 데이터 소스에 대한 알림 전달 무음 처리](v9-alerting-silences.md)
+ [음소거 타이밍](v9-alerting-notification-muting.md)
+ [알림 그룹별 보기 및 필터링](v9-alerting-viewfiltergroups.md)
+ [알림 오류 보기](v9-alerting-viewnotificationerrors.md)

# Alertmanager
<a name="v9-alerting-managenotifications-alertmanager"></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) 섹션을 참조하세요.

Alertmanager를 사용하면 알림을 빠르고 효율적으로 관리하며 대응할 수 있습니다. 이메일 또는 Slack과 같이 선택한 채널을 통해 알림을 보내 알림을 수신하고, 음소거, 억제, 그룹화 및 라우팅을 처리합니다.

Grafana에서는 Grafana Alertmanager 또는 외부 Alertmanager를 사용할 수 있습니다. 또한 여러 Alertmanager를 실행할 수 있습니다. 결정은 설정 및 알림이 생성되는 위치에 따라 달라집니다.

**Grafana Alertmanager**

Grafana Alertmanager는 Grafana 온프레미스 또는 오픈 소스를 실행하는 경우 사전 구성되고 기본적으로 선택할 수 있는 내부 Alertmanager입니다.

Grafana Alertmanager는 Grafana로부터 알림을 수신할 수 있지만 Mimir 또는 Loki와 같은 Grafana 외부에서 알림을 수신할 수는 없습니다.

**참고**  
Grafana Alertmanager에서는 금지 규칙이 지원되지 않습니다.

**외부 Alertmanager**

단일 Alertmanager를 사용하여 모든 Grafana, Loki, Mimir 및 Prometheus 알림을 수신하려면 외부 Alertmanager를 사용하도록 Grafana를 설정할 수 있습니다. Grafana 자체 내에서 이 외부 Alertmanager를 구성하고 관리할 수 있습니다.

다음은 Grafana Alertmanager 대신 자체 외부 Alertmanager를 구성하고 알림을 보낼 수 있는 두 가지 예제입니다.

1. Prometheus와 같은 다른 알림 생성기가 있기 때문에 자체 클라우드 인프라에 이미 설정한 온프레미스 Alertmanager를 보유하고 있으며, 계속 사용하려고 합니다.

1. Prometheus 온프레미스 및 호스팅 Grafana를 모두 사용하여 클라우드 인프라에서 실행되는 동일한 Alertmanager에 알림을 보내려고 합니다.

Alertmanager는 알림 연락 지점 및 알림 정책 페이지의 드롭다운 메뉴에서 볼 수 있습니다.

데이터 소스를 프로비저닝하는 경우 `jsonData` 필드에서 `handleGrafanaManagedAlerts` 플래그를 `true`로 설정하여 Grafana 관리형 알림을 이 Alertmanager로 보내세요.

# 연락 지점 작업
<a name="v9-alerting-contact-points"></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) 섹션을 참조하세요.

연락 지점을 사용하여 알림이 시작될 때 연락처로 알림을 보내는 방법을 정의합니다. 연락 지점에는 Amazon Simple Notification Service 또는 Slack과 같은 하나 이상의 연락 지점 통합이 있을 수 있습니다. 알림이 시작되면 연락 지점에 대해 나열된 모든 연락 지점 통합에 알림이 전송됩니다. 선택적으로 [알림 템플릿](v9-alerting-create-templates.md)을 통해 연락 지점 유형에 대한 알림 메시지를 사용자 지정합니다.

**참고**  
Grafana 관리형 알림에 대한 연락 지점을 생성 및 편집할 수 있습니다. Alertmanager 알림에 대한 연락 지점은 읽기 전용입니다.

## 연락 지점 작업
<a name="v9-alerting-working-contact-points"></a>

다음 절차에서는 연락 지점을 추가, 편집, 테스트 및 삭제하는 방법을 자세히 설명합니다.

**연락 지점을 추가하는 방법**

1. Grafana 콘솔의 Grafana 메뉴에서 **알림**(종 모양) 아이콘을 선택하여 **알림** 페이지를 여세요.

1. **연락 지점**, **연락 지점 추가**를 차례로 선택하세요.

1. **Alertmanager** 드롭다운에서 Alertmanager를 선택하세요. Grafana Alertmanager는 기본적으로 선택됩니다.

1. 연락 지점의 **이름**을 입력하세요.

1. **연락 지점 통합**에서 유형을 선택하고 해당 유형을 기반으로 필수 필드를 선택하세요. 예를 들어 Slack을 선택한 경우 Slack 채널과 연락을 받아야 하는 사용자를 입력하세요.

1. 선택한 연락 지점에 대해 사용할 수 있는 경우 원하는 **선택적 설정**을 선택하여 추가 설정을 지정하세요.

1. **알림 설정**에서 알림이 확인될 때 알림을 받지 않으려면 **확인된 메시지 비활성화**를 선택하세요.

1. 연락 지점에 더 많은 연락 지점 유형이 필요한 경우 **연락 지점 통합 추가**를 선택하고 필요한 각 연락 지점 유형에 대해 단계를 반복할 수 있습니다.

1. **연락 지점 저장**을 선택하여 변경 사항을 저장하세요.

**연락 지점을 편집하는 방법**

1. **연락 지점**을 선택하여 기존 연락 지점 목록을 확인하세요.

1. 편집할 연락 지점을 선택한 다음, **편집** 아이콘(펜)을 선택하세요.

1. 필요한 사항을 변경한 다음, **연락 지점 저장**을 선택하여 변경 사항을 저장하세요.

연락 지점을 생성한 후 테스트 알림을 보내 올바르게 구성되었는지 확인할 수 있습니다.

**테스트 알림을 전송하는 방법**

1. **연락 지점**을 선택하여 기존 연락 지점 목록을 여세요.

1. 테스트할 연락 지점을 선택한 다음, **편집** 아이콘(펜)을 선택하세요.

1. **테스트** 아이콘(종이 비행기)을 선택하세요.

1. 사전 정의된 테스트 알림을 보낼지 또는 **사용자 지정**을 선택하여 테스트 알림에 사용자 지정 주석과 레이블을 추가할지 선택하세요.

1. 지정된 연락 지점으로의 알림을 테스트하려면 **테스트 알림 전송**을 선택하세요.

알림 정책에서 사용하지 않는 연락 지점을 삭제할 수 있습니다.

**연락 지점을 삭제하는 방법**

1. **연락 지점**을 선택하여 기존 연락 지점 목록을 여세요.

1. 삭제할 연락 지점을 선택한 다음, **삭제** 아이콘(휴지통)을 선택하세요.

1. 확인 대화 상자에서 **예, 삭제**를 선택하세요.

**참고**  
알림 정책에서 연락 지점을 사용 중인 경우 연락 지점을 삭제하기 전에 알림 정책을 삭제하거나 다른 연락 지점을 사용하도록 편집해야 합니다.

## 지원되는 전달자 목록
<a name="v9-alerting-contactpoint-supported-notifiers"></a>


|  이름  |  Type  | 
| --- | --- | 
| Amazon SNS  |  sns  | 
|  OpsGenie  |  opsgenie  | 
| PagerDuty  |  pagerduty  | 
| Slack  |  slack  | 
|  VictorOps  |  victorops  | 

# 알림 정책 작업
<a name="v9-alerting-notification-policies"></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) 섹션을 참조하세요.

알림 정책은 알림이 연락 지점으로 라우팅되는 방법을 결정합니다. 정책은 트리 구조를 사용하며, 각 정책에는 하나 이상의 하위 정책이 있을 수 있습니다. 루트 정책을 제외한 각 정책은 특정 알림 레이블과 일치할 수도 있습니다. 각 알림은 루트 정책 및 각 하위 정책에 따라 평가됩니다. 특정 정책에 대해 `Continue matching subsequent sibling nodes` 옵션을 활성화하면 하나 이상의 일치 후에도 평가가 계속됩니다. 상위 정책의 구성 설정 및 연락 지점 정보는 하위 정책과 일치하지 않는 알림의 동작을 제어합니다. 루트 정책은 특정 정책과 일치하지 않는 모든 알림을 제어합니다.

**참고**  
Grafana 관리형 알림에 대한 알림 정책을 생성 및 편집할 수 있습니다. Alertmanager 알림에 대한 알림 정책은 읽기 전용입니다.

**알림 그룹화**

그룹화는 유사한 속성의 알림 전달을 단일 깔대기로 분류합니다. 그러면 시스템의 많은 부분이 한 번에 장애가 발생하여 많은 수의 알림이 동시에 시작될 때 보다 큰 규모의 중단 중에도 알림 전달을 제어할 수 있습니다.

**그룹화 예제**

서로 다른 환경의 데이터베이스에 연결된 서비스가 100개라고 가정합니다. 이러한 서비스는 레이블 `env=environmentname`으로 구분됩니다. 서비스가 데이터베이스에 도달할 수 있는지 여부를 모니터링하기 위한 알림 규칙이 마련되어 있습니다. 알림 규칙은 `alertname=DatabaseUnreachable`이라는 알림을 생성합니다.

서비스의 절반이 더 이상 데이터베이스에 도달할 수 없는 네트워크 파티션이 발생하면 50개의 서로 다른 알림이 시작됩니다. 이 상황에서는 영향을 받는 환경 목록이 포함된 단일 페이지 알림(50페이지가 아님)을 수신하려고 합니다.

`group_by: [alertname]`로 그룹화를 구성할 수 있습니다(서비스마다 서로 다른 `env` 레이블을 사용하지 않음). 이 구성을 마련하면 Grafana에서 이 알림 규칙의 영향을 받는 모든 환경이 포함된 단일 압축 알림을 보냅니다.

**특수 그룹**

Grafana에는 두 개의 특수 그룹이 있습니다. 기본 그룹(`group_by: null`)은 *모든* 알림을 단일 그룹으로 그룹화합니다. `...`이라는 특수 레이블을 사용하여 모든 레이블별로 알림을 그룹화하고 그룹을 효과적으로 비활성화하며 각 알림을 자체 그룹으로 보낼 수도 있습니다.

## 알림 작업
<a name="v9-alerting-notification-policies-working"></a>

다음 절차에서는 알림 정책을 생성 및 관리하는 방법을 보여줍니다.

**루트 알림 정책을 편집하는 방법**

1. Grafana 콘솔의 Grafana 메뉴에서 **알림**(종 모양) 아이콘을 선택하여 **알림** 페이지를 여세요.

1. **알림 정책**을 선택하세요.

1. **Alertmanager** 드롭다운에서 편집할 Alertmanager를 선택하세요.

1. **루트 정책** 섹션에서 **편집** 아이콘(펜)을 선택하세요.

1. **기본 연락 지점**에서 알림 규칙이 특정 정책과 일치하지 않을 때 규칙에 대한 알림을 보내야 하는 연락 지점을 업데이트하세요.

1. **그룹화 기준**에서 알림을 그룹화할 기준이 되는 레이블 또는 특수 그룹을 선택하세요.

1. **타이밍 옵션**의 다음 옵션 중에서 선택하세요.
   + **그룹 대기** - 초기 알림을 전송하기 전에 동일한 그룹의 알림을 버퍼링하기 위해 대기하는 시간. 기본값은 30초입니다.
   + **그룹 간격** - 그룹에 대한 두 알림 사이의 최소 시간 간격. 기본값은 5분입니다.
   + **반복 간격** - 그룹에 새 알림이 추가되지 않은 경우 알림을 다시 보내기 전 최소 시간 간격. 기본값은 4시간입니다.

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

**최상위 수준의 새 정책을 추가하는 방법**

1. Grafana 콘솔의 Grafana 메뉴에서 **알림**(종 모양) 아이콘을 선택하여 **알림** 페이지를 여세요.

1. **알림 정책**을 선택하세요.

1. **Alertmanager** 드롭다운에서 편집할 Alertmanager를 선택하세요.

1. **특정 라우팅** 섹션에서 **새 특정 정책**을 선택하세요.

1. **일치하는 레이블** 섹션에서 일치하는 알림 레이블을 하나 이상 추가하세요. 레이블 일치에 대한 자세한 내용은 이 주제의 뒷부분에 나와 있습니다.

1. **연락 지점**에서 알림이 이 특정 정책과 일치하는 경우 알림을 전송할 연락 지점을 추가합니다. 중첩된 정책은 이 연락 지점을 재정의합니다.

1. 선택적으로 알림이 현재 정책과 일치한 후에도 계속 형제 정책 일치를 수행하려면 **후속 형제 노드 연속 매칭**을 활성화합니다. 이 옵션을 활성화하면 동일한 알림에 대해 둘 이상의 알림을 받을 수 있습니다.

1. 선택적으로 **그룹화 재정의**를 선택하여 루트 정책과 다른 그룹화를 지정합니다.

1. 선택적으로 그룹 알림 정책의 타이밍 옵션을 재정의하려면 **일반 타이밍 재정의**를 선택하세요.

1. 변경 사항을 저장하려면 **정책 저장**을 선택합니다.

**중첩된 정책을 추가하는 방법**

1. 중첩된 정책을 생성할 특정 정책을 확장하세요.

1. **중첩된 정책 추가**를 선택하고 최상위 수준 특정 정책을 추가할 때와 같이 세부 정보를 추가하세요.

1. 변경 사항을 저장하려면 **정책 저장**을 선택합니다.

**특정 정책을 편집하는 방법**

1. **알림** 페이지에서 **알림 정책**을 선택하여 기존 정책을 나열하는 페이지를 엽니다.

1. 편집할 구성 정책을 선택하고 **편집** 아이콘(펜)을 선택하세요.

1. 최상위 수준별 정책을 추가할 때와 같이 변경하세요.

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

**정책 검색**

*레이블 매처* 또는 *연락 지점*별로 정책 트리 내에서 검색할 수 있습니다.
+ 연락 지점별로 검색하려면 **연락 지점별 검색** 필드에 연락 지점의 이름 일부 또는 전체를 입력하세요.
+ 레이블로 검색하려면 **레이블별 검색** 필드에 유효한 레이블 매처를 입력하세요. 쉼표로 구분하여 여러 매처를 입력할 수 있습니다. 예를 들어 유효한 매처 입력은 `severity=high, region=~EMEA|NA`일 수 있습니다.
**참고**  
레이블로 검색할 때 일치하는 모든 정책은 정확히 일치합니다. 부분 일치 및 정규식 스타일의 일치는 지원되지 않습니다.

**레이블 일치 작동 방식**

알림의 레이블이 정책에 지정된 모든 *일치 레이블*과 일치하는 경우 정책은 알림과 일치합니다.
+ **레이블** - 일치시킬 레이블의 이름. 알림의 레이블 이름과 정확히 일치해야 합니다.
+ **연산자** - 레이블 값을 일치 레이블 값과 비교하는 데 사용되는 연산자. 사용 가능한 연산자는 다음과 같습니다.
  + `=` 값이 제공된 문자열과 정확히 일치하는 레이블을 선택합니다.
  + `!=` 값이 제공된 문자열과 일치하지 않는 레이블을 선택합니다.
  + `=~` 값이 제공된 문자열의 정규식 해석 값과 일치하는 레이블을 선택합니다(제공된 문자열은 정규식으로 해석됨).
  + `!=` 제공된 정규식과 일치하지 않는 레이블을 선택합니다.
+ **값** - 레이블 값과 일치하는 값. 선택한 연산자에 따라 문자열 또는 정규식으로 일치할 수 있습니다.

# 알림 사용자 지정
<a name="v9-alerting-notifications"></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) 섹션을 참조하세요.

알림 템플릿을 사용하여 알림을 사용자 지정합니다.

알림 템플릿을 사용하여 알림에서 메시지의 제목, 메시지 및 형식을 변경할 수 있습니다.

알림 템플릿은 이메일 또는 Slack과 같은 특정 연락 지점 통합과 연결되지 않습니다. 그러나 서로 다른 연락 지점 통합을 위한 별도의 알림 템플릿을 생성하도록 선택할 수 있습니다.

알림 템플릿을 사용하여 다음을 수행할 수 있습니다.
+ 요약, 설명, 레이블 및 주석, 값 및 링크를 포함하여 알림에서 정보를 추가, 제거 또는 재정렬합니다.
+ 텍스트를 굵은 기울임꼴 서식으로 지정하고 줄 바꿈 추가 또는 제거

알림 템플릿을 사용하여 다음을 수행할 수 없습니다.
+ Slack 및 Microsoft Teams와 같은 인스턴트 메시징 서비스의 알림 설계 변경

**Topics**
+ [Go의 템플릿 지정 언어 사용](v9-alerting-notifications-go-templating.md)
+ [알림 템플릿 생성](v9-alerting-create-templates.md)
+ [템플릿 참조](v9-alerting-template-reference.md)

# Go의 템플릿 지정 언어 사용
<a name="v9-alerting-notifications-go-templating"></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) 섹션을 참조하세요.

알림 템플릿을 Go의 템플릿 지정 언어인 [text/template](https://pkg.go.dev/text/template)으로 작성합니다.

이 섹션에서는 Go의 템플릿 지정 언어에 대한 개요와 text/template에서 템플릿을 작성하는 방법을 제공합니다.

## 점
<a name="v9-go-dot"></a>

text/template에는 점(dot)이라는 특수 커서가 있습니다(`.`로 씀). 이 커서는 사용되는 템플릿의 위치에 따라 값이 변경되는 변수로 간주할 수 있습니다. 예를 들어 알림 템플릿의 시작 부분에서 `.`은 `ExtendedData` 객체를 참조합니다. 여기에서는 `Alerts`, `Status`, `GroupLabels`, `CommonLabels`, `CommonAnnotations`, `ExternalURL`을 포함하여 여러 필드를 포함합니다. 그러나 점은 목록의 `range`에서 사용할 때, `with`에서 사용할 때 또는 다른 템플릿에서 사용할 기능 템플릿을 작성할 때 다른 항목을 참조할 수 있습니다. [알림 템플릿 생성](v9-alerting-create-templates.md)에서 이에 대한 예제를 확인할 수 있으며, [템플릿 참조](v9-alerting-template-reference.md)에서 모든 데이터 및 함수를 확인할 수 있습니다.

## 여는 태그 및 닫는 태그
<a name="v9-go-openclosetags"></a>

text/template에서 템플릿은 템플릿이 변수를 인쇄하는지 여부와 if 문과 같이 제어 구조를 실행하는지 여부에 관계없이 `{{`로 시작하고 `}}`로 끝납니다. Jinja(변수를 인쇄할 때 `{{` 및 `}}`를 사용하고 제어 구조에서 `{%` 및 `%}`를 사용함)와 같은 다른 템플릿 지정 언어와는 다릅니다.

## 인쇄
<a name="v9-go-print"></a>

무언가의 값을 인쇄하려면 `{{` 및 `}}`를 사용합니다. 점 값, 점 필드, 함수 결과 및 [변수](#v9-go-variables) 값을 인쇄할 수 있습니다. 예를 들어 점이 `ExtendedData`를 참조하는 `Alerts` 필드를 인쇄하려면 다음과 같이 작성합니다.

```
{{ .Alerts }}
```

## 알림에 대한 반복
<a name="v9-go-iterate-alerts"></a>

알림에 대한 모든 정보가 아닌 각 알림의 레이블만 인쇄하려면 `range`를 사용하여 `ExtendedData`에서 알림을 반복할 수 있습니다.

```
{{ range .Alerts }}
{{ .Labels }}
{{ end }}
```

범위 내에서 점은 더 이상 `ExtendedData`를 참조하지 않고 `Alert`를 참조합니다. `{{ .Labels }}`를 사용하여 각 알림의 레이블을 인쇄할 수 있습니다. `{{ range .Alerts }}`에서 알림 목록의 현재 알림을 참조하도록 점을 변경하기 때문에 이러한 방식이 작동합니다. 범위가 완성되면 범위가 시작되기 전에 사용했던 값으로 점이 재설정됩니다(이 예제에서 `ExtendedData`).

```
{{ range .Alerts }}
{{ .Labels }}
{{ end }}
{{/* does not work, .Labels does not exist here */}}
{{ .Labels }}
{{/* works, cursor was reset */}}
{{ .Status }}
```

## 주석 및 레이블에 대한 반복
<a name="v9-go-iterate-labels"></a>

`The name of the label is $name, and the value is $value` 형식으로 각 알림의 레이블을 인쇄하도록 템플릿을 작성합니다. 여기서 `$name` 및 `$value`에는 각 레이블의 이름 및 값이 포함됩니다.

이전 예제와 마찬가지로 점을 사용하여 `.Alerts`에서 알림에 대해 반복합니다. 이때 점은 알림 목록에서 현재 알림을 참조합니다. 그리고 정렬된 레이블에서 두 번째 범위를 사용합니다. 이때 두 번째로 현재 레이블을 참조할 때 점이 업데이트됩니다. 두 번째 범위 내에서 `.Name` 및 `.Value`를 사용하여 각 레이블의 이름 및 값을 인쇄합니다.

```
{{ range .Alerts }}
{{ range .Labels.SortedPairs }}
The name of the label is {{ .Name }}, and the value is {{ .Value }}
{{ end }}
{{ range .Annotations.SortedPairs }}
The name of the annotation is {{ .Name }}, and the value is {{ .Value }}
{{ end }}
{{ end }}
```

## If 문
<a name="v9-go-if"></a>

템플릿에서 if 문을 사용할 수 있습니다. 예를 들어 `.Alerts`에 알림이 없는 경우 `There are no alerts`를 인쇄하려면 다음을 작성합니다.

```
{{ if .Alerts }}
There are alerts
{{ else }}
There are no alerts
{{ end }}
```

## With
<a name="v9-go-with"></a>

With는 if 문과 유사하지만, if 문과 달리 `with`에서는 with에서의 값을 참조하기 위해 점을 업데이트합니다.

```
{{ with .Alerts }}
There are {{ len . }} alert(s)
{{ else }}
There are no alerts
{{ end }}
```

## 변수
<a name="v9-go-variables"></a>

text/template의 변수는 템플릿 내에서 생성해야 합니다. 예를 들어 점의 현재 값을 사용해 `$variable` 변수를 생성하려면 다음을 작성합니다.

```
{{ $variable := . }}
```

`with` 또는 범위 내에서 `$variable`을 사용할 수 있으며, 이는 점의 현재 값이 아니라 변수가 정의된 시점에 점의 값을 참조합니다.

예를 들어 두 번째 범위에서 `{{ .Labels }}`를 사용하는 템플릿은 작성할 수 없습니다. 여기서 점은 현재 알림이 아닌 현재 레이블을 참조하기 때문입니다.

```
{{ range .Alerts }}
{{ range .Labels.SortedPairs }}
{{ .Name }} = {{ .Value }}
{{/* does not work because in the second range . is a label not an alert */}}
There are {{ len .Labels }}
{{ end }}
{{ end }}
```

첫 번째 범위와 두 번째 범위 앞에서 `$alert` 변수를 정의하여 이 문제를 해결할 수 있습니다.

```
{{ range .Alerts }}
{{ $alert := . }}
{{ range .Labels.SortedPairs }}
{{ .Name }} = {{ .Value }}
{{/* works because $alert refers to the value of dot inside the first range */}}
There are {{ len $alert.Labels }}
{{ end }}
{{ end }}
```

## 인덱스가 있는 범위
<a name="v9-go-rangeindex"></a>

범위 시작 위치에서 인덱스 및 값 변수를 정의하여 범위 내 각 알림의 인덱스를 가져올 수 있습니다.

```
{{ $num_alerts := len .Alerts }}
{{ range $index, $alert := .Alerts }}
This is alert {{ $index }} out of {{ $num_alerts }}
{{ end }}
```

## 템플릿 정의
<a name="v9-go-define"></a>

`define` 및 템플릿 이름(큰따옴표로 묶음)을 다른 템플릿 내에서 사용할 수 있는 템플릿을 정의할 수 있습니다. `__subject`, `__text_values_list`, `__text_alert_list`, `default.title`, `default.message`와 같은 기본 템플릿을 포함하여 다른 템플릿과 동일한 이름의 템플릿을 정의해서는 안 됩니다. 템플릿이 기본 템플릿과 동일한 이름으로 생성되었거나 다른 알림 템플릿의 템플릿인 경우 Grafana는 두 템플릿 중 하나를 사용할 수 있습니다. Grafana는 이름이 같은 템플릿이 두 개 이상 있는 경우 이를 금지하거나 오류 메시지를 표시하지 않습니다.

```
{{ define "print_labels" }}
{{ end }}
```

## 템플릿 임베드
<a name="v9-go-embed"></a>

`template`, 템플릿 이름(큰따옴표로 묶음), 템플릿에 전달해야 하는 커서를 사용하여 템플릿 내에서 정의된 템플릿을 임베드할 수 있습니다.

```
{{ template "print_labels" . }}
```

## 템플릿에 데이터 전달
<a name="v9-go-passdata"></a>

템플릿 내에서 점은 템플릿에 전달되는 값을 참조합니다.

예를 들어 템플릿에 실행 알림 목록이 전달되면 점에서는 해당 실행 알림 목록을 나타냅니다.

```
{{ template "print_alerts" .Alerts }}
```

템플릿에 알림에 대해 정렬된 레이블이 전달되면 점은 정렬된 레이블 목록을 참조합니다.

```
{{ template "print_labels" .SortedLabels }}
```

재사용 가능한 템플릿을 작성할 때 유용합니다. 예를 들어 모든 알림을 인쇄하려면 다음을 작성할 수 있습니다.

```
{{ template "print_alerts" .Alerts }}
```

그런 다음, 실행 알림만 인쇄하려면 다음을 작성하면 됩니다.

```
{{ template "print_alerts" .Alerts.Firing }}
```

`.Alerts` 및 `.Alerts.Firing`이 모두 알림 목록이므로 이 방식이 가능합니다.

```
{{ define "print_alerts" }}
{{ range . }}
{{ template "print_labels" .SortedLabels }}
{{ end }}
{{ end }}
```

## 설명
<a name="v9-go-comments"></a>

`{{/*` 및 `*/}}`를 사용하여 주석을 추가할 수 있습니다.

```
{{/* This is a comment */}}
```

설명에 줄 바꿈을 추가하지 못하도록 하려면 다음을 사용합니다.

```
{{- /* This is a comment with no leading or trailing line breaks */ -}}
```

## 들여쓰기
<a name="v9-go-indentation"></a>

탭과 공백, 줄 바꿈에서 모두 들여쓰기를 사용하여 템플릿의 가독성을 개선할 수 있습니다.

```
{{ range .Alerts }}
  {{ range .Labels.SortedPairs }}
    {{ .Name }} = {{ .Value }}
  {{ end }}
{{ end }}
```

그러나 템플릿의 들여쓰기는 텍스트에도 표시됩니다. 다음으로 이를 제거하는 방법을 살펴봅니다.

## 공백 및 줄 바꿈 제거
<a name="v9-go-removespace"></a>

text/template에서 `{{-` 및 `-}}`를 사용하여 선행 및 후행 공백과 줄 바꿈을 제거합니다.

예를 들어 들여쓰기 및 줄 바꿈을 사용하여 템플릿의 가독성을 높이는 경우:

```
{{ range .Alerts }}
  {{ range .Labels.SortedPairs }}
    {{ .Name }} = {{ .Value }}
  {{ end }}
{{ end }}
```

들여쓰기 및 줄 바꿈도 텍스트에 표시됩니다.

```
    alertname = "Test"

    grafana_folder = "Test alerts"
```

각 범위의 시작 위치에서 `}}`를 `-}}`로 변경하여 텍스트에서 들여쓰기 및 줄 바꿈을 제거할 수 있습니다.

```
{{ range .Alerts -}}
  {{ range .Labels.SortedPairs -}}
    {{ .Name }} = {{ .Value }}
  {{ end }}
{{ end }}
```

이제 템플릿의 들여쓰기 및 줄 바꿈은 텍스트에 없습니다.

```
alertname = "Test"
grafana_folder = "Test alerts"
```

# 알림 템플릿 생성
<a name="v9-alerting-create-templates"></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) 섹션을 참조하세요.

연락 지점으로 전송할 재사용 가능한 알림 템플릿을 생성합니다.

알림 템플릿에 하나 이상의 템플릿을 추가할 수 있습니다.

알림 템플릿 이름은 고유해야 합니다. 동일한 알림 템플릿 또는 다른 알림 템플릿에서 이름이 같은 두 개의 템플릿을 사용할 수 없습니다. `__subject`, `__text_values_list`, `__text_alert_list`, `default.title`, `default.message`와 같이 기본 템플릿과 이름이 같은 템플릿을 정의하지 마세요.

연락 지점 탭에서 알림 템플릿 목록을 볼 수 있습니다.

## 알림 템플릿 생성
<a name="v9-alerting-creating-templates"></a>

**알림 템플릿을 생성하는 방법**

1. **템플릿 추가**를 클릭하세요.

1. `email.subject`와 같은 알림 템플릿의 이름을 선택하세요.

1. 콘텐츠 필드에서 템플릿의 콘텐츠를 작성하세요.

   예제:

   ```
   {{ if .Alerts.Firing -}}
      {{ len .Alerts.Firing }} firing alerts
      {{ end }}
      {{ if .Alerts.Resolved -}}
      {{ len .Alerts.Resolved }} resolved alerts
      {{ end }}
   ```

1. 저장을 클릭합니다.

   `{{ define "email.subject" }}`(여기서 `email.subject`는 템플릿의 이름임) 및 `{{ end }}`는 콘텐츠의 시작과 끝에 자동으로 추가됩니다.

**둘 이상의 템플릿이 포함된 알림 템플릿을 생성하는 방법:**

1. **템플릿 추가**를 클하세요.

1. 전체 알림 템플릿의 이름을 입력하세요. 예를 들어 `email`입니다.

1. 각 템플릿의 시작과 끝에 있는 `{{ define "name-of-template" }}` 및 `{{ end }}`를 포함하여 콘텐츠 필드에서 각 템플릿을 작성하세요. 알림 템플릿의 각 템플릿에 대해 설명이 포함된 이름(예: `email.subject` 또는 `email.message`)을 사용할 수 있습니다. 이 경우 위에 입력한 알림 템플릿의 이름을 재사용하지 마세요.

   다음 섹션에서는 생성할 수 있는 템플릿에 대한 자세한 예제를 보여줍니다.

1. 저장을 클릭합니다.

## 이메일 제목에 대한 템플릿 생성
<a name="v9-alerting-create-template-subject"></a>

이 예제와 같이 실행 알림 및 해결된 알림 수가 포함된 이메일 제목에 대한 템플릿을 생성합니다.

```
1 firing alerts, 0 resolved alerts
```

**이메일 제목에 대한 템플릿을 생성하는 방법**

1. 다음 콘텐츠로 `email.subject`라는 템플릿을 생성하세요.

   ```
   {{ define "email.subject" }}
   {{ len .Alerts.Firing }} firing alerts, {{ len .Alerts.Resolved }} resolved alerts
   {{ end }}
   ```

1. `template` 키워드를 **제목** 필드에 입력하여 연락 지점 통합을 생성할 때 템플릿을 사용하세요.

   ```
   {{ template "email.subject" . }}
   ```

## 이메일 메시지에 대한 템플릿 생성
<a name="v9-alerting-create-template-message"></a>

이 예제와 같이 모든 실행 알림 및 해결된 알림의 요약이 포함된 이메일 메시지 템플릿을 생성합니다.

```
There are 2 firing alerts, and 1 resolved alerts

Firing alerts:

- alertname=Test 1 grafana_folder=GrafanaCloud has value(s) B=1
- alertname=Test 2 grafana_folder=GrafanaCloud has value(s) B=2

Resolved alerts:

- alertname=Test 3 grafana_folder=GrafanaCloud has value(s) B=0
```

**이메일 메시지에 대한 템플릿을 생성하는 방법**

1. 콘텐츠에 두 개의 템플릿(`email.message_alert` 및 `email.message`)을 포함하는 `email` 알림 템플릿을 생성하세요.

   `email.message_alert` 템플릿은 각 실행 알림과 해결된 알림에 대한 레이블 및 값을 인쇄하는 데 사용되고, `email.message` 템플릿은 이메일 구조를 포함합니다.

   ```
   {{- define "email.message_alert" -}}
   {{- range .Labels.SortedPairs }}{{ .Name }}={{ .Value }} {{ end }} has value(s)
   {{- range $k, $v := .Values }} {{ $k }}={{ $v }}{{ end }}
   {{- end -}}
   
   {{ define "email.message" }}
   There are {{ len .Alerts.Firing }} firing alerts, and {{ len .Alerts.Resolved }} resolved alerts
   
   {{ if .Alerts.Firing -}}
   Firing alerts:
   {{- range .Alerts.Firing }}
   - {{ template "email.message_alert" . }}
   {{- end }}
   {{- end }}
   
   {{ if .Alerts.Resolved -}}
   Resolved alerts:
   {{- range .Alerts.Resolved }}
   - {{ template "email.message_alert" . }}
   {{- end }}
   {{- end }}
   
   {{ end }}
   ```

1. `template` 키워드를 **텍스트 본문** 필드에 입력하여 연락 지점 통합을 생성할 때 템플릿을 사용하세요.

   ```
   {{ template "email.message" . }}
   ```

## Slack 메시지 제목에 대한 템플릿 생성
<a name="v9-alerting-create-template-slack-title"></a>

다음 예제와 같이 실행 알림 및 해결된 알림 수를 포함하는 Slack 메시지의 제목에 대한 템플릿을 생성합니다.

```
1 firing alerts, 0 resolved alerts
```

**Slack 메시지 제목에 대한 템플릿을 생성하는 방법**

1. 다음 콘텐츠로 `slack.title`라는 템플릿을 생성하세요.

   ```
   {{ define "slack.title" }}
   {{ len .Alerts.Firing }} firing alerts, {{ len .Alerts.Resolved }} resolved alerts
   {{ end }}
   ```

1. `template` 키워드를 **제목** 필드에 입력하여 연락 지점 통합을 생성할 때 템플릿을 사용하세요.

   ```
   {{ template "slack.title" . }}
   ```

## Slack 메시지 콘텐츠에 대한 템플릿 생성
<a name="v9-alerting-create-template-slack-message"></a>

레이블, 주석 및 대시보드 URL을 포함하여 모든 실행 알림 및 해결된 알림에 대한 설명이 포함된 Slack 메시지의 콘텐츠에 대한 템플릿을 생성합니다.

```
1 firing alerts:

[firing] Test1
Labels:
- alertname: Test1
- grafana_folder: GrafanaCloud
Annotations:
- description: This is a test alert
Go to dashboard: https://example.com/d/dlhdLqF4z?orgId=1

1 resolved alerts:

[firing] Test2
Labels:
- alertname: Test2
- grafana_folder: GrafanaCloud
Annotations:
- description: This is another test alert
Go to dashboard: https://example.com/d/dlhdLqF4z?orgId=1
```

**Slack 메시지 콘텐츠에 대한 템플릿을 생성하는 방법**

1. 콘텐츠에 두 개의 템플릿(`slack.print_alert` 및 `slack.message`)을 포함하는 `slack` 템플릿을 생성하세요.

   `slack.print_alert` 템플릿은 레이블, 주석 및 DashboardURL을 인쇄하는 데 사용되는 반면 `slack.message` 템플릿에는 알림 구조가 포함되어 있습니다.

   ```
   {{ define "slack.print_alert" -}}
   [{{.Status}}] {{ .Labels.alertname }}
   Labels:
   {{ range .Labels.SortedPairs -}}
   - {{ .Name }}: {{ .Value }}
   {{ end -}}
   {{ if .Annotations -}}
   Annotations:
   {{ range .Annotations.SortedPairs -}}
   - {{ .Name }}: {{ .Value }}
   {{ end -}}
   {{ end -}}
   {{ if .DashboardURL -}}
     Go to dashboard: {{ .DashboardURL }}
   {{- end }}
   {{- end }}
   
   {{ define "slack.message" -}}
   {{ if .Alerts.Firing -}}
   {{ len .Alerts.Firing }} firing alerts:
   {{ range .Alerts.Firing }}
   {{ template "slack.print_alert" . }}
   {{ end -}}
   {{ end }}
   {{ if .Alerts.Resolved -}}
   {{ len .Alerts.Resolved }} resolved alerts:
   {{ range .Alerts.Resolved }}
   {{ template "slack.print_alert" .}}
   {{ end -}}
   {{ end }}
   {{- end }}
   ```

1. `template` 키워드를 **텍스트 본문** 필드에 입력하여 연락 지점 통합을 생성할 때 템플릿을 사용하세요.

   ```
   {{ template "slack.message" . }}
   ```

## 공유 템플릿으로 이메일 및 Slack 모두 템플릿 지정
<a name="v9-alerting-create-shared-templates"></a>

이메일 및 Slack과 같이 각 연락 지점에 대해 별도의 알림 템플릿을 생성하는 대신 동일한 템플릿을 공유할 수 있습니다.

예를 들어 이 제목의 이메일과 이 `1 firing alerts, 0 resolved alerts` 제목의 Slack 메시지를 보내려면 공유 템플릿을 생성할 수 있습니다.

**공유 템플릿을 생성하는 방법**

1. 다음 콘텐츠로 `common.subject_title`라는 템플릿을 생성하세요.

   ```
   {{ define "common.subject_title" }}
   {{ len .Alerts.Firing }} firing alerts, {{ len .Alerts.Resolved }} resolved alerts
   {{ end }}
   ```

1. 이메일의 경우 이메일 연락 지점 통합의 제목 필드에서 템플릿을 실행하세요.

   ```
   {{ template "common.subject_title" . }}
   ```

1. Slack의 경우 Slack 연락 지점 통합의 제목 필드에서 템플릿을 실행하세요.

   ```
   {{ template "common.subject_title" . }}
   ```

## 알림 템플릿 사용
<a name="v9-alerting-use-notification-templates"></a>

연락 지점의 템플릿을 사용하여 알림을 사용자 지정합니다.

**연락 지점을 생성할 때 템플릿을 사용하는 방법**

1. **알림** 메뉴에서 **연락 지점** 탭을 선택하여 기존 연락처 목록을 확인하세요.

1. **연락 지점 추가**를 선택하세요. 또는 편집하려는 연락 지점 옆에 있는 **편집** 아이콘(펜)을 선택하여 기존 연락 지점을 편집할 수 있습니다.

1. **메시지** 또는 **제목**과 같이 하나 이상의 필드에 사용하려는 템플릿을 입력하세요. 템플릿을 입력하려면 `{{ template "template_name" . }}` 양식을 사용하여 *template\$1name*을 사용하려는 템플릿 이름으로 바꾸세요.

1. **연락 지점 저장**을 클릭하세요.

# 템플릿 참조
<a name="v9-alerting-template-reference"></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-alerting-template-data"></a>

다음 데이터가 메시지 템플릿에 전달됩니다.


| 이름 | Type | 참고 | 
| --- | --- | --- | 
|  `Receiver`  |  문자열  |  알림이 전송되는 연락 지점 이름.  | 
|  `Status`  |  문자열  |  하나 이상의 알림이 실행 중인 경우 실행이고, 그렇지 않으면 해결됨 상태입니다.  | 
|  `Alerts`  |  Alert  |  이 알림에 포함된 알림 객체 목록(아래 참조).  | 
|  `GroupLabels`  |  KeyValue  |  이러한 알림이 그룹화된 레이블.  | 
|  `CommonLabels`  |  KeyValue  |  이 알림에 포함된 모든 알림에 공통된 레이블.  | 
|  `CommonAnnotations`  |  KeyValue  |  이 알림에 포함된 모든 알림에 공통된 주석.  | 
|  `ExternalURL`  |  문자열  |  알림을 전송한 Grafana로 돌아가는 링크. 외부 Alertmanager를 사용하는 경우 이 Alertmanager로 돌아가는 링크.  | 

`Alerts` 유형은 반환된 알림을 필터링하기 위한 두 가지 함수를 노출합니다.
+ `Alerts.Firing` - 실행 알림 목록을 반환합니다.
+ `Alerts.Resolved` - 해결된 알림 목록을 반환합니다.

**알림(유형)**

알림 유형에는 다음 데이터가 포함됩니다.


| 이름 | Type | 참고 | 
| --- | --- | --- | 
|  Status  |  문자열  |  `firing` 또는 `resolved`  | 
|  레이블  |  KeyValue  |  알림에 연결된 레이블 세트.  | 
|  Annotations  |  KeyValue  |  알림에 연결된 주석 세트.  | 
| 값 | KeyValue | 클래식 조건을 포함한 모든 표현식의 값 | 
|  StartsAt  |  time.Time  |  알림 실행이 시작되는 시간.  | 
|  EndsAt  |  time.Time  |  알림의 종료 시간을 알고 있는 경우에만 설정합니다. 그렇지 않으면 마지막 알림이 수신된 이후부터 구성 가능한 제한 시간으로 설정됩니다.  | 
|  GeneratorURL  |  문자열  |  Grafana 또는 외부 Alertmanager에 대한 백 링크.  | 
|  SilenceURL  |  문자열  |  알림을 음소거하는 링크(이 알림에 대한 레이블이 미리 채워짐). Grafana 관리형 알림에만 적용됩니다.  | 
|  DashboardURL  |  문자열  |  알림 규칙이 하나에 속하는 경우 Grafana 대시보드에 대한 링크. Grafana 관리형 알림에만 적용됩니다.  | 
|  PanelURL  |  문자열  |  알림 규칙이 하나에 속하는 경우 Grafana 대시보드 패널에 대한 링크. Grafana 관리형 알림에만 적용됩니다.  | 
|  지문  |  문자열  |  알림을 식별하는 데 사용할 수 있는 지문.  | 
|  ValueString  |  문자열  |  알림에서 축소된 각 표현식의 레이블과 값을 포함하는 문자열.  | 

 **ExtendedData**

ExtendedData 객체는 다음 속성을 포함합니다.


| 이름 | 종류 | 설명 | 예제 | 
| --- | --- | --- | --- | 
|  수신기  |  `string`  |  알림을 보내는 연락 지점의 이름.  |  `{{ .Receiver }}`  | 
|  Status  |  `string`  |  상태가 `firing if at least one alert is firing, otherwise resolved.`입니다.  |  `{{ .Status }}`  | 
|  알림  |  `[]Alert`  |  이 알림에서 모든 실행 알림과 해결된 알림 목록.  |  `There are {{ len .Alerts }} alerts`  | 
|  실행 알림  |  `[]Alert`  |  이 알림에서 모든 실행 알림 목록.  |  `There are {{ len .Alerts.Firing }} firing alerts`  | 
|  해결된 알림  |  `[]Alert`  |  이 알림에서 모든 해결된 알림 목록.  |  `There are {{ len .Alerts.Resolved }} resolved alerts`  | 
|  GroupLabels  |  `KeyValue`  |  이 알림에서 이러한 알림을 그룹화하는 레이블.  |  `{{ .GroupLabels }}`  | 
|  CommonLabels  |  `KeyValue`  |  이 알림에서 모든 알림에 공통된 레이블.  |  `{{ .CommonLabels }}`  | 
|  CommonAnnotations  |  `KeyValue`  |  이 알림에서 모든 알림에 공통된 주석.  |  `{{ .CommonAnnotations }}`  | 
|  ExternalURL  |  `string`  |  이 알림을 보낸 Grafana 워크스페이스 또는 Alertmanager에 대한 링크.  |  `{{ .ExternalURL }}`  | 

**KeyValue 유형**

`KeyValue` 유형은 레이블과 주석을 나타내는 키/값 문자열 페어 세트입니다.

`KeyValue`로 저장된 데이터에 대한 직접 액세스 외에도 데이터를 정렬, 제거 및 변환하는 방법도 있습니다.


| 이름 | 인수 | 반환 | 참고 | 예제 | 
| --- | --- | --- | --- | --- | 
|  SortedPairs  |    |  키 및 값 문자열 페어의 정렬된 목록  |    | `{{ .Annotations.SortedPairs }}` | 
|  제거  |  []string  |  KeyValue  |  지정된 키 없이 키/값 맵의 사본을 반환합니다.  | `{{ .Annotations.Remove "summary" }}` | 
|  이름  |    |  []string  |  레이블 이름 목록  | `{{ .Names }}` | 
|  값  |    |  []string  |  레이블 값 목록  | `{{ .Values }}` | 

**Time**

시간은 Go [https://pkg.go.dev/time#Time](https://pkg.go.dev/time#Time) 패키지에서 가져옵니다. 여러 형식으로 시간을 인쇄할 수 있습니다. 예를 들어, `Monday, 1st January 2022 at 10:00AM` 형식으로 알림이 실행된 시간을 인쇄하려면 다음 템플릿을 작성합니다.

```
{{ .StartsAt.Format "Monday, 2 January 2006 at 3:04PM" }}
```

[여기](https://pkg.go.dev/time#pkg-constants)에서 Go의 시간 형식에 대한 참조를 찾을 수 있습니다.

## 템플릿 함수
<a name="v9-alerting-template-functions"></a>

템플릿 함수를 사용하여 레이블 및 주석을 처리해 동적 알림을 생성할 수 있습니다. 다음 함수를 사용할 수 있습니다.


| 이름 | 인수 유형 | 반환 타입 | 설명 | 
| --- | --- | --- | --- | 
|  `humanize`  |  숫자 또는 문자열  |  문자열  |  지표 접두사를 사용하여 숫자를 더 읽기 쉬운 형식으로 변환합니다.  | 
|  `humanize1024`  |  숫자 또는 문자열  |  문자열  |  humanize와 비슷하지만 1000이 아닌 1024를 밑으로 사용합니다.  | 
|  `humanizeDuration`  |  숫자 또는 문자열  |  문자열  |  기간(초 단위)을 더 읽기 쉬운 형식으로 변환합니다.  | 
|  `humanizePercentage`  |  숫자 또는 문자열  |  문자열  |  비율 값을 100의 분율로 변환합니다.  | 
|  `humanizeTimestamp`  |  숫자 또는 문자열  |  문자열  |  Unix 타임스탬프(초 단위)를 더 읽기 쉬운 형식으로 변환합니다.  | 
|  `title`  |  문자열  |  문자열  |  strings.Title, 각 단어의 첫 번째 문자를 대문자로 표시합니다.  | 
|  `toUpper`  |  문자열  |  문자열  |  strings.ToUpper, 모든 문자를 대문자로 변환합니다.  | 
|  `toLower`  |  문자열  |  문자열  |  strings.ToLower, 모든 문자를 소문자로 변환합니다.  | 
|  `match`  |  패턴, 텍스트  |  부울  |  regexp.MatchString 고정되지 않은 정규식 일치를 테스트합니다.  | 
|  `reReplaceAll`  |  패턴, 교체, 텍스트  |  문자열  |  Regexp.ReplaceAllString Regexp 대체(고정되지 않음).  | 
|  `graphLink`  |  문자열 - `expr` 및 `datasource` 필드가 있는 JSON 객체  |  문자열  |  지정된 표현식 및 데이터 소스에 대한 탐색의 그래픽 보기 경로를 반환합니다.  | 
|  `tableLink`  |  문자열 - `expr` 및 `datasource` 필드가 있는 JSON 객체  |  문자열  |  지정된 표현식 및 데이터 소스에 대한 탐색의 테이블 형식 보기 경로를 반환합니다.  | 
|  `args`  |  []interface\$1\$1  |  map[string]interface\$1\$1  |  객체 목록을 arg0, arg1과 같은 키가 있는 맵으로 변환합니다. 이 함수를 사용하여 여러 인수를 템플릿에 전달합니다.  | 
|  `externalURL`  |  없음  |  문자열  |  외부 URL을 나타내는 문자열을 반환합니다.  | 
|  `pathPrefix`  |  없음  |  문자열  |  외부 URL의 경로를 반환합니다.  | 

다음 표에는 각 함수 사용 예제가 나와 있습니다.


| 함수 | TemplateString | Input | 예상 | 
| --- | --- | --- | --- | 
|  인간화  |  \$1 humanize \$1value \$1  |  1234567.0  |  1.235M  | 
|  humanize1024  |  \$1 humanize1024 \$1value \$1  |  1048576.0  |  1Mi  | 
|  humanizeDuration  |  \$1 humanizeDuration \$1value \$1  |  899.99  |  14m 59s  | 
|  humanizePercentage  |  \$1 humanizePercentage \$1value \$1  |  0.1234567  |  12.35%  | 
|  humanizeTimestamp  |  \$1 humanizeTimestamp \$1value \$1  |  1435065584.128  |  2015-06-23 13:19:44.128 \$10000 UTC  | 
|  제목  |  \$1 \$1value \$1 title \$1  |  aa bB CC  |  Aa Bb Cc  | 
|  toUpper  |  \$1 \$1value \$1 toUpper \$1  |  aa bB CC  |  AA BB CC  | 
|  toLower  |  \$1 \$1value \$1 toLower \$1  |  aa bB CC  |  aa bb cc  | 
|  match  |  \$1 match "a\$1" \$1labels.instance \$1  |  aa  |  true  | 
|  reReplaceAll  |  \$1\$1 reReplaceAll "localhost:(.\$1)" "my.domain:\$11" \$1labels.instance \$1\$1  |  localhost:3000  |  my.domain:3000  | 
|  graphLink  |  \$1\$1 graphLink "\$1\$1"expr\$1": \$1"up\$1", \$1"datasource\$1": \$1"gdev-prometheus\$1"\$1" \$1\$1  |    |  /explore?left=["now-1h","now","gdev-prometheus",\$1"datasource":"gdev-prometheus","expr":"up","instant":false,"range":true\$1]  | 
|  tableLink  |  \$1\$1 tableLink "\$1\$1"expr\$1":\$1"up\$1", \$1"datasource\$1":\$1"gdev-prometheus\$1"\$1" \$1\$1  |    |  /explore?left=["now-1h","now","gdev-prometheus",\$1"datasource":"gdev-prometheus","expr":"up","instant":true,"range":false\$1]  | 
|  args  |  \$1\$1define "x"\$1\$1\$1\$1.arg0\$1\$1 \$1\$1.arg1\$1\$1\$1\$1end\$1\$1\$1\$1template "x" (args 1 "2")\$1\$1  |    |  1 2  | 
|  externalURL  |  \$1 externalURL \$1  |    |  http://localhost/path/prefix  | 
|  pathPrefix  |  \$1 pathPrefix \$1  |    |  /path/prefix  | 

# Prometheus 데이터 소스에 대한 알림 전달 무음 처리
<a name="v9-alerting-silences"></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) 섹션을 참조하세요.

외부 Alertmanager 데이터 소스(Amazon Managed Service for Prometheus 포함)의 경우 *무음*으로 알림 전달을 억제할 수 있습니다. 무음은 알림 생성만 중지합니다. 무음은 알림 규칙이 평가되는 것을 방지하지 않으며 사용자 인터페이스에 인스턴스 알림이 표시되는 것도 중지하지 않습니다. 알림을 무음으로 설정한 경우 알림이 억제되는 기간을 지정합니다.

외부 Alertmanager 데이터 소스에 대해 무음을 구성할 수 있습니다.

**참고**  
정기적인 시간 간격(예: 정기 유지 관리 기간) 또는 다른 데이터 소스에 대해 알림 전달을 억제하려면 무음 대신 [음소거 타이밍](v9-alerting-notification-muting.md)을 사용합니다.

**무음을 추가하는 방법**

1. Grafana 콘솔의 Grafana 메뉴에서 **알림**(종 모양) 아이콘을 선택하여 **알림** 페이지를 여세요.

1. **무음**을 선택하여 기존 [연락 지점 작업](v9-alerting-contact-points.md)이 나열된 페이지를 여세요.

1. **Alertmanager** 드롭다운에서 외부 Alertmanager를 선택하세요.

1. **무음 추가**를 선택하세요.

1. **무음 시작 및 종료**에서 시작 및 종료 날짜를 선택하여 무음이 적용되는 시기와 종료 시기를 표시하세요.

   종료 시간을 설정하는 대신 **기간**에서 무음이 적용되는 기간을 지정하세요. 그러면 **무음 시작 및 종료** 필드의 종료 시간이 자동으로 업데이트됩니다.

1. **이름** 및 **값** 필드에 *일치하는 레이블*을 하나 이상 입력하세요. 매처는 무음이 적용되는 규칙을 결정합니다. 레이블 일치는 이 절차 이후에 자세히 설명합니다.

1. 선택적으로 **설명**을 추가하거나 **생성자** 수정하여 무음 소유자를 설정하세요.

1. **생성**을 선택하여 무음을 생성하세요.

**편집** 아이콘(펜)을 선택하여 기존 무음을 편집할 수 있습니다.

**알림 억제를 위한 레이블 일치**

무음을 생성할 때 무음의 일부로 *일치하는 레이블* 세트를 생성합니다. 알림을 억제하기 위해 일치해야 하는 레이블에 대한 규칙 세트입니다. 일치하는 레이블은 다음과 같이 세 부분으로 구성됩니다.
+ **레이블** - 일치시킬 레이블의 이름. 알림의 레이블 이름과 정확히 일치해야 합니다.
+ **연산자** - 레이블 값을 일치 레이블 값과 비교하는 데 사용되는 연산자. 사용 가능한 연산자는 다음과 같습니다.
  + `=` 값이 제공된 문자열과 정확히 일치하는 레이블을 선택합니다.
  + `!=` 값이 제공된 문자열과 일치하지 않는 레이블을 선택합니다.
  + `=~` 값이 제공된 문자열의 정규식 해석 값과 일치하는 레이블을 선택합니다(제공된 문자열은 정규식으로 해석됨).
  + `!=` 제공된 정규식과 일치하지 않는 레이블을 선택합니다.
+ **값** - 레이블 값과 일치하는 값. 선택한 연산자에 따라 문자열 또는 정규식으로 일치할 수 있습니다.

무음은 표시된 종료일에 종료되지만 언제든지 수동으로 억제를 종료할 수 있습니다.

**수동으로 무음을 종료하는 방법**

1. **알림** 페이지에서 **무음**을 선택하여 기존 무음 목록을 보세요.

1. 종료하려는 무음을 선택하고 **무음 해제**를 선택하세요. 그러면 알림 억제가 종료됩니다.
**참고**  
무음을 해제하면 종료 시간이 현재 시간으로 설정된 것처럼 알림 억제가 종료됩니다. (자동 또는 수동으로) 종료된 무음은 5일 동안 유지되고 나열됩니다. 목록에서 수동으로 무음을 제거할 수 없습니다.

**무음 생성 양식에 대한 링크 생성**

세부 정보가 이미 입력된 무음 생성 양식에 대한 URL을 생성할 수 있습니다. 운영자는 이를 사용하여 운영 이벤트 중에 경보를 신속하게 억제할 수 있습니다.

무음 양식에 대한 링크를 생성할 때 `matchers` 쿼리 파라미터를 사용하여 일치하는 레이블을 지정하고 `comment` 쿼리 파라미터를 사용하여 설명을 지정하세요. `matchers` 파라미터에는 쉼표로 구분된 `[label][operator][value]` 양식의 값이 하나 이상 필요합니다.

**예제 URL**

무음 양식(일치하는 레이블이 `severity=critical` 및 `cluster!~europe-.*`이고 설명이 `Silencing critical EU alerts`임)에 연결하려면 다음과 같은 URL을 사용합니다. *mygrafana*를 Grafana 인스턴스의 호스트 이름으로 바꾸세요.

```
https://mygrafana/alerting/silence/new?matchers=severity%3Dcritical%2Ccluster!~europe-*&comment=Silence%20critical%20EU%20alert
```

외부 Alertmanager의 새 무음 페이지에 연결하려면 `alertmanager=myAlertmanagerdatasource`와 같은 Alertmanage 데이터 소스 이름이 포함된 `alertmanager` 쿼리 파라미터를 추가하세요.

# 음소거 타이밍
<a name="v9-alerting-notification-muting"></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 관리형 음소거 타이밍 및 외부 Alertmanager 데이터 소스에 대한 음소거 타이밍을 구성할 수 있습니다.

**음소거 타이밍과 무음 비교**

다음 표에서는 음소거 타이밍과 무음의 차이를 강조합니다.


| 음소거 타이밍 | 무음 | 
| --- | --- | 
|  다시 발생할 수 있는 시간 간격 정의를 사용합니다.  |  시작 및 종료 시간이 고정되어 있습니다.  | 
|  생성 후 알림 정책에 추가됩니다.  |  레이블을 사용하여 무음 여부를 결정하기 위해 알림과 일치시킵니다.  | 
|  Grafana 알림 및 외부 Alertmanager와 함께 작동합니다.  |  외부 Alertmanager에서만 작동합니다.  | 

**음소거 타이밍을 생성하는 방법**

1. Grafana 콘솔의 Grafana 메뉴에서 **알림**(종 모양) 아이콘을 선택하여 **알림** 페이지를 여세요.

1. **알림 정책**을 선택하세요.

1. **Alertmanager** 드롭다운에서 편집할 Alertmanager를 선택하세요.

1. **음소거 타이밍** 섹션에서 **음소거 타이밍 추가** 버튼을 선택하세요.

1. 음소거 타이밍을 적용할 시간 간격을 선택하세요.

1. **제출**을 선택하여 음소거 타이밍을 생성하세요.

**알림 정책에 음소거 타이밍을 추가하는 방법**

1. 음소거 타이밍을 추가하려는 알림 정책을 선택하고 **편집** 버튼을 선택하세요.

1. **음소거 타이밍** 드롭다운에서 정책에 추가할 음소거 타이밍을 선택하세요.

   **정책 저장** 버튼을 선택하세요.

**시간 간격**

시간 간격은 시간 범위에 대한 정의입니다. 이 간격 동안 알림이 시작되면 알림이 억제됩니다. 범위는 `:`(예: `monday:thursday`)을 사용하여 지원됩니다. 음소거 타이밍에는 여러 시간 간격이 포함될 수 있습니다. 시간 간격은 여러 필드(다음 목록의 세부 정보)로 구성되며, 알림을 억제하려면 모두 일치해야 합니다. 예를 들어 요일(`monday:friday`) 및 시간 범위(8:00\$19:00)를 지정하면 월요일부터 금요일까지 8시\$19시에 알림이 억제되고 토요일 8시\$19시에는 기능 억제되지 않습니다.
+ **시간 범위** - 알림을 억제하는 시간. **시작 시간** 및 **종료 시간**이라는 두 개의 하위 필드로 구성됩니다. 예제 시간은 `14:30`입니다. 시간은 UTC의 24시간 표기법으로 표시됩니다.
+ **요일** - 요일. 하루(예: `monday`), 범위(예: `monday:friday`) 또는 쉼표로 구분된 일 목록(예: `monday, tuesday, wednesday`)일 수 있습니다.
+ **월** - 선택할 월. 숫자를 지정하거나 전체 월 이름을 사용하여 월을 지정할 수 있습니다(예: `1` 또는 `january`). 둘 다 1월을 지정합니다. 한 달, 월 범위 또는 쉼표로 구분된 월 목록을 지정할 수 있습니다.
+ **월의 일** - 한 달의 날짜. 가능한 값의 범위는 `1`\$1`31`입니다. 음수 값은 해당 월의 일을 역순으로 지정하므로 `-1`은 해당 월의 마지막 날짜를 나타냅니다. 월의 일은 하루, 일 범위 또는 쉼표로 구분된 일 목록으로 지정할 수 있습니다.
+ **연도** - 간격에 대한 하나 이상의 연도. 예를 들어 `2023:2025`입니다.

이러한 각 요소는 목록일 수 있으며, 일치하려면 요소의 항목을 하나 이상 충족해야 합니다. 따라서 연도를 `2023:2025, 2027`로 설정한 경우 2023년, 2024년, 2025년 및 2027년(2026년은 아님)에 해당합니다.

필드를 비워 두면 어느 시간이든 필드와 일치합니다. 전체 시간 간격과 일치하려면 시간에서 모든 필드가 일치해야 합니다.

정확한 기간을 지정하려면 해당 기간에 필요한 모든 옵션을 지정합니다. 예를 들어 3월, 6월, 9월, 12월의 첫 번째 월요일, 12:00\$124:00 UTC 시간에 시간 간격을 생성하려는 경우 시간 간격 사양은 다음과 같을 수 있습니다.
+ 시간 범위:
  + 시작 시간: `12:00`
  + 종료 시간: `24:00`
+ 요일: `monday`
+ 월: `3, 6, 9, 12`
+ 해당 월의 일: `1:7`

# 알림 그룹별 보기 및 필터링
<a name="v9-alerting-viewfiltergroups"></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) 섹션을 참조하세요.

알림 그룹에서는 Alertmanager 인스턴스의 그룹화된 경보를 표시합니다. 기본적으로 알림 규칙은 알림 정책의 루트 정책에 대한 레이블 키별로 그룹화됩니다. 공통 알림 규칙을 단일 알림 그룹으로 그룹화하면 중복 알림 규칙이 실행되지 않습니다.

알림 그룹을 보고 특정 기준과 일치하는 알림 규칙을 필터링할 수도 있습니다.

**알림 그룹을 보는 방법**

1. Grafana 메뉴에서 **알림**(종 모양) 아이콘을 클릭하여 기존 알림을 나열하는 알림 페이지를 여세요.

1. **알림 그룹**을 클릭하여 기존 그룹을 나열하는 페이지를 여세요.

1. **Alertmanager** 드롭다운에서 외부 Alertmanager를 데이터 소스로 선택하세요.

1. **사용자 지정 그룹화 기준** 드롭다운에서 레이블 조합을 선택하여 기본값이 아닌 다른 그룹화를 보세요. 이는 알림 정책 그룹을 디버깅하고 확인하는 데 유용합니다.

루트 정책의 그룹화 또는 사용자 지정 그룹화에 지정된 레이블이 알림에 포함되지 않은 경우 헤더가 `No grouping`인 다양한 그룹에 알림이 추가됩니다.

**레이블을 기준으로 필터링하는 방법**
+ **검색**에서 기존 레이블을 입력하여 레이블과 일치하는 알림을 확인하세요.

  예를 들어 `environment=production,region=~US|EU,severity!=warning`입니다.

**상태를 기준으로 필터링하는 방법**
+ **상태**에서 활성, 억제됨 또는 미처리 상태 중에서 선택하여 선택한 상태와 일치하는 알림을 보세요. 다른 모든 알림은 숨겨집니다.

# 알림 오류 보기
<a name="v9-alerting-viewnotificationerrors"></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 Alertmanager에 대해서만 지원됩니다.

**알림 오류를 보는 방법**

1. Grafana 메뉴에서 **알림**(종 모양) 아이콘을 클릭하여 기존 알림을 나열하는 알림 페이지를 여세요.

1. **연락 지점**을 선택하여 기존 연락 지점 목록을 확인하세요.

   연락 지점에서 장애가 발생한 경우 화면 오른쪽의 메시지에서는 오류가 있다는 메시지와 오류 개수를 사용자에게 알립니다.

1. 연락 지점을 클릭하여 해당 연락 지점에 대한 오류 세부 정보를 확인하세요.

   오류 아이콘 위로 마우스를 가져가면 오류 세부 정보가 표시됩니다.

   연락 지점에 둘 이상의 통합이 있는 경우 나열된 각 통합에 대한 모든 오류가 표시됩니다.

1. 상태 열에서 알림 상태를 확인하세요.

   정상, 시도 없음 또는 오류일 수 있습니다.