Skip to content

Commit 516d2f5

Browse files
andrey-gitfabaff
authored andcommitted
Documentation for history_graph (home-assistant#3414)
* Add custom ui documentation * Documentation for history_graph * history_graph is due for 0.55
1 parent 8d9cf01 commit 516d2f5

File tree

2 files changed

+62
-0
lines changed

2 files changed

+62
-0
lines changed
Lines changed: 62 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,62 @@
1+
---
2+
layout: page
3+
title: "History Graph"
4+
description: "Instructions for setting up History Graph."
5+
date: 2017-09-20 15:00
6+
sidebar: true
7+
comments: false
8+
sharing: true
9+
footer: true
10+
ha_category: History
11+
logo: home-assistant.png
12+
ha_release: "0.55"
13+
---
14+
<p class='img'>
15+
<img src='{{site_root}}/images/screenshots/history_graph.png' />
16+
</p>
17+
18+
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.
19+
20+
To use this component in your installation, add the following to your `configuration.yaml` file:
21+
22+
```yaml
23+
# Minimal configuration.yaml entry
24+
history_graph:
25+
gr1:
26+
entities:
27+
- light.ceiling.lights
28+
29+
```
30+
31+
### {% linkable_title Configuration variables %}
32+
33+
| Attribute | Optional | Default | Description |
34+
|---------------------------|----------|-------------------------------------------------------|
35+
| `entities` | no | | List of entities whose history to show as a graph. |
36+
| `name` | yes | ID | Name to display. |
37+
| `hours_to_show` | yes | 24 | Number of hours to show. |
38+
| `refresh` | yes | 0 | Number of seconds between graph refreshes. 0 for no refreshes. |
39+
40+
### {% linkable_title Full Example %}
41+
42+
```yaml
43+
# Full configuration.yaml entry
44+
history_graph:
45+
gr1:
46+
name: Lights Graph
47+
entities:
48+
- light.ceiling.lights
49+
- light.bed_light
50+
hours_to_show: 240
51+
refresh: 60
52+
gr2:
53+
name: Temperature
54+
entities:
55+
- sensor.outside_temperature
56+
- sensor.inside_temperature
57+
hours_to_show: 120
58+
# refresh: 0
59+
60+
```
61+
62+
22.9 KB
Loading

0 commit comments

Comments
 (0)