Object Mapping¶

For basic objects and the Resource Catalog, you can configure field mappings to optimize the display names on the frontend, while the original data remains unchanged.

Configuration¶

1. Select the data source;
2. Choose the object classification;
3. Edit the two attribute fields that need to be mapped;
4. Save.

For example: Map container_id to display as container_name. In the dashboard, the view variable values will be displayed as container_name (container_id), but during queries, the value of container_id will still be passed. Additionally, if the field mapping feature is enabled in the chart settings, the legend of the chart will display the mapped field values.

For already created object mappings, you can edit or delete them as needed.

Use Cases¶

Object mapping can be applied in two scenarios:

Dropdown display in view variables
Display in charts

Applied to View Variables¶

When adding attribute fields of objects to view variables, if the field has field mapping set, it will be displayed as: mapped field (original field).

Example:

1. Add the container_id variable in View Variables;

2. Set container_id to map to container_name in Object Mapping;

3. The view variable will now display as: container_name(container_id).

Applied to Charts¶

When querying attribute fields of objects in charts and enabling field mapping in the settings, if the field has field mapping set, it will be displayed as: mapped field (original query field).

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 will be name(host).