비주얼리제이션에 주석 달기 - Amazon Managed Grafana
패널에 주석 만들기대시보드 설정을 통해 주석을 가져오세요.내장 쿼리

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

비주얼리제이션에 주석 달기

이 설명서 항목은 Grafana 버전 10.x를 지원하는 Grafana 작업 영역을 위해 설계되었습니다.

Grafana 버전 9.x를 지원하는 Grafana 작업 영역에 대한 내용은 을 참조하십시오. Grafana 버전 9에서 작업하기

Grafana 버전 8.x를 지원하는 Grafana 작업 영역에 대한 내용은 을 참조하십시오. Grafana 버전 8에서 작업하기

주석을 사용하면 비주얼리제이션에 포인트를 리치 이벤트로 표시할 수 있습니다. 모든 그래프 패널에서 수직선과 아이콘으로 시각화됩니다. 주석을 마우스로 가리키면 이벤트 설명과 이벤트 태그를 볼 수 있습니다. 텍스트 필드에는 다른 시스템에 대한 자세한 내용이 포함된 링크가 포함될 수 있습니다.

다음과 같은 세 가지 방법으로 시각화에 주석을 달 수 있습니다.

처음 두 경우에는 새 주석을 만들고, 마지막 경우에는 데이터 소스에서 기존 주석을 쿼리합니다. 내장된 주석 쿼리도 이를 지원합니다.

이 섹션에서는 첫 번째 및 세 번째 옵션에 대해 설명합니다. Grafana HTTP API 사용에 대한 자세한 내용은 을 참조하십시오. 어노테이션 API

주석은 다음 시각화 유형에 지원됩니다.

  • 시계열

  • 상태 타임라인

  • 캔들스틱

패널에 주석 만들기

Grafana에는 모든 대시보드에 있는 내장 주석 쿼리를 사용하여 패널에서 직접 주석 이벤트를 추가할 수 있는 기능이 있습니다. 이러한 방식으로 생성한 주석은 Grafana에 저장됩니다.

패널에 직접 주석을 추가하려면:

  • 대시보드가 이미 저장되어 있어야 합니다.

  • 빌트인 쿼리를 활성화해야 합니다.

주석을 추가하려면

  1. 대시보드에서 주석을 추가할 패널을 선택합니다. 컨텍스트 메뉴가 나타납니다.

  2. 컨텍스트 메뉴에서 주석 추가를 선택합니다.

  3. (선택 사항) 주석 설명 및 태그를 추가합니다.

  4. 저장을 선택합니다.

또는 주석을 추가하려면 패널을 선택한 상태에서 Ctrl (또는Cmd) 를 누르면 주석 추가 팝오버가 나타납니다.

영역 주석

시각화에서 특정 지역 또는 기간을 포함하는 주석을 만들 수도 있습니다.

지역 주석을 추가하려면

  1. 대시보드에서 Ctrl (또는Cmd) 를 누른 상태에서 패널 영역을 선택합니다.

  2. 주석 설명 및 태그를 추가합니다 (선택 사항).

  3. 저장을 클릭합니다.

주석을 편집하려면

  1. 대시보드에서 패널의 주석 표시기 위로 마우스를 가져갑니다.

  2. 주석 툴팁에서 편집 (연필) 아이콘을 선택합니다.

  3. 설명 및/또는 태그를 수정합니다.

  4. 저장을 선택합니다.

주석을 삭제하려면

  1. 대시보드에서 패널의 주석 표시기 위에 마우스를 갖다 댑니다.

  2. 주석 툴팁에서 삭제 (휴지통) 아이콘을 선택합니다.

대시보드 설정을 통해 주석을 가져오세요.

대시보드 설정의 주석에서 기본 제공 데이터 주석 데이터 소스를 비롯한 모든 데이터 소스를 사용하여 주석을 가져오는 새 쿼리를 추가할 수 있습니다. 주석 쿼리는 대시보드의 그래프에서 이벤트 마커로 시각화할 수 있는 이벤트를 반환합니다.

새 주석 쿼리를 추가하려면

  1. 대시보드 헤더에서 설정 (기어) 아이콘을 선택하여 설정 메뉴를 엽니다.

  2. 주석을 선택합니다.

  3. 주석 쿼리 추가를 클릭합니다.

  4. 주석 쿼리의 이름을 입력합니다.

    이 이름은 이 쿼리의 주석 이벤트를 표시할 수 있는 토글 (확인란) 에 지정됩니다.

  5. 주석의 데이터 소스를 선택합니다.

    고급 데이터 원본 선택기 열기를 선택하여 새 데이터 원본 추가 (관리자만 사용 가능) 를 비롯한 추가 옵션을 볼 수도 있습니다.

  6. 주석 쿼리를 바로 사용하지 않으려면 활성화됨 확인란의 선택을 취소하세요.

  7. 대시보드에 주석 쿼리 토글이 표시되지 않도록 하려면 숨김 확인란을 선택합니다.

  8. 이벤트 마커의 색상을 선택합니다.

  9. 표시 위치 드롭다운에서 다음 옵션 중 하나를 선택합니다.

    • 모든 패널 - 주석을 지원하는 모든 패널에 주석이 표시됩니다.

    • 선택한 패널 — 선택한 모든 패널에 주석이 표시됩니다.

    • 제외한 모든 패널 - 선택한 패널을 제외한 모든 패널에 주석이 표시됩니다.

  10. 쿼리를 구성합니다.

    주석 쿼리 옵션은 데이터 소스마다 다릅니다. 특정 데이터 원본의 주석에 대한 자세한 내용은 을 참조하십시오. 데이터 원본에 연결

내장 쿼리

주석을 추가한 후에도 주석은 계속 표시됩니다. 이는 모든 대시보드에 내장된 주석 쿼리가 있기 때문입니다. 이 주석 쿼리는 Grafana에 저장된 현재 대시보드에서 발생하는 모든 주석 이벤트를 가져와서 생성된 패널에 표시합니다. 여기에는 알림 상태 기록 주석이 포함됩니다.

기본적으로 기본 제공 주석 쿼리는 Grafana 특수 데이터 소스를 사용하며 수동 주석은 이 데이터 소스를 사용하는 경우에만 지원됩니다. 기본 제공 주석 쿼리에서 다른 데이터 원본을 사용할 수 있지만 해당 데이터 원본의 쿼리 편집기를 사용해서만 자동 주석을 만들 수 있습니다.

대시보드에 직접 주석을 추가하려면 이 쿼리를 활성화해야 합니다.

기본 제공 쿼리가 활성화되었는지 확인하려면

  1. 대시보드 헤더에서 대시보드 설정 (기어) 아이콘을 선택하여 대시보드 설정 메뉴를 엽니다.

  2. 주석을 선택합니다.

  3. 주석 및 알림 (내장) 쿼리를 찾습니다.

    쿼리 이름 앞에 비활성화됨이 표시되면 쿼리 이름을 선택하여 열고 설정을 업데이트해야 합니다.

주석을 가져오고 그리는 것을 중지하려면

  1. 대시보드 헤더에서 대시보드 설정 (기어) 아이콘을 선택하여 대시보드 설정 메뉴를 엽니다.

  2. 주석을 선택합니다.

  3. 주석 및 알림 (내장) 쿼리를 선택합니다.

  4. 활성화됨 토글을 선택하여 끄십시오.

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

태그별 쿼리 필터링

필터 기준을 로 설정하면 Grafana 데이터 소스를 사용하여 기본 제공 주석 쿼리에서 주석을 가져오는 새 쿼리를 만들 수 있습니다. Tags

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

태그 쿼리에서 템플릿 변수를 사용할 수도 있습니다. 즉, 다양한 서비스에 대한 통계를 표시하는 대시보드와 표시할 서비스를 지정하는 템플릿 변수가 있는 경우 주석 쿼리에 동일한 템플릿 변수를 사용하여 해당 서비스에 대한 주석만 표시할 수 있습니다.