기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
라벨 및 주석
이 설명서 항목은 Grafana 버전 9.x를 지원하는 Grafana 작업 영역을 위해 설계되었습니다.
Grafana 버전 10.x를 지원하는 Grafana 작업 영역에 대한 내용은 을 참조하십시오. Grafana 버전 10에서 작업하기
Grafana 버전 8.x를 지원하는 Grafana 작업 영역에 대한 내용은 을 참조하십시오. Grafana 버전 8에서 작업하기
레이블과 주석에는 알림에 대한 정보가 포함됩니다. 레이블과 주석은 이름이 지정된 값 집합이라는 동일한 구조를 갖지만 용도는 다릅니다. 레이블 또는 이에 상응하는 주석의 예가 될 수 있습니다. alertname="test"
레이블과 주석의 주요 차이점은 레이블은 경고를 다른 모든 경고와 구별하는 데 사용되는 반면 주석은 기존 알림에 추가 정보를 추가하는 데 사용된다는 것입니다.
예를 들어 CPU 사용량이 많은 경고 두 개를 고려해 보십시오. 하나는 에 대한 server1
경고이고 다른 하나는 server2
이 예제에서 첫 번째 경고에는 레이블이 server="server1"
있고 두 번째 경고에는 레이블이 server
있는 레이블이 있을 수 server="server2"
있습니다. 하지만 각 알림에 서버 이름 server1
및 75%
CPU 사용량 등의 "The CPU usage for server1 is above 75%."
설명을 추가할 수도 있습니다 (템플릿 라벨 및 주석예: 서버의 이름 및 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
사용자 지정 레이블과 마찬가지로 주석에도 이름이 있어야 하며 해당 값에는 알림이 발생할 때 평가되는 텍스트 및 템플릿 코드의 조합이 포함될 수 있습니다. 주석에 템플릿 코드가 포함된 경우 알림이 시작될 때 템플릿이 한 번 평가됩니다. 알림이 해결되더라도 재평가되지 않습니다. 주석을 템플릿으로 만드는 방법에 대한 설명서는 여기에서 찾을 수 있습니다.