Time Widget¶
Control the data display range of the current Explorer through the time widget. You can filter data by manually entering a time range, quickly selecting a preset time range, or customizing the time range.
Out-of-the-box Time Ranges¶
The system provides multiple preset quick time ranges. By clicking "More," you can select more time ranges for viewing data. The preset time ranges include:
- Drop-down list: "Last 1 hour," "Last 3 hours," "Last 1 day," etc.;
- Dynamic Time
- Static Time
Dynamic Time¶
Includes four units: minutes, days, weeks, and months, such as today, yesterday, this week, last week, etc.
Static Time¶
Includes two formats:
- Date
- Timestamp
Date¶
The static date-time format supports multiple notations, with precision to the second. Delimiters can be ~
, -
, or ,
, spaces are allowed before and after, but commas must be in English. For example:
2022/08/04 09:30:00~2022/08/04 10:00:00
2022/08/04 09:30:00-2022/08/04 10:00:00
2022/08/04 09:30:00,2022/08/04 10:00:00
Timestamp¶
Timestamp ranges support millisecond-level input. Delimiters can be ~
, -
, or ,
, spaces are allowed before and after, but commas must be in English. For example:
1659576600000~1659578400000
1659576600000-1659578400000
1659576600000,1659578400000
Note
- Input formats must meet the requirements. For instance, start time cannot be later than end time, and time formats must conform to the
hour:minute:second
standard. - The hint box and input box of the time widget are real-time linked. When the entered time range exceeds four digits (including time intervals, absolute times, and timestamps), the hint box will display
-
.
Custom Time Range¶
In addition to the preset time ranges, you can click "Custom Time" to select specific time ranges, including dates and times.
Note
- Start and end times for custom time ranges must be entered in the
hour:minute:second
format, such as15:01:09
; - Start time cannot be later than end time;
- Query records for custom time ranges can be viewed in the Custom Time Query History, supporting up to the most recent 20 records. Clicking any history record will quickly filter corresponding data.
URL Time Range¶
In addition to selecting time ranges via the time widget, you can directly modify the time
parameter in the browser's URL to query data. Supports four units: seconds (s), minutes (m), hours (h), and days (d). For example:
time=30s
time=20m
time=6h
time=2d
After modifying time=2h
in the browser, the Explorer will display data from the past 2 hours.
Note
- Each unit can only be used independently, no combination is allowed;
- When the selected time range is greater than or equal to 1 day, the Explorer will automatically stop playback mode.
Fixed Time Range¶
By clicking in the time widget, you can set a fixed query time range. After setting it, all Explorers and dashboards will default to displaying the current time range.
For example, if the locked time is "Last 2 hours," then all Explorers and dashboards will display data according to this time range.
Time Zone¶
Set the currently displayed time zone in the time widget to switch to the corresponding workspace time zone for viewing data.
- Go to Time Widget > Time Zone Settings;
- In the Modify Time Zone window, the default displays "Browser Time," which is the local time detected by the browser;
- Select the time zone;
- Confirm.
Note
- Only Owners and Administrators of the current workspace have the configuration permissions for Workspace Time Zones;
- If the owner or administrator of the workspace sets the "Workspace Time Zone," members can choose the configured workspace time zone;
- After setting a new time zone, all workspaces under your current account will display according to the set time zone. Please proceed with caution.
Workspace Time Zone¶
To ensure that workspace members can analyze data and troubleshoot issues under a unified time zone, you can configure a uniform time zone for the workspace.
- Click Manage > User Settings > Time Zone;
- Enter the modification popup window;
- Select the time zone;
- Confirm.
After configuration, other members of the workspace can choose the configured workspace time zone, and their time zone status will follow the changes of the configured time zone.
Note
- Only Owners and Administrators of the current workspace have the configuration permissions for the workspace time zone;
- Setting the workspace time zone does not automatically change the time zones of members; members need to manually select the workspace time zone;
- If the workspace time zone is deleted, members who have chosen this time zone will automatically revert to browser time.
Auto Refresh¶
"Auto Refresh" allows you to quickly obtain real-time data. Supported refresh frequencies include: 5 seconds, 10 seconds, 30 seconds, 1 minute, 5 minutes, 30 minutes, and 1 hour.
If auto-refresh is not needed, select Off.
Time Widget VS Refresh Frequency
- "Refresh frequency" does not affect changes in the "Time Widget";
- If the selected time range exceeds 1 hour or is absolute time, the refresh frequency may be affected;
- If a relative time range less than 1 hour is reselected, the refresh frequency will automatically revert to the previous configuration.
- When selecting "relative time," even if the refresh frequency is "off," modifying query conditions (such as adding/removing filters in the Explorer, adjusting search box filtering conditions, or switching view variables in dashboards/notes) will still trigger a re-query.
Note
All Explorers share one refresh configuration. Changing the refresh frequency affects all Explorers.