

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# 템플릿 참조
<a name="v12-alerting-template-reference"></a>

****  
이 설명서 주제는 Grafana **버전 12.x를 지원하는 Grafana** 워크스페이스를 위해 설계되었습니다.  
Grafana 버전 10.x를 지원하는 Grafana 워크스페이스는 [Grafana 버전 10에서 작업](using-grafana-v10.md) 섹션을 참조하세요.  
Grafana 버전 9.x를 지원하는 Grafana 워크스페이스는 [Grafana 버전 9에서 작업](using-grafana-v9.md) 섹션을 참조하세요.  
Grafana 버전 8.x를 지원하는 Grafana 워크스페이스의 경우 [Grafana 버전 8에서 작업](using-grafana-v8.md) 섹션을 참조하세요.

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

**알림(유형)**

알림 유형에는 다음 데이터가 포함됩니다.


| 이름 | 종류 | 설명 | 예제 | 
| --- | --- | --- | --- | 
| Status | 문자열 | `firing` 또는 `resolved` | {{ .Status }} | 
| 레이블 | KeyValue | 알림에 연결된 레이블 세트. | {{ .Labels }} | 
| Annotations | KeyValue | 알림에 연결된 주석 세트. | {{ .Annotations }} | 
| 값 | KeyValue | 클래식 조건을 포함한 모든 표현식의 값 | {{ .Values }} | 
| StartsAt | time.Time | 알림 실행이 시작되는 시간. | {{ .StartsAt }} | 
| EndsAt | time.Time | 알림의 종료 시간을 알고 있는 경우에만 설정합니다. 그렇지 않으면 마지막 알림이 수신된 이후부터 구성 가능한 제한 시간으로 설정됩니다. | {{ .EndsAt }} | 
| GeneratorURL | 문자열 | Grafana 또는 외부 Alertmanager에 대한 백 링크. | {{ .GeneratorURL }} | 
| SilenceURL | 문자열 | 알림을 음소거하는 링크(이 알림에 대한 레이블이 미리 채워짐). Grafana 관리형 알림에만 적용됩니다. | {{ .SilenceURL}} | 
| DashboardURL | 문자열 | 알림 규칙이 하나에 속하는 경우 Grafana 대시보드에 대한 링크. Grafana 관리형 알림에만 적용됩니다. | {{ .DashboardURL }} | 
| PanelURL | 문자열 | 알림 규칙이 하나에 속하는 경우 Grafana 대시보드 패널에 대한 링크. Grafana 관리형 알림에만 적용됩니다. | {{ .PanelURL }} | 
| 지문 | 문자열 | 알림을 식별하는 데 사용할 수 있는 지문. | {{ .Fingerprint }} | 
| ValueString | 문자열 | 알림에서 축소된 각 표현식의 레이블과 값을 포함하는 문자열. | {{ .ValueString }} | 

 **ExtendedData**

ExtendedData 객체는 다음 속성을 포함합니다.


| 이름 | 종류 | 설명 | 예제 | 
| --- | --- | --- | --- | 
| 수신기 | `string` | 알림을 보내는 연락 지점의 이름. | `{{ .Receiver }}` | 
| Status | `string` | 상태는 하나 이상의 알림이 실행 중인 경우 `firing`이고, 그렇지 않으면 `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 }}` | 
| ExternalURL | `string` | 이 알림을 보낸 Grafana 워크스페이스 또는 Alertmanager에 대한 링크. | `{{ .ExternalURL }}` | 

**KeyValue 유형**

`KeyValue` 유형은 레이블과 주석을 나타내는 키/값 문자열 페어 세트입니다.

`KeyValue`로 저장된 데이터에 대한 직접 액세스 외에도 데이터를 정렬, 제거 및 변환하는 방법도 있습니다.


| 이름 | 인수 | 반환 | 참고 | 예제 | 
| --- | --- | --- | --- | --- | 
| SortedPairs |  | 키 및 값 문자열 페어의 정렬된 목록 |  | `{{ .Annotations.SortedPairs }}` | 
| 제거 | []string | KeyValue | 지정된 키 없이 키/값 맵의 사본을 반환합니다. | `{{ .Annotations.Remove "summary" }}` | 
| 이름 |  | []string | 이름 목록 | `{{ .Names }}` | 
| 값 |  | []string | 값 목록 | `{{ .Values }}` | 

**Time**

시간은 Go [https://pkg.go.dev/time#Time](https://pkg.go.dev/time#Time) 패키지에서 가져옵니다. 여러 형식으로 시간을 인쇄할 수 있습니다. 예를 들어, `Monday, 1st January 2022 at 10:00AM` 형식으로 알림이 실행된 시간을 인쇄하려면 다음 템플릿을 작성합니다.

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

[여기](https://pkg.go.dev/time#pkg-constants)에서 Go의 시간 형식에 대한 참조를 찾을 수 있습니다.