The Data Recorder State Duration view quantifies how long a particular parameter remained under, within, or over a user‑defined threshold range.
For numeric parameters it aggregates the time spent below the minimum, within the range, and above the maximum.
For string parameters it reports the duration that each distinct value was active.
Download options (CSV)
Download options remain disabled until at least one parameter ID is selected.
Query form: This is the main section where data is queried. The following options are available:
Parameter Id: A dropdown that allows selection of one or more parameter IDs to be queried.
Date and time range: The start and end date-time for the query. By default, the range is set from yesterday at 00:00:00 UTC to the current UTC date and time.
Resolution: The resolution will be calculated automatically. You can select it or adjust it manually according to your needs. Choosing a higher or lower resolution may affect the results, as TimescaleDB generates data points based on the selected time range and resolution. Removing the resolution can produce more precise results, but it is recommended only for short time ranges. For longer time ranges, please use a defined resolution.
Min Threshold: Minimum bound of the range.
Max Threshold: Maximum bound of the range.
Apply: Executes the query using the selected form values and shows the graph
Important:
Min and Max are interpreted as numeric bounds when the parameter is numeric.
For string parameters the Min and Max fields will ignored; but need to filled.
Column (from NumberDuration) |
Description |
|---|---|
| Parameter Id | The Parameter ID. |
| Under min | Total time spent below the minimum threshold, displayed as HH:MM:SS with a percentage of the total query duration. |
| In Range | Total time spent between the min and max thresholds, displayed as HH:MM:SS with a percentage. |
| Over max | Total time spent above the maximum threshold, displayed as HH:MM:SS with a percentage. |
Column (from StringDuration) |
Description |
|---|---|
| Parameter Id | The Parameter ID. |
| Value | The distinct string value that was active. |
| Duration | Time that this value was continuously active, formatted as HH:MM:SS. |
| Percentage | Fraction of the total query period that the value was active. |
Backend API Reference
All actions on this page communicate with the /api/v1/recordingdata/state_duration endpoint.
If you need to review the full API contract, see the documentation here: /api/v1/recordingdata.