템플릿 참조

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

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

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

이 섹션에서는 템플릿 생성을 위한 참조 정보를 제공합니다.

템플릿 데이터

다음 데이터가 메시지 템플릿에 전달됩니다.

명칭	유형	참고
Receiver	문자열	알림이 전송되는 연락처의 이름.
Status	문자열	하나 이상의 경고가 발생하면 실행되며, 그렇지 않으면 해결됩니다.
Alerts	Alert	이 알림에 포함된 경고 개체 목록 (아래 참조).
GroupLabels	KeyValue	이러한 경고를 그룹화한 레이블입니다.
CommonLabels	KeyValue	이 알림에 포함된 모든 알림에 공통적인 레이블입니다.
CommonAnnotations	KeyValue	이 알림에 포함된 모든 경고에 공통적인 주석입니다.
ExternalURL	문자열	알림을 보낸 Grafana로 돌아가는 링크입니다. 외부 경보 관리자를 사용하는 경우 이 경보 관리자로 다시 연결하세요.

이 Alerts 유형은 반환된 경고를 필터링하는 두 가지 함수를 제공합니다.

• Alerts.Firing— 발생 경고 목록을 반환합니다.

• Alerts.Resolved— 해결된 알림 목록을 반환합니다.

알림 (유형)

경고 유형에는 다음 데이터가 포함됩니다.

명칭	유형	참고
상태 표시기	문자열	firing 또는 resolved
레이블	KeyValue	알림에 첨부된 레이블 세트.
주석	KeyValue	알림에 첨부된 주석 세트.
값	KeyValue	클래식 조건을 포함한 모든 표현식의 값
StartsAt	시간. 시간	알림이 시작되기 시작한 시간입니다.
EndsAt	시간. 시간	알림 종료 시간을 알고 있는 경우에만 설정합니다. 그렇지 않으면 마지막 알림을 받은 이후부터 구성 가능한 타임아웃 기간으로 설정하십시오.
생성기 URL	문자열	Grafana 또는 외부 경보 관리자로 연결되는 백 링크입니다.
사일런스 URL	문자열	알림을 무음으로 설정하는 링크 (이 알림의 레이블이 미리 입력되어 있음). Grafana 관리형 알림에만 해당됩니다.
대시보드 URL	문자열	알림 규칙이 Grafana 대시보드에 속하는 경우 Grafana 대시보드에 연결합니다. Grafana 관리형 알림에만 해당됩니다.
패널 URL	문자열	경고 규칙이 패널에 속하는 경우 grafana 대시보드 패널에 연결합니다. Grafana 관리형 알림에만 해당됩니다.
지문	문자열	알림을 식별하는 데 사용할 수 있는 지문.
ValueString	문자열	알림에서 축소된 각 표현식의 레이블과 값을 포함하는 문자열입니다.

ExtendedData

ExtendedData 개체에는 다음과 같은 속성이 있습니다.

명칭	Kind	설명	예
수신기	string	알림을 보내는 연락처의 이름.	{{ .Receiver }}
상태 표시기	string	상태는 다음과 같습니다. firing if at least one alert is firing, otherwise resolved.	{{ .Status }}
알림	[]Alert	이 알림의 모든 발생 및 해결된 알림 목록.	There are {{ len .Alerts }} alerts
경고 발생	[]Alert	이 알림의 모든 발생 경보 목록.	There are {{ len .Alerts.Firing }} firing alerts
해결된 알림	[]Alert	이 알림의 해결된 모든 알림 목록.	There are {{ len .Alerts.Resolved }} resolved alerts
GroupLabels	KeyValue	이러한 알림을 이 알림으로 그룹화하는 레이블.	{{ .GroupLabels }}
CommonLabels	KeyValue	이 알림의 모든 알림에 공통되는 레이블입니다.	{{ .CommonLabels }}
CommonAnnotations	KeyValue	이 알림의 모든 경고에 공통적인 주석입니다.	{{ .CommonAnnotations }}
외부 URL	string	이 알림을 보낸 Grafana 작업 영역 또는 경고 관리자로 연결되는 링크입니다.	{{ .ExternalURL }}

KeyValue 다음을 입력합니다.

KeyValue유형은 레이블과 주석을 나타내는 키/값 문자열 쌍의 집합입니다.

a로 저장된 데이터에 직접 액세스할 수 있을 뿐만 아니라 데이터를 정렬KeyValue, 제거 및 변환하는 방법도 있습니다.

명칭	인수	반환 값	참고	예
SortedPairs		키 및 값 문자열 쌍의 정렬된 목록		{{ .Annotations.SortedPairs }}
Remove	[] 문자열	KeyValue	지정된 키가 없는 키/값 맵의 사본을 반환합니다.	{{ .Annotations.Remove "summary" }}
이름		[] 문자열	라벨 이름 목록	{{ .Names }}
값		[] 문자열	라벨 값 목록	{{ .Values }}

Time

시간은 Go time패키지에서 가져온 것입니다. 시간을 다양한 형식으로 인쇄할 수 있습니다. 예를 들어 알림이 발생한 시간을 해당 형식으로 Monday, 1st January 2022 at 10:00AM 인쇄하려면 다음 템플릿을 작성합니다.

{{ .StartsAt.Format "Monday, 2 January 2006 at 3:04PM" }}

Go의 시간 형식에 대한 참조는 여기에서 찾을 수 있습니다.

템플릿 함수

템플릿 함수를 사용하면 라벨과 주석을 처리하여 동적 알림을 생성할 수 있습니다. 다음 기능을 사용할 수 있습니다.

명칭	인수 유형	반환 타입	설명
humanize	숫자 또는 문자열	문자열	지표 접두사를 사용하여 숫자를 더 읽기 쉬운 형식으로 변환합니다.
humanize1024	숫자 또는 문자열	문자열	휴머나이즈와 비슷하지만 1000이 아닌 1024를 기본으로 사용합니다.
humanizeDuration	숫자 또는 문자열	문자열	지속 시간 (초) 을 더 읽기 쉬운 형식으로 변환합니다.
humanizePercentage	숫자 또는 문자열	문자열	비율 값을 100의 몇 분의 1로 변환합니다.
humanizeTimestamp	숫자 또는 문자열	문자열	Unix 타임스탬프 (초) 를 더 읽기 쉬운 형식으로 변환합니다.
title	문자열	문자열	Strings.title은 각 단어의 첫 문자를 대문자로 표시합니다.
toUpper	문자열	문자열	문자열. ToUpper, 모든 문자를 대문자로 변환합니다.
toLower	문자열	문자열	문자열. ToLower, 모든 문자를 소문자로 변환합니다.
match	패턴, 텍스트	불	정규 표현식. MatchString 고정되지 않은 정규 표현식 일치를 테스트합니다.
reReplaceAll	패턴, 대체, 텍스트	문자열	정규 표현식. ReplaceAllString 정규 표현식 대체, 고정되지 않음.
graphLink	문자열 - 및 필드가 있는 JSON 객체 expr datasource	문자열	지정된 표현식과 데이터 원본에 대한 Explore의 그래픽 뷰 경로를 반환합니다.
tableLink	문자열 - expr 및 datasource 필드가 있는 JSON 개체	문자열	지정된 표현식과 데이터 원본에 대한 Explore의 표 형식 보기 경로를 반환합니다.
args	[] 인터페이스 {}	맵 [문자열] 인터페이스 {}	객체 목록을 키가 있는 맵으로 변환합니다 (예: arg0, arg1). 이 함수를 사용하여 템플릿에 여러 인수를 전달할 수 있습니다.
externalURL	아무것도 없어	문자열	외부 URL을 나타내는 문자열을 반환합니다.
pathPrefix	아무것도 없어	문자열	외부 URL의 경로를 반환합니다.

다음 표는 각 함수를 사용하는 예를 보여줍니다.

함수	TemplateString	Input	예상
인간화	{$value를 인간화하세요}	1234567.0	1.235M
휴머나이즈1024	{1024 달러 가치의 인간화}	1048576.0	1Mi
휴머나이즈 듀레이션	{휴머나이즈 듀레이션 $value}	899.99	14분 59초
퍼센트를 인간화하세요	{퍼센트 $값 인간화}	0.1234567	12.35%
휴머나이즈 타임스탬프	{타임스탬프 $value 인간화}	1435065584.128	2015-06-23 13:19:44.128 +0000 UTC
title	{$value | 제목}	a b B C	Aa Bb Cc
toUpper	{$value | Toupper}	Aa Bb C	A B B C
toLower	{$value | Tolower}	Aa Bb C	a b b c
일치	{매칭 “a+” $labels.instance}	aa	true
reReplaceAll	{{ reReplaceAll “localhost :( .*)” “my.domain: $1" $labels.instance}}	로컬 호스트: 3000	내 도메인: 3000
그래프 링크	{{그래프링크 “{\" expr\”:\ "up\”,\ "data source\”:\ "gdev-prometheus\"}”}		/익스플로어? 왼쪽= ["now-1h”, “now”, “gdev-prometheus”, {"data source”: “gdev-prometheus”, “expr”: “up”, “instant”: false, “range”: true}]
테이블 링크	{{테이블링크 “{\" expr\”:\ "up\”,\ "data source\”:\ "gdev-prometheus\"}”}		/익스플로어? 왼쪽= ["now-1h”, “now”, “gdev-prometheus”, {"data source”: “gdev-prometheus”, “expr”: “up”, “instant”: true, “range”: false}]
args	{{define “x”}} {{.arg0}} {{.arg1}} {{end}} {{템플릿 “x” (args 1 “2")}}		1 2 2
외부 URL	{외부 URL}		http://localhost/path/prefix
경로 접두사	{경로 접두사}		/경로/접두사