翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
ダッシュボード URL 変数
このドキュメントトピックは、Grafana バージョン 9.x をサポートする Grafana ワークスペース向けに設計されています。
Grafana バージョン 10.x をサポートする Grafana ワークスペースについては、「」を参照してくださいGrafana バージョン 10 での作業。
Grafana バージョン 8.x をサポートする Grafana ワークスペースについては、「」を参照してくださいGrafana バージョン 8 での作業。
Grafana は、クエリパラメータとして渡された変数値をダッシュボード URLs。詳細については、「ダッシュボードリンクの管理」および「テンプレートと変数」を参照してください。
変数をクエリパラメータとして渡す
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 は、 value1と の 2 つの値を持つダッシュボード変数の例var-example=value1&var-example=value2として を解釈しますvalue2。
ダッシュボードリンクへの変数の追加
Grafana は、ダッシュボードの設定から変数を生成するときに、ダッシュボードリンクに変数を追加できます。変数を追加する詳細と手順については、「ダッシュボードリンクの管理」を参照してください。
アドホックフィルターの受け渡し
アドホックフィルターは、指定されたデータソースを使用するすべてのメトリクスクエリにキーまたは値のフィルターを適用します。詳細については、「アドホックフィルター」を参照してください。
アドホックフィルターをクエリパラメータとして渡すには、変数構文を使用してアドホックフィルター変数を渡します。また、キー、演算子を値、値をパイプ区切りリストとして指定します。
例えば、この 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、、to、timeおよび time.windowクエリパラメータを使用します。これらは変数ではないため、 var- プレフィックスは必要ありません。
