本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
標籤和註釋
本文件主題是針對支援 Grafana 10.x 版的 Grafana 工作區所設計。
如需支援 Grafana 9.x 版的 Grafana 工作區,請參閱。在 Grafana 第 9 版中工作
如需支援 Grafana 8.x 版的 Grafana 工作區,請參閱。在 Grafana 第 8 版中工作
標籤和註釋包含警示的相關資訊。標籤和註釋具有相同的結構:一組具名值;但它們的預期用途不同。標籤或對等註釋的範例可能是alertname="test"
。
標籤和註釋之間的主要差異在於,標籤用於區分警示與所有其他警示,而註釋則用於將其他資訊新增至現有警示。
例如,考慮兩個 CPU 高警示:一個用於server1
,另一個用於server2
. 在這樣的例子中,我們可能有一個標籤稱為,server
其中第一個警報具有標籤server="server1"
,第二個警報具有標籤server="server2"
。但是,我們可能還想要為每個警報添加描述,例如"The CPU usage for server1 is above 75%."
,位置server1
和75%
被服務器的名稱和 CPU 使用率替換(請參閱有關如何執行範本化標籤和註釋此操作的文檔)。這種描述將更適合作為註釋。
標籤
標籤包含識別警示的資訊。標籤的一個例子可能是server=server1
。每個警示可以有多個標籤,而警示的完整標籤集稱為其標籤集。識別警示的正是此標籤集。
例如,警示可能已設定標籤,{alertname="High CPU usage",server="server1"}
而另一則警示可能已設定標籤{alertname="High CPU usage",server="server2"}
。這是兩個獨立的警示,因為雖然它們的alertname
標籤相同,但它們的server
標籤是不同的。
警示的標籤集是資料來源中的標籤、警示規則中的自訂標籤,以及一些保留標籤 (例如) 的組合。alertname
自訂標籤
自訂標籤是警示規則中的其他標籤。與註釋一樣,自訂標籤必須具有名稱,而且其值可以包含文字和範本程式碼的組合,這些程式碼會在觸發警示時進行評估。有關如何模板自定義標籤的文檔可以在這裡找到。
將自訂標籤與範本搭配使用時,請務必確定標籤值在警示規則的連續評估之間不會變更,因為這樣會建立大量不同的警示。但是,樣板可以為不同的警示產生不同的標籤值。例如,請勿將查詢的值放在自訂標籤中,因為每次值變更時,最終都會建立一組新的警示。而是使用註釋。
同樣重要的是要確定警示設定的標籤沒有兩個或多個具有相同名稱的標籤。如果自定義標籤與數據源中的標籤具有相同的名稱,則它將替換該標籤。但是,如果自定義標籤與保留標籤具有相同的名稱,則自定義標籤將從警報中省略。
註釋
註釋是具名配對,可將其他資訊新增至現有警示。Grafana 中有許多建議的註解,例如description
、summary
runbook_url
、dashboardUId
和。panelId
與自訂標籤一樣,註解必須具有名稱,且其值可以包含文字和範本程式碼的組合,這些程式碼會在引發警示時進行評估。如果註解包含樣板代碼,則會在觸發警示時評估樣板一次。即使已解決警示,也不會重新評估。有關如何模板註釋的文檔可以在這裡找到。