Skip to content

Chart Configuration

Includes common and advanced configurations that are universal within charts.

General Configuration

Title

  1. Title: Set a title name for the chart. Once set, it appears on the top left of the chart. Supports hiding.
  2. Description: Add descriptive information for the chart. After setting, an i prompt appears next to the chart title. If not set, it is not displayed.

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

Unit

Includes general unit formats for different dimensions, such as data size, time intervals, timestamps, etc. You can input custom units in the dropdown box.

Select the metrics included under the current query conditions and input a custom unit.

About Unit Display for Metric Data

  1. Default Unit Display:

    • If the queried data is metric data and you have set a unit for the metric in Metrics Management, it will be displayed using the metric's unit with appropriate scaling by default.
    • If there are no relevant unit configurations in Metrics Management, it will be displayed using numerical scaling with thousand separators (commas).

  2. After Configuring a Unit: The custom configured unit takes priority for scaling display. Metric data supports two options for numerical values:

    • Default Scaling: Units are ten-thousands, millions, e.g., 10,000 displays as 10k, 1,000,000 displays as 1M. Retains two decimal places.
    • Short Scale: Units are K, M, B. This means thousand, million, billion, trillion, etc., corresponding to the Chinese context of thousand, million, billion, trillion, etc. For example, 1,000 is 1 K, 10,000 is 10 K, 1,000,000 is 1 M. Retains two decimal places.

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.

Note
  • The alias for the metric part is determined by the AS on the right side of the query statement.
  • If your query contains a by condition, all returned legend series are displayed.
  • If you set aliases for both the metric part and the grouping part simultaneously, the priority is: grouping alias > metric alias.

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 can result in the following scenarios:

  • Effect without alias:

  • Effect of inputting plain text 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.

Displayed Value

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

Time series chart legend values undergo secondary aggregation calculations 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 the legend value supports ascending/descending sorting.

Note

Avg, Sum, Count display different results depending on the selected time interval (original interval and automatic alignment).

Data Format

  1. Decimal Places: Choose 0, 1, 2, 3 decimal places or full precision.
  2. Thousand Separator: Enabled by default; turning it off displays the raw value without separators.

Dashboard chart query results support automatic display in thousand-separator format. If a unit is set, the data format is displayed according to the set unit.

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

  • Display in thousand-separator format:

  • Display in set data format:

Advanced Configuration

Lock Time

This fixes the time range for the current chart's query data, making it independent of the global time widget. After successful setup, the user-set time appears in the top right corner of the chart, e.g., "xx minutes", "xx hours", "xx days". For example, if the lock time interval is set to 30 minutes, even if the time widget in the top right corner is adjusted, the 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 with the set style.

Set metric ranges and mapping values. When a 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: Defaults to empty, meaning no mapped value is displayed.
  • Color: Defaults to empty, meaning no color mapping is applied, displaying its original color.

Field Mapping

In practical business scenarios, if the field to be queried differs from the field displayed in the frontend, field mapping in the chart can be enabled. This works in conjunction with the object mapping function of view variables and is turned off 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.

Space Authorization

Once enabled, you can query data from external workspaces within the current chart of the current workspace.

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

Data Sampling

Only applicable 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

Since non-time-series data has a query latency of at least 1 minute after ingestion, using relative time queries might result in missing data for the most recent few minutes that haven't been collected yet.

Enabling time offset means that when querying a relative time range, the actual query time range is shifted forward by 1 minute to prevent empty results due to ingestion latency. For example: if the current time is 12:30 and you query the last 15 minutes, with time offset enabled, the actual query time is: 12:14 - 12:29.

Note
  • This setting only works for relative time. If the query time range is an "absolute time range", time offset does not take effect.
  • For charts with time intervals, like time series charts, if the set time interval exceeds 1 minute, time offset does not take effect. It only takes effect when the interval is <= 1 minute. For charts without time intervals, like overview charts, bar charts, etc., time offset remains effective.

Sampling Pre-check

When enabled, the system first initiates the "Sampling Pre-check" function to automatically estimate the data volume after filtering. If the data volume reaches or exceeds the preset lower sampling threshold limit, the system will automatically trigger and execute the sampling process based on the ratio between the threshold and the target data volume. If the data volume is below this limit, no sampling is performed, and all data is retained.

Feedback

Is this page helpful? ×