visualization-date-and-time-controls.md 4.8 KB
Visualization date and time controls
Netdata's dashboard features powerful date visualization controls that include a time control, a timezone selector and a rich date and timeframe selector.
The controls come with useful defaults and rich customization to help you narrow your focus when troubleshooting issues or anomalies.
Time controls
The time control provides you the following options: Play, Pause and Force Play.
- Play - the content of the page will be automatically refreshed while this is in the foreground
- Pause - the content of the page isn't refreshed due to a manual request to pause it or, for example, when your investigating data on a chart (cursor is on top of a chart)
- Force Play - the content of the page will be automatically refreshed even if this is in the background
With this, we aim to bring more clarity and allow you to distinguish if the content you’re looking at is live or historical and also allow you to always refresh the content of the page when the tabs are in the background.
Main use cases for Force Play:
- You use a terminal or deployment tools to do changes in your infra and want to see the effect immediately; Netdata is in the background, displaying the impact of these changes
- You want to have Netdata in the background, example displayed on a TV, to constantly see metrics through dashboards or to watch the alert status
Date and time selector
The date and time selector allows you to change the visible timeframe and change the timezone used in the interface.
Pick timeframes to visualize
While panning through time and zooming in/out from charts, it is helpful when you're looking a recent history, or want to do granular troubleshooting, what if you want to see metrics from 6 hours ago? Or 6 days?
Netdata's dashboard features a timeframe selector to help you visualize specific timeframes in a few helpful ways. By default, it shows a certain number of minutes of historical metrics based on your browser's viewport to ensure it's always showing per-second granularity.
Open the timeframe selector
To visualize a new timeframe, you need to open the picker, which appears just above the menu, near the top-right bar of the dashboard.
The Clear button resets the dashboard back to its default state based on your browser viewport, and Apply closes the picker and shifts all charts to the selected timeframe.
Use the pre-defined timeframes
Click any of the following options in the predefined timeframe column to choose between:
- Last 5 minutes
- Last 15 minutes
- Last 30 minutes
- Last hour
- Last 2 hours
- Last 6 hours
- Last 12 hours
- Last day
- Last 2 days
- Last 7 days
Click Apply to see metrics from your selected timeframe.
Choose a specific interval
Beneath the predefined timeframe columns is an input field and dropdown you use in combination to select a specific timeframe of minutes, hours, days, or months. Enter a number and choose the appropriate unit of time, then click Apply.
Choose multiple days via the calendar
Use the calendar to select multiple days. Click on a date to begin the timeframe selection, then an ending date. The timeframe begins at noon on the beginning and end dates. Click Apply to see your selected multi-day timeframe.
Caveats and considerations
Longer timeframes will decrease metrics granularity. At the default timeframe, based on your browser viewport, each "tick" on charts represents one second. If you select a timeframe of 6 hours, each tick represents the average value across a larger period of time.
You can only see metrics as far back in history as your metrics retention policy allows. Netdata uses an internal time-series database (TSDB) to store as much metrics as it can within a specific amount of disk space. The default storage is 256 MiB, which should be enough for 1–3 days of historical metrics. If you navigate back to a timeframe beyond stored historical metrics, you'll see this message:
At any time, configure the internal TSDB's storage capacity to expand your depth of historical metrics.
Timezone selector
The default timezone used in all date and time fields in Netdata Cloud comes from your browser. To change it, open the date and time selector and use the control displayed here:
