本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
儀表板網址變數
本文件主題是針對支援 Grafana 10.x 版的 Grafana 工作區所設計。
如需支援 Grafana 9.x 版的 Grafana 工作區,請參閱。在 Grafana 第 9 版中工作
如需支援 Grafana 8.x 版的 Grafana 工作區,請參閱。在 Grafana 第 8 版中工作
Grafana 可以套用在儀表板網址中作為查詢參數傳遞的變數值。如需詳細資訊,請參閱管理儀表板連結和範本和變數。
傳遞變量作為查詢參數
Grafana 會var-
將前置詞為指定儀表板中的變數的查詢字串參數解譯。
例如,在此 URL 中:
https://${your-domain}/path/to/your/dashboard?var-example=value
query 參數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 可以將變數新增至儀表板連結。有關新增變數的詳細資訊和步驟,請參閱管理儀表板連結。
通過臨機操作過濾器
臨機操作篩選器會將索引鍵或值篩選器套用至使用指定資料來源的所有量度查詢。如需詳細資訊,請參閱臨機操作篩選器。
若要將臨機操作篩選器當做查詢參數傳遞,請使用變數語法傳遞 ad hoc 篩選器變數,並提供索引鍵、運算子做為值,以及以管道分隔清單的方式提供值。
例如,在此 URL 中:
https://${your-domain}/path/to/your/dashboard?var-adhoc=example_key|=|example_value
query 參數會使用example_key
金鑰、=
運算子和example_value
值var-adhoc=key|=|value
套用設定為 adhoc 儀表板變數的隨機篩選器。
注意
使用臨機操作篩選器共用 URL 時,請記得對 URL 進行編碼。在上面的例子中,用%7C
相等運算符(|
)替換管道(=
)%3D
。
使用 URL 控制時間範圍
若要設定儀表板的時間範圍,請使用from
to
、time
、和time.window
查詢參數。因為這些不是變數,所以不需要var-
前置字元。