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

# 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)