Object Mapping¶

Object mapping is an optimization feature for view variables, applicable only to object-class data such as basic objects and resource catalogs. It maps original fields to more readable display names. The mapping does not alter the original data or query logic; it only optimizes the front-end visualization display.

Core Functions¶

• Improve readability: Maps meaningless original fields (e.g., container_id, host_id) to business-recognizable names.
• Unify display: View variables and charts can synchronously use the mapped names, ensuring consistency in dashboard presentation.
• No impact on queries: Only changes the front-end display; original field values are still passed during queries, eliminating the need to modify existing query statements.

Prerequisites¶

1. Only supports object-class data (basic objects, resource catalogs); does not support other data types like Metrics, LOG, or events.
2. A view variable based on object-class fields must be created before use.
3. Query fields within the same object class cannot be mapped repeatedly; already mapped fields are hidden from the dropdown list.

Configuration¶

1. Select the data source (Basic Objects / Resource Catalog).
2. Select the object class.
3. Configure the original query field and the target mapping field.
4. Save.

For example: Mapping container_id to display as container_name.

In the dashboard, the view variable value will be displayed in the format container_name (container_id), but during queries, the value of container_id is still passed. Furthermore, if the field mapping feature is enabled in the chart settings, the chart's legend will display the mapped field value.

Manage Configuration¶

• Edit: Modify the correspondence between the original field and the mapped field. Changes take effect immediately upon saving.
• Delete: Remove the mapping relationship, and the front-end reverts to displaying the original field.

Use Cases¶

Object mapping can be applied in two scenarios:

Dropdown display in view variables

Display in charts

Applied to View Variables¶

Variable dropdown options are displayed in the format "Mapped Field (Original Field)". When selected, queries still use the original field value.

Example:

1. Added a container_id variable in View Variables.
2. Set container_id to map to container_name in Object Mapping.
3. The variable in the view is now displayed as: container_name(container_id).

Applied to Charts¶

Enable the Field Mapping feature in the chart's advanced settings. The chart legend and data will then display the mapped name.

Example:

1. Set host to map to name in Object Mapping.
2. Enable Field Mapping in Chart > Advanced Settings.
3. The final display format in the chart is name(host).