翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
ダッシュボード URL 変数
このドキュメントのトピックは、Grafana バージョン 10.x をサポートする Grafana ワークスペース向けです。
Grafana バージョン 9.x をサポートする Grafana ワークスペースについては、「Grafana バージョン 9 での作業」を参照してください。
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- プレフィックスは必要ありません。
