# Devices data stream history

Graphical representation of data from a data stream for multiple devices simultaneously

## How it works

{{< staticImage "ux/DatastreamDevices/Widget/DatastreamDevicesWidget.png" "Data Streams Devices widget" >}}

### Widget Menu

{{< staticImage "ux/DatastreamDevices/Widget/DatastreamDevicesWidgetActions.png" "Data Streams Devices Actions" >}}

From here, the following actions can be executed:

- **Download** allows for downloading the data displayed on the chart in CSV format
{{% ux-widget-menu-actions %}}

## Configuration

{{% ux-widget-configuration %}}

- **Data Stream Id** is the data stream you wish to represent on the chart for various entities
- **Axis formatter** allows for the representation of discrete values on the Y-axis of the chart
  {{< staticImage "ux/DatastreamDevices/Configuration/DatastreamDevicesAxisFormatter.png" "Data Streams Devices Axis Formatter" >}}

- **Values formatter** enables alteration of the obtained values for the chart. This allows for the representation of discrete values by assigning them a numerical value.
  {{< staticImage "ux/DatastreamDevices/Configuration/DatastreamDevicesValuesFormatter.png" "Data Streams Devices Values Formatter" >}}

- **Chart type** is the kind of charts to display
- **EntityKey(s)** type of resource and identifier of the entities you wish to consult (not required)

For each entity, the following options are available:

- **Color** an identifying color on the chart
- **Remove** deletes the configuration of the entity from the widget

{{< staticImage "ux/DatastreamDevices/Configuration/DatastreamDevicesConfigGeneral.png" "Data Streams Devices General Configuration" >}}

### Advanced

From here, you can configure how the widget behaves when rendering the chart.

{{< staticImage "ux/DatastreamDevices/Configuration/DatastreamDevicesConfigAdvanced.png" "Data Streams Devices Advanced Configuration" >}}

- **Prevent interpolation** allows for avoiding data interpolation when possible
- **Statistical data graph** displays a panel with basic statistical values

### Visualization

{{< staticImage "ux/DatastreamDevices/Configuration/DatastreamDevicesConfigVisualization.png" "Data Streams Devices Visualization" >}}

From this point, some visual aspects of the widget can be changed.

- **Background color** allows for setting a distinctive color for the widget
- **Hide details header panel** hides the top information panel of the widget, freeing up that space

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

---
