Docs » Using the Time Range Selector

Using the Time Range Selector 🔗

The Time Range selector is located at the top right of dashboards and charts; it is also available to specify a chart’s default time range in the Chart Options tab. By default, SignalFx chooses the best time range for a chart based on the characteristics of the data that it shows. However, you can use the Time Range selector to override the default for all charts in a dashboard. The Time Range selector supports both relative and absolute time ranges.

Specifying a relative time range 🔗

Selecting a time range from the menu 🔗

To change the relative time range of a dashboard or chart, click the Time Range selector and choose your desired time range from the menu that appears.

../_images/time-range-selector-02.png

Typing in a relative time range 🔗

If you don’t see your desired relative time range on the menu, you can type it into the Time Range selector field. Valid time units in SignalFx for time ranges are m (minute), h (hour), d (day), and w (week). E.g. -4h (past 4 hours), or -2d13h30m (past 2 days, 13 hours and 30 mins).

To view data from a relative time window up to now, type the time unit preceded by a “-” (minus sign) into the Time Range selector. For example, if you want to see a metric from the last five minutes, click the Time Range selector and type “-5m”.

../_images/time-range-selector-5m.png

You can also view data from a relative time window up to some time before now using “start time to end time”. For example, if you want to see a metric from between 1 and 3 minutes ago, click the Time Range selector and type “-3m to -1m”. The earlier time point must come first. In this example, typing “-1m to -3m” would not work.

The Time Range selector shows your most recently used custom time range under the heading “Recent”.

../_images/time-range-selector-3m.png

Specifying an absolute time range 🔗

You can also view data from an absolute time window with a defined start and end time. Click on the Time Range selector and choose Custom from the menu. A custom Time Range selector appears. Choose the starting and ending date and time of your desired time range, then click Apply to show data for that time range only.

../_images/time-range-selector-custom.png

Panning through time ranges 🔗

When you are looking at a chart on a dashboard or in the Chart Builder, you can hover over the lower left corner to display panning controls. Initially, you will only see the control for panning back in time. Once you have panned back in time, you will see controls for panning back and forward.

Clicking one of these controls changes the time range to an absolute time range, changing by 2/3 of an increment each time you click the control; for example, if you pan backwards, the last third of the panned chart overlaps the first third of the original chart.

In the illustration below, the current time is approximately 4:55 PM (16:55) and the chart is displaying data for the last 1 hour, starting at 15:55. Panning back once displays a time range starting at approximately 15:15, 40 minutes prior to 15:55.

../_images/panning.png