home-assistant.io/source/_components/history_graph.markdown
2019-03-09 14:57:55 -08:00

2.1 KiB

layout, title, description, date, sidebar, comments, sharing, footer, ha_category, logo, ha_release, ha_qa_scale
layout title description date sidebar comments sharing footer ha_category logo ha_release ha_qa_scale
page History Graph Instructions for setting up History Graph. 2017-09-20 15:00 true false true true History home-assistant.png 0.55 internal

The history_graph component will make the UI display a graph similar to the graphs in more-info popups and the history panel. If you want to add history graphs to the Lovelace UI, please check the History Graph Card configuration as it slightly differs from the component.

To use this component in your installation, add the following to your configuration.yaml file:

# Minimal configuration.yaml entry
history_graph:
  gr1:
    entities:
      - light.ceiling.lights

{% configuration %} entities: description: List of entities whose history to show as a graph. required: true type: string name: description: Name to display. required: false default: ID type: string hours_to_show: description: Number of hours to show in the graph. required: false default: 24 type: integer refresh: description: Number of seconds between graph refreshes. 0 to disable refreshing. required: false default: 0 type: integer {% endconfiguration %}

{% linkable_title Full Example %}

# 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

For sensors to automatically be combined into one graph they need to have exactly the same unit of measurement. This is important if you have, e.g., a unit-less temperature state_topic MQTT sensor and you want to combine this with a weather sensor. unit_of_measurement: of the MQTT sensor then needs to be set to °C.