Dashboard¶

Introduction¶

Clearly shows the range of metric data values. Suitable for cutting through cluttered data to segment the main points.

Use Case¶

The dashboard of the guance is used to display the range of metric data values. For example, you can query the memory usage of a host for the last 15 minutes.

Chart Query¶

Chart query supports 「simple query」, 「expression query」 and 「DQL query」, please click chart-query.md for detailed explanation of chart query conditions.

Note：

Click 「Convert to expression query」 to switch to expression query, and use 「simple query」 as "Query A" to support switching between each other. The same applies to 「DQL query」.
If you use a conversion function in 「Simple query」 that is not supported by 「Expression query」, the function will not be brought into the expression query after switching.

Chart Links¶

Links can help you jump from the current chart to the target page, support adding internal links and external links to the platform, and support modifying the corresponding variable values in the links through template variables to transfer the data information to complete the data linkage. Please click chart-link to view the related settings.

Chart Style¶

Options	Description
Chart Title	Set the title for the chart, after setting, it will be displayed on the top left of the chart, and it supports hiding
Minimum	Sets the minimum value for the dashboard, which is the leftmost value in the dial chart
Max	Sets the maximum value of the dashboard, which is the sum of the leftmost and rightmost values in the dial chart
Segment Threshold	Set the segment threshold and dial color for the value. Click 「+」 and 「-」 to add and remove corresponding thresholds

Chart Setup¶

Basic Settings¶

Options Description

Units 1. Support setting units for query results.
1）If the queried data has no unit, after setting the unit in the chart, it will be displayed on the chart according to the set unit
2）If the query data comes with its own units, or if you are in [Metric Management] (../../metrics/dictionary.md), and you set the units for the metrics in the chart, the units set in the chart will be displayed on the chart.
3）If the query data has no units and no units are set in the chart, the chart Y-axis values are automatically calculated according to scientific notation; the original values are displayed on the chart in the format [thousandths] (chart-query.md#thousand).
Scientific counting instructions
Default query result value is automatically converted to units, display follows 「scientific notation K, M, B」 (1 thousand = 1K, 1 million = 1M, 1 billion = 1B), retaining two decimal points; RMB is automatically converted to units 「yuan, million, billion」, retaining two decimal points
For example, if the unit of time interval is selected as ns, then according to the size of the data, the query result will only automatically convert the unit effect as follows, and so on：
1000000ns: chart query data results are displayed as 1ms
1000000000ns: chart query data results are displayed as 1s
10000000000ns: chart query data results are displayed as 1m

2. support for the query results preset units, manual input format: aggregation function (metric), such as last(age_idle)

Advanced Settings¶

Options	Description
Time Slicing	When time slicing is enabled, the original data will be aggregated in segments at certain time intervals, and then the aggregated data set will be aggregated for the second time to get the result value, which is disabled by default. For details, please refer to time slicing description
Lock time	Support locking the time range of chart query data, not limited by the global time component. The time set by the user will appear in the upper right corner of the chart after successful setup, e.g. 【xx minutes】, 【xx hours】, 【xx days】. If the time interval is locked at 30 minutes, then when adjusting the time component, no matter what time range view is queried, only the last 30 minutes of data will be displayed.
Time interval	If the time slice is off, there is no time interval option, if the time slice is on, the time interval option is as follows： Original interval: default query to display data according to the time range of the time component 自Dynamic Alignment: When turned on, the query will be dynamically adjusted according to the selected time range and aggregation interval, rounded up according to the calculated time interval. (For example, if the automatic aggregation algorithm calculates the time interval to be 50 seconds, then the actual query will be launched according to the time interval of 1 minute) The system presets 1 millisecond, 10 milliseconds, 50 milliseconds, 100 milliseconds, 500 milliseconds, 1 second, 5 seconds, 15 seconds, 30 seconds, 1 minute, 5 minutes, 10 minutes, 30 minutes, 1 hour, 6 hours, 12 hours, 1 day, 1 week, 1 month, and many time interval. Custom time interval: When 【Lock time】 is selected, according to the length of lock time, different optional time intervals will be automatically matched to query the displayed data. (For example, if you select 1 minute as the time interval, the query will actually be launched at 1 minute interval)
Field Mapping	The object mapping function with view variables is off by default, if object mapping is configured in the view variables： When field mapping is enabled, the chart displays the 「grouped fields」 of the query and the corresponding 「mapped fields」, and the grouped fields without specified mapping are not displayed. When field mapping is turned off, the chart is displayed normally, without the mapped fields
Chart Description	Add description information to the chart, after setting the chart title will appear behind the 【i】 prompt, do not set it will not be displayed
Workspace	A list of authorized workspaces, which can be queried and displayed via charts after selection

Example Graph¶

The following graph shows the memory usage of the host for the last 15 minutes.