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

# 新增和管理儀表板變數
<a name="v9-dash-variables"></a>

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

變數是值的預留位置。您可以在指標查詢和面板標題中使用變數。因此，當您使用儀表板頂端的下拉式清單變更值時，面板的指標查詢將會變更以反映新值。

變數可讓您建立更具互動性和動態的儀表板。您可以在指標查詢中使用變數，而不是硬式編碼，例如伺服器、應用程式和感應器名稱。變數會顯示為儀表板頂端的下拉式清單。這些下拉式清單可讓您輕鬆變更儀表板中顯示的資料。

對於想要允許 Grafana 檢視器快速調整視覺效果，但不想提供完整編輯許可的管理員來說，這些功能特別有用。Grafana 檢視器可以使用變數。

變數和範本也可讓您使用單一來源儀表板。如果您有多個相同的資料來源或伺服器，您可以建立一個儀表板，並使用變數來變更您正在檢視的內容。這可簡化維護並大量維護。

**範本**

範本是包含變數的任何查詢。例如，如果您管理儀表板來監控多個伺服器，您可以為每個伺服器建立儀表板，或者您可以建立一個儀表板，並使用面板搭配範本查詢，如下所示。

```
wmi_system_threads{instance=~"$server"}
```

變數值一律使用語法 var-<varname>=value 同步至 URL。

**範例**

變數會在畫面頂端的下拉式清單中列出。選取不同的變數，以查看視覺效果如何變更。

若要查看變數設定，請導覽至**儀表板設定 > 變數**。按一下清單中的變數以查看其設定。


變數可用於標題、描述、文字面板和查詢。開頭為 的文字查詢`$`是 範本。並非所有面板都會有範本查詢。

**變數最佳實務**
+ 變數下拉式清單會依其在**儀表板設定**中的變數清單中列出的順序顯示。
+ 將您經常變更的變數放在頂端，以便先顯示變數 （儀表板上最左邊）。