2.6 Data Recorder

This feature provides a visual and analytical view of stored recorder data points defined in the Recorder Configs.

Recorder points are defined and stored based on the active recorder configuration. Once configured, these data points are continuously written to a time-series PostgreSQL database. The frontend feature queries this database and presents aggregated insights for each recorder point.

Top toolbar

• Data recorder (default)
  • Queries and show chart
• Recorder configs
  • Configure parameter id to store in database

Query expansion panel

This is an expansion panel and can be expand or collapse. It has following functionality:

• Top:

  • Toggle buttons to toggle between:

    • Single chart Show all selected id's data points in a single chart (default)
    • Multi chart Show each chart for each selected icons

  • Download options (CSV)

    Download options remain disabled until at least one Parameter ID is selected.

    

    • Raw data: To download raw data, select one or more Parameter IDs and a time range, then click Raw Data. This exports the unprocessed data as stored in the database.
    • Chart data: Exports the same data currently displayed in the chart, including minimum, maximum, and average values. The data is exported as a single-line CSV, matching the chart output.

  • Expansion panel control: Provides a button to expand or collapse the expansion panel.

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: Defines the interval at which minimum, maximum, and average values are calculated and displayed. The system automatically recommends a resolution based on the selected time range, and the recommended option is always shown at the top. The resolution can be manually edited by typing a custom value. Some smaller units may be disabled and cannot be selected unless a different time range is chosen. If a resolution that is too high or too low is selected, a warning message will be displayed.

• Handle missing values: If data points are missing within the selected time range, one of the following handling methods can be selected:

  • Nothing: Missing data points remain empty.
  • Last Observation Carried Forward: The last known value is carried forward to fill missing values.
  • Interpolate: Missing values are calculated by interpolating between the previous and next available values, producing a smooth transition.

• Time stepper: A time offset can be entered by typing a desired number. The dropdown dynamically displays available units (seconds, minutes, etc.) based on the entered value. The selected time can be added (right button) or subtracted (left button) from the current time range without reopening the date-time range picker. When using the left or right buttons, there is no need to click the Apply button.

• Show Line or Candle chart: Allows switching between chart display modes:

  • Line Chart: Displays only average values.
  • Candle Chart: Displays minimum, maximum, and average values.

• Apply: Executes the query using the selected form values and shows the graph