

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

# Grafana 버전 8에서 작업
<a name="using-grafana-v8"></a>

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

Grafana 워크스페이스를 생성할 때 사용할 Grafana 버전을 선택할 수 있습니다. 다음 주제에서는 Grafana 버전 8을 사용하는 Grafana 워크스페이스 사용을 설명합니다.

**Topics**
+ [패널](Grafana-panels.md)
+ [대시보드](dashboard-overview.md)
+ [탐색](explore.md)
+ [Linking(연결 중)](linking-in-Amazon-Managed-Service-for-Grafana.md)
+ [템플릿 및 변수](templates-and-variables.md)
+ [Grafana 알림](alerts-overview.md)

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

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

패널은 Grafana 서버의 기본적인 시각화 구성 요소입니다. 패널은 몇 가지 특수 용도의 패널을 제외하고 하나 이상의 쿼리에 대한 시각적 표현입니다. 쿼리는 시간 경과에 따른 데이터를 표시합니다. 온도 변동에서 현재 서버 상태, 로그 또는 알림 목록에 이르기까지 다양합니다.

각 패널에는 패널에서 선택한 데이터 소스에 특정한 쿼리 편집기가 있습니다. 쿼리 편집기를 사용하면 패널에 표시할 시각화를 추출할 수 있습니다.



데이터를 표시하려면 워크스페이스에 데이터 소스가 하나 이상 추가되어 있어야 합니다. 데이터 소스에 대한 자세한 내용은 [데이터 원본에 연결](AMG-data-sources.md) 섹션을 참조하세요.

각 패널에는 다양한 스타일 및 서식 지정 옵션이 있습니다. 패널을 끌거나 재배열하거나 크기를 조정할 수 있습니다.

**Topics**
+ [패널 추가](add-a-panel-to-a-dashboard.md)
+ [패널 삭제](Deleting-a-panel.md)
+ [쿼리](panel-queries.md)
+ [기록된 쿼리](recorded-queries.md)
+ [변환](panel-transformations.md)
+ [필드 옵션 및 재정의](field-options-overrides.md)
+ [패널 편집기](AMG-panel-editor.md)
+ [라이브러리 패널](AMG-library-panel.md)
+ [시각화](AMG-visualizations.md)

# 패널 추가
<a name="add-a-panel-to-a-dashboard"></a>

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

 패널을 사용하여 데이터를 시각적 양식으로 표시할 수 있습니다. 이 주제에서는 패널을 빌드하는 기본 단계를 안내합니다.

**대시보드에 패널을 추가하는 방법**

1.  패널을 추가할 대시보드를 선택하세요.

1.  **패널 추가** 아이콘을 선택하세요.

1.  **새 패널 추가**를 선택하세요.

    Grafana 워크스페이스는 기본 데이터 소스가 선택된 빈 그래프 패널을 생성합니다.

1.  필수는 아니지만 패널에 유용한 제목 및 설명을 추가하는 것이 좋습니다. 선택적으로 두 필드에서 정의한 변수를 사용할 수 있지만 전역 변수는 사용할 수 없습니다. 자세한 내용은 [템플릿 및 변수](templates-and-variables.md) 단원을 참조하십시오.
   + **패널 제목** - 이 필드에 입력한 텍스트는 패널 편집기의 패널 상단 및 대시보드에 표시됩니다.
   + **설명** - 이 필드에 입력한 텍스트는 패널의 왼쪽 상단에 있는 툴팁에 표시됩니다. 표시 중인 데이터 및 패널에 대한 설명을 작성합니다.

1. 패널에 대한 쿼리를 작성합니다. 시각화를 표시하려면 각 패널에 하나 이상의 쿼리가 필요합니다. 패널 편집기의 **쿼리** 탭에서 쿼리를 작성합니다. 자세한 내용은 [쿼리](panel-queries.md) 단원을 참조하십시오.

   1. 데이터 원본을 선택합니다. **쿼리** 탭의 첫 번째 줄에서 드롭다운 목록을 선택하여 사용 가능한 모든 데이터 소스를 확인합니다. 이 목록에는 추가한 모든 데이터 소스가 포함됩니다. 데이터 소스에 대한 자세한 내용은 [데이터 원본에 연결](AMG-data-sources.md) 섹션을 참조하세요.

   1. 데이터 소스의 쿼리 언어로 쿼리를 작성하거나 구성합니다. 옵션은 다양합니다. 구체적인 지침은 특정 데이터 소스 설명서를 참조하세요.

1.  **패널** 탭의 **시각화** 섹션에서 시각화 유형을 선택하세요. Grafana 워크스페이스에는 해당 시각화가 적용된 쿼리 결과의 미리 보기가 표시됩니다.

1. **저장**을 선택하기 전에 변경 사항을 설명하는 메모를 추가하는 것이 좋습니다. 대시보드를 이전 버전으로 되돌려야 하는 경우에 이러한 메모가 유용합니다.

1.  대시보드를 저장하려면 화면 오른쪽 상단에서 **저장**을 선택하세요.

# 패널 삭제
<a name="Deleting-a-panel"></a>

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

Grafana에서 패널을 삭제하려면 다음 단계를 완료합니다.
+  패널 제목 옆의 드롭다운을 선택하고 **패널 제거**를 선택하세요.

또는
+ 포인터를 패널 위로 가져가 키보드 단축키 시퀀스 'p r'을 사용합니다.

# 쿼리
<a name="panel-queries"></a>

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

 Grafana 워크스페이스 패널은 *쿼리*를 사용하여 시각화에 대한 데이터를 가져오기 위해 데이터 소스와 통신합니다. 쿼리는 데이터 소스에서 사용하는 쿼리 언어로 작성된 질문입니다. 쿼리가 제대로 구성되면 데이터 소스가 응답합니다. 패널 데이터 소스 옵션에서 쿼리가 데이터 소스로 전송되는 빈도와 수집되는 데이터 포인트 수를 조정할 수 있습니다.

 Grafana 워크스페이스는 패널당 최대 26개의 쿼리를 지원합니다.

## 쿼리 편집기
<a name="query-editors"></a>

 쿼리 편집기는 쿼리를 작성하는 데 도움이 되는 양식입니다. 데이터 소스에 따라 쿼리 편집기는 자동 완성, 지표 이름 또는 변수 제안을 제공할 수 있습니다.

 쿼리 언어 간의 차이로 인해 데이터 소스에서 쿼리 편집기가 다르게 보일 수 있습니다.

## 쿼리 구문
<a name="query-syntax"></a>

 데이터 소스에는 데이터를 요청할 수 있는 다양한 쿼리 언어와 구문이 있습니다. 다음은 두 가지 쿼리 예제입니다.

 **PostgreSQL** 

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

 **PromQL** 

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

 데이터 소스의 쿼리 작성에 대한 자세한 내용은 해당 데이터 소스에 대한 설명서를 참조하세요. 데이터 소스는 [데이터 원본에 연결](AMG-data-sources.md)에 나열되어 있습니다.

## 쿼리 탭 UI
<a name="query-tab-ui"></a>

 **쿼리** 탭은 다음 요소로 구성됩니다.
+  데이터 소스 선택기 
+  쿼리 옵션 
+  쿼리 검사기 버튼 
+  쿼리 편집기 목록 

### 데이터 소스 선택기
<a name="data-source-selector"></a>

 데이터 소스 선택기는 드롭다운 목록입니다. 이를 선택하여 추가한 데이터 소스를 선택합니다. 패널을 생성하면 Amazon Managed Grafana에서 기본 데이터 소스를 자동으로 선택합니다. 데이터 소스에 대한 자세한 내용은 [데이터 원본에 연결](AMG-data-sources.md) 섹션을 참조하세요.

 Grafana 워크스페이스에서 구성한 데이터 소스 외에도 세 가지 특수 데이터 소스를 사용할 수 있습니다.
+ **TestDataDB** - 무작위 워크 데이터를 생성하는 기본 제공 데이터 소스. Grafana 데이터 소스는 시각화를 테스트하고 실험을 실행하는 데 유용합니다.
+  **혼합**- 동일한 패널에서 여러 데이터 소스를 쿼리하기 위한 데이터 소스. 이 데이터 소스를 선택하면 추가하는 모든 새 쿼리에 대한 데이터 소스를 선택할 수 있습니다.
  +  첫 번째 쿼리에서는 **혼합**을 선택하기 전에 선택한 데이터 소스를 사용합니다.
  +  혼합 데이터 소스를 사용하도록 기존 쿼리를 변경할 수 없습니다.
+ **대시보드** - 동일한 대시보드의 다른 패널에서 결과 세트를 사용하기 위한 데이터 소스.

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

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

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

 다음 패널 데이터 소스 쿼리 옵션을 사용할 수 있습니다.
+  **최대 데이터 포인트** - 데이터 소스가 지원하는 경우 반환된 각 시리즈의 최대 데이터 포인트 수를 설정합니다. 쿼리가 최대 데이터 포인트 설정보다 많은 데이터 포인트를 반환하는 경우 데이터 소스는 이를 통합합니다(평균, 최대 또는 기타 함수별로 집계하여 반환되는 포인트 수 감소).

   포인트 수를 제한하는 두 가지 기본적인 이유는 성능 및 라인 평활화입니다. 기본값은 그래프의 너비(또는 픽셀 수)로, 그래프 패널이 표시할 수 있는 것보다 더 많은 데이터 포인트를 갖지 않도록 합니다.

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

   Amazon Managed Grafana는 템플릿 쿼리에서 변수로 사용할 수 있는 적절한 간격을 자동으로 계산합니다. 변수는 초(`$__interval`) 또는 밀리초(`$__interval_ms`)입니다. 일반적으로 `sum` 또는 `average`와 같은 집계 함수에 사용됩니다. 예를 들어 다음은 간격 변수(`rate(http_requests_total[$__interval])`)를 사용하는 Prometheus 쿼리입니다.

   이 자동 간격은 그래프의 너비를 기준으로 계산됩니다. 사용자가 많이 축소하면 간격이 커져 대략적인 집계가 생성됩니다. 사용자가 확대하면 간격이 줄어 보다 세분화된 집계가 생성됩니다.

   자세한 내용은 [전역 변수](variables-types.md#global-variables) 단원을 참조하십시오.
+  **상대 시간** - 대시보드의 오른쪽 상단에 있는 대시보드 시간 선택기에서 선택한 것과 다르게 개별 패널의 상대 시간 범위 재정의. 그러면 동일한 대시보드에서 서로 다른 기간 또는 날짜의 지표를 표시할 수 있습니다.
+  **시간 전환** - 개별 패널의 시간 범위를 재정의하는 또 다른 방법을 제공합니다. 이 함수는 상대 시간 범위에서만 작동하며 시간 범위를 조정할 수 있습니다.

   예를 들어 패널의 시간 범위를 대시보드 시간 선택기보다 2시간 빠르게 전환할 수 있습니다. 자세한 내용은 [시간 범위 제어](dashboard-time-range-controls.md) 단원을 참조하십시오.
+  **캐시 제한 시간** - (이 필드는 데이터 소스에서 사용할 수 있는 경우에만 표시됩니다.) 시계열 저장소에 쿼리 캐시가 있는 경우 기본 캐시 제한 시간을 재정의합니다. 숫자 값(초 단위)으로 지정됩니다.

### 쿼리 검사기 버튼
<a name="query-inspector-button"></a>

 **쿼리 검사기**를 선택하여 패널 검사기의 **쿼리** 탭을 열 수 있습니다. **쿼리** 탭에서는 패널에서 전송한 쿼리 요청과 응답을 볼 수 있습니다.

 **새로 고침**을 선택하여 이 패널에서 서버로 보낸 요청의 전체 텍스트를 확인합니다.

**참고**  
 쿼리 검사기에서 결과를 반환하기 전에 먼저 하나 이상의 쿼리를 추가해야 합니다.

 패널 검사기에 대한 자세한 내용은 [패널 검사](inspect-a-panel.md) 섹션을 참조하세요.

### 쿼리 편집기 목록
<a name="query-editor-list"></a>

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

## 패널 간 쿼리 결과 공유
<a name="share-query-results-between-panels"></a>

 Amazon Managed Grafana를 사용하면 한 패널의 쿼리 결과를 대시보드의 다른 패널에서 사용할 수 있습니다. 패널 간에 쿼리 결과를 공유하면 데이터 소스에 대한 쿼리 수가 줄어들어 대시보드 성능이 향상될 수 있습니다.

 대시보드 데이터 소스를 사용하면 대시보드에서 결과를 공유하려는 쿼리가 포함된 패널을 선택할 수 있습니다. 각 패널에 대해 별도의 쿼리를 전송하는 대신 Amazon Managed Grafana는 하나의 쿼리를 전송하고 다른 패널은 쿼리 결과를 사용하여 시각화를 구성합니다.

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

**다른 패널과 데이터 소스 쿼리를 공유하는 방법**

1.  대시보드를 생성합니다. 자세한 내용은 [대시보드 생성](getting-started-grafanaui.md#create-a-dashboard) 단원을 참조하십시오.

1.  패널을 추가하세요. 자세한 내용은 [패널 추가](add-a-panel-to-a-dashboard.md) 단원을 참조하십시오.

1.  제목을 **Source panel**로 변경하세요. 이 패널을 다른 패널의 소스로 사용합니다. 공유할 쿼리 또는 쿼리를 정의하세요. 현재 데이터 소스를 사용할 수 없는 경우 테스트에 사용할 수 있는 무작위 시계열을 반환하는 **Grafana** 데이터 소스를 사용할 수 있습니다.

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

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

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

 쿼리가 정의된 패널로 이동하려면 해당 쿼리를 선택하세요.

# 기록된 쿼리
<a name="recorded-queries"></a>

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

기록된 쿼리를 사용하여 설정된 간격으로 데이터 포인트의 스냅샷을 생성해 시간 경과에 따른 추세를 확인할 수 있습니다. 이를 통해 과거 추세에 대한 인사이트를 얻을 수 있습니다.

시계열을 반환하지 않는 플러그인의 경우 기록 데이터를 도표화하는 것이 유용할 수 있습니다. 예를 들어 요청 응답 시간 기록을 보기 위해 **ServiceNow**를 쿼리할 수 있지만 이 경우 현재 특정 시점 지표만 반환할 수 있습니다.

## 기록된 쿼리 작동 방식
<a name="how-recorded-queries-work"></a>

기록된 쿼리는 백엔드 데이터 소스 플러그인에서만 작동합니다. 자세한 내용은 [Backend data source plugin](https://grafana.com/tutorials/build-a-data-source-backend-plugin/)을 참조하세요. 세 가지 유형의 쿼리를 기록할 수 있습니다.
+ 단일 행 및 열 - 단일 행 및 열을 반환하는 쿼리.
+ 행 수 - 의미 있는 행을 계산할 수 있도록 반환하는 쿼리.
+ 표현식 - 모든 표현식. 표현식 생성 및 사용에 대한 자세한 내용은 [Expressions](https://grafana.com/docs/grafana/next/panels-visualizations/query-transform-data/expression-queries/)를 참조하세요.

기록된 쿼리가 생성되거나 활성화된 후에는 즉시 스냅샷을 생성하고 설정된 간격으로 스냅샷을 계속 생성합니다. 기록된 쿼리는 비활성화되거나 삭제되거나 Grafana가 실행 중이 아닐 때 스냅샷 캡처를 중지합니다. 기록된 쿼리를 실행하고 각 결과를 원격 쓰기 지원 Prometheus 인스턴스로 전달하여 백엔드에서 데이터 포인트가 수집됩니다.

**참고**  
기록된 쿼리를 사용하려면 먼저 Prometheus 데이터 소스를 구성하고 원격 쓰기 대상에 연결해야 합니다.

## 기록된 쿼리 생성
<a name="create-a-recorded-query"></a>

기록된 쿼리를 생성하려면 다음 단계를 완료하세요.

1. 편집 패널의 대시보드에서 기록할 쿼리를 찾거나 생성하세요. 쿼리는 하나의 행과 열만 반환해야 합니다. 더 많이 반환하는 경우에도 *개수* 옵션을 사용하여 반환된 결과 수를 기록할 수 있습니다. 쿼리의 데이터 소스는 백엔드 데이터 소스여야 합니다. 표현식을 사용하여 시계열 쿼리의 데이터를 집계할 수 있습니다. 표현식 생성 및 사용에 대한 자세한 내용은 [Expressions](https://grafana.com/docs/grafana/next/panels-visualizations/query-transform-data/expression-queries/)를 참조하세요.

1. 쿼리 편집기에 있는 **쿼리 기록** 메뉴를 선택하세요.

1. 기록된 쿼리 정보를 입력하세요. 별도의 설명이 없는 한 모든 필드는 필수 필드입니다.
   + 이름 - 기록된 쿼리의 이름.
   + 설명 - (선택 사항) 기록된 쿼리 목록에 표시할 기록된 쿼리를 설명합니다.
   + 간격 - 스냅샷을 생성할 간격. 간격은 기록된 쿼리를 생성할 때 시작되며 기록된 쿼리를 일시 중지하거나 삭제하면 중지됩니다. 기록된 쿼리 일시 중지 및 삭제에 대한 자세한 내용은 [기록된 쿼리 관리](https://grafana.com/docs/grafana/latest/enterprise/recorded-queries/#manage-recorded-queries)를 참조하세요.
   + 범위 - 쿼리의 상대 시간 범위. 30분 범위와 1시간 간격을 선택하면 쿼리는 1시간마다 지난 30분의 스냅샷을 생성합니다.
   + 쿼리 결과 개수 - 쿼리에서 반환된 행을 계산하려면 이 옵션을 켭니다. 이 옵션이 꺼져 있는 경우 쿼리는 하나의 값을 포함하는 행 하나를 반환해야 합니다.

1. 기록된 쿼리 테스트 버튼을 선택하여 기록된 쿼리를 테스트하세요.

1. **쿼리 기록 시작**을 선택하세요.

## 기록된 쿼리 추가
<a name="Adding-a-recorded-query"></a>

대시보드의 패널에 기존의 기록된 쿼리를 추가할 수 있습니다. 추가하는 각 기록된 쿼리에 대해 Prometheus 쿼리(`generated_recorded_query_name{id="generated_id", name="recorded query name"}`)가 생성됩니다. Prometheus에서 생성된 쿼리는 기록된 쿼리의 수집된 모든 스냅샷을 반환합니다.

1. 대시보드에서 기록된 쿼리를 추가하려는 패널로 이동하세요.

1. **\$1 기록된 쿼리** 메뉴를 선택하세요.

1. 데이터 소스별로 기록된 쿼리를 필터링하려면 데이터 소스별 필터 드롭다운 메뉴에서 데이터 소스를 선택하세요.

1. 기록된 쿼리에서 **추가** 메뉴를 선택하여 패널에 추가하세요.

패널에 기록된 쿼리를 추가하면 패널 데이터 소스는 `-- Mixed --`가 됩니다. 기록된 쿼리는 기록된 쿼리 이름과 일치하는 이름 레이블의 `Prometheus` 쿼리로 표시됩니다. Prometheus 데이터 소스에 대한 자세한 내용은 [Prometheus](https://grafana.com/docs/grafana/latest/datasources/prometheus/)를 참조하세요.

기록된 쿼리를 추가한 후 Prometheus 데이터 소스 대신 `-- Mixed --` 데이터 소스를 포함하는 쿼리가 나타나는 경우, 기록된 쿼리에 대해 `Prometheus ` 원격 쓰기 대상이 설정되지 않았음을 의미할 수 있습니다. [원격 쓰기 대상](https://grafana.com/docs/grafana/latest/enterprise/recorded-queries/#remote-write-target)을 참조하여 원격 쓰기 포인트를 설정하세요.

## 기록된 쿼리 사용
<a name="using-a-recorded-query"></a>

기록된 쿼리를 사용하려면 쿼리를 생성하고 대시보드에 추가하세요. 그런 다음, **기록된 쿼리** 탭의 **기본 설정**에서 관리할 수 있습니다.

## 기록된 쿼리 관리
<a name="managing-recorded-queries"></a>

기록된 쿼리는 기본 설정의 기록된 쿼리 탭에서 활성화 및 삭제하거나 일시 중지할 수 있습니다. 기록된 쿼리를 삭제하면 Grafana에서 제거되지만 Prometheus에서 수집된 정보는 그대로 유지됩니다. 기록된 쿼리를 일시 중지하면 다시 시작될 때까지 새 데이터 포인트가 더 이상 수집되지 않습니다.

## 원격 쓰기 대상
<a name="remote_write_target"></a>

원격 쓰기 대상은 기록된 쿼리 데이터 포인트를 쓰는 **Prometheus** 데이터 소스입니다. 원격 쓰기가 활성화된 Prometheus가 필요하며 이 Prometheus에 대한 데이터 소스를 생성해야 합니다.

원격 쓰기 대상을 편집하려면 콘솔 메뉴에서 **기본 설정**의 **기록된 쿼리** 탭에 있는 **원격 쓰기 대상 편집**을 선택하세요. 원격 쓰기가 활성화된 **Prometheus** 데이터 소스를 선택하고 원격 쓰기 경로를 입력하세요니다.

# 변환
<a name="panel-transformations"></a>

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

시각화로 전달하기 전에 변환으로 결과 세트를 처리합니다. Amazon Managed Grafana 패널 편집기의 **변환** 탭에서 변환에 액세스합니다.

변환을 사용하여 필드 이름을 바꾸고, 별도의 시계열을 조인하며, 쿼리 간에 수학을 수행하는 등의 작업을 수행할 수 있습니다. 대시보드가 크거나 쿼리가 많은 경우 한 패널에서 다른 패널로 쿼리 결과를 재사용할 수 있으면 성능이 크게 향상될 수 있습니다.

**참고**  
변환에서는 그래프로 표시할 수 없는 데이터가 발생하기도 합니다. 이 경우 Amazon Managed Grafana에서는 시각화에 제안을 표시합니다. 테이블 시각화로 전환할 제안을 선택합니다. 그러면 변환이 데이터에 어떤 영향을 미치는지 더 잘 이해하는 데 도움이 됩니다.

Amazon Managed Grafana에서는 화면에 나열된 순서대로 변환을 적용합니다. 모든 변환은 파이프라인의 다음 변환으로 전달되는 새 결과 세트를 생성합니다.

이 순서에 따라 결과 표시가 크게 달라질 수 있습니다. 예를 들어 축소 변환을 사용하여 한 열의 모든 결과를 단일 값으로 압축하는 경우 해당 단일 값에만 변환을 적용할 수 있습니다.

**사전 조건**

변환을 적용하기 전에 다음 사항을 모두 충족해야 합니다.
+ 쿼리를 입력하고 데이터 소스에서 데이터를 반환했습니다. 쿼리에 대한 자세한 내용은 [쿼리](panel-queries.md) 섹션을 참조하세요.
+ 다음 시각화 중 하나와 같이 쿼리를 지원하는 시각화를 적용했습니다.
  + 막대 게이지
  + Gauge
  + 그래프
  + 히트맵
  + 로그
  + Stat
  + 표

## 변환 적용
<a name="apply-a-transformation"></a>

 변환은 **쿼리** 탭 옆의 패널 편집기 하단 창의 **변환** 탭에서 사용할 수 있습니다.

**변환을 적용하는 방법**

1.  변환을 추가하려는 패널에서 패널 제목을 선택하고 **편집**을 선택하세요.

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

1.  변환을 선택하세요.

    표시되는 변환 행에서 변환 옵션을 구성할 수 있습니다.

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

 문제가 있는 경우 버그 아이콘을 선택하여 [변환을 디버깅](#debug-transformations)합니다.

 변환을 제거하려면 휴지통 아이콘을 선택하세요.

## 변환 유형 및 옵션
<a name="transformation-types-and-options"></a>

 Grafana 워크스페이스에는 다음과 같은 변환이 포함됩니다.

**Topics**
+ [축소](#reduce)
+ [병합](#merge)
+ [이름별 필터링](#filter-by-name)
+ [쿼리를 기준으로 데이터 필터링](#filter-data-by-query)
+ [필드 구성](#organize-fields)
+ [필드별 조인(외부 조인)](#join-by-field-outer-join)
+ [계산에서 필드 추가](#add-field-from-calculation)
+ [레이블에서 필드로](#labels-to-fields)
+ [그룹화 기준](#sort-by)
+ [그룹화 기준](#group-by)
+ [시리즈에서 행으로](#series-to-rows)
+ [값을 기준으로 데이터 필터링](#filter-data-by-value)
+ [디버그 변환](#debug-transformations)

### 축소
<a name="reduce"></a>

 결과를 한 값으로 단순화하려는 경우 **축소** 변환을 적용합니다. 축소는 기본적으로 시간 구성 요소를 제거합니다. 테이블로 시각화되면 열을 하나의 행(값)으로 줄입니다.

 **계산** 필드에 하나 이상의 계산 유형을 입력하세요. 계산 선택 목록을 보려는 경우에 선택합니다. 사용할 수 있는 계산에 대한 자세한 내용은 [계산 목록](list-of-calculations.md) 섹션을 참조하세요.

하나 이상의 계산을 선택하면 Amazon Managed Grafana에서 선택한 계산을 사용하여 하나의 값을 표시합니다. 둘 이상의 계산을 선택하면 둘 이상의 값이 표시됩니다.

### 병합
<a name="merge"></a>

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

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

쿼리 A


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

쿼리 B


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

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


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

### 이름별 필터링
<a name="filter-by-name"></a>

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

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

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

### 쿼리를 기준으로 데이터 필터링
<a name="filter-data-by-query"></a>

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

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

### 필드 구성
<a name="organize-fields"></a>

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

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

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

### 필드별 조인(외부 조인)
<a name="join-by-field-outer-join"></a>

 이 변환을 사용하여 필드별 결과 세트에서 여러 시계열을 조인합니다.

 이 변환은 필드의 결과를 계산할 수 있도록 쿼리를 결합하려는 경우에 유용합니다.

### 계산에서 필드 추가
<a name="add-field-from-calculation"></a>

 이 변환을 사용하여 두 개의 다른 필드에서 계산된 새 필드를 추가합니다. 각 변환을 통해 하나의 새 필드를 추가할 수 있습니다.
+  **모드** - 모드를 선택합니다.
  +  **행 축소** - 선택한 필드의 각 행에서 선택한 계산을 독립적으로 적용합니다.
  +  **바이너리 옵션** - 선택한 두 필드의 단일 행 값에 기본 수학 작업(`sum`, `multiply` 등)을 적용합니다.
+  **필드 이름** - 새 필드의 계산에 사용할 필드 이름을 선택합니다.
+  **계산** - Amazon Managed Grafana가 새 필드를 생성할 때 사용할 계산을 선택합니다. 필드를 선택하면 계산 선택 목록이 표시됩니다. 사용할 수 있는 계산에 대한 자세한 내용은 [계산 목록](list-of-calculations.md) 섹션을 참조하세요.
+  **별칭** – (선택 사항) 새 필드의 이름을 입력합니다. 이 항목을 비워 두면 계산과 일치하도록 필드 이름이 지정됩니다.
+  **모든 필드 바꾸기** - (선택 사항) 다른 모든 필드를 숨기고 시각화에 계산된 필드만 표시하려면 이 옵션을 사용합니다.

### 레이블에서 필드로
<a name="labels-to-fields"></a>

**참고**  
 이 변환을 적용하려면 쿼리에서 레이블이 지정된 필드를 반환해야 합니다.

 이 변환을 선택하면 Amazon Managed Grafana에서 레이블이 지정된 모든 데이터를 필드로 자동 변환합니다.

 예를 들어, 두 시계열의 쿼리 결과를 고려합니다.

 1: labels Server=Server A, Datacenter=EU 2: labels Server=Server B, Datacenter=EU 

 이 변환에서는 다음 테이블이 생성됩니다.


|  Time  |  Server  |  데이터 센터  |  값  | 
| --- | --- | --- | --- | 
|  2020-07-07 11:34:20  |  Server A  |  EU  |  1  | 
|  2020-07-07 11:34:20  |  Server B  |  EU  |  2  | 

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


|  Time  |  데이터 센터  |  Server A  |  Server B  | 
| --- | --- | --- | --- | 
|  2020-07-07 11:34:20  |  EU  |  1  |  2  | 

### 그룹화 기준
<a name="sort-by"></a>

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

### 그룹화 기준
<a name="group-by"></a>

 이 변환은 지정된 필드(열) 값을 기준으로 데이터를 그룹화하고 각 그룹에 대한 계산을 처리합니다. 사용 가능한 계산은 축소 변환과 동일합니다.

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


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

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


|  Time  |  서버 ID  |  CPU 온도  |  서버 상태  | 
| --- | --- | --- | --- | 
|  2020-07-07 11:34:20  |  server 1  |  80  |  Shutdown  | 
|  2020-07-07 09:28:06  |  server 1  |  80  |  정상  | 
|  2020-07-07 09:23:07  |  server 1  |  86  |  정상  | 

```
2020-07-07 10:32:20 | server 2 | 90 | Overload
2020-07-07 09:30:05 | server 2 | 88 | OK
2020-07-07 09:25:05 | server 2 | 88 | OK

2020-07-07 11:34:20 | server 3 | 62 | OK
2020-07-07 10:31:22 | server 3 | 55 | OK
2020-07-07 09:30:57 | server 3 | 62 | Rebooting
```

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

데이터를 그룹화할 기준이 되는 필드를 선택한 후 다른 필드에 다양한 계산을 추가할 수 있으며 계산은 각 행 그룹에 적용됩니다. 예를 들어 이러한 각 서버에 대한 평균 `CPU temperature`를 계산할 수 있습니다. `CPU Temperature` 필드에 적용된 *평균* 계산을 추가하여 다음을 가져올 수 있습니다.


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

그리고 이러한 계산 중 둘 이상을 추가할 수 있습니다. 예를 들어 다음 계산을 사용할 수 있습니다.
+  `Time` 필드의 경우 *마지막* 값을 계산하여 각 서버에 대해 마지막 데이터 포인트가 수신된 시점을 알 수 있습니다.
+  `Server Status` 필드의 경우 *마지막* 값을 계산하여 각 서버에 대한 마지막 상태 값을 알 수 있습니다.
+  `Temperature` 필드의 경우 *마지막* 값을 계산하여 각 서버에 대해 모니터링된 최신 온도를 알 수 있습니다.

 그룹화 기준 변환에서는 다음 결과를 생성합니다.


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

이 변환을 사용하면 시계열에서 몇 가지 주요 정보를 추출하여 편리한 방식으로 표시할 수 있습니다.

### 시리즈에서 행으로
<a name="series-to-rows"></a>

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

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

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

 쿼리 A 


|  Time  |  Temperature  | 
| --- | --- | 
|  2020-07-07 11:34:20  |  25  | 
|  2020-07-07 10:31:22  |  22  | 
|  2020-07-07 09:30:05  |  19  | 

 쿼리 B 


|  Time  |  습도  | 
| --- | --- | 
|  2020-07-07 11:34:20  |  24  | 
|  2020-07-07 10:32:20  |  29  | 
|  2020-07-07 09:30:57  |  33  | 

 `Series to rows` 변환을 적용하면 다음과 같은 결과가 생성됩니다.


|  Time  |  지표  |  값  | 
| --- | --- | --- | 
|  2020-07-07 11:34:20  |  Temperature  |  25  | 
|  2020-07-07 11:34:20  |  습도  |  22  | 
|  2020-07-07 10:32:20  |  습도  |  29  | 
|  2020-07-07 10:31:22  |  Temperature  |  22  | 
|  2020-07-07 09:30:57  |  습도  |  33  | 
|  2020-07-07 09:30:05  |  Temperature  |  19  | 

### 값을 기준으로 데이터 필터링
<a name="filter-data-by-value"></a>

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

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

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

숫자 필드에 대해 사용할 수 있는 조건은 다음과 같습니다.
+  **초과** - 값이 지정된 값보다 큰 경우 일치합니다.
+  **미만** - 값이 지정된 값보다 작은 경우 일치합니다.
+  **이상** - 값이 지정된 값 이상인 경우 일치합니다.
+  **이하** - 값이 지정된 값 이하인 경우 일치합니다.
+  **범위** - 지정된 최솟값과 최댓값 사이의 범위를 일치시킵니다. 최솟값과 최댓값은 범위에 포함됩니다.

필터에 둘 이상의 조건을 추가할 수 있습니다. 조건이 둘 이상인 경우 모든 조건 또는 추가한 조건과 일치하는 행에 포함 또는 제외 작업을 적용할지 여부를 선택할 수 있습니다.

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

### 디버그 변환
<a name="debug-transformations"></a>

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

 Amazon Managed Grafana에서는 변환 행 아래에 디버그 변환 보기를 표시합니다.

# 필드 옵션 및 재정의
<a name="field-options-overrides"></a>

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

 이 섹션에서는 Amazon Managed Grafana의 필드 옵션 및 필드 재정의 개념과 이를 사용하는 방법을 설명합니다.

 Grafana 워크스페이스에 사용되는 데이터 모델(데이터 프레임)은 시계열 및 테이블 쿼리 결과를 모두 통합하는 열 중심의 테이블 구조입니다. 이 구조 내의 각 열을 *필드*라고 합니다. 필드는 단일 시계열 또는 테이블 열을 나타낼 수 있습니다.

 필드 옵션을 사용하면 시각화에 데이터가 표시되는 방식을 변경할 수 있습니다. 적용하는 옵션 및 재정의는 데이터를 변경하지 않으며 Amazon Managed Grafana에서 데이터를 표시하는 방식을 변경합니다.

## 필드 옵션
<a name="field-options-overview"></a>

 *필드 옵션*(표준 및 사용자 지정 모두)은 패널 편집기의 **필드** 탭에서 찾을 수 있습니다. 이 탭에서 변경된 사항은 모든 필드(즉, 시리즈 및 열)에 적용됩니다. 예를 들어 단위를 백분율로 변경하면 숫자 값이 있는 모든 필드가 백분율로 표시됩니다. [모든 필드 구성](#configure-all-fields)에서 필드 옵션을 적용하는 방법을 알아봅니다.

## 필드 재정의
<a name="field-overrides-overview"></a>

 *필드 재정의*는 패널 편집기의 **재정의** 탭에서 추가할 수 있습니다. 여기에서는 **필드** 탭에서와 동일한 옵션을 추가할 수 있지만 해당 옵션은 특정 필드에만 적용됩니다. [특정 필드 구성](#configure-specific-fields)에서 재정의를 적용하는 방법을 알아봅니다.

## 사용 가능한 필드 옵션 및 재정의
<a name="available-field-options-and-overrides"></a>

 필드 옵션 유형은 필드 옵션 및 필드 재정의 모두에 공통됩니다. 유일한 차이는 변경 사항이 모든 필드(**필드** 탭에서 적용됨)에 적용되는지 아니면 필드 하위 세트(**재정의** 탭에서 적용됨)에 적용되는지 여부입니다.
+  [표준 필드 옵션](#standard-field-options)은 변환을 허용하는 모든 패널 시각화에 적용됩니다.
+  [테이블 필드 옵션](table-panel.md#table-field-options)은 테이블 패널 시각화에만 적용됩니다.

### 모든 필드 구성
<a name="configure-all-fields"></a>

 모든 필드의 데이터 표시 방식을 변경하기 위해 **필드** 탭에서 옵션을 변경할 수 있습니다. **재정의** 탭에서 특정 필드에 대한 필드 옵션을 재정의할 수 있습니다. 자세한 내용은 [특정 필드 구성](#configure-specific-fields) 단원을 참조하십시오.

 예를 들어 **소수점** 옵션을 변경하여 모든 필드에 표시되는 소수점 자릿수를 변경할 수 있습니다. 옵션에 대한 자세한 내용은 [표준 필드 옵션](#standard-field-options) 및 [테이블 필드 옵션](table-panel.md#table-field-options) 섹션을 참조하세요.

#### 필드 옵션 변경
<a name="change-a-field-option"></a>

 원하는 만큼 많은 옵션을 변경할 수 있습니다.

**필드 옵션을 변경하는 방법**

1.  편집할 패널을 선택하고 패널 제목을 선택한 다음, **편집**을 선택하세요.

1.  **필드** 탭을 선택하세요.

1.  변경하려는 옵션을 찾으세요. 다음을 정의할 수 있습니다.
   +  [표준 필드 옵션](#standard-field-options): 변환을 허용하는 모든 패널 시각화에 적용됩니다.
   +  [테이블 필드 옵션](table-panel.md#table-field-options): 테이블 패널 시각화에만 적용됩니다.

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

1.  대시보드 편집을 완료했으면 **저장**을 선택하세요.

#### 필드 옵션 예제
<a name="field-option-example"></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  | 

 이 경우 소수점 자리는 아무 의미도 없습니다. 소수점을 `auto`에서 0(`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  | 

### 특정 필드 구성
<a name="configure-specific-fields"></a>

 재정의를 사용하여 하나 이상의 필드에 대한 설정을 변경할 수 있습니다. 재정의에 대한 필드 옵션은 특정 시각화에서 사용할 수 있는 필드 옵션과 정확히 동일합니다. 유일한 차이는 적용할 필드를 선택한다는 점입니다.

 예를 들어 **숫자**와 일치하는 **다음 유형의 필드**에 대해 **소수점** 옵션을 변경하여 모든 숫자 필드에 표시되는 소수점 자릿수를 변경할 수 있습니다. 옵션에 대한 자세한 내용은 [표준 필드 옵션](#standard-field-options)(변환을 허용하는 모든 패널 시각화에 적용) 및 [테이블 필드 옵션](table-panel.md#table-field-options)(테이블 패널 시각화에만 적용) 섹션을 참조하세요.

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

 원하는 만큼 많은 필드 옵션을 재정의할 수 있습니다.

**필드 재정의를 추가하는 방법**

1.  편집할 패널을 선택하고 패널 제목을 선택한 다음, **편집**을 선택하세요.

1.  **재정의** 탭을 선택하세요.

1.  **재정의 추가 대상**을 선택하세요.

1.  재정의 규칙을 적용할 필드를 선택하세요.
   +  **다음 이름의 필드** - 이 필드를 사용하여 사용 가능한 모든 필드 목록에서 필드를 선택합니다 이 선택기를 사용하여 규칙에 추가하는 속성은 이 단일 필드에만 적용됩니다.
   +  **정규식과 일치하는 이름의 필드** - 정규식으로 재정의할 필드를 지정하려면 이 옵션을 사용합니다. 이 선택기를 사용하여 규칙에 추가하는 속성은 필드 이름이 정규식과 일치하는 모든 필드에 적용됩니다.
   +  **다음 유형의 필드** - 문자열, 숫자 등 유형별로 필드를 선택하려면 이 옵션을 사용합니다. 이 선택기를 사용하여 규칙에 추가하는 속성은 선택한 유형과 일치하는 모든 필드에 적용됩니다.

1.  **재정의 속성 추가**를 선택하세요.

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

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

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

1.  완료하였으면 **저장**을 선택합니다.

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

1.  삭제하려는 재정의를 포함하는 재정의 탭을 선택하세요.

1.  재정의 옆에 있는 휴지통 아이콘을 선택하세요.

#### 필드 재정의 예제
<a name="field-override-example"></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  | 

 [필드 옵션 예제](#field-option-example)의 필드 옵션을 적용하여 섭씨 단위를 적용하고 소수점을 제거합니다. 그러면 다음 표가 생성됩니다.


|  시간  |  고온  |  저온  |  습도  | 
| --- | --- | --- | --- | 
|  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="standard-field-options"></a>

 이 섹션에서는 사용 가능한 필드 옵션을 설명합니다. 사전순으로 나열됩니다.

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

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

 이러한 옵션 적용에 대한 자세한 내용은 다음 섹션을 잠조하세요.
+  [모든 필드 구성](#configure-all-fields) 
+  [특정 필드 구성](#configure-specific-fields) 

#### 소수점
<a name="decimals"></a>

 이 옵션은 값을 렌더링할 때 포함할 소수점 수를 설정합니다. 데이터 소스에서 제공한 소수점을 사용하려면 Amazon Managed Grafana에서 이 옵션을 비워 둡니다.

 이 설정을 변경하려면 필드에 숫자를 입력하세요.

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

 이 옵션은 값 또는 시각화가 연결되는 URL을 제어합니다. 자세한 정보와 지침은 [데이터 링크](data-links.md) 섹션을 참조하십시오.

#### 표시 명칭
<a name="display-name"></a>

 이 옵션은 모든 필드의 표시 제목을 설정합니다. 필드 제목에서 변수를 사용할 수 있습니다. 템플릿 지정 및 템플릿 변수에 대한 자세한 내용은 [템플릿 및 변수](templates-and-variables.md) 섹션을 참조하세요.

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

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


|  표현식 구문  |  예제  |  렌더링 대상  |  설명  | 
| --- | --- | --- | --- | 
|  \$1\$1\$1\$1field.displayName\$1  |  구문과 동일  |  Temp \$1Loc="PBI", Sensor="3"\$1  |  \$1\$1에 필드 이름 및 레이블(있는 경우)을 표시합니다. 응답에 레이블 키가 하나만 있는 경우 레이블 부분에서 Amazon Managed Grafana는 묶는 괄호 없이 레이블 값을 표시합니다. | 
|  \$1\$1\$1\$1field.name\$1  |  구문과 동일  |  Temp  |  필드 이름을 표시합니다(레이블 제외). | 
|  \$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="max"></a>

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

#### 최소
<a name="min"></a>

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

#### 값 없음
<a name="no-value"></a>

 필드 값이 비어 있거나 null인 경우 Amazon Managed Grafana에서 표시할 값을 입력하세요.

#### 단위
<a name="unit"></a>

 이 옵션에서는 필드가 사용해야 하는 단위를 지정합니다. **단위** 필드를 선택한 다음, 원하는 단위를 찾을 때까지 드릴다운합니다. 선택한 단위는 시간을 제외한 모든 필드에 적용됩니다.

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

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

 사용자 지정 단위를 선택하려면 단위를 입력하고 드롭다운 목록에서 마지막 `Custom: xxx` 옵션을 선택합니다.
+  `suffix:<suffix>`: 값을 초과해야 하는 사용자 지정 단위의 경우.
+  `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="string-units"></a>

 Amazon Managed Grafana에서는 때때로 문자열을 구문 분석하여 숫자로 표시할 수 있습니다. Amazon Managed Grafana에서 원본 문자열을 표시하도록 하려면 필드 재정의를 생성하고 `string` 단위로 단위 속성을 추가합니다.

#### 색상 테마
<a name="color-scheme"></a>

 필드 색상 옵션은 Amazon Managed Grafana에서 시리즈 또는 필드에 대한 색상을 지정하는 방법을 정의합니다. 여기에는 다르게 작동하는 여러 모드가 있으며, 해당 기능은 현재 선택한 시각화에 따라 크게 달라집니다.

 연속 색상 모드는 최소 및 최대를 기준으로 한 값의 백분율을 사용하여 색상을 보간합니다.
+  **단일 색상** - 색상 선택기를 사용하여 설정된 특정 색상. 재정의 규칙에서 가장 유용합니다.
+  **임계치에서** - 일치하는 임계치에서 파생된 색상. 게이지, 통계 및 테이블 시각화에 유용합니다.

##### 시리즈 색상 지정 기준
<a name="color-by-series"></a>

 Amazon Managed Grafana에는 시리즈별로 색상을 정의하는 색상 체계가 포함되어 있습니다. 예를 들어 그래프 및 파이 차트에 유용합니다.

##### 값 기준 색상
<a name="color-by-value"></a>

 Amazon Managed Grafana에는 연속(그라데이션) 색상 체계도 포함되어 있습니다. 이는 통계 패널 및 테이블 패널과 같은 개별 값의 색상을 지정하는 시각화에 유용합니다.

#### Thresholds
<a name="thresholds-overview"></a>

 임계치를 사용하여 값을 기반으로 필드의 색상을 변경할 수 있습니다. 자세한 정보와 지침은 [Thresholds](thresholds.md) 섹션을 참조하십시오.

#### 값 매핑
<a name="value-mapping"></a>

 이 옵션을 사용하여 필드 값 또는 값 범위를 명시적 텍스트로 변환하는 규칙을 설정할 수 있습니다. 두 개 이상의 값 매핑을 추가할 수 있습니다.
+  **매핑 유형** - 옵션을 선택합니다.
  +  **값** - 값을 입력합니다. 필드 값이 값보다 크거나 같으면 **텍스트**가 표시됩니다.
  +  **시작** 및 **종료** - 범위를 입력합니다. 필드 값이 범위의 값 사이이거나 해당 값과 같으면 **텍스트**가 표시됩니다.
+  **텍스트** - 필드에서 조건이 충족되면 표시되는 텍스트. 이 필드는 변수를 허용합니다.

# 패널 편집기
<a name="AMG-panel-editor"></a>

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

 이 주제에서는 Amazon Managed Grafana 패널 편집기의 부분을 설명하며 자세한 정보를 찾을 수 있는 링크를 포함합니다.

## 패널 편집기 열기
<a name="open-the-panel-editor"></a>

 **패널 편집** 화면, *편집 모드* 또는 *패널 편집 모드*와 같이 패널 편집기에 액세스하는 여러 가지 방법이 있습니다.
+  화면 상단의 **패널 추가** 아이콘을 선택한 다음, **새 패널 추가**를 선택합니다. 패널 편집기에서 새 패널이 열립니다. 패널 추가 방법에 대한 자세한 내용은 [패널 추가](add-a-panel-to-a-dashboard.md) 섹션을 참조하세요.
+  기존 패널의 제목을 선택한 다음, **편집**을 선택합니다. 패널이 편집 모드로 열립니다.
+  기존 패널에서 아무 곳이나 선택한 다음, 키보드에서 **e**를 누릅니다. 패널이 편집 모드로 열립니다.

## 패널 편집기 섹션 크기 조정
<a name="resize-panel-editor-sections"></a>

 드래그하여 패널 편집기의 섹션 크기를 조정합니다. 측면 창이 너무 좁아지면 **패널**, **필드** 및 **재정의** 탭이 드롭다운 목록으로 변경됩니다.

## 패널 편집기의 일부
<a name="parts-of-the-panel-editor"></a>

 이 섹션에서는 각 부분과 연결된 필드, 옵션 또는 태스크에 대한 정보와 함께 패널 편집기 화면의 부분을 설명합니다.

### 헤더
<a name="header"></a>

 헤더 섹션에는 패널이 있는 대시보드의 이름과 일부 대시보드 명령이 나열됩니다. **뒤로 이동** 화살표를 선택하여 대시보드로 돌아갈 수도 있습니다.

 헤더 오른쪽에는 다음 옵션이 있습니다.
+  **대시보드 설정(톱니) 아이콘** - 대시보드 설정에 액세스하려면 선택합니다.
+  **삭제** 대시보드를 마지막으로 저장한 이후 패널에서 변경한 모든 사항을 취소하려면 선택합니다.
+  **저장** - 패널 편집기에서 수행한 모든 변경 사항을 포함하여 대시보드를 저장하려면 선택합니다.
+  **적용** - 변경 사항을 적용하려면 선택하고 이후 패널 편집기를 닫고 대시보드로 돌아갑니다. 또한 대시보드를 저장하여 적용된 변경 사항을 유지합니다.

### 시각화 미리 보기
<a name="visualization-preview"></a>

 시각화 미리 보기 섹션에는 보기 옵션, 시간 범위 제어, 시각화 미리 보기, (해당하는 경우) 패널 제목, 축 및 범례가 포함되어 있습니다.
+  **채우기** - 시각화 미리 보기는 미리 보기 부분에서 사용 가능한 공간을 채웁니다. 측면 창의 너비 또는 하단 창의 높이를 변경하면 시각화에서 사용 가능한 공간을 채우도록 조정됩니다.
+  **적합** - 시각화 미리 보기가 사용 가능한 공간에 맞게 채워지지만 패널의 종횡비는 유지됩니다.
+  **정확** - 시각화 미리 보기의 크기는 대시보드의 크기와 정확히 동일합니다. 공간이 충분하지 않으면 종횡비를 유지하며 시각화가 스케일 다운됩니다.
+  **시간 범위 제어** - 자세한 내용은 [시간 범위 제어](dashboard-time-range-controls.md) 섹션을 참조하세요.

### 데이터 섹션(하단 창)
<a name="data-section-bottom-pane"></a>

 데이터 섹션에는 쿼리를 입력하고, 데이터를 변환하며, 알림 규칙을 생성하는 탭(해당하는 경우)이 포함되어 있습니다.
+  **쿼리 탭** - 데이터 소스를 선택하고 여기에 쿼리를 입력합니다. 자세한 내용은 [쿼리](panel-queries.md) 단원을 참조하십시오.
+  **변환 탭** - 데이터 변환을 적용합니다. 자세한 내용은 [변환](panel-transformations.md) 단원을 참조하십시오.
+  **알림 탭** - 알림 규칙을 작성합니다. 자세한 내용은 [Grafana 알림](alerts-overview.md) 단원을 참조하십시오.

### 패널 및 필드 옵션(측면 창)
<a name="panel-and-field-options-side-pane"></a>

 이 섹션에는 데이터 시각화 방법의 거의 모든 측면을 제어하는 탭이 포함되어 있습니다. 각 시각화에서 모든 탭을 사용할 수 있는 것은 아닙니다.

 이러한 탭의 기능은 다음 주제에서 설명합니다.
+  [패널 추가](add-a-panel-to-a-dashboard.md) 
+  [시각화](AMG-visualizations.md) 
+  [필드 옵션 및 재정의](field-options-overrides.md) 
+  [패널 링크](panel-links.md) 및 [데이터 링크](data-links.md)(시각화를 다른 리소스에 연결하는 데 유용함) 

# 라이브러리 패널
<a name="AMG-library-panel"></a>

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

 라이브러리 패널을 사용하면 사용자가 라이브러리 패널의 한 인스턴스에서 변경한 사항이 패널이 사용되는 다른 모든 인스턴스에 영향을 미치는 모든 대시보드에 반영되는 재사용 가능한 패널을 생성할 수 있습니다. 이러한 패널은 대시보드와 함께 폴더에 저장되고 여러 대시보드에서 패널의 재사용을 간소화할 수 있습니다.

## 라이브러리 패널 생성
<a name="library-panel-create"></a>

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

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

1. 평소와 같이 패널을 생성하세요. 기존 패널을 사용할 수도 있습니다.

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

1. 패널 표시 옵션 측면 창에서 아래쪽 화살표 옵션을 선택하여 시각화를 변경하세요.

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

1. 라이브러리 패널의 이름을 입력하고 저장할 폴더를 선택하세요.

1. **라이브러리 패널 생성**을 선택한 다음, 대시보드를 저장하세요.

모든 패널에 대해 **공유** 옵션을 사용하여 라이브러리 패널을 생성할 수도 있습니다.

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

## 라이브러리 패널 추가
<a name="library-panel-add"></a>

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

1. 왼쪽 메뉴의 \$1 옵션에서 일시 중지한 다음, **생성**을 선택하세요.

1. **패널 라이브러리에서 패널 추가**를 선택하세요.

1. 라이브러리 패널 목록을 필터링하여 원하는 패널을 찾으세요.

1. 해당 패널을 선택하고 대시보드에 추가하세요.

## 라이브러리 패널 연결 해제
<a name="library-panel-unlink"></a>

라이브러리 패널의 다른 모든 인스턴스에 영향을 주지 않고 수정하려는 라이브러리 패널이 대시보드에 있는 경우 라이브러리 패널의 연결을 해제할 수 있습니다.

**대시보드에서 라이브러리 패널 연결을 해제하는 방법**

1. 왼쪽 메뉴의 **대시보드**에서 일시 중지한 다음, **라이브러리 패널**을 선택하세요.

1. 라이브러리 패널을 선택하세요. 라이브러리 패널이 사용되는 모든 대시보드의 목록이 표시됩니다.

1. 연결을 해제하고 업데이트할 패널을 선택하세요.

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

1. **링크 해제**를 선택합니다.

## 라이브러리 패널 삭제
<a name="library-panel-delete"></a>

라이브러리 패널을 삭제하기 전에 더 이상 대시보드에서 사용되지 않는지 확인하세요.

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

1. 왼쪽 메뉴의 **대시보드**에서 일시 중지한 다음, **라이브러리 패널**을 선택하세요.

1. 라이브러리 패널을 선택하세요. 라이브러리 패널이 사용되는 모든 대시보드의 목록이 표시됩니다.

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

1. 패널 이름 옆에 있는 삭제 아이콘을 선택하세요.

## 패널 편집기의 일부
<a name="parts-of-the-panel-editor"></a>

 이 섹션에서는 각 부분과 연결된 필드, 옵션 또는 태스크에 대한 정보와 함께 패널 편집기 화면의 부분을 설명합니다.

### 헤더
<a name="header"></a>

 헤더 섹션에는 패널이 있는 대시보드의 이름과 일부 대시보드 명령이 나열됩니다. **뒤로 이동** 화살표를 선택하여 대시보드로 돌아갈 수도 있습니다.

 헤더 오른쪽에는 다음 옵션이 있습니다.
+  **대시보드 설정(톱니) 아이콘** - 대시보드 설정에 액세스하려면 선택합니다.
+  **삭제** 대시보드를 마지막으로 저장한 이후 패널에서 변경한 모든 사항을 취소하려면 선택합니다.
+  **저장** - 패널 편집기에서 수행한 모든 변경 사항을 포함하여 대시보드를 저장하려면 선택합니다.
+  **적용** - 변경 사항을 적용하려면 선택하고 이후 패널 편집기를 닫고 대시보드로 돌아갑니다. 또한 대시보드를 저장하여 적용된 변경 사항을 유지합니다.

### 시각화 미리 보기
<a name="visualization-preview"></a>

 시각화 미리 보기 섹션에는 보기 옵션, 시간 범위 제어, 시각화 미리 보기, (해당하는 경우) 패널 제목, 축 및 범례가 포함되어 있습니다.
+  **채우기** - 시각화 미리 보기는 미리 보기 부분에서 사용 가능한 공간을 채웁니다. 측면 창의 너비 또는 하단 창의 높이를 변경하면 시각화에서 사용 가능한 공간을 채우도록 조정됩니다.
+  **적합** - 시각화 미리 보기가 사용 가능한 공간에 맞게 채워지지만 패널의 종횡비는 유지됩니다.
+  **정확** - 시각화 미리 보기의 크기는 대시보드의 크기와 정확히 동일합니다. 공간이 충분하지 않으면 종횡비를 유지하며 시각화가 스케일 다운됩니다.
+  **시간 범위 제어** - 자세한 내용은 [시간 범위 제어](dashboard-time-range-controls.md) 섹션을 참조하세요.

### 데이터 섹션(하단 창)
<a name="data-section-bottom-pane"></a>

 데이터 섹션에는 쿼리를 입력하고, 데이터를 변환하며, 알림 규칙을 생성하는 탭(해당하는 경우)이 포함되어 있습니다.
+  **쿼리 탭** - 데이터 소스를 선택하고 여기에 쿼리를 입력합니다. 자세한 내용은 [쿼리](panel-queries.md) 단원을 참조하십시오.
+  **변환 탭** - 데이터 변환을 적용합니다. 자세한 내용은 [변환](panel-transformations.md) 단원을 참조하십시오.
+  **알림 탭** - 알림 규칙을 작성합니다. 자세한 내용은 [Grafana 알림](alerts-overview.md) 단원을 참조하십시오.

### 패널 및 필드 옵션(측면 창)
<a name="panel-and-field-options-side-pane"></a>

 이 섹션에는 데이터 시각화 방법의 거의 모든 측면을 제어하는 탭이 포함되어 있습니다. 각 시각화에서 모든 탭을 사용할 수 있는 것은 아닙니다.

 이러한 탭의 기능은 다음 주제에서 설명합니다.
+  [패널 추가](add-a-panel-to-a-dashboard.md) 
+  [시각화](AMG-visualizations.md) 
+  [필드 옵션 및 재정의](field-options-overrides.md) 
+  [패널 링크](panel-links.md) 및 [데이터 링크](data-links.md)(시각화를 다른 리소스에 연결하는 데 유용함) 

# 시각화
<a name="AMG-visualizations"></a>

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

Amazon Managed Grafana에서는 여러 사용 사례에 적합한 다양한 시각화를 제공합니다. 다음 섹션에서는 Amazon Managed Grafana에서 사용할 수 있는 시각화 및 해당 표시 설정을 나열합니다.

**Topics**
+ [알림 목록 패널](alert-list-panel.md)
+ [막대 차트 패널](bar-chart-panel.md)
+ [막대 게이지 패널](alert-panel-bar-gauge-panel.md)
+ [시계 패널](clock-panel.md)
+ [대시보드 목록 패널](dashboard-list-panel.md)
+ [게이지 패널](gauge-panel.md)
+ [Geomap 패널](AMG-Geomap.md)
+ [그래프 패널](graph-panel.md)
+ [히트맵](visualization-heatmap.md)
+ [히스토그램 패널](histogram-panel.md)
+ [로그 패널](logs-panel.md)
+ [뉴스 패널](news-panel.md)
+ [노드 그래프 패널(베타)](node-graph-panel.md)
+ [파이 차트 패널](pie-chart-panel.md)
+ [Plotly 패널](plotly-panel.md)
+ [Sankey 패널](sankey-panel.md)
+ [분산형 패널](scatter-panel.md)
+ [통계 패널](stat-panel.md)
+ [상태 타임라인 패널](state-timeline-panel.md)
+ [상태 기록 패널](status-history-panel.md)
+ [테이블 패널](table-panel.md)
+ [텍스트 패널](text-panel.md)
+ [시계열 패널](time-series-panel.md)
+ [Thresholds](thresholds.md)
+ [WindRose](windrose.md)
+ [패널 검사](inspect-a-panel.md)
+ [계산 목록](list-of-calculations.md)

# 알림 목록 패널
<a name="alert-list-panel"></a>

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

알림 목록 패널에는 대시보드 알림이 표시됩니다. 현재 상태 또는 최근 상태 변경 사항을 표시하도록 목록을 구성할 수 있습니다. 알림에 대한 자세한 내용은 [Grafana 알림](alerts-overview.md) 섹션을 참조하세요.

이러한 설정을 사용하여 시각화를 세분화합니다.

## 옵션
<a name="alert-list-panel-options"></a>
+  **표시** - 패널에서 현재 알림 상태를 표시할지 또는 최근 알림 상태 변경 사항을 표시할지 여부를 선택합니다.
+  **최대 항목** - 나열할 최대 알림 수를 설정합니다.
+  **정렬 순서** - 표시되는 알림 정렬 방법을 선택합니다.
  +  **사전순(오름차순)** - 사전순
  +  **사전순(내림차순)** - 사전의 역순
  +  **중요도** - 다음 값에 따라 중요도에 기반합니다(1이 가장 높음).
    + alerting: 1
    + no\$1data: 2
    + pending: 3
    + ok: 4
    + paused: 5
+  **이 대시보드의 알림** - 알림 목록에 있는 대시보드의 알림만 표시합니다.

## 필터
<a name="alerts-panel-filter"></a>

다음 옵션을 사용하여 선택한 쿼리, 폴더 또는 태그와 일치하도록 알림을 필터링합니다.
+  **알림 이름** - 알림 이름 쿼리를 입력합니다.
+  **대시보드 제목** - 대시보드 제목 쿼리를 입력합니다.
+  **폴더** - 폴더를 선택합니다. 선택한 폴더에 있는 대시보드의 알림만 표시됩니다.
+  **대시보드 태그** - 하나 이상의 태그를 선택합니다. 하나 이상의 태그가 있는 대시보드의 알림만 표시됩니다.

## 상태 필터
<a name="alert-panel-state-filter"></a>

이 패널에 표시할 알림 상태를 선택하세요.
+ 정상
+ Paused
+ 데이터 없음
+ 실행 오류
+ 알림
+ 보류중

# 막대 차트 패널
<a name="bar-chart-panel"></a>

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

이 패널 시각화를 사용하면 범주형 데이터를 그래프로 표시할 수 있습니다.

## 지원되는 데이터 형식
<a name="bar-chart-formats"></a>

하나의 데이터 프레임만 지원되며 X 또는 Y축의 카테고리로 사용할 하나 이상의 문자열 필드와 하나 이상의 숫자 필드가 있어야 합니다. 다음은 데이터 형식 예제입니다.


|  브라우저  |  시장 점유율  | 
| --- | --- | 
|  Chrome  |  50  | 
|  Internet Explorer  |  17.5  | 

숫자 필드가 두 개 이상인 경우 패널에 그룹화된 막대가 표시됩니다.

### 시계열 또는 여러 결과 세트 시각화
<a name="bar-chart-visualization"></a>

시계열이나 테이블이 여러 개 있는 경우 먼저 조인 또는 축소 변환을 사용하여 조인해야 합니다. 예를 들어 시계열이 여러 개이고 마지막 값과 최댓값을 비교하려면 축소 변환을 추가하고 계산에서 최대 및 마지막을 옵션으로 지정합니다.

## 막대 차트 옵션
<a name="bar-chart-options"></a>

다음 옵션을 사용하여 시각화를 세분화합니다.

**Orientation(방향)**
+  **자동** – Grafana는 패널 차원을 기반으로 막대 방향을 결정합니다.
+  **가로** - X축을 카테고리 축으로 설정합니다.
+  **세로** - Y축을 카테고리 축으로 설정합니다.

**값 표시**

값이 막대의 상단에 표시되는지 또는 왼쪽에 표시되는지 여부를 제어합니다.
+  **자동** - 공백이 있는 경우 값이 표시됩니다.
+  **항상** - 항상 값을 표시합니다.
+  **안 함** - 값을 표시하지 않습니다.

**그룹 너비**는 그룹의 너비를 제어합니다. 0=최소 너비 및 1=최대 너비.

**막대 너비**는 막대의 너비를 제어합니다. 0=최소 너비 및 1=최대 너비.

**선 너비**에서는 막대의 선 너비를 제어합니다.

**채우기 불투명도**에서는 막대의 채우기 불투명도를 제어합니다.

**그라데이션 모드**에서는 그라데이션 채우기 모드를 설정합니다. 채우기 그라데이션은 선 색상을 기반으로 합니다. 색상을 변경하려면 표준 색상 체계 필드 옵션을 사용합니다. 그라데이션 모양은 채우기 불투명도 설정의 영향을 받습니다.
+  **없음** - 그라데이션 채우기를 적용하지 않습니다. 기본 설정입니다.
+  **불투명도** - 그라데이션 투명도는 y축의 값을 기반으로 계산됩니다. Y축의 값에 따라 채우기 불투명도가 증가합니다.
+  **색조** - 그라데이션 색상은 선 색상의 색조에 기반하여 생성됩니다.

**툴팁 모드** - 시각화 위에 커서를 놓으면 Grafana에서 툴팁을 표시할 수 있습니다. 툴팁 동작을 선택합니다.
+  **단일** - 가리키기 툴팁에는 시각화에서 가리키고 있는 시리즈인 단일 시리즈만 표시됩니다.
+  **모두** - 가리키기 툴팁에는 그래프의 모든 시리즈가 표시됩니다. Grafana는 툴팁의 시리즈 목록에서 가리킨 시리즈를 굵게 강조 표시합니다.
+  **숨김** - 시각화와 상호 작용할 때 툴팁을 표시하지 않습니다.

**참고**  
재정의를 사용하여 툴팁에서 개별 시리즈를 숨깁니다.

**범례 모드** - 이러한 설정을 사용하여 시각화에 범례가 표시되는 방식을 세분화합니다.
+  **목록** - 범례를 목록으로 표시합니다. 범례의 기본 표시 모드입니다.
+  **테이블** - 범례를 테이블로 표시합니다.
+  **숨김** - 범례를 숨깁니다.

**범례 배치** - 범례를 배치할 위치를 선택합니다.
+  **하단** - 그래프 아래.
+  **오른쪽** - 그래프의 오른쪽.

**범례 계산** - 범례에 표시할 표준 계산 중에서 선택합니다. 둘 이상을 보유할 수 있습니다.

**텍스트 크기** - 막대 차트의 텍스트 크기를 변경하려면 값을 입력합니다.

**축** - 다음 필드 설정을 사용하여 축 표시 방식을 세분화합니다. 편집하려는 필드 옵션 상자 외부를 클릭하거나 Enter를 누를 때까지 일부 필드 옵션은 시각화에 영향을 주지 않습니다.
+  **배치** - Y축의 배치를 설정합니다.
+  **자동** – Grafana는 시리즈에 Y축을 자동으로 할당합니다. 단위가 서로 다른 시리즈가 둘 이상 있는 경우 Grafana는 왼쪽 축을 첫 번째 단위에 할당하고 오른쪽을 다음 단위에 할당합니다.
+  **왼쪽** - 왼쪽에 모든 Y축을 표시합니다.
+  **오른쪽** - 오른쪽에 모든 Y축을 표시합니다.
+  **숨김** - 모든 Y축을 숨깁니다.
+  **레이블** - Y축 텍스트 레이블을 설정합니다. Y축이 둘 이상인 경우 재정의를 통해 다른 레이블을 할당할 수 있습니다.
+  **너비** - 축의 고정 너비를 설정합니다. 기본적으로 Grafana는 축의 너비를 동적으로 계산합니다.

  축의 너비를 설정하면 축 유형이 다른 데이터가 동일한 표시 비율을 공유할 수 있습니다. 이렇게 하면 축이 서로 시각적으로 근접하여 이동 또는 확장되지 않기 때문에 데이터에 대한 둘 이상의 그래프에서 의미를 더 쉽게 비교할 수 있습니다.
+  **소프트 최소 및 소프트 최대** - Y축 제한을 더 잘 제어할 수 있도록 소프트 최소 및 소프트 최대 옵션을 설정합니다. 기본적으로 Grafana는 데이터세트를 기반으로 Y축의 범위를 자동으로 설정합니다.

  소프트 최소 및 소프트 최대 설정은 데이터가 대부분 평탄할 때 일시적 변화가 크게 확대되는 것을 방지할 수 있습니다. 표준 최소 및 최대 필드 옵션에서 파생된 하드 최소 또는 최대는 정의된 지점을 지나 스파이크를 클리핑하여 간헐적인 스파이크가 유용한 세부 정보를 평탄화하는 것을 방지할 수 있습니다.

  표준 최소/최대 옵션을 설정하여 Y축의 하드 제한을 정의할 수 있습니다.

# 막대 게이지 패널
<a name="alert-panel-bar-gauge-panel"></a>

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

막대 게이지는 모든 필드를 단일 값으로 축소하여 데이터를 단순화합니다. Amazon Managed Grafana에서 축소를 계산하는 방법을 선택합니다.

이 패널은 쿼리가 반환하는 시리즈, 행 또는 열 수에 따라 하나 이상의 막대 게이지를 표시할 수 있습니다.

## 데이터 및 필드 옵션
<a name="bar-gauge-data-and-field-options"></a>

막대 게이지 시각화를 사용하면 다음 옵션을 적용할 수 있습니다.
+  [변환](panel-transformations.md) 
+  [필드 옵션 및 재정의](field-options-overrides.md) 
+  [Thresholds](thresholds.md) 

## 표시 옵션
<a name="bar-gauge-display-options"></a>

다음 옵션을 사용하여 시각화를 세분화합니다.
+  **표시** - Amazon Managed Grafana가 데이터를 표시하는 방법을 선택합니다.
  +  **계산** - 모든 행을 기반으로 계산된 값을 표시합니다. 사용 가능한 계산 목록은 [계산 목록](list-of-calculations.md) 섹션을 참조하세요.
  +  **모든 값** - 모든 행에 대해 별도의 통계를 표시합니다. 이 옵션을 선택하면 **제한** 또는 표시할 최대 행 수를 선택할 수도 있습니다.
+  **값** - Amazon Managed Grafana에서 여러 필드를 단일 값으로 줄이는 데 사용할 축소기 함수를 선택합니다. **값** 목록을 선택하여 함수와 간략한 설명을 확인합니다.
+  **방향** - 스택 방향을 선택합니다.
  +  **Auto** – Amazon Managed Grafana에서 가장 적합하다고 생각되는 방향을 선택합니다.
  +  **가로** - 막대가 가로로 확장됩니다(왼쪽에서 오른쪽 방향).
  +  **세로** - 막대가 세로로 확장됩니다(위에서 아래 방향).
+  **표시 모드** - 표시 모드를 선택합니다.
  +  **그라데이션** - 임계치 수준을 선택하여 그라데이션을 정의합니다.
  +  **레트로 LCD** - 켜지거나 켜지지 않은 작은 셀로 분할된 게이지를 표시합니다.
  +  **기본** - 일치하는 임계치를 기반으로 단일 색상을 사용합니다.
+  **채워지지 않은 영역 표시** - 막대의 채워지지 않은 리전을 짙은 회색으로 렌더링하려면 이 옵션을 선택합니다. 레트로 LCD 표시 모드에서는 이 옵션을 사용할 수 없습니다.

# 시계 패널
<a name="clock-panel"></a>

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

시계 패널에는 현재 시간 또는 카운트다운이 표시됩니다. 1초마다 업데이트됩니다.
+ **모드** - 기본값은 **시간**입니다. **카운트다운**을 선택하는 경우 **카운트다운 마감 시간**을 설정하여 카운트다운을 시작합니다.
+ **12시간 또는 24시간** - 시간을 표시하는 옵션은 12시간 형식과 24시간 형식입니다.
+ **시간대** - 시간대는 순간 시간대 라이브러리에서 제공됩니다. 기본값은 컴퓨터의 시간대입니다.
+ **카운트다운 마감 시간** - **모드**를 카운트다운으로 설정한 경우 **카운트다운**을 적용할 시간과 날짜를 지정합니다.
+ **카운트다운 종료 텍스트** - 카운트다운이 종료될 때 표시할 텍스트를 지정합니다.
+ **날짜/시간 형식 지정 옵션** - 글꼴 크기, 가중치 및 날짜/시간 형식을 사용자 지정합니다. 카운트다운을 표시하고 초의 카운트다운을 표시하지 않으려면 시간 형식을 24시간 시계의 경우 `hh:mm`으로, 12시간 시계의 경우 `h:mm A`로 변경합니다. 전체 옵션 목록은 [표시](https://momentjs.com/docs/#/displaying/)를 참조하세요.
+ **배경 색상** - 시계의 배경 색상을 선택합니다.

# 대시보드 목록 패널
<a name="dashboard-list-panel"></a>

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

대시보드 목록 패널에는 다른 대시보드에 대한 동적 링크가 표시됩니다. 별표가 지정된 대시보드, 최근 조회한 대시보드, 검색 쿼리 및 대시보드 태그를 사용하도록 목록을 구성할 수 있습니다.

대시보드를 로드할 때마다 이 패널은 대시보드 목록을 쿼리하여 항상 최신 결과를 제공합니다.

## 옵션
<a name="options-1"></a>

다음 옵션을 사용하여 시각화를 세분화합니다.
+  **별표** - 별표가 지정된 대시보드를 사전순으로 표시합니다.
+  **최근 조회** - 최근 조회한 대시보드를 사전순으로 표시합니다.
+  **검색** - 검색 쿼리 또는 태그별로 대시보드를 표시합니다. 이 옵션을 사용하려면 **쿼리** 또는 **태그**에 값을 하나 이상 입력해야 합니다.
+  **제목 표시** - 선택한 목록 선택 항목(별표, 최근 조회, 검색)을 제목으로 표시합니다.
+  **최대 항목** - 섹션당 나열할 최대 항목 수를 설정합니다. 예를 들어 기본값(10)에서 별표가 지정되고 최근 조회한 대시보드를 표시하도록 선택하면 패널에는 최대 20개의 총 대시보드(섹션당 10개)가 표시됩니다.

### 검색
<a name="panel-dashboard-list-search"></a>

다음 옵션은 **검색** 옵션을 선택한 경우에만 적용됩니다.
+  **쿼리** - 검색하려는 쿼리를 입력합니다. 쿼리는 대소문자를 구분하지 않으며 부분 값이 허용됩니다.
+  **폴더** - 표시할 대시보드 폴더를 선택합니다.
+  **태그** - 검색할 태그를 입력합니다. 기존 태그는 입력할 때 표시되지 않으며 태그는 대소문자를 *구분*합니다.

**참고**  
여러 태그와 문자열이 나타나면 대시보드 목록에 *모든* 조건과 일치하는 태그와 문자열이 표시됩니다.

# 게이지 패널
<a name="gauge-panel"></a>

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

 **게이지**는 모든 시리즈, 열 또는 행에 대해 게이지를 반복할 수 있는 단일 값 패널입니다.

## 데이터 및 필드 옵션
<a name="gauge-panel-data-and-field-options"></a>

게이지 시각화를 사용하면 다음 옵션을 적용할 수 있습니다.
+  [변환](panel-transformations.md) 
+  [필드 옵션 및 재정의](field-options-overrides.md) 
+  [Thresholds](thresholds.md) 

## 표시 옵션
<a name="gauge-panel-display-options-2"></a>

시각화를 세분화하려면 다음 옵션을 사용합니다.
+  **표시** - Amazon Managed Grafana가 데이터를 표시하는 방법을 선택합니다.
  +  **계산** - 모든 행을 기반으로 계산된 **값**을 표시합니다. 사용 가능한 계산 목록은 [계산 목록](list-of-calculations.md) 섹션을 참조하세요.
  +  **모든 값** - 모든 행에 대해 별도의 통계를 표시합니다. 이 옵션을 선택하면 **제한** 또는 표시할 최대 행 수를 선택할 수도 있습니다.
+  **방향** - 스택 방향을 선택합니다.
  +  **자동** - Amazon Managed Grafana에서 최적의 방향이라고 생각하는 항목을 선택합니다.
  +  **가로** - 막대가 가로로 확장됩니다(왼쪽에서 오른쪽 방향).
  +  **세로** - 막대가 세로로 확장됩니다(위에서 아래 방향).
+  **임계치 레이블 표시** - 임계치를 표시할지 여부를 선택합니다.
+  **임계치 마커 표시** - 내부 게이지 값 밴드 외부에 임계치 밴드를 표시할지 여부를 선택합니다.

# Geomap 패널
<a name="AMG-Geomap"></a>

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

**Geomap** 패널 시각화를 사용하면 지리 공간 데이터를 사용하여 세계 지도를 보고 사용자 지정할 수 있습니다. 데이터의 중요한 위치 기반 특성에 쉽게 초점을 맞추기 위해 다양한 오버레이 스타일과 맵 뷰 설정을 구성할 수 있습니다.

## 데이터 계층
<a name="Data-Layer"></a>

Geomap 플러그인의 데이터 계층은 기본 맵 위에 지리 공간 데이터를 시각화하는 방법을 결정합니다.

### Location
<a name="Location"></a>

**Geomap** 패널에는 지리적 데이터 소스가 필요합니다. 이 데이터는 데이터베이스 쿼리에서 가져오며, 데이터에 대한 네 가지 매핑 옵션이 있습니다.
+ **자동**은 위치 데이터를 자동으로 검색합니다. 쿼리가 데이터 필드의 다음 이름 중 하나를 기반으로 하는 경우 이 옵션을 사용합니다.
  + geohash: “geohash”
  + latitude: “latitude”, “lat”
  + longitude: “longitude”, “lng”, “lon”
  + lookup: “lookup”
+  **Coords**에서는 쿼리에서 좌표 데이터를 보유하도록 지정합니다. 데이터베이스 쿼리에서 위도 및 경도에 대한 숫자 데이터 필드를 선택하라는 프롬프트가 표시됩니다.
+  **Geohash**에서는 쿼리에서 지리적 해시 데이터를 보유하도록 지정합니다. 데이터베이스 쿼리에서 지오해시의 문자열 데이터 필드를 선택하라는 프롬프트가 표시됩니다.
+  **Lookup**에서는 쿼리에서 값에 매핑해야 하는 위치 이름 데이터를 보유하도록 지정합니다. 데이터베이스 쿼리 및 ` gazetteer`에서 조회 필드를 선택하라는 프롬프트가 표시됩니다. ` gazetteer `는 쿼리된 데이터를 지리적 지점에 매핑하는 데 사용되는 디렉터리입니다.

## 마커 계층
<a name="Markers-Layer"></a>

**마커** 계층을 사용하면 데이터 포인트를 원, 사각형, 삼각형, 별 등과 같은 다양한 마커 모양으로 표시할 수 있습니다.
+ **마커 색상**에서는 마커의 색상을 구성합니다. 기본 고정 크기는 모든 지점을 단일 색상으로 유지합니다. 데이터 포인트 값과 **임계치** 섹션에 설정된 임계치에 따라 여러 색상을 사용할 수 있는 대체 옵션이 있습니다.
+  **마커 크기**에서는 마커의 크기를 구성합니다. 기본값은 ` Fixed size`이며, 데이터 포인트에 관계없이 모든 마커 크기가 동일합니다. 그러나 원을 해당 데이터 포인트로 조정하는 옵션도 있습니다. 마커 계층이 이러한 범위 내에서 조정할 수 있도록 ` Min` 및 `Max ` 마커 크기를 설정해야 합니다.
+  **마커 모양**에서는 데이터 포인트를 다르게 시각화할 수 있는 유연성을 제공합니다.
  + Circle(원)
  + Square
  + 삼각형
  + 십자선
  + X
+  **채우기 불투명도**에서는 각 마커의 투명도를 구성합니다.

## 히트맵 계층
<a name="Heatmap-layer"></a>

**히트맵** 계층은 다양한 데이터 포인트를 클러스터화하여 밀도가 다른 위치를 시각화합니다. 히트맵 계층을 추가하려면 **데이터 계층**에서 **히트맵**을 선택합니다.



**마커**와 마찬가지로 시각화할 데이터 포인트와 방법을 결정하는 다양한 옵션이 표시됩니다.
+ **가중치 값**에서는 히트맵 클러스터의 강도를 구성합니다. 고정 값은 모든 데이터 포인트에서 일정한 가중치 값을 유지합니다. 이 값은 0\$11 범위여야 합니다. **마커**와 마찬가지로 드롭다운에는 데이터 값에 따라 가중치 값을 자동으로 조정하는 대체 옵션이 있습니다.
+  **반경**에서는 히트맵 클러스터의 크기를 구성합니다.
+  **블러**에서는 각 클러스터의 블러 양을 구성합니다.

# 그래프 패널
<a name="graph-panel"></a>

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

그래프 패널은 선, 점의 경로 또는 일련의 막대로 렌더링할 수 있습니다. 이러한 유형의 그래프는 거의 모든 시계열 데이터를 표시할 수 있을 만큼 다재다능합니다.

## 데이터 및 필드 옵션
<a name="graph-panel-data-and-field-options"></a>

그래프 시각화를 사용하는 경우 다음 옵션을 적용할 수 있습니다.
+  [변환](panel-transformations.md) 
+ 알림. 알림을 설정할 수 있는 유일한 시각화 유형입니다. 자세한 내용은 [Grafana 알림](alerts-overview.md) 단원을 참조하십시오.
+  [Thresholds](thresholds.md) 

## 표시 옵션
<a name="graph-panel-display-options"></a>

시각화를 구체화하려면 다음 설정을 사용합니다.
+  **막대** - 값을 막대 차트로 표시합니다.
+  **선** - 값을 선 그래프로 표시합니다.
+  **선 너비** - 시리즈의 선 너비를 지정합니다. 기본값은 1입니다.
+  **계단식** - 인접한 포인트를 계단식으로 그립니다.
+  **영역 채우기** - 시리즈의 색상 채우기 양을 지정합니다. 기본값은 1이며, 0인 경우 지정하지 않습니다.
+  **채우기 그라데이션** - 영역 채우기에서 그라데이션 수준을 지정합니다. 기본값은 0(그라데이션 없음)이며, 10인 경우 그라데이션 수준이 매우 높습니다.
+  **포인트** - 값에 대한 포인트를 표시합니다.
+  **포인트 반경** - 포인트의 크기를 제어합니다.
+  **알림 임계치** - 패널에 알림 임계치 및 리전을 표시합니다.

### 스택 및 null 값
<a name="stacking-and-null-value"></a>
+  **스택** - 각 시리즈가 다른 시리즈 위에 스택됩니다.
+  **백분율** - 각 시리즈가 모든 시리즈의 합계에 대한 백분율로 그려집니다. 이 옵션은 **스택**을 선택한 경우 사용할 수 있습니다.
+  **Null 값** - null 값이 표시되는 방법을 지정합니다. *중요한 설정입니다.* 아래 참고 사항을 참조하세요.
  +  **연결됨** - 시리즈에 하나 이상의 null 값을 의미하는 갭이 있는 경우 선은 갭을 건너뛰고 null이 아닌 다음 값에 연결됩니다.
  +  **null** - 시리즈에 null 값을 의미하는 갭이 있는 경우 그래프의 선이 끊어지고 갭이 표시됩니다. 기본 설정입니다.
  +  **null을 0으로 설정** - 시리즈에 null 값을 의미하는 갭이 있는 경우 그래프 패널에 0으로 표시됩니다.

**중요**  
서버의 CPU 부하를 모니터링하고 부하가 100%에 도달하면 서버가 잠기고 에이전트 전송 통계가 부하 통계를 수집할 수 없습니다. 이로 인해 지표에 갭이 발생하고 기본 *null* 설정을 사용하면 Amazon Managed Grafana에서 갭을 표시하고 문제가 있음을 나타냅니다. *연결됨*으로 설정된 경우 이 신호를 놓치기 쉽습니다.

### 가리키기 툴팁
<a name="graph-panel-hover-tooltip"></a>

이러한 설정을 사용하여 그래프 시각화를 일시 중지할 때 나타나는 툴팁의 모양을 변경합니다.
+  **모드** - 가리키기 툴팁에서 표시하는 시리즈 수를 결정합니다.
  +  **모든 시리즈** - 가리키기 툴팁에는 그래프의 모든 시리즈가 표시됩니다. 툴팁의 시리즈 목록에서 Grafana 워크스페이스는 일시 중지한 시리즈를 굵게 강조 표시합니다.
  +  **단일** - 가리키기 툴팁에는 그래프에서 일시 중지한 시리즈인 단일 시리즈만 표시됩니다.
+  **정렬 순서** - **모든 시리즈** 모드를 선택한 경우 가리키기 툴팁에서 시리즈의 순서를 정렬합니다. 그래프에서 일시 중지하면 Amazon Managed Grafana에 선과 연결된 값이 표시됩니다. 일반적으로 사용자는 가장 높은 값 또는 가장 낮은 값에 가장 관심이 많습니다. 이러한 값을 정렬하면 원하는 데이터를 훨씬 더 쉽게 찾을 수 있습니다.
  +  **없음** - 툴팁의 시리즈 순서는 쿼리의 정렬 순서에 따라 결정됩니다. 예를 들어 시리즈 이름별로 시리즈를 사전순으로 정렬할 수 있습니다.
  +  **증가** - 가리키기 툴팁에서 시리즈가 값을 기준으로 오름차순으로 정렬됩니다(목록 맨 위에 가장 낮은 값).
  +  **감소** - 가리키기 툴팁에서 시리즈가 값을 기준으로 내림차순으로 정렬됩니다(목록 맨 위에 가장 높은 값).

## 시리즈 재정의
<a name="graph-panel-series-overrides"></a>

시리즈 재정의를 사용하면 그래프 패널의 시리즈를 다른 시리즈와 다르게 렌더링할 수 있습니다. 시리즈별로 또는 정규식 규칙을 사용하여 표시 옵션을 사용자 지정할 수 있습니다. 예를 들어 한 시리즈의 선 너비를 두껍게 설정하거나 해당 시리즈를 오른쪽 Y축으로 이동할 수 있습니다.

여러 시리즈 재정의를 추가할 수 있습니다.

**시리즈 재정의를 추가하는 방법**

1. **시리즈 재정의 추가**를 선택하세요.

1. **별칭 또는 정규식**에서 시리즈를 입력하거나 선택하세요. 필드를 선택하여 사용 가능한 시리즈 목록을 확인하세요.

   예를 들어 `/Network.*/`는 `Network out` 및 `Network in`이라는 두 시리즈와 일치합니다.

1. **\$1**를 선택하고 시리즈에 적용할 스타일을 선택하세요. 각 항목에 여러 스타일을 추가할 수 있습니다.
+  **막대** - 시리즈를 막대 그래프로 표시합니다.
+  **선** - 시리즈를 선 그래프로 표시합니다.
+  **선 채우기** - 영역 채우기가 있는 선 그래프를 표시합니다.
+  **채우기 그라데이션** - 영역 채우기 그라데이션 수준을 지정합니다.
+  **선 너비** - 선 너비를 설정합니다.
+  **Null 포인트 모드** - 이 옵션을 사용하여 null 값을 무시하거나 0으로 바꿉니다. 데이터의 갭을 무시하려는 경우 중요합니다.
+  **다음 아래 채우기** - 두 시리즈 사이의 영역을 채웁니다.
+  **계단식 선** - 시리즈를 계단식 선으로 표시합니다.
+  **대시** - 대시가 있는 선을 표시합니다.
+  **숨긴 시리즈** - 시리즈를 숨깁니다.
+  **대시 길이** - 선의 대시 길이를 설정합니다.
+  **대시 공백** - 선의 대시 간 공백 길이를 설정합니다.
+  **포인트** - 시리즈를 별도의 포인트로 표시합니다.
+  **포인트 반경** - 포인트 렌더링의 반경을 설정합니다.
+  **스택** - 시리즈의 스택 그룹을 설정합니다.
+  **색상** - 시리즈 색상을 설정합니다.
+  **Y축** - 시리즈 y축을 설정합니다.
+  **Z-인덱스** - 시리즈 z-인덱스(렌더링 순서)를 설정합니다. 이 옵션은 막대 차트 및 영역 차트와 같은 다양한 스타일을 오버레이할 때 중요합니다.
+  변환 - 값을 음수로 변환하여 y축 아래를 렌더링합니다.
+  **범례** - 시리즈가 범례에 표시되는지 여부를 제어합니다.
+  **툴팁에서 숨기기** - 그래프 툴팁에 시리즈가 표시되는지 여부를 제어합니다.

## 축
<a name="graph-panel-axes"></a>

이러한 옵션을 사용하여 시각화에서 축 표시를 제어합니다.

### 왼쪽 Y/오른쪽 Y
<a name="left-yright-y"></a>

옵션은 두 y축 모두에서 동일합니다.
+  **표시** - 축을 표시하거나 숨기도록 선택합니다.
+  **단위** - y 값의 표시 단위를 선택합니다.
+  **조정** - y 값에 사용할 조정 방식(**선형** 또는 **대수**)을 선택합니다. 기본값은 **선형**입니다.
+  **Y-최소** - 최소 y 값. 기본값은 **자동**입니다.
+  **Y-최대** - 최대 Y 값. 기본값은 **자동**입니다.
+  **소수점** - y 값에 표시되는 소수점 수를 정의합니다. 기본값은 **자동**입니다.
+  **레이블** - y축 레이블을 지정합니다. 기본값은 ""입니다.

### Y축
<a name="y-axes"></a>
+  **정렬** - 값을 기준으로 왼쪽 및 오른쪽 y축을 정렬합니다. 기본값은 선택 취소된 상태(false)입니다.
+  **수준** - Y=0부터 시작하여 왼쪽 및 오른쪽 y축 정렬에 사용할 값을 입력합니다. 기본값은 0입니다. 이 옵션은 **정렬**을 선택한 경우에 사용할 수 있습니다.

### X축
<a name="x-axis"></a>
+  **표시** - 축을 표시하거나 숨기도록 선택합니다.
+  **모드** - 표시 모드는 그래프 패널의 시각화를 완전히 변경합니다. 한 곳에 세 개의 패널이 있는 것과 같습니다. 기본 모드는 x축에 시간이 있는 시계열 모드입니다. 다른 두 모드는 x축에 시간 대신 시리즈가 있는 기본 막대 차트 모드와 히스토그램 모드입니다.
  +  **시간**(기본값) - x축은 시간을 나타내며 데이터는 시간(예: 시간 또는 분)별로 그룹화됩니다.
  +  **시리즈** - 데이터는 시간이 아닌 시리즈별로 그룹화됩니다. y축은 여전히 값을 나타냅니다.
    +  **값** - 값에 사용할 집계 유형입니다. 기본값은 **합계**입니다(모든 값 합산).
  +  **히스토그램** - 이 옵션은 그래프를 히스토그램으로 변환합니다. 히스토그램은 숫자를 범위로 그룹화하는 일종의 막대 차트로, 버킷 또는 빈이라고도 합니다. 막대가 길면 더 많은 데이터가 해당 범위에 속함을 보여줍니다.

    히스토그램에 대한 자세한 내용은 [히스토그램 및 히트맵 소개](getting-started-grafanaui.md#introduction-to-histograms-and-heatmaps) 섹션을 참조하세요.
    +  **버킷** - 값을 그룹화할 버킷 수를 설정합니다. 비워 두면 Amazon Managed Grafana에서 적당한 수의 버킷을 계산하려고 합니다.
    +  **X-최소** - 히스토그램에서 이 최소 한도보다 작은 값을 필터링합니다.
    +  **X-최대** - 이 최대 한도보다 큰 값을 필터링합니다.

## 범례
<a name="graph-panel-legend"></a>

이러한 설정을 사용하여 시각화에 범례가 표시되는 방식을 세분화합니다.

### 옵션
<a name="graph-panel-legends-options"></a>
+  **표시** - 범례를 숨기려면 지웁니다. 기본값이 선택된 상태(true)입니다.
+  **테이블 형식** - 테이블에 범례를 표시하려면 선택합니다. 기본값은 확인(true)됩니다.
+  **오른쪽** - 오른쪽에 범례를 표시하려면 선택합니다.
+  너비 - 범례의 최소 너비를 픽셀 단위로 입력합니다. 이 옵션은 **오른쪽으로**를 선택한 경우에 사용할 수 있습니다.

### 값
<a name="graph-panel-values"></a>

범례 이름과 함께 추가 값을 표시할 수 있습니다.
+  **최소** - 지표 쿼리에서 반환된 최솟값.
+  **최대** - 지표 쿼리에서 반환된 최댓값.
+  **평균** - 지표 쿼리에서 반환된 평균 값.
+  **현재** - 지표 쿼리에서 반환된 마지막 값.
+  **합계** - 지표 쿼리에서 반환된 모든 값의 합계.
+  **소수점** - 범례 값 및 그래프 가리키기 툴팁에 표시되는 소수점 수.

Amazon Managed Grafana는 클라이언트 측에서 범례 값을 계산합니다. 이러한 범례 값은 지표 쿼리가 사용하는 집계 또는 포인트 통합 유형에 따라 달라집니다. 위의 모든 범례 값은 동시에 정확할 수 없습니다.

예를 들어, 평균을 집계기로 사용할 수 있는 이러한 초당 요청 비율을 작성하는 경우 범례의 합계에서는 총 요청 수를 나타내지 않습니다. 단지 Amazon Managed Grafana에서 수신한 모든 데이터 포인트의 합계입니다.

### 시리즈 숨기기
<a name="graph-panel-hide-series"></a>

지표 쿼리에서 시리즈의 모든 값이 특정 값에 해당하는 경우 시리즈를 숨깁니다.
+  **null만 포함** – 값=null(기본값은 선택 취소된 상태)
+  **0만 포함** - 값=0(기본값은 선택 취소된 상태)

### 시간 리전
<a name="graph-panel-time-regions"></a>

그래프에서 특정 시간대를 강조 표시하여 주말, 근무 시간, 근무 외 시간 등을 더 쉽게 볼 수 있습니다. 구성된 모든 시간 리전은 UTC 시간을 참조합니다.

# 히트맵
<a name="visualization-heatmap"></a>

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

히트맵 패널 시각화를 사용하면 시간 경과에 따른 히스토그램을 볼 수 있습니다. 히스토그램에 대한 자세한 내용은 [히스토그램 및 히트맵 소개](getting-started-grafanaui.md#introduction-to-histograms-and-heatmaps) 섹션을 참조하세요.

## 축 옵션
<a name="heatmap-axes-options"></a>

이러한 설정을 사용하여 시각화에 축이 표시되는 방식을 조정합니다.

### Y축
<a name="heatmap-y-axis"></a>
+  **단위** - y축 값의 표시 단위
+  **스케일** - y축 값에 사용할 스케일.
  +  **선형** - 선형 스케일 
  +  **로그(밑 2)** - 밑 2를 사용하는 로그 스케일
  +  **로그(밑 10)** - 밑 10을 사용하는 로그 스케일
  +  **로그(밑 32)** - 밑 32를 사용하는 로그 스케일
  +  **로그(밑 1024)** - 밑 1024를 사용하는 로그 스케일
+  **Y-최소** – 최소 y 값(기본값은 자동)
+  **Y-최대** – 최대 y 값(기본값은 자동)
+  **소수점** - y축 값을 렌더링할 소수점 수(기본값은 자동)

### 버킷
<a name="heatmap-buckets"></a>

**참고**  
데이터 형식이 **시계열 버킷**인 경우 이 섹션을 사용할 수 없습니다.
+  **Y축 버킷** - y축이 분할될 버킷 수.
+  **크기** - 각 y축 버킷의 크기(**스케일**이 *선형*인 경우에만 표시됨). 이 옵션은 **Y축 버킷**보다 우선됩니다.
+  **분할 인수** - (**스케일**이 *로그(밑 2)* 이상인 경우에만 표시됨). 기본적으로 Amazon Managed Grafana는 로그 밑을 기준으로 y 값을 분할합니다. 이 옵션을 사용하면 각 기본 버킷을 지정된 수의 버킷으로 분할할 수 있습니다.
+  **X축 버킷** - x축이 분할될 버킷 수.
+  **크기** - 각 x축 버킷의 크기. 숫자 또는 시간 간격(10s, 5m, 1h 등). 지원되는 간격: ms, s, m, h, d, w, M, y. 이 옵션은 **X축 버킷**보다 우선됩니다.

#### 버킷 한계
<a name="heatmap-bucket-bound"></a>

데이터 형식이 시계열 버킷인 경우 데이터 소스는 버킷 한계를 나타내는 이름이 포함된 시리즈를 반환합니다. 하지만 데이터 소스에 따라 한계는 상한이거나 하한일 수 있습니다. 이 옵션을 사용하여 한계 유형을 조정할 수 있습니다. **자동**이 설정된 경우 패널의 데이터 소스 유형에 따라 한계 옵션이 선택됩니다.

#### 버킷 크기
<a name="heatmap-bucket-size"></a>

버킷 수 및 크기 옵션은 Amazon Managed Grafana에서 히트맵에 있는 각 셀의 크기를 계산하는 데 사용됩니다. 버킷 크기는 개수(첫 번째 입력 상자) 또는 크기 간격을 지정하여 정의할 수 있습니다. y축의 경우 크기 간격은 값일 뿐입니다. X-버킷의 경우 **크기** 입력에서 시간 간격을 지정할 수 있습니다. 예를 들어 시간 범위를 `1h`로 설정할 수 있습니다. 이 경우 x축의 셀 너비는 1h가 됩니다.

#### 데이터 형식
<a name="heatmap-data-format"></a>

**형식** 목록에서 옵션을 선택합니다.
+ **시계열** - Amazon Managed Grafana는 모든 시계열 값을 검토하여 버킷화를 수행합니다. 버킷 크기 및 간격은 **버킷** 옵션에서 설정됩니다.
+ **시계열 버킷** - 각 시계열은 이미 y축 버킷을 나타냅니다. 시계열 이름(별칭)은 버킷의 상한 또는 하한 간격을 나타내는 숫자 값이어야 합니다. Grafana 워크스페이스는 버킷화를 수행하지 않으므로 버킷 크기 옵션이 숨겨집니다.

## 표시 옵션
<a name="heatmap-display-options"></a>

이러한 설정을 사용하여 시각화를 세분화합니다.

### 색상
<a name="heatmap-colors"></a>

색상 스펙트럼은 각 버킷 내 값 수 및 각 버킷에 할당된 색상 간 매핑을 제어합니다. 스펙트럼의 가장 왼쪽 색상은 최소 개수를 나타내고 가장 오른쪽 색상은 최대 개수를 나타냅니다. 일부 색상 체계는 밝은 테마를 사용할 때 자동으로 반전됩니다.

색상 모드를 **불투명도**로 변경할 수도 있습니다. 이 경우 색상은 변경되지 않지만 버킷 수에 따라 불투명도가 변경됩니다.
+  **Mode(모드)** 
  +  **불투명도** - 셀 불투명도로 표시되는 버킷 값. 불투명한 셀은 최댓값을 의미합니다.
    +  **색상** - 셀 기본 색상.
    +  **스케일** - 버킷 값을 불투명도에 매핑하기 위한 스케일.
      +  **선형** - 선형 스케일. 버킷 값은 불투명도에 선형으로 매핑됩니다.
      +  **sqrt** – 제곱 크기. 셀 불투명도는 `value ^ k`로 계산됩니다. 여기서 `k`는 구성된 **지수** 값입니다. 지수가 `1`보다 작으면 로그 스케일을 사용합니다. 지수가 `1`보다 크면 지수 스케일을 사용합니다. `1`의 경우 스케일은 선형과 동일합니다.
    +  **지수** - `0`보다 큰 지수의 값.
  +  **스펙트럼** - 셀 색상으로 표시되는 버킷 값.
    +  **색상 체계** - 모드가 **스펙트럼**인 경우 색상 체계를 선택합니다.

### 색상 스케일
<a name="heatmap-color-scale"></a>

기본적으로 Amazon Managed Grafana는 최소 및 최대 버킷 값을 기반으로 셀 색상을 계산합니다. **최소** 및 **최대**에서는 해당 값을 덮어쓸 수 있습니다. 버킷 값을 z축으로, 최소 및 최대를 각각 Z-최소 및 Z-최대로 간주합니다.
+  **최소** - 셀 색상 계산에 사용되는 최솟값. 버킷 값이 최소보다 작으면 최소 색상으로 매핑됩니다. 기본값은 `series min value`입니다.
+  **최대** - 셀 색상 계산에 사용되는 최댓값. 버킷 값이 최대보다 크면 최대 색상으로 매핑됩니다. 기본값은 `series max value`입니다.

### 범례
<a name="heatmap-legend"></a>

시각화에서 히트맵 범례를 표시할지 여부를 선택합니다.

### 버킷
<a name="heatmap-legend-buckets"></a>
+  **0 숨기기** - 값이 0인 셀을 그리지 않습니다.
+  **공간** - 셀 사이 공간을 픽셀 단위로 설정합니다. 기본값은 1픽셀입니다.
+  **라운드** - 셀 라운드 효과를 픽셀 단위로 설정합니다. 기본값은 0.

### Tooltip
<a name="heatmap-tooltip"></a>
+  **툴팁 표시** - 히트맵 툴팁을 표시합니다.
+  **히스토그램** - 툴팁에 y축 히스토그램을 표시합니다. 히스토그램은 특정 타임스탬프에 대한 버킷 값의 분포를 나타냅니다.
+  **소수점** - 버킷 값을 렌더링할 소수점 수를 설정합니다(기본값은 자동).

# 히스토그램 패널
<a name="histogram-panel"></a>

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

히스토그램 시각화는 값의 분포를 계산하여 막대 차트로 표시합니다. Y축과 각 막대의 높이는 각 괄호에 포함된 값의 수를 나타내는 반면, X축은 값 범위를 나타냅니다.

히스토그램 시각화는 하나 이상의 숫자 필드를 포함하는 시계열 및 테이블 결과를 지원합니다.

## 표시 옵션
<a name="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="histogram-legend"></a>

범례 옵션이 활성화되면 값 매핑 또는 임계치 괄호를 표시할 수 있습니다. 범례에 값 매핑을 표시하려면 표준 옵션 아래 색상 체계 옵션을 단일 색상 또는 클래식 팔레트로 설정해야 합니다. 범례에서 임계치 괄호를 보려면 색상 체계를 시작 임계치로 설정하세요.

**범례 모드** 이러한 설정을 사용하여 시각화에 범례가 표시되는 방식을 세분화합니다.
+  **목록** - 범례를 목록으로 표시합니다. 범례의 기본 표시 모드입니다.
+  **테이블** - 범례를 테이블로 표시합니다.
+  **숨김** - 범례를 숨깁니다.

**범례 배치** - 범례를 배치할 위치를 선택합니다.
+  **하단** - 그래프 아래.
+  **오른쪽** - 그래프의 오른쪽.

**범례 계산**

범례에 표시할 계산을 선택하세요. 자세한 내용은 [계산 목록](list-of-calculations.md) 단원을 참조하십시오.

# 로그 패널
<a name="logs-panel"></a>

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

로그 패널 시각화에는 Elastic, Influx, Loki와 같은 로그를 지원하는 데이터 소스의 로그 줄이 표시됩니다. 일반적으로 그래프 패널 옆에 있는 이 패널을 사용하여 관련 프로세스의 로그 출력을 표시합니다.

로그 패널에는 **쿼리** 탭에 입력된 쿼리의 결과가 표시됩니다. 여러 쿼리의 결과가 병합되어 시간별로 정렬됩니다. 데이터 소스가 표시할 수 있는 것보다 더 많은 줄을 반환하는 경우 패널 내에서 스크롤할 수 있습니다.

렌더링되는 줄 수를 제한하려면 **쿼리 옵션**에서 **최대 데이터 포인트** 설정을 사용할 수 있습니다. 설정하지 않으면 데이터 소스는 일반적으로 기본 제한을 적용합니다.

## 표시 옵션
<a name="logs-panel-display-options"></a>

다음 설정을 사용하여 시각화를 세분화합니다.
+  **시간** - 시간 열을 표시하거나 숨깁니다. 데이터 소스에서 보고된 로그 줄과 연결된 타임스탬프입니다.
+  **고유 레이블** - 공통되지 않은 레이블만 표시하는 고유 레이블 열을 표시하거나 숨깁니다.
+  **줄 바꿈** - 줄 바꿈 기능을 전환합니다.
+  **순서** - 결과를 내림차순 또는 오름차순으로 표시합니다. 기본값은 **내림차순**이며 최신 로그가 먼저 표시됩니다. **오름차순**으로 설정하여 가장 오래된 로그 줄을 먼저 표시합니다.

# 뉴스 패널
<a name="news-panel"></a>

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

이 패널에는 RSS 피드가 표시됩니다. 기본적으로 Grafana Labs 블로그의 문서가 표시됩니다.

**표시** 섹션의 **URL** 필드에 RSS 피드의 URL을 입력합니다. 이 패널 유형은 다른 쿼리를 수락하지 않습니다.

# 노드 그래프 패널(베타)
<a name="node-graph-panel"></a>

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

노드 그래프 패널은 방향성 그래프 또는 네트워크를 시각화합니다. 방향을 지닌 하중 레이아웃을 사용하여 노드를 효과적으로 배치하므로 복잡한 인프라 맵, 계층 구조 또는 실행 다이어그램을 표시하는 데 도움이 될 수 있습니다.

## 데이터 요구 사항
<a name="node-graph-panel-requirements"></a>

노드 그래프 패널에는 노드와 엣지를 표시할 수 있는 데이터의 특정 형태가 필요합니다. 이 패널에서 모든 데이터 소스 또는 쿼리를 시각화할 수 있는 것은 아닙니다.

노드 그래프 시각화는 *노드* 및 *엣지*로 구성됩니다.
+ *노드*는 원으로 표시됩니다. 노드는 애플리케이션, 서비스 또는 애플리케이션 관점에서 관련된 모든 항목을 나타낼 수 있습니다.
+ *엣지*는 두 노드를 연결하는 선으로 표시됩니다. 연결은 요청, 실행 또는 두 노드 간의 기타 관계일 수 있습니다.

## Nodes(노드)
<a name="node-graph-panel-nodes"></a>

일반적으로 노드는 노드 내에 두 개의 통계 값과 노드 바로 아래에 두 개의 식별자(일반적으로 이름과 유형)를 표시합니다. 노드는 노드 주변의 색상 원으로 다른 값 세트를 표시할 수도 있습니다. 색상이 다른 섹션은 최대 1의 값을 더해야 하는 서로 다른 값을 나타냅니다. 예를 들어, 원의 빨간색 부분으로 오류 비율을 표시할 수 있습니다.

추가 세부 정보는 컨텍스트 메뉴에 표시될 수 있으며, 노드를 선택할 때 표시됩니다. 컨텍스트 메뉴에는 Grafana 워크스페이스의 다른 부분 또는 외부 링크를 대상으로 할 수 있는 추가 링크가 있을 수도 있습니다.

## 엣지
<a name="node-graph-panel-edges"></a>

엣지 위에 마우스를 가져가면 엣지에 통계가 표시될 수도 있습니다. 노드와 마찬가지로 엣지를 선택하여 추가 세부 정보 및 링크가 포함된 컨텍스트 메뉴를 열 수 있습니다.

이 시각화를 지원하는 첫 번째 데이터 소스는 서비스 맵 기능의 AWS X-Ray 데이터 소스입니다. 자세한 내용은 [AWS X-Ray 데이터 소스에 연결](x-ray-data-source.md) 단원을 참조하십시오.

추가 세부 정보는 컨텍스트 메뉴에 표시될 수 있으며, 노드를 선택할 때 표시됩니다. 컨텍스트 메뉴에는 Grafana 워크스페이스의 다른 부분 또는 외부 링크를 대상으로 할 수 있는 추가 링크가 있을 수도 있습니다.

## 노드 그래프 탐색
<a name="node-graph-panel-navigation"></a>

노드 또는 엣지 외부를 선택하고 마우스를 끌어 노드 그래프 내에서 이동할 수 있습니다.

노드 그래프의 왼쪽 상단에 있는 버튼을 사용해 확대/축소할 수 있습니다.

# 파이 차트 패널
<a name="pie-chart-panel"></a>

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

파이 차트에서는 하나 이상의 쿼리에서 축소된 시리즈 또는 시리즈의 값이 서로 상관되므로 해당 항목을 파이 슬라이스로 표시합니다. 슬라이스의 아크 길이, 영역 및 중심 각도는 모든 값의 합계와 관련이 있으므로 모두 슬라이스 값에 비례합니다. 이 유형의 차트는 작은 값 세트를 미적으로 만족스러운 형태로 빠르게 비교하려는 경우에 가장 적합합니다.

파이 차트 시각화를 사용하면 다음 옵션을 적용할 수 있습니다.
+  [변환](panel-transformations.md). 
+  [필드 옵션 및 재정의](field-options-overrides.md). 
+  [Thresholds](thresholds.md).

## 옵션
<a name="pie-chart-panel-options"></a>

다음 옵션을 사용하여 시각화를 세분화할 수 있습니다.
+  **표시** - 표시할 정보의 양을 선택합니다. **계산** - 각 값을 시리즈당 단일 값으로 줄입니다. **모든 값** - 단일 시리즈의 모든 값을 표시합니다.
+  **계산** - 계산을 선택한 경우 각 시리즈를 줄이려면 **계산**을 선택합니다. 사용할 수 있는 계산에 대한 자세한 내용은 [계산 목록](list-of-calculations.md) 섹션을 참조하세요.
+  **제한** - 단일 시리즈의 모든 값을 표시할 때 표시되는 값 수를 제한합니다.
+  **필드** - 시각화에 표시할 필드를 선택합니다.
  + **숫자 필드** - 숫자 값이 있는 모든 필드.
  + **모든 필드** - 변환으로 제거되지 않은 모든 필드.
  + **시간** - 시간 값이 있는 모든 필드.

## 레이블
<a name="pie-charts-panel-labels"></a>

파이 차트에 표시할 레이블을 선택합니다. 둘 이상을 선택할 수 있습니다.
+  **이름** - 시리즈 또는 필드 이름.
+  **백분율** - 전체의 백분율.
+  **값** - 원시 숫자 값.

레이블은 차트 본문 위에 흰색으로 표시됩니다. 더 잘 보이도록 더 어두운 차트 색상을 선택해야 할 수도 있습니다. 긴 이름이나 숫자는 잘릴 수 있습니다.

## 범례 배치 및 값
<a name="pie-charts-panel-legend"></a>

범례를 표시할 위치를 선택합니다.
+  **하단** - 차트 아래.
+  **오른쪽** - 차트의 오른쪽.

범례에 표시할 값을 둘 이상 선택할 수 있습니다. **백분율**은 전체의 백분율이고 **값은** 원시 숫자 값입니다.

# Plotly 패널
<a name="plotly-panel"></a>

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

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;
let y = data.series[0].fields[1].values;
let series = {
    x: x,
    y: y,
    name: variables.name, // where ‘name’ is the name of a Grafana dashboard variable
};

return {
    data: [series],
    config: {
        displayModeBar: false,
    },
};
```

*데이터*, *레이아웃* 및 *구성* 필드에 제공된 스크립트 및 JSON에서 반환된 객체가 병합됩니다(심층 병합).

스크립트가 제공되지 않으면 패널은 *데이터*, *레이아웃* 및 *구성* 필드만 사용합니다.

# Sankey 패널
<a name="sankey-panel"></a>

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

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="scatter-panel"></a>

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

분산형 패널은 다른 그래프 패널보다 인터페이스가 더 간단한 테이블 데이터에 대한 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 대시보드에서 **패널 추가**를 선택하세요. 패널 추가에 대한 자세한 내용은 [패널 추가](add-a-panel-to-a-dashboard.md) 섹션을 참조하세요.

1. 쿼리에서 필요한 데이터를 반환하는 쿼리를 작성하세요. 이 경우 `SELECT * FROM HEIGHT`와 같은 쿼리를 사용합니다.

1. **분산형** 시각화를 선택하세요.

이렇게 하면 첫 번째 열을 X축으로 사용하고 다른 숫자 열을 Y축으로 사용하여 산점도가 생성됩니다.

**구성 옵션**

분산형 패널은 다음과 같은 네 가지 사용자 지정 구성 옵션을 제공합니다.
+ **X축** - X축으로 사용할 필드와 축의 범위 및 제목과 표시 정보를 선택할 수 있습니다.
+ **Y축** - 각 필드의 표시 옵션, 축의 범위 및 제목 정보를 포함하여 Y축에 표시할 필드를 선택할 수 있습니다. 각 필드에 대한 회귀선을 표시하도록 선택할 수도 있습니다. 회귀선 구성에 대한 자세한 내용은 다음 정보를 참조하세요.
+ **범례** - 패널의 범례를 켜거나 끌 수 있으며 범례에서 텍스트 크기를 선택할 수 있습니다.
+ **표시** - 그리드 색상 및 테두리 스타일을 포함하여 차트에 대한 다른 옵션을 설정할 수 있습니다.

**회귀선 구성**

각 Y축 데이터세트는 개별 점 외에도 선을 표시할 수 있습니다. 선 유형에는 다섯 가지 옵션이 있습니다.
+ **없음** - 회귀선을 표시하지 않습니다.
+ **단순** - 데이터세트 포인트를 연결하는 회귀선을 표시합니다.
+ **선형** - 최소 제곱, 최적 메서드를 사용하여 직선을 표시합니다.
+ **지수** - 지수 최적 회귀선을 표시합니다.
+ **멱** - 멱 최적 회귀선을 표시합니다.

# 통계 패널
<a name="stat-panel"></a>

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

통계 패널에는 그래프 스파크라인(선택 사항)과 함께 하나의 큰 통계 값이 표시됩니다. 임계치를 사용하여 배경 또는 값 색상을 제어할 수 있습니다.

기본적으로 통계 패널에서는 다음 표시 중 하나를 표시합니다.
+ 단일 시리즈 또는 필드의 값만.
+ 여러 시리즈 또는 필드의 값과 이름 모두.

**텍스트 모드** 옵션을 사용하여 텍스트 표시 여부를 제어할 수 있습니다.

## 데이터 및 필드 옵션
<a name="stat-panel-data-and-field-options"></a>

통계 시각화를 사용하면 다음 옵션을 적용할 수 있습니다.
+  [변환](panel-transformations.md).
+  [필드 옵션 및 재정의](field-options-overrides.md).
+  [Thresholds](thresholds.md).

## 자동 레이아웃 조정
<a name="stat-panel-automatic-layout-adjustment"></a>

패널은 대시보드에서 사용 가능한 너비와 높이에 따라 레이아웃을 자동으로 조정합니다. 패널이 너무 작아지면 그래프(스파크라인)를 자동으로 숨깁니다.

## 표시 옵션
<a name="stat-panel-display-options"></a>

다음 옵션을 사용하여 시각화를 세분화합니다.
+  **표시** - Amazon Managed Grafana가 데이터를 표시하는 방법을 선택합니다.
  +  **계산** - 모든 행을 기반으로 계산된 값을 표시합니다.
    +  **계산** - 적용할 계산을 선택합니다. 사용할 수 있는 계산에 대한 자세한 내용은 [계산 목록](list-of-calculations.md) 섹션을 참조하세요.
  +  **모든 값** - 각 행에 대해 별도의 통계를 표시합니다.
    +  **제한** - 표시할 최대 행 수를 지정합니다.
+  **필드** - 이 패널에 포함할 필드 이름 또는 필드 유형(**모든 필드** 또는 **숫자 필드** 포함)을 선택합니다.
+  **값** - Amazon Managed Grafana에서 여러 필드를 단일 값으로 줄이는 데 사용할 축소기 함수를 선택합니다. **값** 목록을 선택하여 함수와 간략한 설명을 확인합니다.
+  **방향** - 스택 방향을 선택합니다.
  +  **자동** - Amazon Managed Grafana에서 최적의 방향이라고 생각하는 항목을 선택합니다.
  +  **가로** - 막대가 가로로 확장됩니다(왼쪽에서 오른쪽 방향).
  +  **세로** - 막대가 세로로 확장됩니다(위에서 아래 방향).
+  **텍스트 모드** - **텍스트 모드** 옵션을 사용하여 패널에 표시되는 텍스트를 제어할 수 있습니다. 이름 및 색상만 중요하고 값이 중요하지 않은 경우 **텍스트 모드**를 **이름**으로 변경합니다. 값은 색상을 결정하는 데 계속 사용되며 툴팁에 표시됩니다.
  +  **자동** - 데이터에 여러 시리즈 또는 필드가 포함된 경우 이름 및 값을 모두 표시합니다.
  +  **값** - 값만 표시하고 이름은 표시하지 않습니다. 이름은 툴팁에 표시됩니다.
  +  **값 및 이름** - 항상 값 및 이름을 표시합니다.
  +  **이름** - 값 대신 이름을 표시합니다. 값은 툴팁에 표시됩니다.
  +  **없음** - 아무것도 표시하지 않습니다(비어 있음). 이름 및 값이 툴팁에 표시됩니다.
+  **색상 모드** - 색상 모드를 선택합니다.
  +  **값** - 값 및 그래프 영역만 색상으로 지정합니다.
  +  **배경** - 배경의 색상도 지정합니다.
+  **그래프 모드** - 그래프 모드를 선택합니다.
  +  **없음** - 그래프를 숨기고 값만 표시합니다.
  +  **영역** - 값 아래에 영역 그래프를 표시합니다. 이 옵션을 사용하려면 쿼리에서 시간 열을 반환해야 합니다.
+  **정렬 모드** - 정렬 모드를 선택합니다.
  +  **자동** - 단일 값만 표시되는 경우(반복 없음) 값이 가운데 배치됩니다. 여러 시리즈 또는 행이 표시되면 값이 왼쪽 정렬됩니다.
  +  **가운데** - 통계 값이 가운데 배치됩니다.

# 상태 타임라인 패널
<a name="state-timeline-panel"></a>

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

상태 타임라인 패널 시각화에는 시간 경과에 따른 개별 상태 변화가 표시됩니다. 각 필드 또는 시리즈는 고유한 가로 밴드로 렌더링됩니다. 상태 리전은 값을 사용하거나 사용하지 않고 렌더링할 수 있습니다. 이 패널은 문자열 또는 부울 상태에서도 잘 작동하지만 시계열에서도 사용할 수 있습니다. 시계열과 함께 사용할 경우 임계치를 사용하여 숫자 값을 개별 상태 리전으로 변환합니다.

## 상태 타임라인 옵션
<a name="state-timeline-options"></a>

다음 옵션을 사용하여 시각화를 세분화합니다.

**동일한 연속 값 병합**

Grafana가 동일한 값이 서로 근접한 경우 병합할지 여부를 제어합니다.

**값 표시**

값이 상태 리전 내에서 렌더링되는지 여부를 제어합니다. 자동인 경우 공간이 충분하면 값을 렌더링합니다.

**값 정렬**

상태 리전 내에서 값 정렬을 제어합니다.

**행 높이**

행 사이의 공간을 제어합니다. 1 = 공간 없음, 0.5 = 50% 공백.

**선 너비**

상태 리전의 선 너비를 제어합니다.

**채우기 불투명도**

상태 리전의 불투명도를 제어합니다.

## 값 매핑
<a name="state-timeline-valuemap"></a>

부울 또는 문자열 값에 색상을 할당하려면 [값 매핑](field-options-overrides.md#value-mapping)을 사용합니다.

## 임계치가 있는 시계열 데이터
<a name="state-timeline-threshold"></a>

패널은 시계열 데이터와도 함께 사용할 수 있습니다. 이 경우 임계치를 사용하여 시계열을 색상이 지정된 개별 상태 리전으로 전환합니다.

## 범례 옵션
<a name="state-timeline-legend"></a>

범례 옵션이 활성화되면 값 매핑 또는 임계치 괄호를 표시할 수 있습니다. 범례에 값 매핑을 표시하려면 표준 옵션 아래 색상 체계 옵션을 단일 색상 또는 클래식 팔레트로 설정해야 합니다. 범례에서 임계치 괄호를 보려면 색상 체계를 시작 임계치로 설정하세요.

**범례 모드** 이러한 설정을 사용하여 시각화에 범례가 표시되는 방식을 세분화합니다.
+  **목록** - 범례를 목록으로 표시합니다. 범례의 기본 표시 모드입니다.
+  **테이블** - 범례를 테이블로 표시합니다.
+  **숨김** - 범례를 숨깁니다.

**범례 배치** - 범례를 배치할 위치를 선택합니다.
+  **하단** - 그래프 아래.
+  **오른쪽** - 그래프의 오른쪽.

# 상태 기록 패널
<a name="status-history-panel"></a>

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

상태 기록 시각화에는 시간 경과에 따른 주기적 상태가 표시됩니다. 각 필드 또는 시리즈는 가로 행으로 렌더링됩니다. 상자는 각 값을 중심으로 렌더링되고 가운데 배치됩니다.

상태 기록 시각화는 문자열, 부울 및 숫자 필드 또는 시계열에서 작동합니다. 시간 필드는 필수 항목입니다. 값 매핑을 사용하여 문자열의 색상을 지정하거나 숫자 범위에 텍스트 값을 할당할 수 있습니다.

## 표시 옵션
<a name="status-timeline-options"></a>

다음 옵션을 사용하여 시각화를 세분화합니다.

**값 표시**

값 상자 내에서 값이 렌더링되는지 여부를 제어합니다. 자동인 경우 공간이 충분하면 값을 렌더링합니다.

**열 너비**는 상자 너비를 제어합니다. 1=최대 너비 및 0=최소 너비.

**선 너비**에서는 상태 리전의 선 너비를 제어합니다.

**채우기 불투명도**에서는 상태 리전의 채우기 불투명도를 제어합니다.

## 값 매핑
<a name="status-history-valuemap"></a>

부울 또는 문자열 값에 색상을 할당하려면 [값 매핑](field-options-overrides.md#value-mapping)을 사용합니다.

## 임계치가 있는 시계열 데이터
<a name="status-history-threshold"></a>

패널은 시계열 데이터와도 함께 사용할 수 있습니다. 이 경우 임계치를 사용하여 상자 색상을 지정합니다. 그라데이션 색상 체계를 사용하여 값 색상을 지정할 수도 있습니다.

## 범례 옵션
<a name="status-history-legend"></a>

범례 옵션이 활성화되면 값 매핑 또는 임계치 괄호를 표시할 수 있습니다. 범례에 값 매핑을 표시하려면 표준 옵션 아래 색상 체계 옵션을 단일 색상 또는 클래식 팔레트로 설정해야 합니다. 범례에서 임계치 괄호를 보려면 색상 체계를 시작 임계치로 설정하세요.

**범례 모드** 이러한 설정을 사용하여 시각화에 범례가 표시되는 방식을 세분화합니다.
+  **목록** - 범례를 목록으로 표시합니다. 범례의 기본 표시 모드입니다.
+  **테이블** - 범례를 테이블로 표시합니다.
+  **숨김** - 범례를 숨깁니다.

**범례 배치** - 범례를 배치할 위치를 선택합니다.
+  **하단** - 그래프 아래.
+  **오른쪽** - 그래프의 오른쪽.

# 테이블 패널
<a name="table-panel"></a>

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

테이블 패널은 시계열 및 테이블, 주석 및 원시 JSON 데이터에 대해 여러 모드를 지원합니다. 이 패널은 날짜 형식, 값 형식 및 색상 지정 옵션도 제공합니다.

## 데이터 및 필드 옵션
<a name="data-and-field-options"></a>

테이블 시각화를 사용하면 다음 옵션을 적용할 수 있습니다.
+  [변환](panel-transformations.md).
+  [필드 옵션 및 재정의](field-options-overrides.md).
+  [Thresholds](thresholds.md).

## 표시 옵션
<a name="display-options"></a>
+  **헤더 표시** - 데이터 소스에서 가져온 열 이름을 표시하거나 숨깁니다.
+  **오름차순/내림차순 정렬** - 정렬 순서를 기본에서 오름차순, 내림차순으로 변경하려면 열 제목을 선택합니다. 선택할 때마다 정렬 순서가 주기의 다음 옵션으로 변경됩니다. 열은 한 번에 하나만 정렬할 수 있습니다.
+  [테이블 필드 옵션](#table-field-options) - 열 너비, 정렬 및 셀 표시 모드와 같은 필드 옵션을 변경합니다.
+  [테이블 열 필터링](#filter-table-columns) - 열 데이터 표시 방식을 일시적으로 변경합니다. 예를 들어 값을 가장 높은 값에서 가장 낮은 값으로 정렬하거나 특정 값을 숨길 수 있습니다.

## 주석 지원
<a name="annotation-support"></a>

주석은 현재 새 테이블 패널에서 지원되지 않습니다.

## 테이블 필드 옵션
<a name="table-field-options"></a>

이 섹션에서는 사용 가능한 모든 테이블 필드 옵션을 설명합니다. 옵션은 Amazon Managed Grafana와 동일한 순서로 나열됩니다. 이 주제에 나열된 옵션은 테이블 패널 시각화에만 적용됩니다.

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

이러한 옵션 적용에 대한 자세한 내용은 [모든 필드 구성](field-options-overrides.md#configure-all-fields) 및 [특정 필드 구성](field-options-overrides.md#configure-specific-fields) 섹션을 참조하세요.

### 열 정렬
<a name="column-alignment"></a>

Amazon Managed Grafana에서 셀 콘텐츠를 정렬하는 방법을 선택합니다.
+ Auto(기본값)
+ 나감
+ Center
+ 오른쪽

### 열 너비
<a name="column-width"></a>

기본적으로 Amazon Managed Grafana는 셀 콘텐츠를 기반으로 열 너비를 자동으로 계산합니다. 이 필드 옵션에서 설정을 재정의하고 모든 열의 너비를 픽셀 단위로 정의할 수 있습니다.

예를 들어 필드에 `100`을 입력하는 경우 필드 외부를 선택하면 모든 열이 100픽셀 너비로 설정됩니다.

### 셀 표시 모드
<a name="cell-display-mode"></a>

기본적으로 Amazon Managed Grafana는 자동으로 표시 설정을 선택합니다. 다음 옵션 중 하나를 선택하여 설정을 재정의해 모든 필드를 변경할 수 있습니다.

**참고**  
**필드** 탭에서 이를 설정하면 시간 필드를 포함한 모든 필드에 표시 모드가 적용됩니다. **재정의** 탭에서 옵션을 설정하면 많은 옵션이 가장 잘 작동합니다.

#### 텍스트 색상
<a name="color-text"></a>

임계치가 설정된 경우 필드 텍스트가 적절한 임계치 색상으로 표시됩니다.

#### 배경 색상
<a name="color-background"></a>

임계치가 설정된 경우 필드 배경이 적절한 임계치 색상으로 표시됩니다.

#### 그라데이션 게이지
<a name="gradient-gauge"></a>

임계치 수준에서는 그라데이션을 정의합니다.

#### LCD 게이지
<a name="lcd-gauge"></a>

게이지가 켜지거나 켜지지 않은 작은 셀로 분할됩니다.

#### JSON 보기
<a name="json-view"></a>

값이 코드 형식으로 표시됩니다. 값이 객체인 경우 값에서 일시 중지하면 JSON 객체를 탐색할 수 있는 JSON 보기가 나타납니다.

### 열 필터
<a name="column-filter"></a>

## 테이블 열 필터링
<a name="filter-table-columns"></a>

테이블 옵션에서 **열 필터링**을 켜면 테이블 옵션을 필터링할 수 있습니다. 자세한 내용은 [테이블 필드 옵션](#table-field-options) 단원을 참조하십시오.

### 열 필터링 켜기
<a name="turn-on-column-filtering"></a>

1. Amazon Managed Grafana에서 필터링하려는 열이 있는 테이블을 표시하는 대시보드를 선택하세요.

1. 필터링하려는 테이블 패널에서 [패널 편집기 열기](AMG-panel-editor.md#open-the-panel-editor).

1. **필드** 탭을 선택하세요.

1. **테이블** 옵션에서 **열 필터** 옵션을 켜세요.

필터 아이콘이 각 열 제목 옆에 나타납니다.

### 열 값 필터링
<a name="filter-column-values"></a>

열 값을 필터링하려면 열 제목 옆에 있는 필터(깔대기) 아이콘을 선택합니다. Grafana 워크스페이스에 해당 열의 필터 옵션이 표시됩니다.

다운로드할 파일 옆에 있는 확인란을 선택합니다. 상단의 검색 필드에 텍스트를 입력하여 해당 값을 화면에 표시합니다. 그러면 해당 값을 찾기 위해 스크롤하지 않고 선택할 수 있습니다.

### 열 필터 지우기
<a name="clear-column-filters"></a>

필터가 적용된 열에는 제목 옆에 파란색 깔때기가 표시됩니다.

필터를 제거하려면 파란색 깔대기 아이콘을 선택한 다음, **필터 지우기**를 선택합니다.

# 텍스트 패널
<a name="text-panel"></a>

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

텍스트 패널을 사용하여 대시보드에 대한 정보 및 설명 패널을 만들 수 있습니다.

**모드**에서 마크다운 또는 HTML을 사용하여 텍스트 스타일을 지정할지 여부를 선택한 다음, 아래 상자에 콘텐츠를 입력합니다. Grafana 워크스페이스에는 시작하는 데 도움이 되는 제목 및 단락이 포함되어 있거나 다른 편집기의 콘텐츠를 붙여넣을 수 있습니다.

# 시계열 패널
<a name="time-series-panel"></a>

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

시계열 패널은 시계열을 선, 점의 경로 또는 일련의 막대로 렌더링할 수 있습니다. 이러한 유형의 그래프는 거의 모든 시계열 데이터를 표시할 수 있을 만큼 다재다능합니다.

**참고**  
그래프 패널 시각화를 시계열 시각화로 마이그레이션할 수 있습니다. 마이그레이션하려면 **패널** 탭에서 **시계열 시각화**를 선택합니다. Grafana는 적용 가능한 모든 설정을 전송합니다.

시계열 시각화를 사용하면 다음 옵션을 적용할 수 있습니다.
+  [변환](panel-transformations.md) 
+  [필드 옵션 및 재정의](field-options-overrides.md) 
+  [Thresholds](thresholds.md) 

필드 옵션을 사용하여 다양한 유형의 그래프를 생성하거나 축을 조정할 수도 있습니다.

이러한 설정을 사용하여 시각화를 세분화합니다.

## 툴팁 모드
<a name="time-series-panel-tooltip"></a>

그래프 위에 커서를 놓으면 Grafana에서 툴팁을 표시할 수 있습니다. 툴팁 동작을 선택합니다.
+  **단일** - 가리키기 툴팁에는 가리키고 있는 시리즈만 표시됩니다.
+  **모두** - 가리키기 툴팁에는 그래프의 모든 시리즈가 표시됩니다. Grafana는 툴팁의 시리즈 목록에서 가리킨 시리즈를 굵게 강조 표시합니다.
+  **숨김** - 툴팁을 표시하지 않습니다.

## 범례 모드 및 배치
<a name="time-series-panel-legend"></a>

범례가 표시되는 방식을 선택합니다.
+  **목록** - 범례를 목록으로 표시합니다. 기본값입니다.
+  **테이블** - 범례를 테이블로 표시합니다.
+  **숨김** - 범례를 숨깁니다.

범례를 표시할 위치를 선택합니다.
+  **하단** - 그래프 아래.
+  **오른쪽** - 그래프의 오른쪽.

## 범례 계산
<a name="time-series-panel-legend-calculations"></a>

범례에 표시할 계산을 선택하세요. 자세한 내용은 [계산 목록](list-of-calculations.md) 단원을 참조하십시오.

# 시계열을 줄로 사용해 그래프 작성
<a name="time-series-graph-lines"></a>

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

이 섹션에서는 시계열 필드 옵션을 사용하여 시계열 데이터를 선으로 시각화하는 방법을 설명하고 옵션 기능을 보여줍니다.

**패널 생성**

1. **시계열** 시각화를 선택하여 패널을 생성하세요. 자세한 내용은 [패널 추가](add-a-panel-to-a-dashboard.md) 단원을 참조하십시오.

1. **패널 편집기**에서 **필드**를 선택하세요.

1. **스타일**에서 **행**을 선택합니다.

## 줄 스타일 지정
<a name="time-series-graph-lines-style"></a>

선 스타일을 지정하기 위한 다양한 옵션이 있습니다.
+ **선 보간** - Grafana가 시리즈 선을 보간하는 방법을 선택합니다. 선택 항목은 **선형**, **평활**, **이전 단계** 및 **이후 단계**입니다.
+ **선 너비** - 선 두께를 0\$110픽셀로 설정합니다.
+ **채우기 불투명도** - 시리즈 채우기의 불투명도를 0\$1100%로 설정합니다.
+ **그라데이션 모드** - 그라데이션 채우기 모드를 설정합니다. 채우기 그라데이션은 선 색상을 기반으로 합니다. 색상을 변경하려면 표준 색상 체계 필드 옵션을 사용합니다.

  그라데이션 모양은 **채우기 불투명도** 설정의 영향을 받습니다.

  그라데이션 채우기에 대한 선택 사항은 **없음**, **불투명도**, **색상**입니다. **불투명도**를 사용하면 그라데이션의 투명도가 y축의 값을 기반으로 계산됩니다. y축의 값에 따라 채우기의 불투명도가 증가하고 있습니다. **색조**를 사용하면 그라데이션 색상은 선 색상의 색조에 기반으로 생성됩니다.
+ **선 스타일** - 선 스타일을 설정합니다. 색상을 변경하려면 표준 색상 체계 필드 옵션을 사용합니다.

  선 스타일 모양은 **선 너비** 및 **채우기 불투명도** 설정의 영향을 받습니다.

  선 스타일의 선택 항목은 **실선**, **대시**, **점선**입니다.
+ **Null 값** - 데이터의 갭을 표시하는 방법을 선택합니다. Null 값을 연결하여 연속 선을 형성하거나 선택적으로 데이터의 갭이 더 이상 연결되지 않도록 임계치를 설정할 수 있습니다. 데이터 포인트를 갭과 연결하지 않거나(**안 함**), 데이터 포인트를 **항상** 갭과 연결하도록 선택하거나 데이터의 갭이 더 이상 연결되지 않아야 하는 **임계치**를 설정할 수 있습니다.
+ **포인트 표시** - 그래프에 포인트를 표시해야 하는 시기를 선택합니다. 선택 항목은 **자동**, **항상** 및 **안 함**입니다.

## 다음 아래 채우기
<a name="time-series-panel-legend-fillbelow"></a>

이 옵션은 재정의 탭에서만 사용할 수 있습니다.

**두 시리즈 사이의 영역을 채우는 방법**

1. 아래에서 작성할 필드를 선택하세요.

1. **재정의 속성 추가**에서 **다음 아래 채우기**를 선택하세요.

1. 채우기를 중지할 시리즈를 선택하세요.

# 시계열을 막대로 사용해 그래프 작성
<a name="time-series-graph-bars"></a>

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

이 섹션에서는 시계열 필드 옵션을 사용하여 시계열 데이터를 막대로 시각화하는 방법을 설명하고 옵션 기능을 보여줍니다.

**패널 생성**

1. **시계열** 시각화를 선택하여 패널을 생성하세요. 자세한 내용은 [패널 추가](add-a-panel-to-a-dashboard.md) 단원을 참조하십시오.

1. **패널 편집기**에서 **필드**를 선택하세요.

1. **스타일**에서 **막대**를 선택합니다.

## 막대 스타일 지정
<a name="time-series-graph-bars-style"></a>

막대 스타일을 지정하기 위한 다양한 옵션이 있습니다.
+ **막대 정렬** - 데이터 포인트를 기준으로 막대의 위치를 설정합니다. 선택 항목은 **이전,** **가운데**, **이후**입니다.
+ **선 너비** - 막대 윤곽선의 두께를 0\$110픽셀로 설정합니다.
+ **채우기 불투명도** - 막대 채우기의 불투명도를 0\$1100%로 설정합니다.
+ **그라데이션 모드** - 그라데이션 채우기 모드를 설정합니다. 채우기 그라데이션은 선 색상을 기반으로 합니다. 색상을 변경하려면 표준 색상 체계 필드 옵션을 사용합니다.

  그라데이션 모양은 **채우기 불투명도** 설정의 영향을 받습니다.

  그라데이션 채우기에 대한 선택 사항은 **없음**, **불투명도**, **색상**입니다. **불투명도**를 사용하면 그라데이션의 투명도가 y축의 값을 기반으로 계산됩니다. y축의 값에 따라 채우기의 불투명도가 증가하고 있습니다. **색조**를 사용하면 그라데이션 색상은 선 색상의 색조에 기반으로 생성됩니다.
+ **포인트 표시** - 그래프에 포인트를 표시해야 하는 시기를 선택합니다. 선택 항목은 **자동**, **항상** 및 **안 함**입니다.

# 시계열을 포인트로 사용해 그래프 작성
<a name="time-series-graph-points"></a>

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

이 섹션에서는 시계열 필드 옵션을 사용하여 시계열 데이터를 포인트로 시각화하는 방법을 설명하고 옵션 기능을 보여줍니다.

**패널 생성**

1. **시계열** 시각화를 선택하여 패널을 생성하세요. 자세한 내용은 [패널 추가](add-a-panel-to-a-dashboard.md) 단원을 참조하십시오.

1. **패널 편집기**에서 **필드**를 선택하세요.

1. **스타일**에서 **포인트**를 선택하세요.

## 포인트 스타일 지정
<a name="time-series-graph-points-style"></a>

포인트로 그래프를 작성할 때 포인트 크기를 선택할 수 있습니다.
+ **포인트 크기** - 직경이 1\$140픽셀인 포인트 크기를 선택합니다.

# 축 표시 변경
<a name="time-series-change-axis"></a>

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

이 섹션에서는 시계열 필드 옵션을 사용하여 시각화에서 축 표시를 제어하는 방법을 설명하고 축 옵션 기능을 보여줍니다.

축에는 다양한 옵션이 있습니다.
+ **Y축 배치** - y축의 배치를 설정합니다. 선택 항목은 **왼쪽**, **오른쪽**, **숨김**입니다.
+ **Y축 레이블** - y축의 텍스트 레이블을 설정합니다. y축이 둘 이상인 경우 **재정의** 탭을 사용하여 다른 레이블을 할당할 수 있습니다.
+ **너비** - 축의 고정 너비를 설정합니다. 기본적으로 Grafana 워크스페이스는 축 너비를 동적으로 계산합니다. 축의 너비를 설정하면 축 유형이 다른 데이터가 동일한 표시 비율을 공유할 수 있습니다. 이렇게 하면 축이 서로 시각적으로 근접하여 이동 또는 확장되지 않기 때문에 데이터에 대한 둘 이상의 그래프에서 의미를 더 쉽게 비교할 수 있습니다.
+ **소프트 최소 및 소프트 최대** - y축 제한을 더 잘 제어할 수 있도록 **소프트 최소** 또는 **소프트 최대**를 설정합니다. 기본적으로 Grafana 워크스페이스는 데이터를 기반으로 y축의 범위를 자동으로 설정합니다.

  **소프트 최소** 또는 **소프트 최대** 설정은 데이터가 대부분 평탄할 때 일시적 변화가 크게 확대되는 것을 방지할 수 있습니다. 표준 최소 및 최대 필드 옵션에서 파생된 하드 최소 또는 최대는 정의된 지점을 지나 스파이크를 클리핑하여 간헐적인 스파이크가 유용한 세부 정보를 평탄화하는 것을 방지할 수 있습니다.
+ **스케일** - y축 값에 사용할 스케일을 설정합니다. 선택 항목은 **선형** 및 **대수**입니다.

# 그래프 스택 시계열
<a name="time-series-stacked"></a>

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

이 섹션에서는 시계열 패널 필드 옵션을 사용하여 시리즈의 스택을 제어하는 방법을 설명하고 스택 옵션 기능을 보여줍니다. 스택을 사용하면 Grafana가 시리즈를 서로 위에 표시할 수 있습니다. 시각화에서 스택을 사용할 때 잘못 이해할 수 있는 그래프를 쉽게 생성할 수 있으므로 주의해야 합니다. 스택이 최선의 접근 방식이 아닌 이유에 대한 자세한 내용은 [The Issue with Stacking](https://www.data-to-viz.com/caveat/stacking.html)을 참조하세요.

# 그룹에서 시리즈 스택
<a name="time-series-stacked-groups"></a>

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

스택 그룹 옵션은 재정의로만 사용할 수 있습니다.

**동일한 그룹에서 시리즈를 스택하는 방법**

1. 재정의 섹션에서 **시리즈 스택** 옵션에 대한 필드 재정의를 생성하세요.

1. **일반** 스택 모드를 선택하세요.

1. 시리즈를 표시할 스택 그룹의 이름을 지정하세요. 스택 그룹 이름 옵션은 재정의를 생성할 때만 사용할 수 있습니다.

# Thresholds
<a name="thresholds"></a>

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

임계치는 정의한 조건에 따라 값 텍스트 또는 배경의 색상을 설정합니다.

임계치는 다음 두 가지 방법 중 하나로 정의할 수 있습니다.
+ **절대** 임계치는 숫자를 기준으로 정의됩니다. 예를 들어 1\$1150의 스케일에서 80과 같습니다.
+ **백분율** 임계치는 최소 또는 최대를 기준으로 정의됩니다. 예를 들어 80%와 같습니다.

다음 시각화에 임계치를 적용할 수 있습니다.
+ [막대 게이지 패널](alert-panel-bar-gauge-panel.md) 
+  [게이지 패널](gauge-panel.md) 
+  [그래프 패널](graph-panel.md)
+  [통계 패널](stat-panel.md)
+  [테이블 패널](table-panel.md)

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

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

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

## 임계치 추가
<a name="add-a-threshold"></a>

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

**참고**  
이 지침은 통계, 게이지, 막대 게이지 및 테이블 시각화에만 적용됩니다.

1. 임계치를 추가할 패널을 선택하세요.

1. **필드** 탭을 선택하세요.

1. **임계치 추가**를 선택하세요.

   Amazon Managed Grafana는 제안된 숫자 및 색상 값이 포함된 임계치를 추가합니다.

1. 권장 사항을 수락하거나 새 임계치를 편집하세요.
   +  **색상 편집** - 변경하려는 색상 점을 선택한 다음, 새 색상을 선택합니다.
   +  **번호 편집** - 변경할 번호를 선택한 다음, 새 번호를 입력합니다.
   +  **임계치 모드** - 이 패널의 모든 임계치에 대해 변경할 모드를 선택합니다.

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

## 그래프 패널에 임계치 추가
<a name="add-a-threshold-to-a-graph-panel"></a>

그래프 패널 시각화에서 임계치를 사용하여 그래프가 특정 임계치를 통과할 때 더 쉽게 볼 수 있도록 그래프에 임의의 선 또는 섹션을 추가하세요.

1. 임계치을 추가할 그래프 패널을 선택하세요.

1. **패널** 탭에서 **임계치**를 선택하세요.

1. **임계치 추가**를 선택하세요.

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

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

## 임계치 삭제
<a name="delete-a-threshold"></a>

1. 임계치를 제거할 패널을 선택하세요.

1. **필드** 탭을 선택하세요. (또는 그래프 패널의 경우 **패널** 탭을 선택하세요.)

1. 제거하려는 임계치 옆에 있는 휴지통 아이콘을 선택하세요.

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

# WindRose
<a name="windrose"></a>

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

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="windrose-options"></a>

WindRose 템플릿은 다음 옵션을 지원합니다.
+ 축 빈도
+ 축 스타일(각도 또는 나침반)
+ 스케일(선형, 사각형, 로그)

# 패널 검사
<a name="inspect-a-panel"></a>

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

패널 검사기는 패널을 이해하고 문제를 해결하는 데 도움이 됩니다. Grafana 워크스페이스 패널에서 원시 데이터를 검사하고, 해당 데이터를 쉼표로 구분된 값(CSV) 파일로 내보내며, 쿼리 요청을 보고, 패널 및 데이터 JSON을 내보낼 수 있습니다.

## 패널 검사기 UI
<a name="panel-inspector-ui"></a>

패널 검사기는 창 상단에 **검사: <NameOfPanelBeingInspected>**를 표시합니다. 오른쪽 상단의 화살표를 선택하여 창을 확장하거나 줄입니다.

패널 검사기는 네 개의 탭으로 구성됩니다.
+  **데이터 탭** - 변환이 적용된 상태로 쿼리에서 반환된 원시 데이터를 표시합니다. 재정의 및 값 매핑과 같은 필드 옵션은 기본적으로 적용되지 않습니다.
+  **통계 탭** - 쿼리에 걸리는 시간과 반환되는 양을 보여줍니다.
+  **JSON 탭** - 패널 JSON, 패널 데이터 JSON 및 데이터 프레임 구조 JSON을 보고 복사할 수 있습니다. Amazon Managed Grafana를 프로비저닝하거나 관리하는 경우에 유용합니다.
+  **쿼리 탭** - Amazon Managed Grafana에서 데이터 소스를 쿼리할 때 전송된 서버에 대한 요청을 표시합니다.

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

## 패널 검사기 태스크
<a name="panel-inspector-tasks"></a>

패널 검사기에서 패널을 검사하고, 원시 쿼리 결과를 검사 및 다운로드하며, 쿼리 성능을 검사하고, 패널 JSON 모델을 보며, 데이터 소스에 대한 원시 요청 및 응답을 볼 수 있습니다.

### 패널 검사기 열기
<a name="open-the-panel-inspector"></a>

볼 수 있는 모든 패널을 검사할 수 있습니다.

1. Grafana 워크스페이스 콘솔에서 검사할 패널이 포함된 대시보드를 선택하세요.

1. 검사하려는 패널의 제목을 선택한 다음, **검사**를 선택하세요. 또는 패널 제목에서 잠시 멈춘 다음, **i**를 누르세요.

패널 검사기 창이 화면 오른쪽에서 열립니다.

### 원시 쿼리 결과 검사
<a name="inspect-raw-query-results"></a>

테이블에서 원시 쿼리 결과를 확인하세요. 이는 패널에서 필드 옵션 또는 필드 옵션 재정의를 적용하기 전에 변환이 적용된 쿼리에서 반환되는 데이터입니다.

1. 패널 검사기를 열고 **데이터** 탭을 선택하세요. 또는 패널 메뉴에서 **검사**, **데이터**를 선택하세요.

1. 패널에 여러 쿼리가 포함되어 있거나 여러 노드를 쿼리하는 경우 추가 옵션이 있습니다.
+  **결과 선택** - 보려는 결과 세트 데이터를 선택합니다.
+  **데이터 변환** 
  +  **시간별 조인** - 열당 하나의 결과 세트로 모든 쿼리의 원시 데이터를 동시에 확인합니다. 열 제목을 선택하여 데이터를 재정렬합니다.

  필드 옵션 및 옵션 재정의가 적용된 테이블에서 원시 쿼리 결과를 확인하세요.

  1. 패널 검사기에서 **데이터** 탭을 엽니다.

  1. 테이블 위에서 **데이터 표시 옵션**을 선택하세요.

  1. **필드 구성 적용** 토글 버튼을 선택하세요.

### 원시 쿼리 결과를 CSV 파일로 다운로드
<a name="download-raw-query-results-as-csv"></a>

Amazon Managed Grafana는 기본 브라우저 다운로드 위치에 CSV 파일을 생성합니다. 원하는 뷰어에서 열 수 있습니다.

1. 패널 검사기를 엽니다.

1. 위에 설명된 대로 원시 쿼리 결과를 검사하세요. 내보내려는 원시 데이터가 표시될 때까지 설정을 조정하세요.

1. **Download CSV**를 선택합니다.

Excel에 대해 형식화된 CSV 파일을 다운로드하려면 **CSV 다운로드**를 선택하기 전에 **데이터 옵션** 패널을 확장하고 **Excel용 다운로드** 옵션을 켜세요.

### 쿼리 성능 검사
<a name="inspect-query-performance"></a>

**통계** 탭에는 쿼리 소요 시간, 전송한 쿼리 수, 반환된 행 수를 알려주는 통계가 표시됩니다. 이 정보는 특히 예상치 못하게 높거나 낮은 숫자가 있는 경우 쿼리 문제를 해결하는 데 도움이 될 수 있습니다.

1. 패널 검사기를 엽니다.

1. **상태** 탭을 선택하세요.

통계는 읽기 전용 형식으로 표시됩니다.

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

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

1. 패널 검사기를 열고 **JSON** 탭을 선택하세요. 또는 패널 메뉴에서 **검사**, **패널 JSON**을 선택하세요.

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

1. JSON의 일부를 확장하거나 축소하여 탐색하거나 **클립보드로 복사**를 선택하여 다른 애플리케이션에서 JSON을 붙여넣을 수 있습니다.

### 데이터 소스에 대한 원시 요청 및 응답 보기
<a name="view-raw-request-and-response-to-data-source"></a>

1. 패널 검사기를 열고 **쿼리** 탭을 선택하세요. 또는 패널 메뉴에서 **검사**, **쿼리**를 선택하세요.

1. [**Refresh**]를 선택합니다.

Amazon Managed Grafana는 정보를 수집하기 위해 서버에 쿼리를 전송한 다음, 결과를 표시합니다. 쿼리의 특정 부분을 드릴다운하거나, 모든 쿼리를 확장 또는 축소하거나, 다른 애플리케이션에서 사용할 클립보드에 데이터를 복사할 수 있습니다.

# 계산 목록
<a name="list-of-calculations"></a>

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

이 주제에서는 Amazon Managed Grafana에 사용되는 계산을 나열하고 정의합니다.

특히 이러한 계산은 **변환** 탭과 막대 게이지, 게이지 및 통계 시각화에 사용됩니다.


|  계산  |  설명  | 
| --- | --- | 
|  모든 null  |  모든 값이 null인 경우 True  | 
|  모두 0  |  모든 값이 0인 경우 True  | 
|  변경 횟수  |  필드의 값이 변경되는 횟수  | 
|  개수  |  필드에 있는 값 수  | 
|  델타  |  값의 누적 변화  | 
|  차이  |  필드의 첫 번째 값과 마지막 값의 차이  | 
|  고유한 개수  |  필드에 있는 고유한 값 수  | 
|  첫 번째(null 아님)  |  필드에서 null이 아닌 첫 번째 값  | 
|  최대  |  필드의 최댓값  | 
|  평균  |  필드에 있는 모든 값의 평균 값  | 
|  최소  |  필드의 최솟값  | 
|  최소(0 초과)  |  필드의 최소 양수 값  | 
|  Range  |  필드의 최댓값과 최솟값의 차이  | 
|  단계  |  필드의 값 사이에서 최소 간격  | 
|  합계  |  필드에 있는 모든 값의 합계  | 

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

1.  이름을 편집합니다.

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

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

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

1.  간격을 편집합니다.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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


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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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


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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

1.  대시보드를 여세요.

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

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

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

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

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

```
{
  "id": null,
  "uid": "cLV5GDCkz",
  "title": "New dashboard",
  "tags": [],
  "style": "dark",
  "timezone": "browser",
  "editable": true,
  "hideControls": false,
  "graphTooltip": 1,
  "panels": [],
  "time": {
    "from": "now-6h",
    "to": "now"
  },
  "timepicker": {
    "time_options": [],
    "refresh_intervals": []
  },
  "templating": {
    "list": []
  },
  "annotations": {
    "list": []
  },
  "refresh": "5s",
  "schemaVersion": 17,
  "version": 0,
  "links": []
}
```

 다음 표에서는 대시보드 JSON의 각 필드에 대한 사용 세부 정보를 제공합니다.


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

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

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

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

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

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

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

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

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

```
"timepicker": {
    "collapse": false,
    "enable": true,
    "notice": false,
    "now": true,
    "refresh_intervals": [
      "5s",
      "10s",
      "30s",
      "1m",
      "5m",
      "15m",
      "30m",
      "1h",
      "2h",
      "1d"
    ],
    "status": "Stable",
    "type": "timepicker"
  }
```

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


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

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

 `templating` 필드에는 저장된 값 및 기타 메타데이터와 함께 템플릿 변수 배열이 포함되어 있습니다. 다음 예제에서는 `templating` 메타데이터를 보여줍니다.

```
 "templating": {
    "enable": true,
    "list": [
      {
        "allFormat": "wildcard",
        "current": {
          "tags": [],
          "text": "prod",
          "value": "prod"
        },
        "datasource": null,
        "includeAll": true,
        "name": "env",
        "options": [
          {
            "selected": false,
            "text": "All",
            "value": "*"
          },
          {
            "selected": false,
            "text": "stage",
            "value": "stage"
          },
          {
            "selected": false,
            "text": "test",
            "value": "test"
          }
        ],
        "query": "tag_values(cpu.utilization.average,env)",
        "refresh": false,
        "type": "query"
      },
      {
        "allFormat": "wildcard",
        "current": {
          "text": "apache",
          "value": "apache"
        },
        "datasource": null,
        "includeAll": false,
        "multi": false,
        "multiFormat": "glob",
        "name": "app",
        "options": [
          {
            "selected": true,
            "text": "tomcat",
            "value": "tomcat"
          },
          {
            "selected": false,
            "text": "cassandra",
            "value": "cassandra"
          }
        ],
        "query": "tag_values(cpu.utilization.average,app)",
        "refresh": false,
        "regex": "",
        "type": "query"
      }
    ]
  }
```

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


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

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

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

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

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

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

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

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

```
var seriesName = 'argName';

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

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

return dashboard;
```

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

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

# 탐색
<a name="explore"></a>

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

 Grafana 워크스페이스에서 대시보드 UI는 시각화를 위한 대시보드를 구축하기 위한 도구를 제공합니다. *탐색*에서는 쿼리에 집중할 수 있도록 모든 대시보드 및 패널 옵션이 사라집니다. 작업 쿼리가 있을 때까지 반복한 다음, 대시보드를 계획하고 구축합니다.

 인프라 모니터링 및 인시던트 대응의 경우 더 이상 다른 도구로 전환하여 잘못된 부분을 디버깅할 필요가 없습니다. 탐색을 사용하여 지표와 로그를 자세히 살펴보고 원인을 찾을 수 있습니다.

 탐색을 사용하면 대시보드를 생성하지 않고도 데이터를 더 쉽게 볼 수 있습니다. 데이터 소스가 그래프 및 테이블 데이터를 지원하는 경우 탐색은 결과를 그래프와 테이블로 표시합니다. 이렇게 하면 데이터의 추세와 세부 정보를 동시에 확인할 수 있습니다.

## 탐색 시작
<a name="start-exploring"></a>

**참고**  
 기본적으로 최종 사용자 역할의 사용자는 편집할 수 없으며 탐색에 액세스할 수 없습니다.

 왼쪽 메뉴의 **탐색** 아이콘을 누르면 빈 탐색 탭을 엽니다.

 패널의 기존 쿼리를 시작하려면 **패널** 메뉴에서 **탐색** 옵션을 선택하세요. 그러면 패널의 쿼리가 포함된 탐색 탭이 열립니다. 그런 다음, 대시보드 외부에서 쿼리를 조정하거나 반복할 수 있습니다.

 왼쪽 상단의 드롭다운 목록에서 데이터 소스를 선택하세요. Prometheus에는 사용자 지정 탐색 구현이 있습니다. 다른 데이터 소스는 표준 쿼리 편집기를 사용합니다.

 쿼리 필드에서 쿼리를 작성하고 데이터를 탐색할 수 있습니다. 쿼리 필드 옆에는 지우기 버튼(X), 쿼리 추가 버튼(\$1) 및 쿼리 제거 버튼(-)와 같은 3개의 버튼이 있습니다. 패널 쿼리 편집기와 마찬가지로 여러 쿼리를 추가하고 제거할 수 있습니다.

## 분할 및 비교
<a name="split-and-compare"></a>

 분할 보기 기능은 그래프와 테이블을 나란히 비교하거나 한 페이지에서 관련 데이터를 함께 보는 방법입니다. **분할**을 선택하여 현재 쿼리를 복제하고 페이지를 두 개의 쿼리로 나란히 분할합니다. 새 쿼리에 대해 다른 데이터 소스를 선택하는 옵션이 제공됩니다. 이 기능을 사용하면 서로 다른 두 서버에 대해 동일한 쿼리를 비교하거나 스테이징 환경을 프로덕션 환경과 비교할 수 있습니다.

 분할 보기에서는 시간 선택기에 연결된 시간 동기화 버튼 중 하나를 선택하여 두 패널의 시간 선택기를 연결할 수 있습니다(하나를 변경하면 다른 항목도 변경됨). 시간 선택기를 연결하면 분할 보기 쿼리의 시작 시간과 종료 시간을 동기화하여 두 분할 패널 모두에서 동일한 시간 간격을 확인할 수 있습니다.

 **분할 닫기**를 선택하여 새로 생성된 쿼리를 닫을 수 있습니다.

## 단축 링크 공유
<a name="share-shortened-link"></a>

 **단축 링크 공유** 기능을 사용하여 복잡한 쿼리 파라미터가 포함된 더 긴 URL을 공유하는 대신 `/goto/:uid` 형식의 더 작고 간단한 URL을 생성합니다. 탐색 도구 모음에서 **공유** 옵션을 선택하여 단축 링크를 생성할 수 있습니다. 사용하지 않는 단축 링크는 7일 후에 자동으로 삭제됩니다.

## 쿼리 기록
<a name="query-history"></a>

 쿼리 기록은 탐색에서 사용한 쿼리 목록입니다. 기록은 브라우저에 로컬로 존재하며 공유되지 않습니다. 기록을 열고 상호 작용하려면 탐색에서 **쿼리 기록**을 선택하세요.

### 쿼리 기록 보기
<a name="view-query-history"></a>

 쿼리 기록에서 다음을 수행할 수 있습니다.
+  쿼리를 실행합니다.
+  주석을 생성하거나 편집합니다.
+  쿼리를 클립보드에 복사합니다.
+  쿼리가 포함된 단축 링크를 클립보드에 복사합니다.
+  쿼리를 시작합니다.

### 즐겨찾기 쿼리 관리
<a name="manage-favorite-queries"></a>

 쿼리 기록 탭에서 별표가 지정된 모든 쿼리는 별표 탭에 표시됩니다. 자주 사용하는 쿼리에 더 빠르게 액세스하고 쿼리를 다시 입력하지 않고 재사용할 수 있습니다.

### 쿼리 기록 정렬
<a name="sort-query-history"></a>

 기본적으로 쿼리 기록에는 최신 쿼리가 표시됩니다. 날짜 또는 데이터 소스 이름을 기준으로 오름차순 또는 내림차순으로 기록을 정렬할 수 있습니다.

쿼리 기록 오른쪽의 드롭다운 목록에서 다음 옵션 필드 중 하나를 선택하세요.
+  최신 항목 우선 
+  가장 오래된 항목 우선 
+  데이터 소스 A-Z 
+  데이터 소스 Z-A 

**참고**  
 분할 보기인 경우 정렬 모드는 활성 패널에만 적용됩니다.

### 쿼리 기록 필터링
<a name="filter-query-history"></a>

 **쿼리 기록** 및 **별표** 탭에서 데이터 소스 이름으로 쿼리 기록을 필터링할 수 있습니다.

1. **특정 데이터 소스에 대한 쿼리 필터링**을 선택하세요.

1. 기록을 필터링하는 데 사용할 데이터 소스를 선택하세요. 여러 데이터 소스를 선택할 수 있습니다.

**쿼리 기록** 탭에서 세로 슬라이더를 사용하여 쿼리를 날짜별로 필터링할 수 있습니다.
+ 시작 날짜를 조정하려면 하단 핸들을 끄세요.
+ 종료 날짜를 조정하려면 상단 핸들을 끄세요.

**참고**  
분할 보기인 경우 필터는 활성 패널에만 적용됩니다.

### 쿼리 기록에서 검색
<a name="search-in-query-history"></a>

 기록의 쿼리 및 설명에서 검색할 수 있습니다. **쿼리 기록** 및 **별표** 탭에서 쿼리를 검색할 수 있습니다.

1.  **쿼리 검색** 필드를 선택하세요.

1.  검색 필드에 검색어를 입력하세요.

### 쿼리 기록 설정
<a name="query-history-settings"></a>

 **설정** 탭에서 쿼리 기록을 사용자 지정할 수 있습니다. 다음 표에는 사용 가능한 옵션이 나열되어 있습니다.


|  설정  |  기본값  | 
| --- | --- | 
|  Grafana에서 쿼리 기록을 저장하는 기간을 지정합니다. |  1주  | 
|  기본 활성 탭을 변경합니다. |  쿼리 기록 탭  | 
|  현재 탐색에서 활성 상태인 데이터 소스에 대한 쿼리만 표시합니다. |  True  | 
|  쿼리 기록을 지웁니다. |  (저장된 모든 쿼리를 영구적으로 삭제하려면 쿼리 기록 지우기를 선택합니다.)  | 

**참고**  
쿼리 기록 설정은 전역적이며 분할 모드의 두 패널에 모두 적용됩니다.

## Prometheus별 기능
<a name="prometheus-specific-features"></a>

 첫 번째 버전의 탐색에서는 Prometheus에 대한 사용자 지정 쿼리 환경을 제공합니다. 쿼리를 실행할 때 Grafana는 실제로 그래프에 대한 일반 Prometheus 쿼리 및 테이블에 대한 인스턴스 쿼리라는 두 가지 쿼리를 실행합니다. 인스턴트 쿼리는 각 시계열의 마지막 값을 반환하며, 이는 그래프에 표시된 데이터의 좋은 요약 정보를 보여줍니다.

### 지표 탐색기
<a name="metrics-explorer"></a>

 쿼리 필드 왼쪽에서 **지표**를 선택하여 지표 탐색기를 엽니다. 그러면 지표가 접두사별로 그룹화된 계층적 메뉴가 표시됩니다. 예를 들어 모든 Alertmanager 지표는 `alertmanager` 접두사 아래에 그룹화됩니다. 이는 사용 가능한 지표를 탐색하는 데 좋은 출발점입니다.

### 쿼리 필드
<a name="query-field"></a>

 쿼리 필드는 지표 이름, 함수에 대한 자동 완성을 지원하며 표준 Prometheus 쿼리 편집기와 거의 동일한 방식으로 작동합니다. **Enter**를 눌러 쿼리를 실행합니다.

 자동 완성 메뉴는 **Ctrl\$1Space**를 눌러 액세스할 수 있습니다. 자동 완성 메뉴에는 최근에 실행된 쿼리 목록이 포함된 새 기록 섹션이 포함되어 있습니다.

 제안은 쿼리 필드 아래에 표시될 수 있습니다. 제안 사항을 선택하여 제안된 변경 사항으로 쿼리를 업데이트합니다.
+  카운터(단조적으로 증가하는 지표)의 경우 비율 함수가 제안됩니다.
+  버킷의 경우 히스토그램 함수가 제안됩니다.
+  기록 규칙의 경우 규칙을 확장할 수 있습니다.

### 테이블 필터
<a name="table-filters"></a>

 테이블 패널의 **레이블** 열에서 **필터** 버튼을 선택하여 쿼리 표현식에 필터를 추가합니다. 여러 쿼리에 대한 필터를 추가할 수도 있습니다. 필터는 모든 쿼리에 추가됩니다.

## 로그 통합
<a name="logs-integration"></a>

 또한 탐색을 사용하여 다음 데이터 소스로 로그를 조사할 수 있습니다.
+  InfluxDB 
+  Elasticsearch 

### 로그 시각화
<a name="logs-visualization"></a>

 로그 쿼리 결과는 그래프에 히스토그램으로 표시되고 개별 로그는 아래에 표시됩니다. 데이터 소스가 요청된 시간 범위에 대한 히스토그램 데이터를 전송하지 않는 경우 로그 모델은 자동으로 계산된 시간 간격으로 버킷화된 로그 행 수를 기반으로 시계열을 계산합니다. 그런 다음, 히스토그램의 시작은 결과에서 첫 번째 로그 행의 타임스탬프에 의해 고정됩니다. 시계열의 끝은 시계 선택기의 **종료** 범위에 고정됩니다.

#### 로그 수준
<a name="log-level"></a>

 **수준** 레이블이 지정된 로그의 경우 Grafana에서는 레이블 값을 사용하여 로그 수준을 결정하고 그에 따라 색상을 업데이트합니다. 로그에 수준 레이블이 지정되지 않은 경우 Grafana에서는 로그를 구문 분석하여 해당 콘텐츠가 지원되는 표현식과 일치하는지 확인합니다. 로그 수준은 항상 첫 번째 일치에 의해 결정됩니다. Grafana에서 로그 수준을 확인할 수 없는 경우 **알 수 없음** 로그 수준으로 시각화됩니다. 다음 표에는 로그 수준과 로그 수준 약어 및 표현식의 매핑이 나열되어 있습니다.


|  지원되는 표현식  |  로그 수준  |  색상  | 
| --- | --- | --- | 
|  긴급  |  심각  |  보라색  | 
|  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="visualization-options"></a>

 로그가 표시되는 방법을 사용자 지정하고 표시되는 열을 선택할 수 있습니다.

#### Time
<a name="visualization-options-time"></a>

 이 옵션은 시간 열을 표시하거나 숨깁니다. 데이터 소스에서 보고된 로그 줄과 연결된 타임스탬프입니다.

#### 고유 레이블
<a name="visualization-options-unique-labels"></a>

 이 옵션은 공통 레이블이 아닌 레이블만 포함하는 고유 레이블 열을 표시하거나 숨깁니다. 모든 공통 레이블은 위에 표시됩니다.

#### 줄 바꿈
<a name="visualization-options-wrap-lines"></a>

 화면에서 줄 바꿈을 사용하려면 이를 **True**로 설정합니다. 이 옵션을 **False**로 설정하면 가로 스크롤을 지원합니다.

#### 중복
<a name="visualization-options-deduping"></a>

 로그 데이터는 매우 반복적일 수 있습니다. 탐색에서 중복 로그 줄을 숨기면 도움이 될 수 있습니다. 다양한 중복 제거 알고리즘 중에서 선택할 수 있습니다.
+  **정확** - 정확한 일치는 날짜 필드를 제외한 전체 줄에서 수행됩니다.
+  **숫자** - 기간, IP 주소 등과 같은 숫자를 제거한 후 줄에서 일치가 수행됩니다.
+  **서명** - 가장 적극적인 중복 제거 방법으로, 모든 문자와 숫자를 제거합니다. 나머지 공백 및 구두점에 대해 일치가 수행됩니다.

#### 결과 순서 뒤집기
<a name="visualization-options-flip-results-order"></a>

 수신된 로그의 순서를 기본 내림차순(최신 항목 우선)에서 오름차순(가장 오래된 항목 우선)으로 변경할 수 있습니다.

### 레이블 및 감지된 필드
<a name="labels-and-detected-fields"></a>

 각 로그 행에는 보다 강력한 상호 작용을 위해 레이블 및 감지된 필드를 포함하는 확장 가능한 영역이 있습니다. 모든 레이블에 대해 선택한 레이블을 기준으로 필터링하여 해당 레이블을 포함(긍정 필터)하거나 제외(부정 필터)할 수 있습니다. 또한 각 필드 또는 레이블에는 표시된 모든 로그와 관련된 일회성 통계를 표시하는 통계 아이콘이 있습니다.

### 감지된 필드 토글
<a name="toggle-detected-fields"></a>

 로그가 JSON 또는 logfmt로 구성된 경우 감지된 필드를 표시하거나 숨길 수 있습니다. 로그 줄을 확장한 다음, 눈 아이콘을 선택하여 필드를 표시하거나 숨깁니다.

 \$1\$1< docs-imagebox img="/img/docs/explore/parsed-fields-7-2.gif" max-width="800px" caption="Toggling detected fields in Explore" >\$1\$1 

## 추적 통합
<a name="tracing-integration"></a>

 탐색에서 추적 데이터 소스의 추적을 시각화할 수 있습니다. 현재 지원되는 데이터 소스: 
+ [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="explore-header"></a>

헤더에는 다음 항목이 포함되어 있습니다.
+  루트 범위의 이름과 추적 ID를 보여주는 헤더 제목 
+  검색된 텍스트가 포함된 범위를 강조 표시하는 검색 
+  추적에 대한 메타데이터 

### 미니맵
<a name="explore-minimap"></a>

 미니맵에서는 요약 보기 또는 추적 타임라인을 보여줍니다. 미니맵 위로 마우스를 끌어 더 작은 시간 범위로 확대합니다. 확대/축소는 기본 타임라인도 업데이트하므로 더 짧은 기간을 쉽게 볼 수 있습니다. 미니맵에서 일시 중지하면 확대/축소 시 **선택 재설정** 버튼(확대/축소 재설정)이 표시됩니다.

### 타임라인
<a name="explore-timeline"></a>

 타임라인에는 추적 내 범위 목록이 표시됩니다. 각 범위 행은 다음과 같은 구성 요소로 이루어집니다.
+ **하위 확장** 버튼: 선택한 범위의 모든 하위 범위 확장 또는 축소 
+ 서비스 이름: 범위를 로깅하는 서비스의 이름
+ 작업 이름: 이 범위가 나타내는 작업의 이름
+ 범위 기간 막대: 추적 내 작업 기간의 시각적 표시

범위 행에서 아무 곳이나 선택하면 범위 세부 정보가 표시됩니다.

### 범위 세부 정보
<a name="explore-span-details"></a>

범위 세부 정보에는 다음 항목이 포함됩니다.
+  작업 이름 
+  범위 메타데이터 
+  태그(이 범위와 연결된 모든 태그) 
+  프로세스 메타데이터(이 범위를 로깅하는 프로세스에 대한 메타데이터) 
+  로그: 이 범위 및 연결된 키 값으로 로깅된 로그 목록. Zipkin 로그의 경우 섹션에 Zipkin 주석이 표시됩니다.

## 탐색 및 대시보드 간 탐색
<a name="navigating-between-explore-and-a-dashboard"></a>

 탐색에서 대시보드로 또는 그 반대로 정기적으로 전환하는 워크플로를 가속화할 수 있도록 패널의 드롭다운에서 탐색으로 이동한 후 원본 대시보드로 돌아가는 기능을 추가했습니다.

 탐색으로 이동한 후에는 탐색 도구 모음에 '뒤로' 버튼이 표시됩니다.

 버튼을 선택하면 원본 대시보드로 돌아갑니다. 또는 탐색에서 변경한 내용을 대시보드에 반영하려는 경우 버튼 옆의 화살표를 선택하면 '변경 사항이 있는 패널로 돌아가기' 메뉴 항목이 표시됩니다.

## 쿼리 검사기
<a name="query-inspector"></a>

 쿼리 디버깅을 지원하기 위해 탐색에서는 쿼리 검사기를 통해 쿼리 요청 및 응답과 쿼리 통계를 조사할 수 있습니다. 이 기능은 패널 검사기 **통계** 탭 및 **쿼리** 탭과 유사합니다. 자세한 내용은 [쿼리 성능 검사](inspect-a-panel.md#inspect-query-performance) 및 [데이터 소스에 대한 원시 요청 및 응답 보기](inspect-a-panel.md#view-raw-request-and-response-to-data-source) 섹션을 참조하세요.

# Linking(연결 중)
<a name="linking-in-Amazon-Managed-Service-for-Grafana"></a>

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

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

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

## 사용해야 할 링크는 무엇인가요?
<a name="which-link-should-you-use"></a>

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

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

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

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

# 대시보드 링크
<a name="dashboard-links"></a>

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

 대시보드 링크를 생성할 때 시간 범위와 현재 템플릿 변수를 포함하여 다른 대시보드에서 동일한 컨텍스트로 직접 이동할 수 있습니다. 이렇게 하면 링크를 보내는 사람이 올바른 데이터를 볼 수 있습니다. 다른 유형의 링크에 대해서는 [데이터 링크 변수](linking-in-Amazon-Managed-Service-for-Grafana.md#data-link-variables) 섹션을 참조하세요.

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

## 대시보드에 링크 추가
<a name="add-links-to-dashboards"></a>

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

1.  링크를 추가하려는 대시보드를 보는 동안 화면 상단의 톱니 아이콘을 선택하여 **대시보드 설정**을 여세요.

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

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

1.  링크 옵션을 선택하세요.
   +  **태그 사용** - 입력한 태그가 있는 대시보드로만 연결된 대시보드를 제한하려면 태그를 입력합니다. 그렇지 않으면 Grafana 워크스페이스에는 다른 모든 대시보드에 대한 링크가 포함됩니다.
   +  **드롭다운으로** - 여러 대시보드에 연결하는 경우 이 옵션을 선택하고 드롭다운 목록에 선택적 제목을 추가합니다. 이 옵션을 선택하지 않으면 Grafana 워크스페이스에서 대시보드 링크가 대시보드 상단과 나란히 표시됩니다.
   +  **시간 범위** - 링크에 대시보드 시간 범위를 포함하려면 이 옵션을 선택합니다. 사용자가 링크를 선택하면 표시된 시간 범위가 이미 설정된 상태로 연결된 대시보드가 열립니다.
   +  **변수 값** - 현재 쿼리 파라미터로 사용되는 템플릿 변수를 링크에 포함하려면 이 옵션을 선택합니다. 사용자가 링크를 선택하면 연결된 대시보드에서 일치하는 모든 템플릿이 링크의 값으로 설정됩니다.
   +  **새 탭에서 열기** - 새 탭 또는 창에서 대시보드 링크를 열려면 이 옵션을 선택합니다.

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

## 대시보드에 URL 링크 추가
<a name="add-a-url-link-to-a-dashboard"></a>

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

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

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

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

1.  링크 옵션을 선택하세요.
   +  **URL** - 연결할 URL을 입력합니다. 대상에 따라 필드 값을 포함할 수 있습니다.
   +  **제목** - 링크를 표시할 제목을 입력합니다.
   +  **툴팁** - 사용자가 일시 중지할 때 링크를 표시할 툴팁을 입력합니다.
   +  **아이콘** - 링크와 함께 표시할 아이콘을 선택합니다.
   +  **시간 범위** - 링크에 대시보드 시간 범위를 포함하려면 이 옵션을 선택합니다. 사용자가 링크를 선택하면 표시된 시간 범위가 이미 설정된 상태로 연결된 대시보드가 열립니다.
     +  `from`에서는 시간 범위의 하한(밀리초 에포크로 지정됨)을 정의합니다.
     +  `to`에서는 시간 범위의 상한(밀리초 에포크로 지정됨)을 정의합니다.
     +  `time` 및 `time.window`는 `time-time.window/2`\$1`time+time.window/2`의 시간 범위를 정의합니다. 두 파라미터 모두 밀리초 단위로 지정해야 합니다. 예를 들어 `?time=1500000000000&time.window=10000`은 1,499,999,995,000\$11,500,000,005,000 범위의 10초를 지정합니다.
   +  **변수 값** - 현재 쿼리 파라미터로 사용되는 템플릿 변수를 링크에 포함하려면 이 옵션을 선택합니다. 사용자가 링크를 선택하면 링크된 대시보드의 일치하는 템플릿이 링크의 값으로 설정됩니다(예: https://play.grafana.org/d/000000074/alerting?var-app=backend&var-server=backend\$101&var-server=backend\$103&var-interval=1h).
   +  **새 탭에서 열기** - 새 탭 또는 창에서 대시보드 링크를 열려면 이 옵션을 선택합니다.

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

## 대시보드 링크 업데이트
<a name="update-a-dashboard-link"></a>

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

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

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

## 대시보드 링크 복제
<a name="duplicate-a-dashboard-link"></a>

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

## 대시보드 링크 삭제
<a name="delete-a-dashboard-link"></a>

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

# 패널 링크
<a name="panel-links"></a>

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

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

패널 왼쪽 상단에 있는 아이콘을 선택하여 사용 가능한 패널 링크를 확인하세요.

## 패널 링크 추가
<a name="add-a-panel-link"></a>

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

1.  **패널** 탭에서 아래로 스크롤하여 **링크** 섹션으로 이동하세요.

1.  **링크**를 확장한 다음, **링크 추가**를 선택하세요.

1.  링크의 **제목**을 입력하세요. 제목이 UI에 표시됩니다.

1.  연결할 **URL**을 입력합니다. 대시보드에 정의된 템플릿 변수 중 하나를 포함할 수 있습니다. **Ctrl\$1Space** 또는 **Cmd\$1Space**를 누른 다음, **URL** 필드를 선택하여 사용 가능한 변수를 확인하세요. 패널 링크에 템플릿 변수를 추가하면 링크는 관련 변수가 이미 설정된 올바른 컨텍스트로 사용자를 보냅니다. 시간 변수를 사용할 수도 있습니다.
   +  `from`에서는 시간 범위의 하한(밀리초 에포크로 지정됨)을 정의합니다.
   +  `to`에서는 시간 범위의 상한(밀리초 에포크로 지정됨)을 정의합니다.
   +  `time` 및 `time.window`는 `time-time.window/2`\$1`time+time.window/2`의 시간 범위를 정의합니다. 두 파라미터 모두 밀리초 단위로 지정해야 합니다. 예를 들어 `?time=1500000000000&time.window=10000`은 1,499,999,995,000\$11,500,000,005,000 범위의 10초를 지정합니다.

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

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

1.  오른쪽 상단에서 **저장**을 선택하여 대시보드에 대한 변경 사항을 저장합니다.

## 패널 링크 업데이트
<a name="update-a-panel-link"></a>

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

1.  **편집**(연필) 아이콘을 선택하여 **링크 편집** 창을 여세요.

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

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

1.  오른쪽 상단에서 **저장**을 선택하여 대시보드에 대한 변경 사항을 저장합니다.

## 패널 링크 삭제
<a name="delete-a-panel-link"></a>

1.  **패널** 탭에서 삭제할 링크를 찾으세요.

1.  삭제할 키 옆의 **X** 아이콘을 선택하세요.

1.  오른쪽 상단에서 **저장**을 선택하여 대시보드에 대한 변경 사항을 저장합니다.

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

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

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

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

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

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

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

## 데이터 링크 추가
<a name="add-a-data-link"></a>

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

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

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

1.  링크의 **제목**을 입력하세요. 제목이 UI에 표시됩니다.

1.  연결할 **URL**을 입력합니다.

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

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

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

1.  오른쪽 상단에서 **저장**을 선택하여 대시보드에 대한 변경 사항을 저장합니다.

## 데이터 링크 업데이트
<a name="update-a-data-link"></a>

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

1.  **편집**(연필) 아이콘을 선택하여 **링크 편집** 창을 여세요.

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

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

1.  오른쪽 상단에서 **저장**을 선택하여 대시보드에 대한 변경 사항을 저장합니다.

## 데이터 링크 삭제
<a name="delete-a-data-link"></a>

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

1.  삭제할 키 옆의 **X** 아이콘을 선택하세요.

1.  오른쪽 상단에서 **저장**을 선택하여 대시보드에 대한 변경 사항을 저장합니다.

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

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

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

 데이터 링크 URL에서 템플릿 변수를 사용할 수도 있습니다. 자세한 내용은 [템플릿 및 변수](templates-and-variables.md) 단원을 참조하십시오.

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

 다음 변수를 사용하여 데이터 링크 URL에 현재 시간 범위를 포함할 수 있습니다.
+  `__url_time_range` - 현재 대시보드의 시간 범위(예: `?from=now-6h&to=now`) 
+  `$__from and $__to` - 자세한 내용은 [전역 변수](\$1\$1< relref "../variables/variable-types/global-variables.md\$1\$1\$1from-and-\$1\$1to" >\$1\$1)를 참조하세요.

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

 시리즈별 변수는 `__series` 네임스페이스에서 사용할 수 있습니다.
+  `__series.name` - URL에 시리즈 이름을 추가합니다.
+  `__series.labels.<LABEL>` - URL에 레이블의 값을 추가합니다. 레이블에 점이 포함된 경우 `__series.labels["<LABEL>"]` 구문을 사용하세요.

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

 필드별 변수는 `__field` 네임스페이스에서 사용할 수 있습니다.
+  `__field.name` - 필드의 이름 

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

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

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

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

 `var-myvar=${myvar}`을 사용합니다. 여기서 `myvar`은 사용하려는 현재 대시보드의 템플릿 변수와 일치하는 템플릿 변수의 이름입니다.

 현재 대시보드의 모든 변수를 URL에 추가하려면 `__all_variables`를 사용합니다.

# 템플릿 및 변수
<a name="templates-and-variables"></a>

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

변수는 값의 자리표시자입니다. 지표 쿼리 및 패널 제목에서 변수를 사용할 수 있습니다. 변수를 사용하면 보다 동적이고 대화형 기능이 강화된 대시보드를 생성할 수 있습니다. 지표 쿼리에서 서버, 애플리케이션 및 센서 이름과 같은 사물을 하드 코딩하는 대신 해당 위치에서 변수를 사용할 수 있습니다.

변수는 대시보드 상단에 드롭다운 목록으로 표시됩니다. 대시보드 상단의 드롭다운 목록을 사용하여 값을 변경하는 경우 패널의 지표 쿼리에 새 값이 반영됩니다.

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

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

지원되는 변수 유형 목록과 각 변수 유형 추가 지침은 [변수 유형](variables-types.md) 섹션을 참조하세요.

## 템플릿
<a name="templates"></a>

 *템플릿*은 변수를 포함하는 모든 쿼리입니다.

예를 들어 여러 서버를 모니터링하기 위해 대시보드를 관리하는 경우 각 서버에 대한 대시보드를 만들 수 있습니다. 또는 다음 예제와 같이 하나의 대시보드를 생성하고 템플릿 쿼리가 있는 패널을 사용할 수 있습니다.

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

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

## 변수 모범 사례
<a name="variable-best-practices"></a>

변수 드롭다운 목록은 **대시보드 설정**의 변수 목록에 나열된 순서대로 표시됩니다.

자주 변경하는 변수를 맨 위에 배치하면 해당 변수가 먼저 표시됩니다(대시보드에서 맨 왼쪽).

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

 패널 제목과 지표 쿼리는 두 가지 다른 구문을 사용하여 변수를 참조할 수 있습니다.
+  `$varname` 다음 예제와 같이 이 구문을 더 쉽게 읽을 수 있습니다. `apps.frontend.$server.requests.count`. 하지만 단어 중간에 변수를 사용할 수 없습니다.
+  `${var_name}` - 표현식 중간에 변수를 보간하려는 경우 이 구문을 사용합니다.
+  `${var_name:<format>}` - 이 형식을 사용하면 Grafana에서 값을 보간하는 방법을 더 잘 제어할 수 있습니다. 자세한 내용은 [고급 변수 형식 옵션](#advanced-variable-format-options) 단원을 참조하십시오.

 쿼리가 데이터 소스로 전송되기 전에 쿼리가 *보간*됩니다. 즉, 변수가 현재 값으로 대체됩니다. 보간 중에 쿼리 언어의 구문과 사용되는 위치를 준수하기 위해 변수 값이 *이스케이프 처리*될 수 있습니다. 예를 들어 Prometheus 쿼리의 정규식에 사용되는 변수는 정규식으로 이스케이프 처리됩니다. 보간 중 값 이스케이프 처리에 대한 자세한 내용은 데이터 소스별 설명서 주제를 참조하세요.

 데이터 소스 기본 형식을 재정의하는 고급 구문에 대한 자세한 내용은 [고급 변수 형식 옵션](#advanced-variable-format-options) 섹션을 참조하세요.

# 변수 유형
<a name="variables-types"></a>

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

 Grafana에서는 여러 유형의 변수를 사용합니다.


|  변수 유형  |  설명  | 
| --- | --- | 
|  Query  |  지표 이름, 서버 이름, 센서 ID, 데이터 센터 등과 같은 쿼리 생성 값 목록. 자세한 내용은 [쿼리 변수 추가](#add-a-query-variable) 단원을 참조하십시오. | 
|  사용자 지정  |  쉼표로 구분된 목록을 사용하여 변수 옵션을 수동으로 정의합니다. 자세한 내용은 [사용자 지정 변수 추가](#add-a-custom-variable) 단원을 참조하십시오. | 
|  텍스트 상자  |  선택적 기본값이 있는 텍스트 입력 필드를 표시합니다. 자세한 내용은 [텍스트 상자 변수 추가](#add-a-text-box-variable) 단원을 참조하십시오. | 
|  상수  |  숨겨진 상수를 정의합니다. 자세한 내용은 [상수 변수 추가](#add-a-constant-variable) 단원을 참조하십시오. | 
|  데이터 소스  |  전체 대시보드의 데이터 소스를 빠르게 변경합니다. 자세한 내용은 [데이터 소스 변수 추가](#add-a-data-source-variable) 단원을 참조하십시오. | 
|  간격  |  간격 변수는 시간 범위를 나타냅니다. 자세한 내용은 [간격 변수 추가](#add-an-interval-variable) 단원을 참조하십시오. | 
|  임시 필터  |  데이터 소스의 모든 지표 쿼리에 자동으로 추가되는 키-값 필터(InfluxDB, Prometheus 및 OpenSearch만 해당). 자세한 내용은 [임시 필터 추가](#add-ad-hoc-filters) 단원을 참조하십시오. | 
|  전역 변수  |  쿼리 편집기의 표현식에 사용할 수 있는 기본 제공 변수. 자세한 내용은 [전역 변수](#global-variables) 단원을 참조하십시오. | 
|  체인 변수  |  변수 쿼리는 다른 변수를 포함할 수 있습니다. 자세한 내용은 [체인 변수](#chained-variables) 단원을 참조하십시오. | 

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

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

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

### 쿼리 표현식
<a name="query-expressions"></a>

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

### 일반 옵션 입력
<a name="enter-general-options"></a>

**쿼리 변수에 대한 일반 옵션을 입력하는 방법**

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

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

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

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

1. (선택 사항) **레이블**에서 변수 드롭다운 목록의 표시 이름을 입력하세요. 표시 이름을 입력하지 않으면 드롭다운 레이블이 변수 이름이 됩니다.

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

### 쿼리 옵션 입력
<a name="enter-query-options"></a>

**쿼리 변수에 대한 쿼리 옵션을 입력하는 방법**

1. **데이터 소스** 목록에서 쿼리의 대상 데이터 소스를 선택하세요. 데이터 소스에 대한 자세한 내용은 [데이터 원본에 연결](AMG-data-sources.md) 섹션을 참조하세요.

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

1.  **쿼리** 필드에 쿼리를 입력하세요.
   +  쿼리 필드는 데이터 소스에 따라 다릅니다. 일부 데이터 소스에는 사용자 지정 쿼리 편집기가 있습니다.
   + 단일 입력 필드 쿼리 편집기에 더 많은 공간이 필요한 경우 필드의 오른쪽 하단에 있는 선에서 일시 중지하고 아래로 끌어 확장하세요.

1. (선택 사항) **정규식** 필드에 정규식을 입력하여 데이터 소스 쿼리에서 반환된 이름의 특정 부분을 필터링하거나 캡처하세요. 예시는 [정규식으로 변수 필터링](templates-and-variables.md#filter-variables-with-regex) 섹션을 참조하세요.

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

1. (선택 사항) **선택 옵션**을 입력하세요. 자세한 내용은 [변수 선택 옵션 입력](templates-and-variables.md#enter-variable-selection-options) 단원을 참조하십시오.

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

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

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

 변경되지 않는 값에 대해 *사용자 지정* 변수를 사용합니다. 숫자, 문자열 또는 기타 변수일 수 있습니다.

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

### 일반 옵션 입력
<a name="variables-enter-general-options"></a>

**사용자 지정 변수에 대한 쿼리 옵션을 입력하는 방법**

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

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

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

1.  **유형** 목록에서 **사용자 지정**을 선택하세요.

1. (선택 사항) **레이블**에서 변수 드롭다운 목록의 표시 이름을 입력하세요. 표시 이름을 입력하지 않으면 드롭다운 레이블이 변수 이름이 됩니다.

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

### 사용자 지정 옵션 입력
<a name="enter-custom-options"></a>

**사용자 지정 변수에 대한 사용자 지정 옵션을 입력하는 방법**

1. **쉼표로 구분된 값** 목록에서 쉼표로 구분된 목록에 이 변수의 값을 입력하세요. 숫자, 문자열, 기타 변수 또는 콜론으로 구분된 키-값 페어를 포함할 수 있습니다.

1.  (선택 사항) **선택 옵션**을 입력하세요. 자세한 내용은 [변수 선택 옵션 입력](templates-and-variables.md#enter-variable-selection-options) 단원을 참조하십시오.

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

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

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

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

### 일반 옵션 입력
<a name="text-box-enter-general-options"></a>

**텍스트 상자 변수에 대한 일반 옵션을 입력하는 방법**

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

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

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

1.  **유형** 목록에서 **텍스트 상자**를 선택하세요.

1. (선택 사항) **레이블**에서 변수 드롭다운 목록의 표시 이름을 입력하세요. 표시 이름을 입력하지 않으면 드롭다운 레이블이 변수 이름이 됩니다.

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

### 텍스트 옵션 입력
<a name="enter-text-options"></a>

**텍스트 상자 변수에 텍스트 옵션을 입력하는 방법**

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

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

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

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

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

상수 변수는 유연하지 않습니다. 각 상수 변수에는 값이 하나만 있습니다. 업데이트하려면 변수 설정을 업데이트해야 합니다.

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

### 일반 옵션 입력
<a name="constant-variable-enter-general-options"></a>

**상수 변수에 대한 일반 옵션을 입력하는 방법**

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

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

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

1.  **유형** 목록에서 **상수**를 선택하세요.

1. (선택 사항) **레이블**에서 변수 드롭다운 목록의 표시 이름을 입력하세요. 표시 이름을 입력하지 않으면 드롭다운 레이블이 변수 이름이 됩니다.

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

### 상수 옵션 입력
<a name="enter-constant-options"></a>

**상수 변수에 대한 상수 옵션을 입력하는 방법**

1. **값** 필드에 변수 값을 입력하세요. 문자, 숫자 및 기호를 입력할 수 있습니다. 고급 변수 형식 옵션을 사용하는 경우 와일드카드를 사용할 수도 있습니다. 자세한 내용은 [고급 변수 형식 옵션](templates-and-variables.md#advanced-variable-format-options) 단원을 참조하십시오.

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

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

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

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

### 일반 옵션 입력
<a name="data-source-enter-general-options"></a>

**데이터 소스 변수에 대한 일반 옵션을 입력하는 방법**

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

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

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

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

1. (선택 사항) **레이블**에서 변수 드롭다운 목록의 표시 이름을 입력하세요. 표시 이름을 입력하지 않으면 드롭다운 레이블이 변수 이름이 됩니다.

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

### 데이터 소스 옵션 입력
<a name="enter-data-source-options"></a>

**데이터 소스 변수에 대한 데이터 소스 옵션을 입력하는 방법**

1.  **유형** 목록에서 변수의 대상 데이터 소스를 선택하세요. 데이터 소스에 대한 자세한 내용은 [데이터 원본에 연결](AMG-data-sources.md) 섹션을 참조하세요.

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

1.  (선택 사항) **선택 옵션**을 입력하세요. 자세한 내용은 [변수 선택 옵션 입력](templates-and-variables.md#enter-variable-selection-options) 단원을 참조하십시오.

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

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

## 간격 변수 추가
<a name="add-an-interval-variable"></a>

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

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

### 일반 옵션 입력
<a name="interval-variable-enter-general-options"></a>

**간격 변수에 대한 일반 옵션을 입력하는 방법**

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

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

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

1.  **유형** 목록에서 **간격**을 선택하세요.

1. (선택 사항) **레이블**에서 변수 드롭다운 목록의 표시 이름을 입력하세요. 표시 이름을 입력하지 않으면 드롭다운 레이블이 변수 이름이 됩니다.

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

### 간격 옵션 입력
<a name="enter-interval-options"></a>

**간격 변수에 간격 옵션을 입력하는 방법**

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개의 2분 증분 단위로 그룹화합니다.

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

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

### 간격 변수 예제
<a name="interval-variable-examples"></a>

 Graphite 함수에서 템플릿 변수 `myinterval`을 사용하는 예제: 

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

 보다 복잡한 Graphite 예제: 

```
groupByNode(summarize(movingAverage(apps.$app.$server.counters.requests.count, 5), '$interval', 'sum', false), 2, 'sum')
```

## 임시 필터 추가
<a name="add-ad-hoc-filters"></a>

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

**참고**  
**참고:** 일회성 또는 임시 필터 변수는 InfluxDB, Prometheus 및 OpenSearch 데이터 소스에서만 작동합니다.

### 일반 옵션 입력
<a name="ad-hoc-filters-enter-general-options"></a>

**임시 필터의 일반 옵션을 입력하는 방법**

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

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

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

1.  **유형** 목록에서 **임시 필터**를 선택하세요.

1. (선택 사항) **레이블**에서 변수 드롭다운 목록의 표시 이름을 입력하세요. 표시 이름을 입력하지 않으면 드롭다운 레이블이 변수 이름이 됩니다.

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

### 옵션 입력
<a name="ad-hoc-enter-options"></a>

**임시 필터에 대한 옵션을 입력하는 방법**

1.  **데이터 소스** 목록에서 대상 데이터 소스를 선택합니다. 데이터 소스에 대한 자세한 내용은 [데이터 원본에 연결](AMG-data-sources.md) 섹션을 참조하세요.

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

### 임시 필터 생성
<a name="create-ad-hoc-filters"></a>

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

## 체인 변수
<a name="chained-variables"></a>

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

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

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

### 모범 사례 및 팁
<a name="variables-best-practices-and-tips"></a>

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

#### 새 체인 변수 생성
<a name="creating-new-linked-variables"></a>
+  변수를 체인화하면 상위-하위 종속 항목이 생성됩니다. 사다리나 트리로 구상할 수 있습니다.
+ 새 체인 변수를 생성하는 가장 빠른 방법은 새 변수를 기반으로 할 변수를 복사하는 것입니다. 변수 목록에서 변수 항목 오른쪽에 있는 변수 **복제** 아이콘을 선택하여 사본을 생성합니다. 그런 다음, 상위 변수에 대한 쿼리에 추가할 수 있습니다.
+ 이렇게 생성된 새 체인 변수는 목록 하단에 표시됩니다. 목록에 논리적 순서를 적용하려면 변수를 목록의 다른 위치로 끕니다.

#### 변수 순서
<a name="variable-order"></a>

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

#### 복잡성 고려 사항
<a name="complexity-consideration"></a>

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

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

## 전역 변수
<a name="global-variables"></a>

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

### \$1\$1\$1dashboard
<a name="global-variable-dashboard"></a>

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

### \$1\$1\$1from 및 \$1\$1\$1to
<a name="global-variable-from-and-__to"></a>

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


|  구문  |  결과 예제  |  설명  | 
| --- | --- | --- | 
|  \$1\$1\$1\$1from\$1  |  1594671549254  |  Unix 밀리초 에포크  | 
|  \$1\$1\$1\$1from:date\$1  |  2020-07-13T20:19:09.254Z  |  인수 없음, 기본값: ISO 8601/RFC 3339  | 
|  \$1\$1\$1\$1from:date:iso\$1  |  2020-07-13T20:19:09.254Z  |  ISO 8601/RFC 3339  | 
|  \$1\$1\$1\$1from:date:seconds\$1  |  1594671549  |  Unix 초 에포크  | 
|  \$1\$1\$1\$1from:date:YYYY-MM\$1  |  2020-07  |  사용자 지정 데이터 형식. 자세한 내용은 [표시](https://momentjs.com/docs/#/displaying/)를 참조하세요. | 

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

URL에서도 이 변수를 사용할 수 있습니다. 예를 들어 최종 사용자를 6시간 전부터 현재까지의 시간 범위를 보여주는 대시보드로 보내려면 다음 URL을 사용합니다. https://play.grafana.org/d/000000012/grafana-play-home?viewPanel=2&orgId=1?from=now-6h&to=now 

### \$1\$1\$1interval
<a name="global-variable-interval"></a>

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

Grafana는 쿼리에서 시간별로 그룹화하는 데 사용할 수 있는 간격을 자동으로 계산합니다. 그래프에 표시할 수 있는 것보다 많은 데이터 포인트가 있는 경우 더 큰 간격으로 그룹화하여 쿼리의 효율성을 개선할 수 있습니다. 예를 들어 3개월 데이터를 볼 때 10초보다 1일 단위로 그룹화하는 것이 더 효율적입니다. 그래프는 동일하게 보이며 쿼리 속도는 더 빨라집니다. `$__interval`은 그래프의 시간 범위와 너비(픽셀 수)를 사용하여 계산됩니다.

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

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

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

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

### \$1\$1\$1interval\$1ms
<a name="global-variable-interval_ms"></a>

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

### \$1\$1\$1name
<a name="global-variable-name"></a>

 이 변수는 단일 통계 패널에서만 사용할 수 있으며 **옵션** 탭의 접두사 또는 접미사 필드에서 사용할 수 있습니다. 변수가 시리즈 이름 또는 별칭으로 대체됩니다.

### \$1\$1\$1org
<a name="global-variable-org"></a>

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

### \$1\$1\$1user
<a name="global-variable-user"></a>

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

### \$1\$1\$1range
<a name="global-variable-range"></a>

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

### \$1timeFilter 또는 \$1\$1\$1timeFilter
<a name="global-variable-timefilter-or-__timefilter"></a>

`$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="other-variable-options"></a>

이 섹션에서는 사용 가능한 다른 변수 옵션을 설명합니다.

### 변수 선택 옵션 입력
<a name="enter-variable-selection-options"></a>

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

#### 다중 값
<a name="multi-value"></a>

이 옵션을 켜면 변수 드롭다운 목록에서 여러 옵션의 동시 선택을 지원합니다. 자세한 내용은 [다중 값 변수 형식 지정](#formatting-multi-value-variables) 단원을 참조하십시오.

#### 모두 포함 옵션
<a name="include-all-option"></a>

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

#### 모든 사용자 지정 값
<a name="custom-all-value"></a>

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

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

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

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

### 고급 변수 형식 옵션
<a name="advanced-variable-format-options"></a>

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

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

#### 일반 구문
<a name="general-syntax"></a>

 구문: `${var_name:option}` 

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

#### CSV
<a name="variables-csv"></a>

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

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

#### 분산 - OpenTSDB
<a name="distributed---opentsdb"></a>

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

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

#### 큰따옴표
<a name="doublequote"></a>

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

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

#### Glob - Graphite
<a name="glob---graphite"></a>

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

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

#### JSON
<a name="json"></a>

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

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

#### Lucene - OpenSearch
<a name="lucene---opensearch"></a>

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

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

#### Percentencode
<a name="percentencode"></a>

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

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

#### 파이프
<a name="pipe"></a>

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

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

#### 원시
<a name="raw"></a>

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

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

#### Regex
<a name="regex"></a>

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

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

#### Singlequote
<a name="singlequote"></a>

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

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

#### Sqlstring
<a name="sqlstring"></a>

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

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

#### 텍스트
<a name="text"></a>

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

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

### 다중 값 변수 형식 지정
<a name="formatting-multi-value-variables"></a>

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

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

#### Graphite 데이터 소스에서 다중 값 변수
<a name="multi-value-variables-with-a-graphite-data-source"></a>

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

#### Prometheus 또는 InfluxDB 데이터 소스에서 다중 값 변수
<a name="multi-value-variables-with-a-prometheus-or-influxdb-data-source"></a>

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

#### 탄력적 데이터 소스에서 다중 값 변수
<a name="multi-value-variables-with-an-elastic-data-source"></a>

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

#### 형식 문제 해결
<a name="formatting-troubles"></a>

 자동 이스케이프 처리 및 서식 지정으로 문제가 생길 수 있습니다. 특히 InfluxDB 및 Prometheus에서 문제 이면의 논리를 파악하기란 쉽지 않습니다. 이 경우 정규식 구문을 사용하려면 정규식 연산자 컨텍스트에서 변수를 사용해야 하기 때문입니다.

 Grafana가 이 자동 정규식 이스케이프 처리 및 서식 지정을 수행하지 않도록 하려면 다음 중 하나를 수행해야 합니다.
+ **다중 값**, **모두 포함 옵션** 옵션을 끕니다.
+ [원시 변수 형식](\$1\$1< relref "advanced-variable-format-options.md\$1raw" >\$1\$1)을 사용합니다.

### 정규식으로 변수 필터링
<a name="filter-variables-with-regex"></a>

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

이 섹션에서는 정규식을 사용하여 변수 드롭다운 목록에서 값을 필터링하고 수정하는 방법을 보여줍니다.

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

 다음 옵션 목록에 대한 필터링 예제: 

```
backend_01
backend_02
backend_03
backend_04
```

#### `01` 또는 `02`로 끝나는 옵션만 반환되도록 필터링
<a name="filter-so-that-only-the-options-that-end-with-01-or-02-are-returned"></a>

 정규식: 

```
/.*[01|02]/
```

 결과: 

```
backend_01
backend_02
```

#### 정규식 캡처 그룹을 사용하여 텍스트의 일부를 반환하도록 옵션 필터링 및 수정
<a name="filter-and-modify-the-options-using-a-regex-capture-group-to-return-part-of-the-text"></a>

 정규식: 

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

 결과: 

```
01
02
```

#### 필터링 및 수정 - Prometheus 예제
<a name="filter-and-modify---prometheus-example"></a>

 옵션 목록: 

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

#### 이름 지정된 텍스트 및 값 캡처 그룹을 사용하여 필터링 및 수정
<a name="filter-and-modify-using-named-text-and-value-capture-groups"></a>

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

 예를 들어 `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="repeat-panels-or-rows"></a>

 *템플릿 변수*를 사용하여 동적 대시보드를 생성할 수 있습니다. 쿼리의 모든 변수는 쿼리가 데이터베이스로 전송되기 전에 변수의 현재 값으로 확장됩니다. 변수를 사용하면 모든 서비스에 단일 대시보드를 재사용할 수 있습니다.

 템플릿 변수는 전체 대시보드에서 쿼리를 동적으로 변경하는 데 매우 유용할 수 있습니다. Grafana에서 선택한 값을 기반으로 새 패널 또는 행을 동적으로 생성하도록 하려면 *반복* 기능을 사용할 수 있습니다.

#### 패널 반복
<a name="repeating-panels"></a>

 `Multi-value` 또는 `Include all value` 옵션이 켜져 있는 변수가 있는 경우 패널 하나를 선택하고 Grafana에서 선택한 모든 값에 대해 해당 패널을 반복하도록 할 수 있습니다. 패널 편집 모드의 *일반 탭*에서 *반복* 기능을 찾을 수 있습니다.

 `direction`에서는 패널 배열 방법을 제어합니다.

`horizontal`을 선택하면 패널이 나란히 배열됩니다. Grafana는 각 반복 패널의 너비를 자동으로 조정하여 전체 행을 채웁니다. 현재 행의 다른 패널을 반복 패널과 혼합할 수 없습니다.

 `Max per row`를 설정하여 Grafana에 행당 원하는 최대 패널 수를 알려줍니다. 기본값은 *4*입니다.

`vertical`을 선택하면 패널이 열에서 배열(위에서 아래 방향)됩니다. 반복되는 패널의 너비는 반복되는 첫 번째 패널(원본 템플릿)과 동일합니다.

첫 번째 패널(원본 템플릿)만 변경합니다. 변경 사항이 모든 패널에 적용되려면 동적 대시보드를 다시 빌드하도록 시작해야 합니다. 변수 값(즉, 반복의 기준)을 변경하거나 대시보드를 다시 로드하여 이 작업을 수행할 수 있습니다.

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

#### 행 반복
<a name="repeating-rows"></a>

 위에서 볼 수 있듯이 패널에서 `Multi-value` 또는 `Include all value` 선택 옵션으로 변수가 설정된 경우에도 행을 반복할 수 있습니다.

 이 기능을 켜려면 먼저 *패널 추가* 메뉴를 사용하여 새 *행*을 추가해야 합니다. 그런 다음, 행 제목에서 일시 중지하고 톱니 버튼을 선택하여 `Row Options` 구성 패널에 액세스합니다. 그런 다음, 행을 반복할 변수를 선택할 수 있습니다.

 모범 사례는 행 제목에도 변수를 사용하는 것입니다.

# Grafana 알림
<a name="alerts-overview"></a>

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

Grafana 알림은 시스템 문제가 발생한 후 바로 문제를 파악하여 서비스 중단을 최소화하는 데 도움이 되는 강력하고 실행 가능한 알림을 제공합니다.

Amazon Managed Grafana에는 검색 가능한 단일 보기에서 알림 정보를 중앙 집중화하는 업데이트된 알림 시스템인 *Grafana 알림*에 대한 액세스가 포함되어 있습니다. 다음 기능이 포함되어 있습니다.
+ 중앙 집중식 보기에서 Grafana 알림을 생성하고 관리합니다.
+ 단일 인터페이스를 통해 Cortex 및 Loki 관리형 알림을 생성하고 관리합니다. 자세한 내용은 [알림 규칙 관리](v9-alerting-managerules.md) 단원을 참조하십시오.
+ Prometheus, Amazon Managed Service for Prometheus 및 기타 Alertmanager 호환 데이터 소스의 알림 정보를 확인합니다.
+ 단일 알림 규칙에서 여러 알림 인스턴스를 생성합니다. 자세한 내용은 [단일 및 다차원 규칙](v9-alerting-managerules-grafana.md#v9-alerting-single-multi-rule) 단원을 참조하십시오.
+ terraform 또는 프로비저닝 API를 사용하여 알림 리소스를 관리합니다. 자세한 내용은 [Grafana 알림 리소스 프로비저닝](v9-alerting-setup-provision.md) 단원을 참조하십시오.

기존 Amazon Managed Grafana 워크스페이스의 경우 기본값은 [클래식 대시보드 알림](old-alerts-overview.md)입니다. Grafana 알림으로 마이그레이션하려면 [Grafana 알림으로 마이그레이션](alert-opt-in.md)해야 합니다.

Grafana 알림에 대한 자세한 내용은 [Grafana 알림의 새로운 기능](alerts-whats-new.md) 섹션을 참조하세요.

Grafana 알림에는 네 가지 주요 구성 요소가 있습니다.
+ [알림 규칙](alert-rules.md) - 알림 시작 여부를 결정하는 평가 기준. 하나 이상의 쿼리와 표현식, 조건, 평가 빈도 및 조건이 충족되는 기간(선택 사항)으로 구성됩니다.
+ [연락 지점](alert-contact-points.md) - 알림 규칙 조건이 충족될 때 알림을 보내는 채널.
+ [알림 정책](alert-notifications.md) - 알림 빈도를 결정하는 데 사용되는 일치 및 그룹화 조건 세트.
+ [무음](alert-silences.md) - 알림을 무음 처리하는 데 사용되는 날짜 및 일치 조건.

Grafana 알림이 활성화된 경우 다음을 수행할 수 있습니다.
+ [Grafana 관리형 알림 규칙 생성](alert-rules.md#create-grafana-alert-rule)
+ [Cortex 또는 Loki 관리형 알림 규칙 생성](alert-rules.md#create-alert-rule)
+ [기존 알림 규칙 보기 및 현재 상태 관리](alert-rules.md#manage-alert-rules)
+ [알림 규칙의 상태 조건 및 상태 보기](alert-fundamentals.md#alerts-state)
+ [알림 연락 지점 추가 또는 편집](alert-contact-points.md#alert-working-contact-points)
+ [알림 정책 추가 또는 편집](alert-notifications.md#alert-notifications-working)
+ [무음 추가 또는 편집](alert-silences.md)

## 제한 사항
<a name="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**
+ [제한 사항](#alert-limitations)
+ [Grafana 알림의 새로운 기능](alerts-whats-new.md)
+ [Grafana 알림으로 클래식 대시보드 알림 마이그레이션](alert-opt-in.md)
+ [알림 기본 정보](alert-fundamentals.md)
+ [Grafana 알림 규칙 생성 및 관리](alert-rules.md)
+ [알림 그룹](alert-groups.md)
+ [Prometheus 데이터 소스에 대한 알림 전달 무음 처리](alert-silences.md)
+ [연락 지점 작업](alert-contact-points.md)
+ [메시징 템플릿 사용](alert-message-templates.md)
+ [알림 정책 작업](alert-notifications.md)

# Grafana 알림의 새로운 기능
<a name="alerts-whats-new"></a>

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

Grafana 알림에는 클래식 대시보드 알림에 대한 몇 가지 개선 사항이 있습니다.

## 다차원 알림 생성
<a name="alerts-new-dimensional"></a>

이제 시스템 전반의 가시성을 제공하는 단일 알림 규칙을 생성하여 단일 알림 규칙에서 여러 알림 인스턴스를 생성할 수 있습니다. 예를 들어 단일 호스트에서 여러 탐재 지점의 디스크 사용량을 모니터링하는 규칙을 생성할 수 있습니다. 평가 엔진은 단일 쿼리에서 여러 시계열을 반환하며 각 시계열은 레이블 세트로 식별됩니다.

**참고**  
각 알림 인스턴스는 알림 할당량에 포함됩니다. 알림 할당량 내에서 수용할 수 있는 것보다 많은 인스턴스를 생성하는 다차원 규칙은 평가되지 않으며 할당량 오류를 반환합니다. 자세한 내용은 [할당량에 도달함 오류](alert-rules.md#rule-quota-reached) 단원을 참조하십시오.

## 대시보드 외부에서 알림 생성
<a name="alerts-new-not-dashboard"></a>

클래식 대시보드 알림과 달리 Grafana 알림을 사용하면 여러 소스의 데이터를 고유한 방식으로 결합하는 쿼리와 표현식을 생성할 수 있습니다. ID를 사용하여 대시보드와 패널을 알림 규칙에 연결하고 관찰 중인 시스템의 문제를 신속하게 해결할 수 있습니다.

통합 알림은 더 이상 패널 쿼리에 직접 연결되지 않으므로 알림 이메일에 이미지 또는 쿼리 값을 포함하지 않습니다. 사용자 지정 알림 템플릿을 사용하여 쿼리 값을 볼 수 있습니다.

## Loki 및 Cortex 알림 규칙 생성
<a name="alerts-new-loki-cortex"></a>

Grafana 알림에서 Grafana 관리형 알림과 동일한 UI 및 API를 사용하여 Loki 및 Cortex 알림 규칙을 관리할 수 있습니다.

## Amazon Managed Service for Prometheus 및 기타 Prometheus 호환 데이터 소스에서 알림 보기 및 검색
<a name="alerts-new-prometheus"></a>

이제 Amazon Managed Service for Prometheus 및 Prometheus 호환 데이터 소스에 대한 알림이 알림 인터페이스에 나열됩니다. 여러 데이터 소스에서 레이블을 검색하여 관련 알림을 빠르게 찾을 수 있습니다.

## 알림 상태 NoData 및 Error에 대한 특별 알림
<a name="alerts-new-error"></a>

Grafana 알림은 알림 규칙 평가에서 `NoData` 또는 `Error` 상태를 생성할 때 다음 레이블을 포함하는 특수 알림을 생성합니다.
+ 상태에 따라 값이 `DatasourceNoData` 또는 `DatasourceError`인 `alertname`.
+ 특수 알림이 속한 알림 규칙의 이름을 포함하는 `rulename`.
+ `datasource_uid`에는 상태의 원인이 되는 데이터 소스의 UID가 있습니다.
+ 원본 규칙의 모든 레이블 및 주석.

예를 들어 무음을 추가하거나 연락 지점으로 라우팅하여 이러한 알림을 일반 알림과 동일하게 처리할 수 있습니다.

**참고**  
규칙이 여러 데이터 소스를 사용하고 하나 이상에서 데이터를 반환하지 않는 경우, 알림 상태의 원인이 되는 각 데이터 소스에 대해 특수 알림이 생성됩니다.

# Grafana 알림으로 클래식 대시보드 알림 마이그레이션
<a name="alert-opt-in"></a>

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

기존 워크스페이스 또는 Grafana 알림을 사용하지 않도록 선택한 워크스페이스는 클래식 대시보드 알림을 사용합니다. 새 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="alert-opt-in-migrating"></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="alert-migration-limitations"></a>
+ Grafana 알림 시스템은 사용 가능한 모든 Prometheus, Loki 및 Alertmanager 데이터 소스에서 규칙을 검색할 수 있습니다. 지원되는 다른 데이터 소스에서 알림 규칙을 가져오지 못할 수 있습니다.
+ Grafana 알림과 클래식 대시보드 알림 사이에서 앞뒤로 마이그레이션하면 한 시스템에서 지원되는 기능에 대한 데이터가 손실될 수 있지만 다른 시스템에서는 손실되지 않을 수 있습니다.
**참고**  
클래식 대시보드 알림으로 다시 마이그레이션하면 생성된 새 알림 규칙을 포함하여 Grafana 알림이 활성화된 상태에서 수행된 구성 알림에 대한 모든 변경 사항이 사라집니다.

# 알림 기본 정보
<a name="alert-fundamentals"></a>

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

이 섹션에서는 Grafana 알림의 기본 개념에 대한 정보를 제공합니다.

## 알림 개념
<a name="alert-fundamentals-terms"></a>

다음 표에서는 Grafana 알림의 주요 개념을 설명합니다.


| 주요 개념 또는 특성 | 정의 | 
| --- | --- | 
|  알림에 대한 데이터 소스  |  지표, 로그 및 추적을 쿼리하고 시각화할 데이터 소스를 선택합니다.  | 
|  스케줄러  |  데이터 소스에 대해 쿼리를 주기적으로 실행하는 구성 요소인 알림 규칙을 평가합니다. Grafana 관리형 규칙에만 적용됩니다.  | 
|  Alertmanager  |  알림 인스턴스의 라우팅 및 그룹화를 관리합니다.  | 
|  알림 규칙  |  알림 규칙을 실행해야 하는 시점에 대한 평가 기준 세트. 알림 규칙은 하나 이상의 쿼리와 표현식, 조건, 평가 빈도 및 조건이 충족되는 기간으로 구성됩니다. 알림 규칙은 여러 개의 알림 인스턴스를 생성할 수 있습니다.  | 
|  알림 인스턴스  |  알림 인스턴스는 알림 규칙의 인스턴스입니다. 단일 차원 알림 규칙에는 하나의 알림 인스턴스가 있습니다. 다차원 알림 규칙에는 하나 이상의 알림 인스턴스가 있습니다. 10개 VM의 CPU와 같이 여러 결과와 일치하는 단일 알림 규칙은 여러 알림 인스턴스(이 경우 10개)로 계산됩니다. 이 숫자는 시간에 따라 달라질 수 있습니다. 예를 들어 시스템의 모든 VM에 대한 CPU 사용량을 모니터링하는 알림 규칙에는 VM 개수만큼 알림 인스턴스가 추가됩니다. 알림 인스턴스 할당량에 대한 자세한 내용은 [할당량에 도달함 오류](alert-rules.md#rule-quota-reached) 섹션을 참조하세요.  | 
|  알림 그룹  |  Alertmanager는 루트 알림 정책의 레이블을 사용하여 기본적으로 알림 인스턴스를 그룹화합니다. 이를 통해 연락 지점으로 전송되는 알림 인스턴스의 중복 제거 및 그룹을 제어합니다.  | 
|  연락 지점  |  알림 규칙이 실행될 때 연락처에 알림을 보내는 방법을 정의합니다.  | 
|  메시지 템플릿 지정  |  재사용 가능한 사용자 지정 템플릿을 생성하고 연락 지점에서 사용합니다.  | 
|  알림 정책  |  알림이 그룹화되고 연락 지점으로 라우팅되는 위치, 시간 및 방법에 대한 규칙 세트.  | 
|  레이블 및 레이블 매처  |  레이블을 통해 알림 규칙을 고유하게 식별합니다. 알림 규칙을 알림 정책 및 무음에 연결하여 어떤 정책이 이를 처리해야 하는지, 어떤 알림 규칙을 무음 처리해야 하는지 결정합니다.  | 
|  무음  |  하나 이상의 알림 인스턴스에서 알림을 중지합니다. 무음과 음소거 타이밍의 차이는 무음은 일정 기간 지속되지만, 음소거 타이밍은 반복 일정에서 수행된다는 점입니다. 레이블 매처를 사용하여 알림 인스턴스를 무음으로 설정합니다.  | 
|  음소거 타이밍  |  새 알림을 생성하거나 전송하지 않으려는 시간 간격을 지정합니다. 유지 관리 기간과 같이 반복 기간에 알림 전달을 동결할 수 있습니다. 기존 알림 정책에 연결되어야 합니다.  | 

## 알림 데이터 소스
<a name="alert-sources"></a>

Grafana 관리형 알림은 알림이 활성화된 다음 백엔드 데이터 소스를 쿼리합니다.
+ Grafana에서 기본 제공하거나 개발 및 유지 관리하는 데이터 소스: `Alertmanager`, `Graphite`, `Prometheus`(Amazon Managed Service for Prometheus 포함), `Loki`, `InfluxDB`, `Amazon OpenSearch Service`, `Google Cloud Monitoring`, `Amazon CloudWatch`, `Azure Monitor`, `MySQL`, `PostgreSQL`, `MSSQL`, `OpenTSDB`, `Oracle`, `Azure Monitor`.

## 숫자 데이터에 대한 알림
<a name="alert-numeric"></a>

시계열 형식이 아닌 숫자 데이터는 서버 측 표현식에서 직접 알리거나 서버 측 표현식으로 전달할 수 있습니다. 이렇게 하면 데이터 소스 내에서 처리와 결과 효율성을 개선할 수 있으며 알림 규칙을 단순화할 수도 있습니다. 시계열 데이터 대신 숫자 데이터에 대한 알림을 전달할 때 레이블이 지정된 각 시계열을 단일 숫자로 줄이지 않아도 됩니다. 대신 레이블이 지정된 번호가 대신 Grafana로 반환됩니다.

### 테이블 형식 데이터
<a name="alert-tabular-data"></a>

이 기능은 MySQL, Postgres, MSSQL 및 Oracle과 같은 SQL 데이터 소스를 포함하여 테이블 형식의 데이터를 쿼리하는 백엔드 데이터 소스에서 지원됩니다.

Grafana 관리형 알림 또는 서버 측 표현식을 사용하는 쿼리는 이러한 데이터 소스에서 숫자로 간주됩니다.
+ 데이터 소스 쿼리에서 `Format AS` 옵션이 `Table`로 설정된 경우.
+ 쿼리에서 Grafana로 반환된 테이블 응답에 숫자(예: int, double 또는 float) 열이 하나만 포함되고 선택적으로 추가 문자열 열이 포함되는 경우.

문자열 열이 있는 경우 해당 열은 레이블이 됩니다. 열 이름은 레이블 이름이 되고 각 행의 값은 해당 레이블의 값이 됩니다. 여러 행이 반환되는 경우 각 행은 레이블로 고유하게 식별되어야 합니다.

### 예제
<a name="alert-tabular-example"></a>

다음과 같이 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  |  정상  | 

## Alertmanager
<a name="alert-alertmanager"></a>

Grafana에는 Prometheus Alertmanager에 대한 기본 지원이 포함되어 있습니다. Alertmanager는 알림 규칙을 그룹화 및고 관리하는 데 도움이 되며 경보 엔진 위에 오케스트레이션 계층을 추가합니다. 기본적으로 Grafana 관리형 알림에 대한 알림은 코어 Grafana의 일부인 임베디드 Alertmanager에서 처리됩니다. Alertmanager 드롭다운에서 Grafana 옵션을 선택하여 Grafana 알림 UI에서 Alertmanager의 연락 지점, 알림 정책 및 템플릿을 구성할 수 있습니다.

Grafana 알림은 외부 Alertmanager 구성을 지원합니다(외부 데이터 소스로서 Alertmanager에 대한 자세한 내용은 [Alertmanager 데이터 소스에 연결](data-source-alertmanager.md) 참조). 외부 Alertmanager를 추가하면 Alertmanager 드롭다운에 사용 가능한 외부 Alertmanager 데이터 소스 목록이 표시됩니다. 독립 실행형 Cortex 또는 Loki 데이터 소스에 대한 알림을 생성 및 관리할 데이터 소스를 선택하세요.

## 알림 규칙의 상태 조건 및 상태
<a name="alerts-state"></a>

알림 규칙의 상태 조건 및 상태는 알림에 대한 몇 가지 주요 상태 표시기를 이해하는 데 도움이 됩니다. 알림 상태, 알림 규칙 상태 조건, 알림 규칙 상태와 같은 세 가지 주요 구성 요소가 있습니다. 서로 관련되었지만 각 구성 요소는 약간 다른 정보를 전달합니다.

**알림 규칙 상태 조건**
+ **Normal** - 평가 엔진에서 반환한 시계열 중 `Pending` 또는 `Firing` 상태의 시계열은 없습니다.
+ **Pending** - 평가 엔진에서 반환한 시계열 중 하나 이상의 상태가 `Pending`입니다.
+ **Firing** - 평가 엔진에서 반환한 시계열 중 하나 이상의 상태가 `Firing`입니다.

**알림 상태 조건**
+ **Normal** - 평가 엔진에서 반환하는 모든 시계열에 대해 알림 규칙의 조건이 **거짓**입니다.
+ **Alerting** - 평가 엔진에서 반환한 하나 이상의 시계열에 대해 알림 규칙의 조건이 **참**입니다. 설정된 경우 알림이 시작되기 전에 조건이 참이어야 하는 기간을 충족하거나 초과합니다.
+ **Pending** - 평가 엔진에서 반환한 하나 이상의 시계열에 대해 알림 규칙의 조건이 **참**입니다. 설정된 경우 알림이 시작되기 전에 조건이 참이어야 하는 기간을 충족하지 않습니다.
+ **NoData** – 알림 규칙이 시계열을 반환하지 않거나 시계열의 모든 값이 null이거나 시계열의 모든 값이 0입니다.
+ **Error** - 알림 규칙을 평가하려고 할 때 오류가 발생했습니다.

**알림 규칙 상태**
+ **Ok** - 알림 규칙을 평가할 때 오류가 없습니다.
+ **Error** - 알림 규칙을 평가할 때 오류가 발생했습니다.
+ **NoData** - 규칙 평가 중에 반환된 하나 이상의 시계열에 데이터가 없습니다.

# Grafana 알림 규칙 생성 및 관리
<a name="alert-rules"></a>

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

알림 규칙은 알림 시작 여부를 결정하는 평가 기준 세트입니다. 규칙은 하나 이상의 쿼리와 표현식, 조건, 평가 빈도 및 조건이 충족되는 기간(선택 사항)으로 구성됩니다.

쿼리 및 표현식에서는 평가할 데이터세트를 선택하는 반면, 조건은 알림을 생성하기 위해 알림에서 충족하거나 초과해야 하는 임계치를 설정합니다. 간격은 알림 규칙이 평가되는 빈도를 지정합니다. 기간을 구성하면 조건을 충족해야 하는 기간을 나타냅니다. 또한 규칙은 데이터가 없는 경우 알림 동작을 정의할 수 있습니다.

다음 섹션에서는 다양한 종류의 Grafana 알림 규칙 생성 및 관리를 설명합니다.

**Topics**
+ [Cortex 또는 Loki 관리형 알림 규칙 생성](#create-alert-rule)
+ [Cortex 또는 Loki 관리형 기록 규칙 생성](#create-alert-recording-rule)
+ [Grafana 관리형 알림 규칙 생성](#create-grafana-alert-rule)
+ [알림 규칙에 대한 주석 및 레이블](#alert-rule-labels)
+ [알림 규칙 관리](#manage-alert-rules)
+ [Cortex 또는 Loki 규칙 그룹 및 네임스페이스](#alert-rule-groups)

## Cortex 또는 Loki 관리형 알림 규칙 생성
<a name="create-alert-rule"></a>

Grafana를 사용하면 외부 Cortex 또는 Loki 인스턴스에 대한 알림 규칙을 생성할 수 있습니다.

**참고**  
Cortex는 Amazon Managed Service for Prometheus 및 Prometheus 데이터 소스에서 사용하는 시계열 데이터베이스입니다.

**사전 조건**
+ Prometheus 데이터 소스에 대한 쓰기 권한이 있는지 확인합니다. 그렇지 않으면 Cortex 관리형 알림 규칙을 생성하거나 업데이트할 수 없습니다.
+ Cortex 및 Loki 데이터 소스의 경우 해당 서비스를 구성하여 눈금자 API를 활성화합니다.
  + **Loki** - Loki 데이터 소스의 기본값인 `local` 규칙 스토리지 유형은 규칙 보기만 지원합니다. 규칙을 편집하려면 다른 스토리지 유형 중 하나를 구성합니다.
  + **Cortex** - `/prometheus`가 아닌 레거시 `/api/prom` 접두사를 사용합니다. Prometheus 데이터 소스는 Cortex 및 Prometheus를 모두 지원하며 Grafana는 쿼리 API 및 눈금자 API가 모두 동일한 URL에 있을 것으로 예상합니다. 눈금자 API에 별도의 URL을 제공할 수 없습니다.

**참고**  
특정 Loki 또는 Prometheus 데이터 소스에 대한 알림 규칙을 관리하지 않으려면 해당 설정으로 이동하여 **알림 UI를 통해 알림 관리** 확인란의 선택을 취소합니다.

**Cortex 또는 Loki 관리형 알림 규칙을 추가하는 방법**

1. Grafana 콘솔의 Grafana 메뉴에서 **알림**(종 모양) 아이콘을 선택하여 기존 알림이 나열된 **알림** 페이지를 엽니다.

1. **새 알림 규칙**을 선택하세요.

1. **1단계**에서 다음과 같이 규칙 이름, 유형 및 스토리지 위치를 추가하세요.
   + **규칙 이름**에 설명이 포함된 이름을 추가하세요. 이 이름은 알림 규칙 목록에 표시됩니다. 또한 이 규칙에서 생성된 모든 알림 인스턴스에 대한 `alertname` 레이블이기도 합니다.
   + **규칙 유형** 드롭다운에서 **Cortex/Loki 관리형 알림**을 선택하세요.
   + **데이터 소스 선택** 드롭다운에서 Prometheus 또는 Loki 데이터 소스를 선택하세요.
   + **네임스페이스** 드롭다운에서 기존 규칙 네임스페이스를 선택하세요. 그렇지 않으면 **새로 추가**를 선택하고 이름을 입력하여 이름을 생성하세요. 네임스페이스에는 하나 이상의 규칙 그룹이 포함될 수 있으며 조직의 목적만 있을 수 있습니다. 자세한 내용은 [Cortex 또는 Loki 규칙 그룹 및 네임스페이스](#alert-rule-groups) 단원을 참조하십시오.
   + **그룹** 드롭다운에서 선택한 네임스페이스 내에서 기존 그룹을 선택하세요. 그렇지 않으면 **새로 추가**를 선택하고 이름을 입력하여 이름을 생성하세요. 새로 생성된 규칙은 그룹 끝에 추가됩니다. 그룹 내 규칙은 동일한 평가 시간으로 일정한 간격에 따라 순차적으로 실행됩니다.

1. **2단계**에서 평가할 쿼리를 추가하세요.

   값은 PromQL 또는 LogQL 표현식일 수 있습니다. 평가 결과에 값이 0보다 큰 시리즈가 하나 이상 있는 경우 규칙은 알림을 시작합니다. 각 시리즈에 대한 알림이 생성됩니다.

1. **3단계**에서 조건을 추가하세요.

   조건의 기간 텍스트 상자에 알림이 시작되기 전 조건이 true여야 하는 기간을 지정하세요. `5m`을 지정하는 경우 알림이 시작되기 전에 5분 동안 조건이 true여야 합니다.
**참고**  
조건이 충족되면 알림이 `Pending` 상태가 됩니다. 지정된 기간에 조건이 활성 상태로 유지되면 알림이 `Firing` 상태로 전환됩니다. 더 이상 충족되지 않으면 `Normal` 상태로 돌아갑니다.

1. **4단계**에서 규칙과 연결된 메타데이터를 추가하세요.
   + 설명과 요약을 추가하여 알림 메시지를 사용자 지정하세요. [알림 규칙에 대한 주석 및 레이블](#alert-rule-labels)의 지침을 사용하세요.
   + 런북 URL, 패널, 대시보드 및 알림 ID를 추가하세요.
   + 사용자 지정 레이블을 추가하세요.

1. **알림 미리 보기**를 선택하여 규칙을 평가하고 어떤 알림을 생성할지 확인하세요. 각 알림의 상태 및 값과 함께 알림 목록을 표시합니다.

1. **저장**을 선택하여 규칙을 저장하거나 **저장 및 종료**를 선택하여 규칙을 저장하고 **알림** 페이지로 돌아가세요.

## Cortex 또는 Loki 관리형 기록 규칙 생성
<a name="create-alert-recording-rule"></a>

외부 Cortex 또는 Loki 인스턴스에 대한 기록 규칙을 생성 및 관리할 수 있습니다. 기록 규칙을 사용하면 자주 필요하거나 계산 비용이 많이 드는 표현식을 미리 계산하고, 해당 결과를 새로운 시계열 세트로 저장합니다. 이 새 시계열을 쿼리하는 것이 더 빠릅니다. 특히 대시보드를 새로 고칠 때마다 동일한 표현식을 쿼리하기 때문에 대시보드의 경우 더 빠릅니다.

**사전 조건**

Cortex 및 Loki 데이터 소스의 경우 해당 서비스를 구성하여 눈금자 API를 활성화합니다.
+ **Loki** - Loki 데이터 소스의 기본값인 `local` 규칙 스토리지 유형은 규칙 보기만 지원합니다. 규칙을 편집하려면 다른 스토리지 유형 중 하나를 구성합니다.
+ **Cortex** - Cortex를 가리키도록 Grafana Prometheus 데이터 소스를 구성할 때 `/prometheus`가 아닌 레거시 `/api/prom` 접두사를 사용합니다. Prometheus 데이터 소스는 Cortex 및 Prometheus를 모두 지원하며 Grafana는 쿼리 API 및 눈금자 API가 모두 동일한 URL에 있을 것으로 예상합니다. 눈금자 API에 별도의 URL을 제공할 수 없습니다.

**참고**  
특정 Loki 또는 Prometheus 데이터 소스에 대한 알림 규칙을 관리하지 않으려면 해당 설정으로 이동하여 **알림 UI를 통해 알림 관리** 확인란의 선택을 취소합니다.

**Cortex 또는 Loki 관리형 기록 규칙을 추가하는 방법**

1. Grafana 콘솔의 Grafana 메뉴에서 **알림**(종 모양) 아이콘을 선택하여 기존 알림이 나열된 **알림** 페이지를 엽니다.

1. **새 알림 규칙**을 선택하세요.

1. **1단계**에서 다음과 같이 규칙 이름, 유형 및 스토리지 위치를 추가하세요.
   + **규칙 이름**에 설명이 포함된 이름을 추가하세요. 이 이름은 알림 규칙 목록에 표시됩니다. 또한 이 규칙에서 생성된 모든 알림 인스턴스에 대한 `alertname` 레이블이기도 합니다.
   + **규칙 유형** 드롭다운에서 **Cortex/Loki 관리형 알림**을 선택하세요.
   + **데이터 소스 선택** 드롭다운에서 Prometheus 또는 Loki 데이터 소스를 선택하세요.
   + **네임스페이스** 드롭다운에서 기존 규칙 네임스페이스를 선택하세요. 그렇지 않으면 **새로 추가**를 선택하고 이름을 입력하여 이름을 생성하세요. 네임스페이스에는 하나 이상의 규칙 그룹이 포함될 수 있으며 조직의 목적만 있을 수 있습니다. 자세한 내용은 [Cortex 또는 Loki 규칙 그룹 및 네임스페이스](#alert-rule-groups) 단원을 참조하십시오.
   + **그룹** 드롭다운에서 선택한 네임스페이스 내에서 기존 그룹을 선택하세요. 그렇지 않으면 **새로 추가**를 선택하고 이름을 입력하여 이름을 생성하세요. 새로 생성된 규칙은 그룹 끝에 추가됩니다. 그룹 내 규칙은 동일한 평가 시간으로 일정한 간격에 따라 순차적으로 실행됩니다.

1. **2단계**에서 평가할 쿼리를 추가하세요.

   값은 PromQL 또는 LogQL 표현식일 수 있습니다. 평가 결과에 값이 0보다 큰 시리즈가 하나 이상 있는 경우 규칙은 알림을 시작합니다. 각 시리즈에 대한 알림이 생성됩니다.

1. **3단계**에서 규칙과 연결된 메타데이터를 추가하세요.
   + 설명과 요약을 추가하여 알림 메시지를 사용자 지정하세요. [알림 규칙에 대한 주석 및 레이블](#alert-rule-labels)의 지침을 사용하세요.
   + 런북 URL, 패널, 대시보드 및 알림 ID를 추가하세요.
   + 사용자 지정 레이블을 추가하세요.

1. **저장**을 선택하여 규칙을 저장하거나 **저장 및 종료**를 선택하여 규칙을 저장하고 **알림** 페이지로 돌아가세요.

## Grafana 관리형 알림 규칙 생성
<a name="create-grafana-alert-rule"></a>

Grafana를 사용하면 하나 이상의 데이터 소스를 쿼리하고, 결과를 줄이거나 변환하며, 서로 비교하거나 임계치를 수정하는 알림 규칙을 생성할 수 있습니다. 이러한 작업이 처리되면 Grafana는 연락 지점에 알림을 보냅니다.

**참고**  
Grafana 알림을 사용하는 동안 Grafana 관리형 알림 규칙을 생성하면 규칙이 일치할 때 여러 알림이 전송됩니다. 일부 연락 지점 제공업체에는 알림을 중복 제거하는 구성 가능한 옵션이 있을 수 있습니다.

**Grafana 관리형 규칙을 추가하는 방법**

1. Grafana 콘솔의 Grafana 메뉴에서 **알림**(종 모양) 아이콘을 선택하여 기존 알림을 나열하는 **알림** 페이지를 여세요.

1. **새 알림 규칙**을 선택하세요.

1. **1단계**에서 다음과 같이 규칙 이름, 유형 및 스토리지 위치를 추가하세요.
   + **규칙 이름**에 설명이 포함된 이름을 추가하세요. 이 이름은 알림 규칙 목록에 표시됩니다. 또한 이 규칙에서 생성된 모든 알림 인스턴스에 대한 `alertname` 레이블이기도 합니다.
   + **규칙 유형** 드롭다운에서 **Grafana 관리형 알림**을 선택하세요.
   + **폴더** 드롭다운에서 규칙을 저장할 폴더를 선택하세요. 폴더를 선택하지 않으면 규칙은 `General` 폴더에 저장됩니다. 폴더를 생성하려면 드롭다운을 선택하고 새 폴더 이름을 입력하세요.

1. **2단계**에서 평가할 쿼리와 표현식을 추가하세요.
   + 기본 이름을 그대로 두거나 마우스를 위로 가져가 편집 아이콘을 선택하여 이름을 변경하세요.
   + 쿼리의 경우 드롭다운에서 데이터 소스를 선택하세요.
   + 하나 이상의 [쿼리](panel-queries.md) 또는 표현식을 추가합니다(표현식에 대한 자세한 내용은 **Grafana 설명서의 [Expressions](https://grafana.com/docs/grafana/next/panels/query-a-data-source/) 참조).
   + 각 표현식에 대해 **클래식 조건**을 선택하여 단일 알림 규칙을 생성하거나 **수학**, **축소**, **리샘플링** 옵션 중에서 선택하여 각 시리즈에 대해 별도의 알림을 생성하세요. 이러한 옵션에 대한 자세한 내용은 [단일 및 다차원 규칙](#single-multi-rule) 섹션을 참조하세요.
   + **쿼리 실행**을 선택하여 쿼리가 성공했는지 확인하세요.

1. **3단계**에서 조건을 추가하세요.
   + **조건** 드롭다운에서 쿼리 또는 표현식을 선택하여 알림 규칙을 시작하세요.
   + **평가 간격**에서 평가 빈도를 지정합니다. 10초의 배수여야 합니다. 예, `1m`, `30s`.
   + **평가 대상**에서 알림이 시작되기 전에 조건이 true여야 하는 기간을 지정하세요.
**참고**  
조건이 위반되면 알림이 `Pending` 상태가 됩니다. 지정된 기간에 조건이 위반된 상태로 유지되면 알림이 `Firing` 상태로 전환됩니다. 더 이상 충족되지 않으면 `Normal` 상태로 돌아갑니다.
   + **데이터 없음 및 오류 처리 구성**에서 데이터가 없는 경우 알림 동작을 구성하세요. [데이터 없음 또는 오류 사례 처리](#rule-no-data-error)의 지침을 사용하세요.
   + **미리 보기**를 선택하여 현재 쿼리 실행 결과를 확인하세요. 미리 보기에서는 데이터 없음 및 오류 처리 조건이 제외됩니다.

1. **4단계**에서 규칙과 연결된 메타데이터를 추가하세요.
   + 설명과 요약을 추가하여 알림 메시지를 사용자 지정하세요. [알림 규칙에 대한 주석 및 레이블](#alert-rule-labels)의 지침을 사용하세요.
   + 런북 URL, 패널, 대시보드 및 알림 ID를 추가하세요.
   + 사용자 지정 레이블을 추가하세요.

1. **저장**을 선택하여 규칙을 저장하거나 **저장 및 종료**를 선택하여 규칙을 저장하고 **알림** 페이지로 돌아가세요.

### 단일 및 다차원 규칙
<a name="single-multi-rule"></a>

Grafana 관리형 알림 규칙의 경우 클래식 조건의 규칙을 생성하거나 다차원 규칙을 생성할 수 있습니다.

**단일 차원 규칙(클래식 조건)**

클래식 조건 표현식을 사용하여 조건이 충족될 때 단일 알림을 시작하는 규칙을 생성합니다. 여러 시리즈를 반환하는 쿼리의 경우 Grafana에서는 각 시리즈의 알림 상태를 추적하지 않습니다. 따라서 Grafana는 여러 시리즈에 대한 알림 조건이 충족되더라도 단일 알림만 전송합니다.

표현식을 포맷하는 방법에 대한 자세한 내용은 *Grafana 설명서*의 [Expressions](https://grafana.com/docs/grafana/next/panels/query-a-data-source/)를 참조하세요.

**다차원 규칙**

쿼리에서 반환된 각 시리즈에 대해 별도의 알림 인스턴스를 생성하려면 다차원 규칙을 생성합니다.

**참고**  
다차원 규칙에 의해 생성된 각 알림 인스턴스는 총 알림 할당량에 포함됩니다. 알림 할당량에 도달하면 규칙이 평가되지 않습니다. 다차원 규칙의 할당량에 대한 자세한 내용은 [할당량에 도달함 오류](#rule-quota-reached) 섹션을 참조하세요.

단일 규칙에서 여러 인스턴스를 생성하려면 `Math`, `Reduce` 또는 `Resample` 표현식을 사용하여 다차원 규칙을 생성합니다. 예를 들어, 다음을 수행할 수 있습니다.
+ 각 쿼리에 `Reduce` 표현식을 추가하여 선택한 시간 범위의 값을 단일 값으로 집계합니다. ([숫자 데이터를 사용하는 규칙](alert-fundamentals.md#alert-numeric)에는 필요하지 않습니다.)
+ 규칙의 조건에 `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))에서 확인할 수 있습니다.



**다차원 규칙에 대한 성능 고려 사항**

각 알림 인스턴스는 알림 할당량에 포함됩니다. 알림 할당량 내에서 수용할 수 있는 것보다 많은 인스턴스를 생성하는 다차원 규칙은 평가되지 않으며 할당량 오류를 반환합니다. 자세한 내용은 [할당량에 도달함 오류](#rule-quota-reached) 단원을 참조하십시오.

다차원 알림은 Grafana에서 알림 규칙을 평가하기 위해 쿼리할 때 Grafana 워크스페이스의 성능뿐만 아니라 데이터 소스의 성능에도 큰 영향을 미칠 수 있습니다. 다음 고려 사항은 모니터링 시스템의 성능을 최적화하는 데 도움이 될 수 있습니다.
+ **규칙 평가 빈도** - 알림 규칙의 **평가 간격** 속성은 규칙 평가 빈도를 제어합니다. 허용되는 최조 평가 빈도를 사용하는 것이 좋습니다.
+ **결과 세트 카디널리티** - 규칙으로 생성한 알림 인스턴스 수가 성능에 영향을 미칩니다. 플릿의 모든 VM에서 모든 API 경로에 대한 API 응답 오류를 모니터링한다고 가정합니다 이 세트에는 경로 수에 VM 수를 곱한 카디널리티가 있습니다. 예를 들어, VM당 경로 기준 대신 VM당 총 오류 수를 모니터링하여 결과 세트의 카디널리티를 줄일 수 있습니다.
+ **쿼리의 복잡성** - 데이터 소스가 처리 및 응답하여 리소스를 빠르게 소비할 수 있는 쿼리. 이 고려 사항은 위에 나열된 다른 고려 사항보다 덜 중요하지만, 최대한 줄이면 개별 쿼리 성능을 살펴볼 때 차이가 나타날 수 있습니다. 또한 이러한 규칙의 평가가 데이터 소스에 미치는 성능 영향도 알고 있어야 합니다. 알림 쿼리는 데이터베이스 모니터링으로 처리되는 대부분의 쿼리이므로 Grafana 인스턴스에 영향을 미치는 동일한 부하 인자도 이에 영향을 미칩니다.

### 할당량에 도달함 오류
<a name="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="rule-no-data-error"></a>

데이터가 없거나 오류가 있을 때 알림 동작을 처리하는 방법에 대한 옵션을 선택합니다.

데이터 없음 처리를 위한 옵션은 다음 표에 나열되어 있습니다.


| 데이터 없음 옵션 | 동작 | 
| --- | --- | 
|  데이터 없음  |  알림 규칙의 이름과 UID, 레이블로 데이터를 반환하지 않은 데이터 소스의 UID를 사용하여 `DatasourceNoData` 알림을 생성합니다.  | 
|  알림  |  알림 규칙 상태를 `Alerting` 상태로 설정합니다.  | 
|  정상  |  알림 규칙 상태를 `Normal` 상태로 설정합니다.  | 

오류 사례 처리 옵션은 다음 표에 나와 있습니다.


| 오류 또는 제한 시간 옵션 | 동작 | 
| --- | --- | 
|  알림  |  알림 규칙 상태를 `Alerting` 상태로 설정  | 
|  정상  |  알림 규칙 상태를 `Normal` 상태로 설정  | 
|  오류  |  알림 규칙의 이름과 UID, 레이블로 데이터를 반환하지 않은 데이터 소스의 UID를 사용하여 `DatasourceError` 알림을 생성합니다.  | 

## 알림 규칙에 대한 주석 및 레이블
<a name="alert-rule-labels"></a>

주석 및 레이블은 알림 규칙, 데이터 소스 응답 및 알림 규칙 평가의 결과에서 비롯된 알림과 연결된 키-값 페어입니다. 알림 전달에서 직접 사용하거나 [템플릿](alert-message-templates.md) 및 [템플릿 함수](alert-message-templates.md#alert-template-functions)에서 사용하여 알림 연락처를 동적으로 생성할 수 있습니다.

**Annotations**

주석은 알림에 대한 추가 정보를 제공하는 키-값 페어입니다. `description`, `summary`, `runbook_url`, `alertId`, `dashboardUid`, `panelId`와 같은 주석을 사용할 수 있습니다. 이는 UI의 규칙 및 알림 세부 정보에 표시되며 연락 지점 메시지 템플릿에서 사용할 수 있습니다.

**레이블**

레이블은 알림에 대한 정보를 포함하는 키-값 페어입니다. 알림에 대한 레이블 세트가 생성되고 알림 평가 및 알림 프로세스 전반에 걸쳐 추가됩니다. 다음과 같은 방식으로 사용됩니다.
+ 알림의 전체 레이블 세트를 통해 Grafana 알림 내에서 해당 알림을 고유하게 식별합니다.
+ Alertmanager는 레이블을 사용하여 [알림 정책](alert-notifications.md)의 [무음](alert-silences.md) 및 [알림 그룹](alert-groups.md)에 대한 알림을 매칭합니다.
+ 알림 UI에는 해당 규칙의 평가에서 생성된 모든 알림 인스턴스의 레이블이 표시됩니다.
+ 연락 지점에서는 레이블에 액세스하여 알림을 생성시키는 알림 관련 정보가 포함된 알림을 동적으로 생성할 수 있습니다.
+ 레이블을 [알림 규칙](#alert-rules)에 추가할 수 있습니다. 이와 같이 수동으로 구성된 레이블은 템플릿 함수를 사용하고 다른 레이블을 참조할 수 있습니다. 여기에서 알림 규칙에 추가된 레이블은 레이블 간 충돌이 발생하는 경우 우선됩니다.

주석 및 레이블을 확장할 때 다음 템플릿 변수를 사용할 수 있습니다.


| 이름 | 설명 | 
| --- | --- | 
|  `$labels`  |  쿼리 또는 조건의 레이블. 예: `{{ $labels.instance }}` 및 `{{ $labels.job }}`. 규칙이 클래식 조건을 사용하는 경우 사용할 수 없습니다.  | 
|  `$values`  |  이 알림 규칙에 대해 평가된 모든 축소 및 수학 표현식의 값. 예: `{{ $values.A }}`, `{{ $values.A.Labels }}`, `{{ $values.A.Value }}`. 여기서 `A`는 표현식의 `refID`입니다. 규칙이 클래식 조건을 사용하는 경우 사용할 수 없습니다.  | 
|  `$value`  |  알림 인스턴스의 값 문자열. 예를 들어 `[ var='A' labels={instance=foo} value=10 ]`입니다.  | 

## 알림 규칙 관리
<a name="manage-alert-rules"></a>



**알림** 페이지에는 알림 규칙이 나열됩니다. 기본적으로 규칙은 데이터 소스 유형별로 그룹화됩니다. **Grafana** 섹션에는 Grafana에서 관리하는 규칙이 나열되고 **Cortex/Loki** 섹션에는 Prometheus 호환 데이터 소스에 대한 규칙이 나열됩니다. Prometheus 호환 데이터 소스에 대한 알림 규칙은 볼 수 있지만 편집할 수 없습니다.

### 알림 규칙 보기
<a name="manage-alerts-view"></a>

Grafana 알림을 사용하면 한 페이지에서 모든 알림을 볼 수 있습니다.

**알림 세부 정보를 보는 방법**

1. Grafana 콘솔의 Grafana 메뉴에서 **알림**(종 모양) 아이콘을 선택하여 **알림** 페이지를 여세요. 기본적으로 규칙은 데이터 소스 유형별 그룹으로 표시됩니다. 각 알림의 현재 상태를 기준으로 볼 수도 있습니다(다음 텍스트에 자세히 설명함).

1. **보기 형식**에서 원하는 옵션을 선택하여 그룹 보기와 상태 보기 사이를 전환할 수 있습니다.

1. 해당 행에 대한 자세한 내용을 확인하려면 행 옆의 화살표를 선택합니다. 규칙의 세부 정보에는 규칙 레이블, 주석, 데이터 소스 및 쿼리와 규칙에서 생성되는 알림 인스턴스 목록이 포함됩니다.

**그룹 보기**

그룹 보기에는 폴더별로 그룹화된 Grafana 알림 규칙과 `namespace` \$1 `group`으로 그룹화된 Loki 또는 Prometheus 알림 규칙이 표시됩니다. 이는 규칙 관리를 위한 기본 규칙 목록 보기입니다. 각 그룹을 확장하여 이 그룹의 규칙 목록을 볼 수 있습니다. 규칙을 더 확장하여 세부 정보를 확인합니다. 규칙에서 생성되는 알림 및 작업 버튼을 확장하여 세부 정보를 볼 수도 있습니다.

**상태 보기**

상태 보기에는 상태별로 그룹화된 알림 규칙이 표시됩니다. 이 보기를 사용하여 어떤 규칙이 어떤 상태에 있는지에 대한 개요를 확인합니다. 각 규칙을 확장하여 세부 정보를 볼 수 있습니다. 작업 버튼 및 이 규칙에서 생성된 모든 알림과 각 알림을 추가로 확장하여 세부 정보를 볼 수 있습니다.

**알림 규칙 필터링**

알림 페이지에 표시되는 **알림** 규칙을 여러 가지 방법으로 필터링할 수 있습니다.
+ **데이터 소스 선택**을 선택하고 필터링할 데이터 소스를 선택하여 특정 데이터 소스를 쿼리하는 규칙을 표시하도록 필터링할 수 있습니다.
+ **레이블별 검색**에서 검색 기준을 선택하여 레이블별로 필터링할 수 있습니다. 일부 샘플 기준에는 `environment=production`, `region=~US|EU`, `severity!=warning`이 포함됩니다.
+ **상태별 알림 필터링**을 선택하고 보려는 상태를 선택하여 특정 상태의 규칙을 표시하도록 필터링할 수 있습니다

### 알림 규칙 편집 또는 삭제
<a name="manage-alerts-edit"></a>

Grafana 관리형 알림 규칙은 규칙을 저장하는 폴더에 대한 편집 권한이 있는 사용자만 편집하거나 삭제할 수 있습니다. 외부 Cortex 또는 Loki 인스턴스에 대한 알림 규칙은 편집자 또는 관리자 역할의 사용자가 편집하거나 삭제할 수 있습니다.

**규칙을 편집하거나 삭제하는 방법**

1. **보기**, **편집** 및 **삭제**에 대한 규칙 제어가 표시될 때까지 규칙을 확장하세요.

1. **편집**을 선택하여 규칙 생성 페이지를 여세요. 규칙을 생성하는 것과 동일한 방식으로 업데이트하세요. 자세한 내용은 [Grafana 관리형 알림 규칙 생성](#create-grafana-alert-rule) 또는 [Cortex 또는 Loki 관리형 알림 규칙 생성](#create-alert-rule)의 지침을 참조하세요.

1. 선택적으로 **삭제**를 선택하여 규칙을 삭제하세요.

## Cortex 또는 Loki 규칙 그룹 및 네임스페이스
<a name="alert-rule-groups"></a>

규칙을 구성할 수 있습니다. 규칙은 규칙 그룹 내에서 생성되며 규칙 그룹은 네임스페이스로 구성됩니다. 규칙 그룹 내의 규칙은 정기적으로 순차적으로 실행됩니다. 기본 간격은 1분입니다. Cortex 또는 Loki 네임스페이스 및 규칙 그룹의 이름을 바꾸고 규칙 그룹 평가 간격을 편집할 수 있습니다.

**규칙 그룹 또는 네임스페이스를 편집하는 방법**

1. Grafana 콘솔의 Grafana 메뉴에서 **알림**(종 모양) 아이콘을 선택하여 **알림** 페이지를 여세요.

1. 편집하려는 규칙 그룹 또는 네임스페이스 내 규칙으로 이동하세요.

1. **편집**(펜) 아이콘을 선택하세요.

1. 규칙 그룹 또는 네임스페이스를 변경하세요.
**참고**  
네임스페이스의 경우 이름만 편집할 수 있습니다. 규칙 그룹의 경우 이름 또는 그룹의 규칙에 대한 평가 간격을 변경하세요. 예를 들어 `1m`을 선택하여 규칙을 분당 1회 평가하거나 `30s`를 선택하여 30초마다 1회 평가할 수 있습니다.

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

# 알림 그룹
<a name="alert-groups"></a>

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

알림 그룹에서는 Alertmanager 인스턴스의 그룹화된 경보를 표시합니다. 기본적으로 알림은 [알림 정책 작업](alert-notifications.md)의 루트 정책에 대한 레이블 키별로 그룹화됩니다. 일반 알림을 단일 알림 그룹으로 그룹화하면 중복 알림이 시작되지 않습니다.

**알림 그룹화를 보는 방법**

1. Grafana 콘솔의 Grafana 메뉴에서 **알림**(종 모양) 아이콘을 선택한 다음, **알림 그룹화** 항목을 선택하여 기존 그룹을 나열하는 페이지를 엽니다.

1. **Alertmanager** 드롭다운에서 외부 Alertmanager를 데이터 소스로 선택하세요. 기본적으로 `Grafana` Alertmanager가 선택됩니다.

1. **사용자 지정 그룹화 기준** 드롭다운에서 레이블 조합을 선택하여 기본값이 아닌 다른 그룹화를 보세요. 이 보기를 사용하여 알림 정책 그룹을 디버깅하거나 확인할 수 있습니다.

루트 정책의 그룹화 또는 사용자 지정 그룹화에 레이블이 지정되지 않은 알림은 헤더가 `No grouping`인 그룹에 추가됩니다.

**알림 필터링**

다음 필터를 사용하여 특정 기준과 일치하는 알림을 볼 수 있습니다.
+ **레이블별 검색** - **검색**에 기존 레이블을 입력하여 레이블과 일치하는 알림을 봅니다. 예: `environment=production`, `region=~US|EU`, `severity!=warning`.
+ **상태별 알림 필터링** - **상태**에서 `Active`, `Suppressed` 또는 `Unprocessed` 상태 중 원하는 상태를 선택하여 해당 상태의 알림을 봅니다.

# Prometheus 데이터 소스에 대한 알림 전달 무음 처리
<a name="alert-silences"></a>

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

외부 Alertmanager 데이터 소스(Amazon Managed Service for Prometheus 포함)의 경우 *무음*으로 알림 전달을 억제할 수 있습니다. 무음은 알림 생성만 중지합니다. 무음은 알림 규칙이 평가되는 것을 방지하지 않으며 사용자 인터페이스에 인스턴스 알림이 표시되는 것도 중지하지 않습니다. 알림을 무음으로 설정한 경우 알림이 억제되는 기간을 지정합니다.

외부 Alertmanager 데이터 소스에 대해 무음을 구성할 수 있습니다.

**참고**  
정기적인 시간 간격(예: 정기 유지 관리 기간)으로 알림 전달을 억제하려면 무음 대신 [음소거 타이밍](alert-notifications.md#alert-notification-muting)을 사용합니다.

**무음을 추가하는 방법**

1. Grafana 콘솔의 Grafana 메뉴에서 **알림**(종 모양) 아이콘을 선택하여 **알림** 페이지를 여세요.

1. **무음**을 선택하여 기존 [연락 지점](alert-contact-points.md)이 나열된 페이지를 여세요.

1. **Alertmanager** 드롭다운에서 외부 Alertmanager를 선택하세요.

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="alert-contact-points"></a>

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

연락 지점을 사용하여 알림이 시작될 때 연락처로 알림을 보내는 방법을 정의합니다. 연락 지점에는 Amazon Simple Notification Service 또는 Slack과 같은 하나 이상의 연락 지점 유형이 있을 수 있습니다. 알림이 시작되면 연락 지점에 대해 나열된 모든 연락 지점 유형에 알림이 전송됩니다. 선택적으로 [메시징 템플릿 사용](alert-message-templates.md)를 통해 연락 지점 유형에 대한 알림 메시지를 사용자 지정합니다.

**참고**  
Grafana 관리형 알림에 대한 연락 지점을 생성 및 편집할 수 있습니다. Alertmanager 알림에 대한 연락 지점은 읽기 전용입니다.

## 연락 지점 작업
<a name="alert-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="alert-supported-notifiers"></a>


|  이름  |  Type  | 
| --- | --- | 
| Amazon SNS  |  sns  | 
|  OpsGenie  |  opsgenie  | 
| PagerDuty  |  pagerduty  | 
| Slack  |  slack  | 
|  VictorOps  |  victorops  | 

# 메시징 템플릿 사용
<a name="alert-message-templates"></a>

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

[연락 지점 작업](alert-contact-points.md)을 통해 전송되는 알림은 *메시징 템플릿*를 사용하여 빌드됩니다. Grafana의 기본 템플릿은 [Go 템플릿 지정 시스템](https://golang.org/pkg/text/template)을 기반으로 합니다. 여기서 일부 필드는 텍스트로 평가되고 다른 필드는 HTML(이스케이핑에 영향을 미칠 수 있음)로 평가됩니다.

대부분의 연락 지점 필드는 템플릿 지정 가능하므로 재사용 가능한 사용자 지정 템플릿을 생성하고 여러 연락 지점에서 사용할 수 있습니다. 이 [템플릿 데이터](#alert-template-data) 주제에서는 템플릿 지정에 사용할 수 있는 변수를 나열합니다.

**템플릿 사용**

템플릿은 메시지를 생성하는 데 사용됩니다. 예를 들어, Slack 알림 메시지를 사용하는 경우 연락 지점의에서제목과 본문을 설정할 수 있습니다. 다음 예제에서는 기본 템플릿을 사용하여 실행 알림 및 해결된 알림 수를 포함하는 제목과 알림 및 해당 상태를 나열하는 본문을 생성하는 방법을 보여줍니다.
+ **제목**:

  ```
  {{ len .Alerts.Firing }} firing, {{ len .Alerts.Resolved }} resolved
  ```
+ **텍스트 본문:** 

  ```
  {{ range .Alerts }}{{ .Status }}: {{ .Labels.alertname }}
  {{end }}
  ```

다음 예제와 같이 사용자 지정 템플릿을 생성할 수 있습니다.
+ **제목**:

  ```
  {{ template "slack.default.title" .}}
  ```
+ **텍스트 본문:** 

  ```
  {{ template "mymessage" .}}
  ```

다음은 샘플 템플릿입니다.

```
{{ define "myalert" }}
  [{{.Status}}] {{ .Labels.alertname }}

  Labels:
  {{ range .Labels.SortedPairs }}
    {{ .Name }}: {{ .Value }}
  {{ end }}

  {{ if gt (len .Annotations) 0 }}
  Annotations:
  {{ range .Annotations.SortedPairs }}
    {{ .Name }}: {{ .Value }}
  {{ end }}
  {{ end }}

  {{ if gt (len .SilenceURL ) 0 }}
    Silence alert: {{ .SilenceURL }}
  {{ end }}
  {{ if gt (len .DashboardURL ) 0 }}
    Go to dashboard: {{ .DashboardURL }}
  {{ end }}
{{ end }}
```

다음 절차에서는 사용자 지정 메시지 템플릿을 생성, 편집 및 삭제하는 방법을 보여줍니다.

**메시지 템플릿을 생성하는 방법**

1. Grafana 콘솔의 Grafana 메뉴에서 **알림**(종 모양) 아이콘을 선택하여 **알림** 페이지를 여세요.

1. **연락 지점**을 선택하세요.

1. **Alertmanager** 드롭다운에서 메시지 템플릿을 생성할 Alertmanager 인스턴스를 선택하세요. 기본값은 Grafana Alertmanager입니다.

1. **템플릿 추가**를 선택하세요.

1. 설명이 포함된 **이름**을 지정하세요.

1. 템플릿의 **콘텐츠**를 추가하세요. 예를 들어 다음과 같습니다.

   ```
   {{ define "mymessage" }}
     {{ range .Alerts }}
       [{{ .Status }}] {{ range .Labels }} {{ .Name }}={{.Value }}{{end}}
     {{ end }}
   {{ end }}
   ```

   콘텐츠 섹션의 `define` 태그는 템플릿 이름을 할당합니다. 이 태그는 선택 사항이며 생략하면 템플릿 이름이 **이름** 필드에서 파생됩니다. 둘 다 지정하면 동일하게 유지하는 것이 가장 좋습니다.

1. **템플릿 저장**을 선택합니다.

**참고**  
알림 메시지 템플릿의 HTML은 텍스트로 렌더링되며 제어 문자가 이스케이프 처리됩니다. Grafana는 결과 알림에서 HTML 렌더링을 지원하지 않습니다.

**메시지 템플릿을 편집하려면 다음과 같이 하십시오.**

1. **알림** 페이지에서 **연락 지점**을 선택하여 연락 시점 목록을 여세요.

1. **템플릿 테이블**에서 편집할 템플릿을 찾고 **편집** 아이콘(펜)을 선택하세요.

1. 변경을 수행하고 **템플릿 저장**을 선택하세요.

**메시지 템플릿을 삭제하려면 다음과 같이 하십시오.**

1. **알림** 페이지에서 **연락 지점**을 선택하여 연락 시점 목록을 여세요.

1. **템플릿 테이블**에서 제거할 템플릿을 찾고 **삭제** 아이콘(휴지통)을 선택하세요.

1. **예, 삭제**를 선택하여 템플릿을 삭제하세요.

**중첩된 템플릿**

다른 템플릿 내에 템플릿을 포함할 수 있습니다.

예를 들어 `define` 키워드를 사용하여 템플릿 조각을 정의할 수 있습니다.

```
{{ define "mytemplate" }}
  {{ len .Alerts.Firing }} firing. {{ len .Alerts.Resolved }} resolved.
{{ end }}
```

그런 다음, `template` 키워드를 사용하여 이 조각 내에 사용자 지정 템플릿을 포함할 수 있습니다. 예제:

```
Alert summary:
{{ template "mytemplate" . }}
```

다음 기본 제공 템플릿 옵션을 사용하여 사용자 지정 템플릿을 포함할 수 있습니다.


| 이름 | 참고 | 
| --- | --- | 
|  `default.title`  |  개요 수준의 상태 정보를 표시합니다.  | 
|  `default.message`  |  실행 알림 및 해결된 알림의 형식이 지정된 요약을 제공합니다.  | 

**사용자 지정 템플릿 예제**

다음은 사용자 지정 템플릿을 사용하는 방법에 대한 예제입니다.

단일 알림을 렌더링하기 위한 템플릿:

```
{{ define "myalert" }}
  [{{.Status}}] {{ .Labels.alertname }}

  Labels:
  {{ range .Labels.SortedPairs }}
    {{ .Name }}: {{ .Value }}
  {{ end }}

  {{ if gt (len .Annotations) 0 }}
  Annotations:
  {{ range .Annotations.SortedPairs }}
    {{ .Name }}: {{ .Value }}
  {{ end }}
  {{ end }}

  {{ if gt (len .SilenceURL ) 0 }}
    Silence alert: {{ .SilenceURL }}
  {{ end }}
  {{ if gt (len .DashboardURL ) 0 }}
    Go to dashboard: {{ .DashboardURL }}
  {{ end }}
{{ end }}
```

전체 알림 메시지를 렌더링하기 위한 템플릿:

```
{{ define "mymessage" }}
  {{ if gt (len .Alerts.Firing) 0 }}
    {{ len .Alerts.Firing }} firing:
    {{ range .Alerts.Firing }} {{ template "myalert" .}} {{ end }}
  {{ end }}
  {{ if gt (len .Alerts.Resolved) 0 }}
    {{ len .Alerts.Resolved }} resolved:
    {{ range .Alerts.Resolved }} {{ template "myalert" .}} {{ end }}
  {{ end }}
{{ end }}
```

## 템플릿 데이터
<a name="alert-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  |  알림에 연결된 주석 세트.  | 
|  StartsAt  |  time.Time  |  알림 실행이 시작되는 시간.  | 
|  EndsAt  |  time.Time  |  알림의 종료 시간을 알고 있는 경우에만 설정합니다. 그렇지 않으면 마지막 알림이 수신된 이후부터 구성 가능한 제한 시간으로 설정됩니다.  | 
|  GeneratorURL  |  문자열  |  Grafana 또는 외부 Alertmanager에 대한 백 링크.  | 
|  SilenceURL  |  문자열  |  이 알림의 레이블이 미리 채워진 Grafana 무음에 대한 링크. Grafana 관리형 알림에만 적용됩니다.  | 
|  DashboardURL  |  문자열  |  알림 규칙이 하나에 속하는 경우 Grafana 대시보드에 대한 링크. Grafana 관리형 알림에만 적용됩니다.  | 
|  PanelURL  |  문자열  |  알림 규칙이 하나에 속하는 경우 Grafana 대시보드 패널에 대한 링크. Grafana 관리형 알림에만 적용됩니다.  | 
|  지문  |  문자열  |  알림을 식별하는 데 사용할 수 있는 지문.  | 
|  ValueString  |  문자열  |  알림에서 축소된 각 표현식의 레이블과 값을 포함하는 문자열.  | 

**KeyValue 유형**

`KeyValue` 유형은 레이블과 주석을 나타내는 키/값 문자열 페어 세트입니다.

`KeyValue`로 저장된 데이터에 대한 직접 액세스 외에도 데이터를 정렬, 제거 및 변환하는 방법도 있습니다.


| 이름 | 인수 | 반환 | 참고 | 
| --- | --- | --- | --- | 
|  SortedPairs  |    |  키 및 값 문자열 페어의 정렬된 목록  |    | 
|  제거  |  []string  |  KeyValue  |  지정된 키 없이 키/값 맵의 사본을 반환합니다.  | 
|  이름  |    |  []string  |  레이블 이름 목록  | 
|  값  |    |  []string  |  레이블 값 목록  | 



## 템플릿 함수
<a name="alert-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  | 

# 알림 정책 작업
<a name="alert-notifications"></a>

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

알림 정책은 알림이 연락 지점으로 라우팅되는 방법을 결정합니다. 정책은 트리 구조를 사용하며, 각 정책에는 하나 이상의 하위 정책이 있을 수 있습니다. 루트 정책을 제외한 각 정책은 특정 알림 레이블과 일치할 수도 있습니다. 각 알림은 루트 정책 및 각 하위 정책에 따라 평가됩니다. 특정 정책에 대해 `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="alert-notifications-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. **정책 저장**을 선택합니다.

**레이블 일치 작동 방식**

알림의 레이블이 정책에 지정된 모든 *일치 레이블*과 일치하는 경우 정책은 알림과 일치합니다.
+ **레이블** - 일치시킬 레이블의 이름. 알림의 레이블 이름과 정확히 일치해야 합니다.
+ **연산자** - 레이블 값을 일치 레이블 값과 비교하는 데 사용되는 연산자. 사용 가능한 연산자는 다음과 같습니다.
  + `=` 값이 제공된 문자열과 정확히 일치하는 레이블을 선택합니다.
  + `!=` 값이 제공된 문자열과 일치하지 않는 레이블을 선택합니다.
  + `=~` 값이 제공된 문자열의 정규식 해석 값과 일치하는 레이블을 선택합니다(제공된 문자열은 정규식으로 해석됨).
  + `!=` 제공된 정규식과 일치하지 않는 레이블을 선택합니다.
+ **값** - 레이블 값과 일치하는 값. 선택한 연산자에 따라 문자열 또는 정규식으로 일치할 수 있습니다.

## 음소거 타이밍
<a name="alert-notification-muting"></a>

음소거 타이밍은 정책에 대한 새 알림이 생성되거나 전송되지 않는 반복 간격입니다. 이를 사용하여 정기 유지 관리 기간과 같은 특정 기간 및 반복 기간에 알림이 실행되지 않도록 합니다.

무음과 마찬가지로 음소거 타이밍은 알림 규칙이 평가되지 않도록 하며 사용자 인터페이스에 알림 인스턴스가 표시되지 않도록 합니다. 이 기능은 알림 생성만 방지합니다.

Grafana 관리형 음소거 타이밍 및 외부 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`은 해당 월의 마지막 날짜를 나타냅니다. 월의 일은 하루, 일 범위 또는 쉼표로 구분된 일 목록으로 지정할 수 있습니다.