Timechart

A Timechart is a graph produced by applying statistical aggregation to a label over an interval. The X-axis of a timechart will always be time.

Timecharts allow you to see the change in metric value over time. The amount of data visualized on a graph is dependent on the time selection selected within the Dashboard. You can aggregate metrics from multiple sources into a single line, or graph a line per combination of segment labels.

Time aggregation: For example, the average value of sysdig_host_cpu_used_percent metric is computed for each entity over 1 hour at 1-minute intervals.

Group Rollup: For each host_hostName the values from time aggregation are averaged over the scope and the top 10 segments are shown on the chart.

For information on configuring a chart, see Create a New Panel.

Types of Timecharts

TypePreview
Line

Stacked Area

Stacked Bars

Timechart look and feel can be configured under Display settings when configuring a panel.

When to Use

TypeUse case
LineWhen quickly identifying outlier segments is important.
When plotting a single metric over time.
Stacked AreaWhen an aggregate view of segments is needed.
Stacked BarsWhen metrics are sometimes reporting zero.

Sampling

PromQL-based panels and Form-based panels follow different rules when it comes to choosing which data sampling to use when displaying time series.

PromQL-Based Panels

PromQL-based panels dynamically choose the appropriate sampling that satisfies an upper limit of 360 data points per query. For a 10-second granular metric such as sysdig_container_cpu_used_percent, the below table can be used as a reference.

Time IntervalSampling usedNumber of data points displayed
10 minutes10 seconds60 data points
20 minutes10 seconds120 data points
30 minutes10 seconds180 data points
40 minutes10 seconds240 data points
90 minutes10 seconds360 data points
180 minutes1 minute90 data points
1 day10 minutes240 data points
2 weeks1 day14 data points

Form-Based Panels

Form-based panels follow a static rule when choosing the sampling to use per query.

Time IntervalSampling used
< 20 minutes10 seconds
< 2 hours1 minute
< 1 day10 minutes
< 14 days1 hour
>= 14 days1 days