

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

# 시각화 주석 달기
<a name="v9-panels-annotate-visualizations"></a>

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

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

**기본 주석**

Grafana에는 기본 주석 저장소와 그래프 패널 또는 HTTP API를 통해 직접 주석 이벤트를 추가할 수 있는 기능이 함께 제공됩니다.

**주석 추가**

1. 대시보드에서 **시계열** 패널을 클릭하세요. 컨텍스트 메뉴가 나타납니다.

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

1. 주석 설명과 선택적으로 태그를 추가하세요.

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

또는 주석을 추가하려면 **시계열** 패널에서 `Ctrl+Click` 또는 `Cmd+Click`를 누르세요. **주석 추가** 팝업이 나타납니다.

**리전 주석 추가**

1. 대시보드에의 **시계열** 패널에서 `Ctrl+Click` 또는 `Cmd+Click`를 클릭하세요.

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

1. 주석 설명과 선택적으로 태그를 추가하세요.

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

**주석 편집**

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

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

1. 설명 및 태그(선택 사항)를 수정하세요.

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

**주석 삭제**

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

1. 주석 툴팁에서 휴지통 아이콘을 클릭하세요.

**기본 제공 쿼리**

주석을 추가한 후에도 주석은 계속 표시됩니다. 이는 모든 대시보드에 존재하는 기본 제공 주석 쿼리 때문입니다. 이 주석 쿼리는 현재 대시보드에서 시작된 모든 주석 이벤트를 가져와서 생성된 패널에 표시합니다. 여기에는 알림 상태 기록 주석이 포함됩니다. 대시보드 톱니 메뉴를 통해 **주석** 설정을 열고 `Annotations & Alerts (Built-in)`라는 쿼리를 수정하여 주석을 가져오고 그리지 않도록 할 수 있습니다.

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

**태그별 쿼리**

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

Grafana v8.1 이상 버전에서는 기존 태그의 미리 입력 기능도 지원하고 하나 이상의 태그를 제공합니다.

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

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

**기타 데이터 소스 쿼리**

주석 이벤트는 주석 쿼리를 사용하여 가져옵니다. 대시보드에 새 주석 쿼리를 추가하려면 대시보드 설정 메뉴를 열고 **주석**을 선택하세요. 그러면 대시보드 주석 설정 보기가 열립니다. 새 주석 쿼리를 생성하려면 **새로 만들기** 버튼을 누르세요.

주석 쿼리의 이름을 지정하세요. 이 이름은 토글(확인란)에 지정되며, 이를 통해 이 쿼리에서 주석 이벤트 표시를 활성화하거나 비활성화할 수 있습니다. 예를 들어 `Deploys` 및 `Outages`라는 두 개의 주석 쿼리가 있을 수 있습니다. 토글을 사용하면 표시할 주석을 결정할 수 있습니다.

**주석 쿼리 세부 정보**

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