알림 규칙 템플릿 참조
알림 규칙 템플릿 참조 (Template reference)
알림 규칙에서 사용하는 템플릿의 참조 문서예요. 알림 규칙의 라벨, 주석, 그리고 쿼리·표현식 값($values, $labels)을 템플릿으로 표현하는 방법을 자세히 다룹니다. 알림 메시지에 쿼리 결과를 동적으로 넣을 때 유용합니다.
출처: 문서
본문
알림 규칙 템플릿은 알림 규칙의 라벨과 주석을 커스터마이즈하는 데 사용됩니다. 템플릿에는 쿼리에서 반환된 데이터를 참조하는 특별한 변수가 있습니다.
템플릿 변수
알림 규칙 템플릿에서 사용할 수 있는 주요 변수입니다.
| 변수 | 설명 |
|---|---|
$labels |
쿼리에서 반환된 라벨. 예: {{ $labels.instance }}. |
$values |
쿼리·표현식의 평가 값. 예: {{ $values.B.value }}. |
$value |
알림 조건 값. |
$values는 표현식의 각 알파벳 키(A, B, C 등)로 접근합니다.
값 접근
각 값은 다음 속성을 가집니다.
.value— 실제 계산된 값.labels— 값과 연결된 라벨
예:
{{ $values.B.value }}
문자열 연산
{{ }} 안에서 다음과 같은 연산을 할 수 있습니다.
- 문자열 결합:
{{ $labels.env }}-{{ $labels.app }} - 함수 호출:
{{ humanize $values.A.value }}
주석에서의 사용
주석(annotation)에서 템플릿을 사용해 설명을 동적으로 생성할 수 있습니다.
description: "{{ $labels.instance }} CPU 사용률이 {{ $values.B.value }}% 초과"