本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 範本參考
<a name="v10-alerting-template-reference"></a>

****  
本文件主題專為支援 Grafana **10.x 版的 Grafana** 工作區而設計。  
如需支援 Grafana 9.x 版的 Grafana 工作區，請參閱 [使用 Grafana 第 9 版](using-grafana-v9.md)。  
如需支援 Grafana 8.x 版的 Grafana 工作區，請參閱 [使用 Grafana 第 8 版](using-grafana-v8.md)。

本節提供建立範本的參考資訊。

**提醒 （類型）**

提醒類型包含下列資料。


| 名稱 | Kind | Description | 範例 | 
| --- | --- | --- | --- | 
|  狀態  |  string  |  `firing` 或 `resolved`  | \$1\$1 .Status \$1\$1 | 
|  標籤  |  KeyValue  |  連接到提醒的一組標籤。  | \$1\$1 .Labels \$1\$1 | 
|  註釋  |  KeyValue  |  附加到提醒的一組註釋。  | \$1\$1 .Annotations \$1\$1 | 
| 值 | KeyValue | 所有表達式的值，包括傳統條件 | \$1\$1 .Values \$1\$1 | 
|  StartsAt  |  time.Time  |  警示開始觸發的時間。  | \$1\$1 .StartsAt \$1\$1 | 
|  EndsAt  |  time.Time  |  只有在已知警示的結束時間時才設定。否則，請設定為自上次收到提醒以來的可設定逾時期間。  | \$1\$1 .EndsAt \$1\$1 | 
|  GeneratorURL  |  string  |  Grafana 或外部 Alertmanager 的後退連結。  | \$1\$1 .GeneratorURL \$1\$1 | 
|  SilenceURL  |  string  |  提醒靜音的連結 （已預先填入此提醒的標籤）。僅適用於 Grafana 受管提醒。  | \$1\$1 .SilenceURL\$1\$1 | 
|  DashboardURL  |  string  |  如果警示規則屬於一個，則連結至 grafana 儀表板。僅適用於 Grafana 受管提醒。  | \$1\$1 .DashboardURL \$1\$1 | 
|  PanelURL  |  string  |  如果警示規則屬於一個，則連結至 grafana 儀表板面板。僅適用於 Grafana 受管提醒。  | \$1\$1 .PanelURL \$1\$1 | 
|  指紋  |  string  |  可用來識別提醒的指紋。  | \$1\$1 .Fingerprint \$1\$1 | 
|  ValueString  |  string  |  字串，其中包含提醒中每個減少表達式的標籤和值。  | \$1\$1 .ValueString \$1\$1 | 

 **ExtendedData**

ExtendedData 物件包含下列屬性。


| 名稱 | Kind | Description | 範例 | 
| --- | --- | --- | --- | 
|  接收者  |  `string`  |  傳送通知的聯絡點名稱。  |  `{{ .Receiver }}`  | 
|  狀態  |  `string`  |  `firing` 如果至少一個提醒正在觸發，則狀態為 ，否則為 `resolved`。  |  `{{ .Status }}`  | 
|  Alerts (提醒)  |  `[]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 }}` | 
|  移除  |  【】字串  |  KeyValue  |  傳回不含指定金鑰的金鑰/值映射複本。  | `{{ .Annotations.Remove "summary" }}` | 
|  名稱  |    |  【】字串  |  名稱清單  | `{{ .Names }}` | 
|  值  |    |  【】字串  |  值清單  | `{{ .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 時間格式的參考。