diff --git a/source/_integrations/history.markdown b/source/_integrations/history.markdown index 7b9a5f10cb4..68395d253b5 100644 --- a/source/_integrations/history.markdown +++ b/source/_integrations/history.markdown @@ -11,7 +11,7 @@ ha_domain: history ha_integration_type: system --- -The `history` integration will track everything that is going on within Home +The **History** integration tracks everything that is going on within Home Assistant and allows the user to browse through it. It depends on the [`recorder`](/integrations/recorder/) integration for storing the data and uses the same database setting. If any entities are excluded from being recorded, @@ -24,7 +24,33 @@ This integration is by default enabled, unless you've disabled or removed the [` history: ``` +## Exporting data from the History panel + +You can access the **History** panel from the side bar. To export the data, follow these steps: + +1. Select the areas, devices, or entities of interest. +2. Set the time frame. +3. In the top right corner, select the **Download data** button. + **Result**: Your data is exported in CSV format. + +History panel can be accessed via sidebar. + +## About the data sources + +By default, the recorder stores the sensor data for 10 days. Older data is purged automatically. The data for the last 10 days is taken from the recorder. + +If you select a time frame that exceeds 10 days, the data is taken from the long term statistics table. The long term statistics data is sampled and averaged once per hour, to save storage. Therefore, the values might look different from what you see from the recorder data, which shows the measured values at the sample rate defined for that sensor. + +If the chosen time frame exceeds the retention period defined in the recorder, the long term statistics table is used as a data source. + + If you want to see the data in full resolution for a longer period of time, you could change the retention period for that sensor in the recorder. If you do this, you may need to increase the storage capacity of your device. + ## API The history information is also available through the [RESTful API](/developers/rest_api/#get-apihistory). + +## Related topics + +- [Recorder integration](/integrations/recorder/) +- [Home Assistant Data Science Portal](https://data.home-assistant.io) \ No newline at end of file diff --git a/source/images/integrations/history/history-panel_export-data.png b/source/images/integrations/history/history-panel_export-data.png new file mode 100644 index 00000000000..33962ee57ad Binary files /dev/null and b/source/images/integrations/history/history-panel_export-data.png differ diff --git a/source/images/integrations/history/history-panel_including-long-term-storage.png b/source/images/integrations/history/history-panel_including-long-term-storage.png new file mode 100644 index 00000000000..e2b901ce3f4 Binary files /dev/null and b/source/images/integrations/history/history-panel_including-long-term-storage.png differ