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

# 儀表板 URL 變數
<a name="v10-dash-dashboard-url-variables"></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)。

Grafana 可以在儀表板 URLs 中套用做為查詢參數傳遞的變數值。如需詳細資訊，請參閱[管理儀表板連結](v10-dash-manage-dashboard-links.md)和[範本和變數](v10-dash-variables.md)。

**將變數做為查詢參數傳遞**

Grafana 會將字首為 的查詢字串參數解譯`var-`為指定儀表板中的變數。

例如，在此 URL 中：

```
https://${your-domain}/path/to/your/dashboard?var-example=value
```

查詢參數`var-example=value`代表值為 的儀表板變數範例`value`。

**傳遞變數的多個值**

若要傳遞多個值，請為每個值重複變數參數一次。

```
https://${your-domain}/path/to/your/dashboard?var-example=value1&var-example=value2
```

Grafana 會解譯`var-example=value1&var-example=value2`為具有兩個值的儀表板變數範例： `value1`和 `value2`。

**將變數新增至儀表板連結**

當您從儀表板的設定產生變數時，Grafana 可以將變數新增至儀表板連結。如需新增變數的詳細資訊和步驟，請參閱[管理儀表板連結](v10-dash-manage-dashboard-links.md)。

**傳遞臨機操作篩選條件**

臨機操作篩選條件會將金鑰或值篩選條件套用至使用指定資料來源的所有指標查詢。如需詳細資訊，請參閱[臨機操作篩選條件](v10-dash-variable-add.md#v10-dash-variable-add-adhoc)。

若要傳遞臨機操作篩選條件做為查詢參數，請使用變數語法來傳遞臨機操作篩選條件變數，並提供金鑰、運算子做為值，以及值做為管道分隔清單。

例如，在此 URL 中：

`https://${your-domain}/path/to/your/dashboard?var-adhoc=example_key|=|example_value` 

查詢參數會使用 `example_key`金鑰、 `=`運算子和 `example_value`值，`var-adhoc=key|=|value`套用設定為臨機操作儀表板變數的臨機操作篩選條件。

**注意**  
與臨機操作篩選條件共用 URLs 時，請記得編碼 URL。在上述範例中，將管道 (`|`) 取代為 `%7C`，將等式運算子 (`=`) 取代為 `%3D`。

**使用 URL 控制時間範圍**

若要設定儀表板的時間範圍，請使用 `from`、`time`、 `to`和 `time.window`查詢參數。由於這些不是變數，因此不需要字`var-`首。