home-assistant.io/source/_components/emoncms_history.markdown
Nicholas Westerhausen 8689698486 Update configuration variable format. (#6699)
Update configuration variable.
Fix api_key value in example configuration.
Have consistent capitalization when referencing Emoncms
2018-10-11 22:15:59 +02:00

55 lines
1.7 KiB
Markdown

---
layout: page
title: "Emoncms history"
description: "Instructions on how to integrate Emoncms history into Home Assistant."
date: 2016-09-25 12:50
sidebar: true
comments: false
sharing: true
footer: true
logo: emoncms.png
ha_category: History
featured: false
ha_release: 0.31
---
The `emoncms_history` component makes it possible to transfer details collected with Home Assistant to [Emoncms.org](https://emoncms.org/) or your local running Emoncms instance. It will send the data to a specific input node on Emoncms with the entity IDs as a key. Afterwards you can create feeds and dashboards in Emoncms with the collected data.
To use the `emoncms_history` component in your installation, add the following to your `configuration.yaml` file:
```yaml
# Example configuration.yaml entry
emoncms_history:
api_key: YOUR_EMONCMS_WRITE_API_KEY
url: https://emoncms.org
inputnode: 19
whitelist:
- sensor.owm_temperature
- sensor.owm_wind_speed
```
{% configuration %}
api_key:
description: Your Emoncms write api key
required: true
type: string
url:
description: The root URL of your Emoncms installation. (Use https://emoncms.org for the cloud based version)
required: true
type: string
inputnode:
description: Input node that will be used inside Emoncms. Please make sure you use a dedicated, not used before, node for this component!
required: true
type: integer
whitelist:
description: List of entity IDs you want to publish.
required: true
type: list
scan_interval:
description: Defines, in seconds, how regularly the states of the whitelisted entities are being gathered and send to Emoncms.
required: false
type: integer
default: 30
{% endconfiguration %}