ダッシュボード URL 変数

このドキュメントトピックは、Grafana バージョン 10.x をサポートする Grafana ワークスペース向けに設計されています。

Grafana バージョン 9.x をサポートする Grafana ワークスペースについては、「」を参照してくださいGrafana バージョン 9 での作業。

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 は、 と の 2 つの値を持つダッシュボード変数の例var-example=value1&var-example=value2として value1を解釈します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- プレフィックスは必要ありません。