翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
このドキュメントのトピックは、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 に同期されます。
例
変数は、画面上部のドロップダウンリストに表示されます。さまざまな変数を選択して、視覚化がどのように変化するかを確認します。
変数設定を表示するには、[ダッシュボード設定] > [変数] に移動します。リスト内の変数をクリックすると、その設定が表示されます。
変数は、タイトル、説明、テキストパネル、クエリで使用できます。$ で始まるテキストを含むクエリはテンプレートです。すべてのパネルにテンプレートクエリがあるわけではありません。
変数のベストプラクティス
-
変数のドロップダウンリストは、[ダッシュボード設定] の変数リストに一覧されている順序で表示されます。
-
頻繁に変更する変数を一番上に置くと、ダッシュボードの左端に最初に表示されるようになります。
