本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
Variables
本文件主題是針對支援 Grafana 10.x 版的 Grafana 工作區所設計。
如需支援 Grafana 9.x 版的 Grafana 工作區,請參閱。在 Grafana 第 9 版中工作
如需支援 Grafana 8.x 版的 Grafana 工作區,請參閱。在 Grafana 第 8 版中工作
變數是值的預留位置。您可以在量度查詢和面板標題中使用變數。因此,當您使用儀表板頂部的下拉式清單變更值時,面板的度量查詢將會變更以反映新值。
變數可讓您建立更具互動性和動態的儀表板。您可以在指標查詢中使用變量,而不是對服務器,應用程序和傳感器名稱等硬編碼內容。變數會在儀表板頂端顯示為下拉式清單。這些下拉式清單可讓您輕鬆變更顯示在儀表板中的資料。
對於希望允許 Grafana 檢視器快速調整視覺效果但不想授予完整編輯權限的管理員而言,這些功能特別有用。Grafana 觀眾可以使用變量.
變數和範本也可讓您使用單一來源儀表板。如果您有多個相同的資料來源或伺服器,則可以建立一個儀表板,並使用變數來變更正在檢視的內容。這大大簡化了維護和保養。
範本
範本是包含變數的任何查詢。例如,如果您要管理儀表板來監視多個伺服器,您可以為每個伺服器建立一個儀表板,或者您可以建立一個儀表板並將面板與範本查詢搭配使用,例如下所示。
wmi_system_threads{instance=~"$server"}
變量值始終使用語法同步到 URL 變量 = 值<varname>。
範例
變量列在屏幕頂部的下拉列表中。選取不同的變數以查看視覺效果如何變更。
若要查看變數設定,請瀏覽至儀表板設定 > 變數。按一下清單中的變數以查看其設定。
變數可用於標題、說明、文字面板和查詢。開頭為文字的查詢$
為範本。並非所有面板都會有範本查詢。
變數最佳做法
-
變數下拉式清單會依照在 [儀表板] 設定中變數清單中列出的順序顯示。
-
將您經常更改的變量放在頂部,以便首先顯示它們(儀表板上最左側)。
-
根據預設,變數會在下拉式清單中預先選取最上方的值。如果您要改為選擇空值,請變更變數設定,如下所示:
-
選取「包含全部選項」核取方塊。
-
在「自訂所有值」欄位中,輸入值
+
。
-