Chart Configuration¶

Includes commonly used configurations and advanced configurations for charts.

Common Configurations¶

Title¶

1. Title: Set a title name for the chart. After setting, it will be displayed in the top-left corner of the chart and supports hiding.
2. Description: Add a description to the chart. After setting, an [i] prompt will appear after the chart title; if not set, it will not be displayed.

Based on TrueWatch's large model natural language generation capabilities, you can use the "Auto Generate" function to quickly generate semantically appropriate titles and descriptions for the chart.

Units¶

1. Global: Includes common unit formats for different dimensions, such as data size, time intervals, timestamps, etc. You can input custom units in the dropdown box, and after pressing Enter, they will be applied to the current chart.
2. Custom: Select the metrics included under the current query conditions and input custom units.

Legend¶

1. Alias: After adding an alias, the legend's name will also change, making it easier to distinguish between related metrics.

Aliases support one-click replacement using template variables. For example:

• {tags} replaces all "tag names" and "tag values";
• {host} replaces the host "tag value";
• {__name__} replaces all metric names.

Example: Based on metrics, setting aliases will result in the following scenarios:

Effect without adding an alias:

Effect of replacing with plain text:

Using variables {tags} based on by condition:

Note: When your query contains a by condition, it will display all returned legend sequences.

1. Position: Currently supports choosing to hide, bottom, or right-side legends (clicking on the metric line in the legend allows you to hide/show the corresponding metric).

2. Display Values: Choose which values or calculated values to show in the legend.

Time series chart legend values will undergo additional aggregation calculations based on the chart query results. Currently, you can choose from Last (last value), First (first value), Avg (average), Min (minimum), Max (maximum), Sum (sum), Count (number of points).

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

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

Data Format¶

1. Decimal Places: You can choose 0, 1, 2, 3 decimal places or full precision.
2. Thousand Separator: Enabled by default; when disabled, it shows the raw value without separators.

TrueWatch dashboard chart query results support automatically adding data with thousand separators for display.

If units are set, the data format will be displayed according to the set units.

After setting, the data format can be previewed with thousand separators, or according to the set unit format.

• Thousand Separator Data Format Display:

• Set Data Format Display:

Advanced Configurations¶

Lock Time¶

This fixes the time range for querying data in the current chart, independent of the global time component. After setting successfully, the upper-right corner of the chart will display the user-defined time, such as [xx minutes], [xx hours], [xx days]. For example, if the locked time interval is 30 minutes, even if the time control in the upper-right corner is adjusted, the current chart will only display data from the last 30 minutes.

Rule Mapping¶

Set metric ranges and corresponding background colors, font colors for different columns. Metrics within the defined range will be displayed according to the set styles.

Set metric ranges and mapping values; when the metric value falls within the set data range, it will display as the corresponding mapped value.

When a metric value satisfies multiple settings simultaneously, it will display as the style of the last satisfied condition.

When setting value mappings, neither the "Display As" nor the "Color" fields are mandatory:

• "Display As" defaults to blank, meaning no mapping value will be displayed;
• "Color" defaults to blank, meaning no color mapping will be applied and the original color will be displayed.

Field Mapping¶

In practical business scenarios, if the fields to be queried do not match the fields displayed on the front end, you can enable field mapping in the chart. This feature works together with the object mapping function of view variables and is off by default.

After enabling field mapping, the chart will display the grouped fields and their corresponding mapped fields. Grouped fields without specified mappings will not be displayed.

Workspace Authorization¶

Once enabled, you can query data from external workspaces under the current chart in the current workspace.

Below the chart, you can select the target workspace from the authorized workspace dropdown list to perform queries.

Data Sampling¶

Applies only to Doris log data engine workspaces.

After enabling, sampling queries will be performed on data other than "Metrics". The sampling rate is not fixed and adjusts dynamically based on the volume of data.

Time Offset¶

Due to at least a 1-minute delay in querying non-time-series data after it has been stored, selecting relative time queries may result in recent data not being collected, leading to data loss.

After enabling time offset, when querying relative time ranges, the actual query time range shifts forward by 1 minute to prevent data retrieval from being empty due to storage delays. 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 would be 12:14-12:29.