ビュー変数¶
ビュー変数は、Guance のシナリオにおいてグラフ連携フィルタリングを実現するためのコアメカニズムです。ユーザーが1つ以上のビュー変数の値を変更することで、複数のグラフが同時に同じフィルター条件に応答し、可視化結果をリアルタイムで更新できます。
シナリオ比較¶
| ❌ ビュー変数なし | ✅ ビュー変数あり |
|---|---|
ホスト A のモニタリングを確認する場合:host=A に変更;host=A に変更;host=A に変更 |
ホスト A のモニタリングを確認する場合:上部のドロップダウンで「ホスト A」を選択すると、すべてのグラフが自動更新 |
| 10 個のグラフ 10 回の操作が必要 | 10 個のグラフ 1 回の操作のみ |
| チームメンバーがそれぞれ変更し、設定が混乱しやすい | 統一された入り口で、設定を集中管理 |
コアロジック¶
ダッシュボード上部のグローバルフィルターコントロールとして、その動作原理は以下の通りです。
- 変数名(例:
host)とオプションの値のソース(例:すべてのホストリスト)を指定; - グラフクエリ内で
#{host}構文を使用して変数を挿入; - ユーザーが上部で値を選択すると、その変数を参照するすべてのグラフが自動更新されます。
追加を開始する¶
- 変数名:現在のビュー変数セットに属する変数の名前。ダッシュボードにグラフを追加する際、グラフクエリで参照するために使用します。形式は
#{変数名}です。 - 表示名:現在のビュー変数セットがダッシュボードに表示される名前。例:変数名が
hostの場合、表示名はホスト名になります。 - クエリ:選択可能な値のデータソースを定義;
- 並び替え:クエリから返されたビュー変数を、デフォルト、昇順、降順で並べ替えます;
- 表示オプションを決定;
- デフォルト値:ダッシュボード内の現在のビュー変数の初期値。「表示オプション」の設定に基づいてドロップダウンに変数がリスト表示され、ダッシュボードにデフォルトで表示する初期値を選択できます。デフォルト値が空の場合、ダッシュボードには最新のフィールドデータが表示されます。選択をクリックすると、現在のリストのすべての値を選択できます;
- 保存。
注意
ワークスペースのデータが中断した場合、ビュー変数にフィールドを事前設定できます。データ復旧後、システムは自動的にマッチングします。
表示オプション¶
| オプション | 機能説明 | 使用シナリオ |
|---|---|---|
| 非表示 | 有効にすると、非編集モードでは、この変数はダッシュボード内に表示されません | 強制的に条件を固定する場合に使用。例:本番環境のみを表示する場合 |
| 複数値 | 複数の値を同時に選択可能 | 複数のホストを比較する必要がある場合に有効化 |
* を含む |
デフォルトで有効(❗️ * を選択すると、この変数のフィルター条件は無視され、グラフは全データを表示します) |
デフォルトで全データを表示する必要がある場合に有効化 |
変数の管理¶
ビュー変数リストでは、以下の操作が可能です。
- クローン:現在の変数設定を複製し、類似した変数を迅速に作成;
- 編集:変数のクエリロジックや表示オプションなどを変更;
- 削除:この変数を削除(この変数を参照しているグラフは無効になります);
- 非表示マーク:非表示としてマークされた変数には、非表示ボタンが表示されます。