레이블 및 주석 - Amazon Managed Grafana

레이블 및 주석

이 설명서 주제는 Grafana 버전 9.x를 지원하는 Grafana 워크스페이스를 위해 설계되었습니다.

Grafana 버전 10.x를 지원하는 Grafana 워크스페이스의 경우 Grafana 버전 10에서 작업 섹션을 참조하세요.

Grafana 버전 8.x를 지원하는 Grafana 워크스페이스의 경우 Grafana 버전 8에서 작업 섹션을 참조하세요.

레이블 및 주석에는 알림에 대한 정보가 포함되어 있습니다. 레이블 및 주석은 모두 이름이 지정된 값 세트라는 동일한 구조를 사용하지만, 용도는 다릅니다. 레이블 또는 이와 동등한 주석의 예로 alertname="test"가 있습니다.

레이블 및 주석의 주요 차이는 레이블은 알림을 다른 모든 알림과 구분하는 데 사용되는 반면 주석은 기존 알림에 추가 정보를 추가하는 데 사용된다는 점입니다.

예를 들어 두 개의 높은 CPU 알림이 있습니다. server1에 대한 알림과 server2에 대한 알림입니다. 이 예제에서는 server라는 레이블을 사용합니다. 첫 번째 알림의 레이블은 server="server1"이고 두 번째 알림의 레이블은 server="server2"입니다. 그러나 "The CPU usage for server1 is above 75%."와 같이 각 알림에 대한 설명을 추가할 수 있습니다. 여기서 server175%는 서버의 이름 및 CPU 사용량으로 대체됩니다(이 방법을 알아보려면 레이블 및 주석 템플릿 지정의 설명서 참조). 이러한 종류의 설명은 주석으로 더 적합합니다.

레이블

레이블에는 알림을 식별하는 정보가 포함되어 있습니다. 레이블의 예로 server=server1이 있습니다. 각 알림에는 둘 이상의 레이블이 있을 수 있으며, 알림에 대한 전체 레이블 세트를 레이블 세트라고 합니다. 알림을 식별하는 레이블 세트입니다.

예를 들어 알림에 레이블 세트 {alertname="High CPU usage",server="server1"}이 있고, 다른 알림에 레이블 세트 {alertname="High CPU usage",server="server2"}가 있을 수 있습니다. alertname 레이블은 동일하지만 server 레이블은 다르기 때문에 이는 두 개의 개별 알림입니다.

알림에 대한 레이블 세트는 데이터 소스의 레이블, 알림 규칙의 사용자 지정 레이블 및 alertname과 같은 여러 예약 레이블의 조합입니다.

사용자 지정 레이블

사용자 지정 레이블은 알림 규칙의 추가 레이블입니다. 주석과 마찬가지로 사용자 지정 레이블에는 이름이 있어야 하며, 해당 값에는 알림이 실행될 때 평가되는 텍스트와 템플릿 코드의 조합이 포함될 수 있습니다. 사용자 지정 레이블을 템플릿으로 지정하는 방법에 대한 설명서는 여기에서 확인할 수 있습니다.

템플릿과 함께 사용자 지정 레이블을 사용하는 경우 알림 규칙의 연속 평가 사이에서 레이블 값이 변경되지 않도록 하는 것이 중요합니다. 변경될 경우 많은 수의 고유한 알림이 생성되기 때문입니다. 그러나 템플릿이 다른 알림에 대해 다른 레이블 값을 생성하는 것은 괜찮습니다. 예를 들어 사용자 지정 레이블에 쿼리 값을 넣지 마세요. 그러면 값이 변경될 때마다 새 알림 세트가 생성됩니다. 대신 주석을 사용합니다.

또한 알림에 대한 레이블 세트에 이름이 같은 레이블이 둘 이상 없는지 확인하는 것도 중요합니다. 사용자 지정 레이블의 이름이 데이터 소스의 레이블과 동일한 경우 해당 레이블을 대체합니다. 그러나 사용자 지정 레이블의 이름이 예약 레이블과 동일한 경우 사용자 지정 레이블은 알림에서 생략됩니다.

주석

주석은 기존 알림에 추가 정보를 추가하는 이름 지정된 페어입니다. Grafana에는 description, summary, runbook_url, dashboardUId, panelId와 같은 여러 추천 주석이 있습니다. 사용자 지정 레이블과 마찬가지로 주석에는 이름이 있어야 하며, 해당 값에는 알림이 실행될 때 평가되는 텍스트와 템플릿 코드의 조합이 포함될 수 있습니다. 주석에 템플릿 코드가 포함된 경우 알림이 실행되면 템플릿이 한 번 평가됩니다. 알림이 해결되더라도 재평가되지 않습니다. 주석을 템플릿으로 지정하는 방법에 대한 설명서는 여기에서 확인할 수 있습니다.