# Data Stream history

Graphical representation of data stream information

## How it works

{{< staticImage "ux/DatastreamHistory/Widget/DatastreamHistoryWidget.png" "Data Streams History widget" >}}

### Widget Menu

{{< staticImage "ux/DatastreamHistory/Widget/DatastreamHistoryWidgetActions.png" "Data Streams History Actions" >}}

From here, the following actions can be performed:

- **Open device information** allows for the opening of a temporary dashboard associated with the selected entity
- **Edit** allows the editing of the selected entity
- **Historical data** displays the chart data in a list format (requires selecting a grouping parameter)
- **Download** downloads the data displayed in the chart in CSV format
- **Visualization** toggles between different data visualization options on the chart
{{% ux-widget-menu-actions %}}

## Configuration

{{% ux-widget-configuration %}}

- **Resource Type + EntityKey(s)** specifies the resource type and identifier of the entities to be queried (not required)

Columns from which to extract data to display on the graph must be configured. A graph will be generated for each column.

For each piece of data, the following can be configured:

- **Alias** a representative name for the column data on the chart
- **Color** to distinguish it on the graph
- **Intensity** allows for the graph to change shades depending on the value
- **Unit** indicates the measurement being displayed on the corresponding axis
- **Chart Type** toggles between different data visualization possibilities. Can also be configured globally for all metrics.
- **Axis editor** enables the configuration of the Y-axis on the chart to assign discrete values to specific values
- **Formatter tool** is a utility that processes each data point, allowing for its modification and/or calculation before it is displayed on the graph. For instance, it can convert discrete data into numerical data for representation.
- **Reduce tool** allows code-based reformulation of series data by grouping and similar operations.
- **Remove** removes the data stream from the chart

{{< staticImage "ux/DatastreamHistory/Configuration/DatastreamHistoryConfigGeneral.png" "Datastreams History General Configuration" >}}

### Advanced

From here, you can configure the widget's behavior while plotting the graph as well as when it is opened within a temporary dashboard.

{{< staticImage "ux/DatastreamHistory/Configuration/DatastreamHistoryConfigAdvanced.png" "Datastreams History Advanced Configuration" >}}

- **Prevent interpolation** allows the avoidance of data interpolation where possible
- **Statistical data graph** displays a panel with basic statistical values
- **Data Stream template** activates the override of the EntityKey in the widget when the dashboard is opened in a device template, taking a data stream from the entity itself at the time of loading

### Visualization

{{< staticImage "ux/DatastreamHistory/Configuration/DatastreamHistoryConfigVisualization.png" "Datastreams History Visualization" >}}

From here, you can change some visual aspects of the widget.

- **Background color** allows setting a distinctive color for the widget
- **Hide details header panel** hides the upper information panel of the widget, freeing up that space
- **Show basic stats in chart** displays basic statistics on the chart data as long as only one series is being represented

{{% children sort="weight" depth="10" %}}

---