Skip to content

Time Series Chart


Generally used to display the trend changes of data at equal time intervals, and can also be used to analyze the effects and influences between multiple sets of metrics data.

The chart types include:

  • Line chart (default selected)
  • Bar chart
  • Area chart

Use Cases

  • View the trend changes of application performance metrics data within a certain time range, such as the trend changes in "request counts" in the last 15 minutes;
  • View the trend changes of user access metrics data within a certain time range, such as the occurrence of "error counts" during different time periods;
  • View similar trend indicators within a fixed time range;
  • View related events triggered when data fluctuations are abnormal.

Chart Query

Supports simple query, expression query, DQL query, Promql query, and data source query. Each query has 5 preset return result quantities, including 5, 10, 20, 50, and 100, with a default return of 20 data points; manual input is also possible, with a maximum of 100 data points.

For more detailed descriptions of chart query conditions, refer to Chart Query.

Chart Configuration

For more details, refer to Chart Configuration.

Style

Line Chart

Four styles can be selected: linear, smooth, pre-step, post-step.

Area Chart

Two styles can be selected:

  • Basic: Intuitively displays the trends of each data series, making it easy to observe changes in individual data.
  • Stacked: Suitable for multiple data series, where each data series is stacked sequentially, with the starting point of each series based on the endpoint of the previous series, making it convenient to observe the cumulative effect of overall data.

Breakpoint Connection

Considering that in time series charts, all time points are automatically connected. If there is no data at a certain time point, a breakpoint will appear in the chart at this point. By default, Guance will automatically connect the data before and after the breakpoint. By setting Breakpoint Connection, you can avoid judgment errors regarding breakpoint data.

Display Return Values

Applicable to time series charts > bar charts.

After enabling, specific values will be displayed above the bars. Here, only values are displayed, not units; if the number of decimal places is set to 0, 1, 2, or 3 in Basic Settings > Data Format, the values will follow the set number of decimal places; if the number of decimal places is set to "full precision", then by default, two decimal places will be displayed; the display of thousand separators will also synchronize here.

Time Interval

That is, the calculation interval (interval) for querying chart data.

For example, when switching time intervals is unavailable:

After enabling, the query will dynamically adjust according to the selected time range and aggregation time interval, rounding up to the nearest calculated time interval.

At this point, the selectable time intervals will be listed based on the maximum number of points entered:

Note

When querying includes metric metrics, the smallest listed interval = 10s.


Execute queries according to the selected interval, when conflicting with "maximum returned points", interval will be adjusted according to "time range / maximum points"; includes 10 seconds, 20 seconds, 30 seconds, 1 minute, 5 minutes, 10 minutes, 30 minutes, 1 hour, 6 hours, 12 hours, 1 day, 7 days, and 30 days.


Supplementary Explanation of Time Interval Logic

The system has built-in 18 commonly used time interval options, including:

  • 10ms, 50ms, 100ms, 500ms
  • 1s, 10s, 20s, 30s
  • 1m, 5m, 10m, 30m
  • 1h, 6h, 12h
  • 1d, 7d, 30d

When setting up a chart, the system will automatically recommend appropriate time interval options based on the "maximum returned points" set in the chart > advanced settings. If not set, the "maximum returned points" defaults to 720.

For example, if you query the most recent 3 hours of data:

Choosing interval=10s would generate 1,080 data points, exceeding the default limit of 720 points, so it does not meet the requirements; Choosing interval=20s results in only 540 data points, meeting the requirements, and the system will automatically select this time interval.

Note

If your chart queries metric data (metric), the minimum time interval is 10s.

Maximum Returned Points

That is, the maximum number of data points per sequence, any integer between 2-1,000 can be entered arbitrarily. If you do not customize, the default maximum point limit is 720.

Note
  • Based on the selected time interval, if the query range is too large and exceeds the maximum number of points, the data will be returned after calculating the interval and rounding;
  • If the query returns too many results, the system will only display the first 1,000 data points.

Mixed Line Chart

Only supports bar charts.

Year-on-Year and Month-on-Month Comparison

Comparison with data from the same period of time. Default is off.

Comparison Dimensions

After enabling, the comparison dimensions support the following options:

  • Hourly (compared with one hour ago)
  • Daily (compared with one day ago)
  • Weekly (compared with one week ago)
  • Monthly (compared with one month ago)
  • Month-on-month

Comparison Logic

  • Default line chart query: Drawn based on the selected start time - end time.

  • Line chart for the same period comparison: Drawn by moving forward the same time range based on the selected comparison dimension.

Example

Taking the query of host A's CPU usage trend as an example:

  • Comparison dimension selected as "hour":

    • When querying "the last 1 hour" (3/2 10:00 - 3/2 11:00), the comparison time range is (3/2 09:00 - 3/2 10:00).
    • When querying "today" (3/2 00:00 - 3/2 11:00), the comparison time range is (3/1 23:00 - 3/2 10:00).
  • Comparison dimension selected as "day":

    • When querying "the last 1 hour" (3/2 10:00 - 3/2 11:00), the comparison time range is (3/1 10:00 - 3/1 11:00).
    • When querying "today" (3/2 00:00 - 3/2 11:00), the comparison time range is (3/1 00:00 - 3/1 11:00).

Chart Analysis

A time series chart is a two-dimensional chart indexed by time order, with the horizontal axis as the time scale and the vertical axis as the data scale. Based on the selected time range, the time series chart will plot the trend changes of object data within that time period.

Note

A single query statement in a time series chart can return a maximum of 10 timelines, i.e., based on the results of the grouping (group by) condition, data exceeding 10 timelines will only display the first 10 timelines in order.

Timeline

At the same time, in analysis mode, Guance provides a timeline feature, meaning you can not only preview the interaction changes of object data and time through the timeline below the chart but also drag and select the displayed time range. The timeline range is the selected time range as the query cycle, fixed three query cycles backward, and at most one query cycle forward (up to the current time point).

For example: The current time point is 11:33, and the time range is selected as 【the last 1 hour】, so the timeline range is 【10:33 - 11:33】.

Similar Trend Indicators

In the analysis mode of the time series chart, selecting the trend line/bar of the time series chart allows you to view similar trend indicators.

Viewing similar trend indicators uses the selected time range as absolute time, querying similar indicator trends within the space. You can:

  • On the time series chart, click the chart and drag the mouse to select the search time range;
  • Click the "button" to search for similar trend results;
  • Click the query result to enter the "similar trend indicators" detail page.

Similar Trend Results

Based on the selected absolute time range, the query result list includes:

  • Source: Measurement sets with similar trends;
  • Similar quantity: The number of charts with similar trends under the corresponding "measurement set";
  • Preview: Preview images of similar trend charts.

Note
  • When querying similar intervals, the currently selected time range is the 【absolute time】 by default and will not change due to any external influence or observer. If you need to change the time range, you must readjust the time range;

  • After entering the similar interval page, you can adjust the search time range by dragging a rectangle. If a region has already been selected, you can still move or adjust the selected time range;

  • After dragging to a new time range, you need to confirm/cancel changing the time range.

Feedback

Is this page helpful? ×