翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
ダッシュボード変数の追加と管理
このドキュメントトピックは、Grafana バージョン 9.x をサポートする Grafana ワークスペース向けに設計されています。
Grafana バージョン 10.x をサポートする Grafana ワークスペースについては、「」を参照してくださいGrafana バージョン 10 での作業。
Grafana バージョン 8.x をサポートする Grafana ワークスペースについては、「」を参照してくださいGrafana バージョン 8 での作業。
変数は値のプレースホルダーです。メトリクスクエリとパネルタイトルで変数を使用できます。したがって、ダッシュボードの上部にあるドロップダウンを使用して値を変更すると、パネルのメトリクスクエリが新しい値を反映するように変更されます。
変数を使用すると、よりインタラクティブで動的なダッシュボードを作成できます。サーバー、アプリケーション、センサー名などのものをメトリクスクエリでハードコーディングする代わりに、代わりに変数を使用できます。変数は、ダッシュボードの上部にドロップダウンリストとして表示されます。これらのドロップダウンを使用すると、ダッシュボードに表示されるデータを簡単に変更できます。
これらは、Grafana ビューワーが視覚化をすばやく調整できるようにしたいが、完全な編集権限を与えたくない管理者にとって特に役立ちます。Grafana ビューワーは変数を使用できます。
変数とテンプレートを使用すると、単一ソースのダッシュボードも作成できます。同じデータソースまたはサーバーが複数ある場合は、1 つのダッシュボードを作成し、変数を使用して表示内容を変更できます。これにより、メンテナンスと維持が大幅に簡素化されます。
テンプレート
テンプレートは、変数を含む任意のクエリです。例えば、ダッシュボードを管理して複数のサーバーをモニタリングする場合、サーバーごとにダッシュボードを作成したり、ダッシュボードを 1 つ作成して次のようなテンプレートクエリでパネルを使用したりできます。
wmi_system_threads{instance=~"$server"}
変数値は、常に構文 var-<varname>=value を使用して URL に同期されます。
例
変数は、画面上部のドロップダウンリストに表示されます。さまざまな変数を選択して、視覚化がどのように変化するかを確認します。
変数設定を表示するには、ダッシュボード設定 > 変数 に移動します。リスト内の変数をクリックすると、その設定が表示されます。
変数は、タイトル、説明、テキストパネル、クエリで使用できます。で始まるテキストを含むクエリ$
は テンプレートです。すべてのパネルにテンプレートクエリがあるわけではありません。
変数のベストプラクティス
-
変数ドロップダウンリストは、ダッシュボード設定 の変数リストにリストされている順序で表示されます。
-
頻繁に変更する変数を一番上に置くと、最初に表示されます (ダッシュボードの左端)。