翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
ダッシュボード URL 変数
このドキュメントのトピックは、Grafana バージョン 9.x をサポートする Grafana ワークスペース向けです。
Grafana バージョン 12.x をサポートする Grafana ワークスペースについては、「」を参照してくださいGrafana バージョン 12 での作業。
Grafana バージョン 10.x をサポートする Grafana ワークスペースについては、「Grafana バージョン 10 での作業」を参照してください。
Grafana バージョン 8.x をサポートする Grafana ワークスペースについては、「Grafana バージョン 8 での作業」を参照してください。
Grafana は、ダッシュボード URL でクエリパラメータとして渡された変数値を適用できます。詳細については、「ダッシュボードリンクの管理」と「テンプレートおよび変数の管理」を参照してください。
変数をクエリパラメータとして渡す
Grafana は、var- のプレフィックスが付加されたクエリ文字列パラメータを、特定のダッシュボードの変数として解釈します。
例えば、この URL では、次のようになります。
https://${your-domain}/path/to/your/dashboard?var-example=value
クエリパラメータ var-example=value は、ダッシュボード変数の例を表し、値は value です。
変数に複数の値を渡す
複数の値を渡すには、値ごとに変数パラメータを 1 回繰り返します。
https://${your-domain}/path/to/your/dashboard?var-example=value1&var-example=value2
Grafana は、 var-example=value1&var-example=value2 を value1 と value2 の 2 つの値を持つダッシュボード変数の例として解釈します。
ダッシュボードリンクへの変数の追加
Grafana は、ダッシュボードの設定から変数を生成するときに、ダッシュボードリンクに変数を追加できます。変数を追加する方法と手順の詳細については、「ダッシュボードリンクの管理」を参照してください。
アドホックフィルターを渡す
アドホックフィルターは、指定されたデータソースを使用するすべてのメトリクスクエリにキーまたは値フィルターを適用します。詳細については、「アドホックフィルター」を参照してください。
アドホックフィルターをクエリパラメータとして渡すには、変数構文を使用してアドホックフィルター変数を渡し、キー、演算子を値、値をパイプ区切りリストとして指定します。
例えば、この URL では、次のようになります。
https://${your-domain}/path/to/your/dashboard?var-adhoc=example_key|=|example_value
クエリパラメータ var-adhoc=key|=|value は、 example_key キー、 = 演算子、および example_value 値を使用して、アドホックダッシュボード変数として設定されたアドホックフィルターを適用します。
注記
アドホックフィルターを使用して URL を共有する場合は、必ず URL をエンコードしてください。上記の例では、パイプ (|) を %7Cに、等価演算子 (=) を %3D に置き換えます。
URL の使用による時間範囲の制御
ダッシュボードの時間範囲を設定するには、from、to、time、および time.window クエリパラメータを使用します。これらは変数ではないため、var- プレフィックスは必要ありません。
