알림 템플릿 참조
알림 템플릿 참조 (Template reference)
Grafana Alerting 알림 템플릿의 전체 참조 문서예요. 템플릿 데이터 모델과 사용 가능한 함수·파이프라인을 자세히 다룹니다. 알림 메시지를 세밀하게 커스터마이즈할 때 참조용으로 사용해요.
출처: 문서
본문
이 참조는 알림 템플릿에서 사용할 수 있는 데이터와 함수를 설명합니다. 템플릿은 Go 템플릿 언어를 기반으로 합니다.
템플릿 데이터
알림 템플릿에서 접근할 수 있는 주요 데이터 구조입니다.
| 필드 | 설명 |
|---|---|
.Receiver |
알림을 받는 연락 지점 이름. |
.Status |
알림 상태 (firing 또는 resolved). |
.Alerts |
알림 인스턴스 목록. |
.GroupLabels |
알림 그룹 라벨. |
.CommonLabels |
모든 알림에 공통인 라벨. |
.CommonAnnotations |
모든 알림에 공통인 주석. |
.ExternalURL |
Grafana 외부 URL. |
각 알림 인스턴스는 다음 필드를 제공합니다.
.Labels— 알림 라벨.Annotations— 알림 주석.Status— 인스턴스 상태.StartsAt— 알림 시작 시간.EndsAt— 알림 종료 시간.GeneratorURL— 생성기 URL
함수
Grafana 템플릿에서 사용하는 주요 함수는 다음과 같습니다.
| 함수 | 설명 |
|---|---|
title |
각 단어의 첫 글자를 대문자로. |
toUpper / toLower |
대문자/소문자 변환. |
trimSpace |
앞뒤 공백 제거. |
replace |
문자열 치환. |
match |
정규식 매칭. |
reReplaceAll |
정규식으로 모든 치환. |
humanize |
숫자를 사람이 읽기 쉬운 형식으로. |
humanizeDuration |
초를 기간으로 포매팅. |
humanizePercentage |
백분율 포매팅. |
printf |
형식화된 문자열. |
eq, ne, lt, gt, le, ge |
비교 연산. |
and, or, not |
논리 연산. |
add, sub, mul, div, mod |
산술 연산. |
first, last, join |
목록 처리. |
date |
날짜 포매팅. |
default |
값이 없을 때 기본값. |
파이프라인
Go 템플릿의 파이프라인(|)을 사용해 함수를 연결할 수 있습니다.
{{ .Alerts.Firing | len }} 건의 알림 발생