Chart Configuration¶

Includes common and advanced configurations applicable to charts.

General Configuration¶

Title¶

1. Title: Set a title name for the chart. After setting, it will be displayed at the top left of the chart. Supports hiding.

2. Description: Add descriptive information for the chart. After setting, an i prompt will appear next to the chart title. If not set, it will not be displayed.

Leveraging the large model natural language generation capabilities provided by Guance, you can use the "Auto-generate" function to quickly generate semantically fitting titles and descriptions.

Unit¶

Alias¶

The system automatically lists all metrics and groupings under the current chart query. After adding an alias, the grouping part of the chart will be dynamically updated based on the alias value. Aliases support using template variables for one-click replacement. For example:

• {tags}: Replaced with all "tag names" and "tag values";

• {host}: Replaced with the "tag value" of host;

• {__name__}: Replaced with all metric names.

Usage Example¶

As shown in the figure below, querying the total CPU usage (usage_total) and user mode CPU usage (usage_user) of a host. Based on the former, alias settings result in the following scenarios:

• Effect without alias:

• Effect of inputting pure text for replacement:

• Inputting the variable {tags} based on the by condition:

Legend¶

Position¶

Supports choosing to hide the legend, or display it at the bottom or right. Clicking on a metric row in the legend can hide/show the corresponding metric.

Display Value¶

Choose the value or calculated value to display in the legend.

Time series legend values undergo re-aggregation calculation based on the chart query results. Supports selecting Last, First, Avg, Min, Max, Sum, Count.

As shown in the figure below: First represents the first value of the current time series query result, Last is the last value of the current time series query result. Clicking on the legend value supports ascending/descending sorting.

Data Format¶

1. Decimal Places: Choose 0, 1, 2, 3 decimal places or full precision.

2. Thousand Separator: Enabled by default; when turned off, the raw value is displayed without separators.

Dashboard chart query results support automatic formatting with thousand separators. If a unit is set, the data format follows the set unit.

After configuration, the data can be previewed in thousand-separator format. If a unit is set, it displays according to the unit format.

• Display with thousand-separator data format:

• Display with the set data format (e.g., with unit):

Advanced Configuration¶

Lock Time¶

Fixes the time range for the current chart's query data,不受全局时间组件的限制 (not subject to the global time widget限制). After successful setup, the user-set time, such as "xx minutes", "xx hours", "xx days", will appear in the upper right corner of the chart. For example, if the locked time interval is 30 minutes, even if the time widget in the upper right corner is adjusted, the current chart will still only display data from the last 30 minutes.

Rule Mapping¶

Set value ranges for different columns and corresponding background colors and font colors. Metrics within the range will be displayed according to the set style.

Set the metric range and mapping value. When the metric value falls within the set data range, it will be displayed as the corresponding mapped value.

If a metric value satisfies multiple conditions simultaneously, the style of the last satisfied condition is displayed.

When setting value mapping, neither "Display as" nor "Color" are mandatory:

• Display as: Default is empty, meaning no mapped value display.

• Color: Default is empty, meaning no color mapping, displaying its original color.

Field Mapping¶

In actual business scenarios, if the field to be queried is inconsistent with the field displayed on the front end, field mapping in the chart can be enabled. Used in conjunction with the object mapping function of view variables. Disabled by default.

After enabling field mapping, the chart displays the queried grouping field and the corresponding mapped field. Grouping fields without a specified mapping are not displayed.

Workspace Authorization¶

Once enabled, data from external workspaces can be queried in the current chart within the current workspace.

Below the chart, you can select the target workspace for querying from the dropdown box of authorized workspaces.

Data Sampling¶

Applicable only to workspaces using the Doris log data engine.

When enabled, sampling queries are performed on data other than "Metrics". The sampling rate is not fixed and is dynamically adjusted based on the data volume.

For more details, refer to the Data Sampling Function Technical Guide.

Time Offset¶

Non-time series data has a query latency of at least 1 minute after ingestion. When querying relative time ranges, this may cause data from the last few minutes to not be collected yet, resulting in missing data.

Enabling time offset means that when querying a relative time interval, the actual query time range is shifted forward by 1 minute to prevent data retrieval failures due to ingestion latency. Example: Current time is 12:30, querying data from the last 15 minutes. With time offset enabled, the actual query time is: 12:14 - 12:29.