diff --git a/source/_components/history_graph.markdown b/source/_components/history_graph.markdown new file mode 100644 index 00000000000..f38cd482907 --- /dev/null +++ b/source/_components/history_graph.markdown @@ -0,0 +1,62 @@ +--- +layout: page +title: "History Graph" +description: "Instructions for setting up History Graph." +date: 2017-09-20 15:00 +sidebar: true +comments: false +sharing: true +footer: true +ha_category: History +logo: home-assistant.png +ha_release: "0.55" +--- +

+ +

+ +The `history_graph` component will make the UI display a graph similar to the graphs in `more-info` popups and the [history](/components/history/) panel. + +To use this component in your installation, add the following to your `configuration.yaml` file: + +```yaml +# Minimal configuration.yaml entry +history_graph: + gr1: + entities: + - light.ceiling.lights + +``` + +### {% linkable_title Configuration variables %} + +| Attribute | Optional | Default | Description | +|---------------------------|----------|-------------------------------------------------------| +| `entities` | no | | List of entities whose history to show as a graph. | +| `name` | yes | ID | Name to display. | +| `hours_to_show` | yes | 24 | Number of hours to show. | +| `refresh` | yes | 0 | Number of seconds between graph refreshes. 0 for no refreshes. | + +### {% linkable_title Full Example %} + +```yaml +# Full configuration.yaml entry +history_graph: + gr1: + name: Lights Graph + entities: + - light.ceiling.lights + - light.bed_light + hours_to_show: 240 + refresh: 60 + gr2: + name: Temperature + entities: + - sensor.outside_temperature + - sensor.inside_temperature + hours_to_show: 120 + # refresh: 0 + +``` + + diff --git a/source/images/screenshots/history_graph.png b/source/images/screenshots/history_graph.png new file mode 100644 index 00000000000..2478ff77e83 Binary files /dev/null and b/source/images/screenshots/history_graph.png differ