オブジェクトマッピング¶
オブジェクトマッピングはビュー変数の付随的最適化機能です。基本オブジェクトやリソースカタログなどのオブジェクトデータにのみ適用され、元のフィールドをより読みやすい表示名にマッピングします。マッピングは元のデータとクエリロジックを変更せず、フロントエンドの可視化表示のみを最適化します。
主な機能¶
- 可読性の向上:意味のない元のフィールド(
container_id、host_idなど)を、ビジネスで認識可能な名前にマッピングします。 - 表示の統一:ビュー変数とチャートでマッピング後の名前を同期して使用できるため、ダッシュボードの表示の一貫性が保たれます。
- クエリへの影響なし:フロントエンドの表示のみを変更し、クエリ時には引き続き元のフィールド値が渡されるため、既存のクエリステートメントを変更する必要はありません。
前提条件¶
- オブジェクトデータ(基本オブジェクト、リソースカタログ)のみをサポートします。メトリクス、ログ、イベントなどの他のデータはサポートされません。
- 使用する前に、オブジェクトフィールドに基づくビュー変数を作成する必要があります。
- 同じオブジェクト分類のクエリフィールドへの重複マッピングはサポートされません。マッピング済みのフィールドはドロップダウンリストに表示されなくなります。
設定¶
- データソースを選択します(基本オブジェクト / リソースカタログ)。
- オブジェクト分類を選択します。
- 元のクエリフィールドとマッピング先フィールドを設定します。
- 保存します。
例:container_id を container_name として表示するようにマッピングします。
すると、ダッシュボード上で、ビュー変数の値は container_name (container_id) の形式で表示されますが、クエリ時には引き続き container_id の値が渡されます。また、チャート設定でフィールドマッピング機能を有効にすると、チャートの凡例にはマッピング後のフィールド値が表示されます。
設定管理¶
- 編集:元のフィールドとマッピングフィールドの対応関係を変更します。保存後、すぐに反映されます。
- 削除:マッピング関係を削除すると、フロントエンドの表示が元のフィールドに戻ります。
シナリオ例¶
オブジェクトマッピングは、次の2つのシナリオで使用できます。
ビュー変数への適用¶
変数のドロップダウンオプションは「マッピングフィールド (元のフィールド)」の形式で表示されます。選択後もクエリは元のフィールド値を使用します。
例:
- ビュー変数に
container_id変数を追加します。 - オブジェクトマッピングで
container_idをcontainer_nameにマッピングするように設定します。 - すると、ビューでは変数が
container_name(container_id)と表示されます。
チャートへの適用¶
チャートの詳細設定でフィールドマッピング機能を有効にすると、チャートの凡例とデータにマッピング後の名前が表示されます。
例:
- オブジェクトマッピングで
hostをnameにマッピングするように設定します。 - チャート > 詳細設定でフィールドマッピングを有効にします。
- 最終的にチャートには
name(host)の形式で表示されます。
注意
- マッピングフィールドは、オブジェクトデータの既存のフィールドである必要があります。無関係な名前をカスタマイズすることはできません。
- マッピング済みのビュー変数を削除しても、対応するマッピング関係は自動的に削除されません。手動でクリーンアップする必要があります。
- 複数のダッシュボードで同じ変数を共有している場合、オブジェクトマッピングはグローバルに適用されます。