Widget data loading
Speed up dashboard load times by switching DataPrime widgets to Fast loading. A widget set to Fast serves a recently computed result when one is available, instead of recomputing the query every time the dashboard opens. Widgets keep their default Latest behavior unless you change them, so existing dashboards are unaffected.
This feature is available for early-access customers. To request access and confirm your organization meets the feature criteria, contact your account representative or Support.
What you need
- A DataPrime widget on a Custom Dashboard
- The
TEAM-DASHBOARDS:UPDATEpermission
How widget data loading works
Each DataPrime widget runs in one of two loading modes:
| Mode | Behavior |
|---|---|
| Latest (default) | The widget runs a fresh query every time it loads. Results always reflect the current state of your data. |
| Fast | The widget serves a recently computed result when one is available within an allowed drift window. Data might be slightly older. If no eligible cached result exists, the widget computes fresh results. |
Fast loading uses the DataPrime query result cache. Cache eligibility depends on the query text, the selected time range, and how close the requested range is to a previously cached one. See Cache eligibility for the exact rules.
The setting is stored as part of the widget configuration, so it stays consistent across page reloads, tabs, and users.
Refresh behavior
- Manual refresh bypasses the cache. Selecting the dashboard refresh control forces a fresh query for every widget, including those set to Fast.
- Auto refresh respects each widget's loading mode. A widget set to Fast continues to serve cached results between refreshes when eligible; a widget set to Latest always recomputes.
Switch a single widget to fast loading
Use the widget settings panel when you want to change one widget at a time.
- Open a Custom Dashboard that contains a DataPrime widget.
- From the widget's more actions menu, select Settings.
- In the Data caching field, select Fast.
- Select Save.
The widget reloads using the new mode. When it serves a cached result, a Fast badge appears in the widget header.
Manage data loading for multiple widgets
Use the DataPrime data loading drawer to review and update the mode of every DataPrime widget on the dashboard in one place.
- Open a Custom Dashboard.
- From the dashboard more actions menu, select DataPrime data management.
- In the drawer, locate the widget you want to update in the Data caching column.
- Select Latest or Fast for each widget. To apply the same mode to every widget in the table, select a mode and then select Apply to all widgets.
- Select Apply.
The drawer lists every DataPrime widget on the dashboard along with its visualization type. Other widget types do not appear in the drawer and are not affected by this feature.
Fast indicator
When a widget set to Fast serves a cached result, a Fast badge appears in the widget header. Hover over the badge to see when the data was computed:
Data from 10:45 (3 min ago)
The tooltip combines an absolute timestamp with a relative offset. It appears when you are querying near the current time. For historical time ranges, the freshness indicator is hidden to reduce visual noise.
If a manual refresh runs while the widget is loading, the badge clears once fresh results arrive.
Cache eligibility
Fast loading serves a cached result only when all of the following are true:
- The query text matches a cached query exactly.
- The selected timeframe is longer than 10 minutes.
- The requested timeframe is within the allowed drift of a cached timeframe.
If any condition is not met, the widget computes fresh results and caches them for future eligible requests.
Allowed drift by timeframe
Drift compares the requested timeframe to a cached one, not wall-clock time between requests. A "last 24h" dashboard reopened a minute later can still reuse the cached result because the requested range shifts only a few minutes.
| Query timeframe | Allowed drift |
|---|---|
| 10 min to 2 hr | 30 sec |
| 2 hr to 100 hr | 0.5% of the timeframe, up to 30 min |
| Over 100 hr | 30 min |
For a 24-hour range, allowed drift is 1,440 × 0.5% = 7.2 min. Two requests for "last 24 hours" submitted 7 minutes apart can return the same cached result.
Limitations
- Applies to DataPrime widgets only. Other widget types are not affected.
- Mode is set per widget. There is no dashboard-wide or team-wide default.
- The query result cache is not active for timeframes shorter than 10 minutes. Widgets querying short windows always compute fresh results, even when set to Fast.