Skip to content

Chart Configuration


Includes the common general configuration and advanced configuration available in charts.

General Configuration

Title

  1. Title: Set a title for the chart. Once set, it is displayed in the upper-left corner of the chart and can be hidden.

  2. Description: Add description information for the chart. Once set, an i tip appears after the chart title; if not set, it is not displayed.

With the large-model natural language generation capability provided by TrueWatch, you can use Auto-generate to quickly generate titles and descriptions that fit the semantics.

Unit

Includes common unit formats for different dimensions, such as data size, time interval, timestamp, and so on.

You can enter a custom unit in the drop-down list.


Select a metric included in the current query conditions and enter 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, the value is displayed in scaled form using the metric unit by default.

    • If no relevant unit is configured in Metrics Management, values are displayed using numeric scaling with thousands-separator commas.

  2. After configuring a unit: the custom unit you configured is used first for scaled display. Metric data supports two options for values:

    • Default scaling: units are ten-thousand and million; for example, 10,000 is displayed as 1 ten-thousand and 1,000,000 as 1 million. Two decimal places are retained.

    • Short scale: units are K, M, B. That is, thousand, million, billion, trillion, etc., represent thousand, million, billion, and trillion in the Chinese context, respectively. For example, 1,000 is 1 k, 10,000 is 10 k, and 1,000,000 is 1 million; two decimal places are retained.

Follow Workspace Currency

When you create a dashboard chart yourself, if you need to convert cloud billing amounts, first select the Cloud Billing data source in the query, and then select Follow Workspace Currency under General Configuration > Unit > Currency. Charts exported from the Cloud Billing page do not need currency configuration again.

Amounts are converted according to the workspace's cloud billing display currency and the exchange rate of the current day. Historical bills also use the current day's exchange rate, and the original billing data is not modified.

You can set the unit for the current chart uniformly in Global mode, or set it separately for amount metrics or amount columns in Custom mode. When a chart contains different types of data, such as amounts and quantities, it is recommended to use Custom mode and select this unit only for amounts.

  • When the workspace selects a specific currency, the chart is displayed in that currency; after the currency is changed, it takes effect on the next query or chart refresh.
  • When the workspace selects the original currency, the chart displays amounts separately in each bill's original currency and does not directly sum amounts in different currencies.
  • If data lacks original currency information or an exchange rate, the page prompts that the related charges cannot be converted, and the current summary may be incomplete.

Alias

The system automatically lists all metrics and groups under the current chart query. After an alias is added, the group part of the chart is dynamically updated based on the alias value. Aliases support template variables for one-click replacement. For example:

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

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

  • {{__name__}}: replaces with all metric names.

Note
  • The alias of the metric part is determined by the AS on the right side of the query statement.

  • When a by condition exists in your query, all returned legend series are displayed.

  • If both the metric part and the group part are set in the alias, the priority is: group alias > metric alias.

Example Scenario

As shown below, query the host CPU total usage (usage_total) and user-space usage (usage_user) respectively. Based on the former, the following alias scenarios occur:

  • Effect without an alias:

  • Effect of entering plain text replacement:

  • Entering the {{tags}} variable based on a by condition:

Legend

Position

You can select Hidden, Bottom, or Right for the legend. Click a metric row in the legend to hide/show the corresponding metric.

Display Value

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

Time series chart legend values are re-aggregated from the chart query results. You can select Last (last value), First (first value), Avg (average), Min (minimum), Max (maximum), Sum (sum), and Count (number of points returned).

As shown below, First indicates the first value returned by the current time series chart query result, and Last is the last value of the current time series chart query result. Click a legend value to sort in ascending or descending order.

Note

Avg, Sum, and Count display different results depending on the selected time interval (original interval or auto-aligned).

Data Format

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

  2. Thousands separator: enabled by default; when disabled, raw values are displayed without separators.

Dashboard chart query results support automatic display with thousands separators. If a unit is set, the data format is displayed according to the configured unit.

After configuration, the preview can display data in thousands-separator format; if a unit is set, it is displayed in the configured unit format.

  • Thousands-separator data format display:

  • Configured data format display:

Advanced Configuration

Lock Time

This fixes the time range of the current chart query data and is not subject to the global Time Widget. After the setting is successful, the user-defined time appears in the upper-right corner of the chart, such as "xx minutes," "xx hours," or "xx days." If the lock time interval is 30 minutes, the current chart still displays only the last 30 minutes of data even if you adjust the Time Widget in the upper-right corner.

Rule Mapping

Set metric ranges and corresponding background colors and font colors for different columns. Metrics within a range are displayed in the configured style.

Set metric ranges and mapping values. When a metric value is within the configured data range, it is displayed as the corresponding mapping value.

When a metric value satisfies multiple settings, the style of the last matching setting is displayed.

When setting value mappings, both "Display As" and "Color" are optional:

  • Display As: empty by default, meaning no mapped value is displayed.

  • Color: empty by default, meaning no color mapping is applied and the original color is displayed.

Field Mapping

In actual business scenarios, if the field to query differs from the field displayed in the frontend, you can enable Field Mapping in the chart. It works with the object mapping feature of view variables and is disabled by default.

After Field Mapping is enabled, the chart displays the queried group fields and their corresponding mapped fields. Group fields without a specified mapping are not displayed.

Workspace Authorization

After it is enabled, you can query data from external workspaces in the current chart of the current workspace.

Below the chart, you can select a target workspace from the authorized workspace drop-down list for querying.

Data Sampling

Only for workspaces using the Doris log data engine.

After it is 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, see the Data Sampling Technical Guide.

Time Offset

Non-time-series data has at least a 1-minute query delay after ingestion. When you select a relative time query, data from the last few minutes may not be collected, resulting in data loss.

After Time Offset is enabled, when you query a relative time range, the actual query time range is shifted forward by 1 minute to prevent empty data retrieval caused by ingestion delay. For example, if the current time is 12:30 and you query the last 15 minutes of data, with Time Offset enabled, the actual query time is 12:14–12:29.

Note
  • This setting only applies to relative time. If the query time range is "Absolute Time Range," Time Offset does not take effect.
  • For charts with a time interval, such as time series charts, Time Offset does not take effect if the configured time interval exceeds 1 min; it takes effect only when the interval is <= 1 min. For charts without a time interval, such as overview charts and bar charts, Time Offset remains effective.

Sampling Precheck

After it is enabled, the system first starts the Sampling Precheck feature to automatically estimate the filtered data volume. If the data volume reaches or exceeds the preset lower sampling threshold, the system automatically triggers and executes the sampling process based on the ratio of the threshold to the target data volume; if the data volume is below the lower threshold, no sampling is performed and all data is retained.