diff --git a/atom.xml b/atom.xml index e299d1586c..69623402bc 100644 --- a/atom.xml +++ b/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Home Assistant]]> - 2015-12-06T21:41:08-08:00 + 2015-12-08T00:15:12-08:00 https://home-assistant.io/ @@ -13,6 +13,126 @@ Octopress + + <![CDATA[InfluxDB and Grafana]]> + + 2015-12-07T06:15:13-08:00 + https://home-assistant.io/blog/2015/12/07/influxdb-and-grafana +
+The InfluxDB database is a so-called time series database primarly designed to store sensor data and real-time analytics.

+ +

The influxdb component makes it possible to transfer all state changes from Home Assistant to an external InfluxDB database.

+ + + +

The first step is to install the InfluxDB packages. If you are not running Fedora, check the installation section for further details.

+ +
+ 
$ sudo dnf -y install http://influxdb.s3.amazonaws.com/influxdb-0.9.5.1-1.x86_64.rpm
+
+
+
+ +

Launch the InfluxDB service.

+ +
+ 
$ sudo systemctl start influxdb
+
+
+
+ +

If everything went well, then the web interface of the ddatabase should be accessible at http://localhost:8083/. Create a database home_assistant to use with Home Assistant either with the web interface or the commandline tool influx.

+ +

+ + InfluxDB web frontend +

+ +
+ 
$ influx
+Visit https://enterprise.influxdata.com to register for updates, InfluxDB server management, and monitoring.
+Connected to http://localhost:8086 version 0.9.5.1
+InfluxDB shell 0.9.5.1
+> CREATE DATABASE home_assistant
+
+
+
+ +

An optional step is to create a user. Keep in mind to adjust the configuration (add username and password) in the next step if you prefer to go this way.

+ +
+ 
> CREATE USER "home-assistant" WITH PASSWORD 'password'
+
+
+
+ +

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

+ +
+ 
influxdb:
+  host: 127.0.0.1
+
+
+
+ +

After you restart Home Assistant you should see that the InfluxDB database gets filled. The language to query the database is similar to SQL.

+ +
+ 
$ influx
+[...]
+> USE home_assistant
+Using database home_assistant
+> SELECT * FROM binary_sensor
+name: binary_sensor
+-------------------
+time            domain        entity_id    value
+1449496577000000000    binary_sensor    bathroom_door    0
+1449496577000000000    binary_sensor    bathroom_window    0
+1449496577000000000    binary_sensor    basement_door    0
+1449496577000000000    binary_sensor    basement_window    0
+1449496684000000000    binary_sensor    bathroom_window    1
+[...]
+
+
+
+ +

Grafana is a dashboard that can create graphs from different sources including InfluxDB. The installation is simple, and there are detailed steps for many different configurations on the Grafana installation page. For a recent system that is running Fedora:

+ +
+ 
$ sudo dnf -y install https://grafanarel.s3.amazonaws.com/builds/grafana-2.5.0-1.x86_64.rpm
+
+
+
+ +

Start the grafana server.

+ +
+ 
$ sudo systemctl daemon-reload
+$ sudo systemctl start grafana-server
+$ sudo systemctl status grafana-server
+
+
+
+ +

Login with the username admin and the password admin at http://localhost:3000/login. Now follow the InfluxDB setup instructions.

+ +

Now you can start to create dashboards and graphs. You have various options to get the data from the graph. The next image just shows a screenshot of the setting for a temperature sensor.

+ +

+ + Grafana settings +

+ +

If the graph is not showing up in the dashboard you need to adjust the time range in the right upper corner. The graph is created for all state changes recorded by Home Assistant.

+ +

+ + Grafana Temperature graph +

+ +]]> + + <![CDATA[0.9: Rollershutters, locks, binary sensors and InfluxDB]]> @@ -2195,44 +2315,6 @@ Before diving into the newly supported devices and services, I want to highlight -]]> - - - - <![CDATA[UTC & Time zone awareness]]> - - 2015-05-09T23:08:00-07:00 - https://home-assistant.io/blog/2015/05/09/utc-time-zone-awareness - I have recently merged code to refactor Home Assistant to use only UTC times internally. A much needed refactor. I’ve added some extra test coverage to time sensitive parts to ensure stability. The code has been live in the dev branch for the last 9 days and will be soon released to the master branch.

- -

From now on all internal communication will be done in UTC: time changed events, datetime attributes of states, etc. To get the current time in UTC you can call homeassistant.util.dt.utcnow(). This is a timezone aware UTC datetime object. homeassistant.util.dt is a new util package with date helpers.

- -

There is also such a thing as local time. Local time is based on the time zone that you have setup in your configuration.yaml. Local times should only be used for user facing information: logs, frontend and automation settings in configuration.yaml.

- -

Setting up your time zone

-

Setting up a time zone happens in configuration.yaml. If you have no time zone setup, it will be auto detected using the existing detection code using freegeoip.net. You can find a list of compatible time zones on Wikipedia.

- -
- 
homeassistant:
-  time_zone: America/Los_Angeles
-
-
-
- -

Compatibility

-

The changes to the code are mostly backwards compatible. The old hass.track_time_change and hass.track_point_in_time use now internally two new methods: hass.track_utc_time_change and hass.track_point_in_utc_time. The usage of the old methods have not changed and should be backwards compatible.

- -

This refactor adds a new migration for the database adding a utc_offset column to events and states. This information is currently not used but can prove useful in the future when we start analyzing the historical data.

- -

Backwards incompatible stuff

- -

All built-in components have been upgraded. The following list is only for people that run custom components:

- -
    -
  • hass.track_time_change and hass.track_point_in_time will now return a time zone aware datetime object. Python does not allow comparing a naive with an aware datetime object.
    • -
  • the sun attributes for rising and setting are now in UTC. The methods sun.next_rising(hass) and sun.next_setting(hass) are backwards compatible, just be careful if you used to read the raw attributes.
    • -
  • the API sends all times in UTC. If you use anything else besides the frontend to talk to HA, make sure it handles it differently.
    • -
]]> diff --git a/blog/2014/12/18/website-launched/index.html b/blog/2014/12/18/website-launched/index.html index 285f6df422..52e5d2634b 100644 --- a/blog/2014/12/18/website-launched/index.html +++ b/blog/2014/12/18/website-launched/index.html @@ -187,6 +187,12 @@ diff --git a/blog/2014/12/26/home-control-home-automation-and-the-smart-home/index.html b/blog/2014/12/26/home-control-home-automation-and-the-smart-home/index.html index 721a9ea365..77fc3e7b19 100644 --- a/blog/2014/12/26/home-control-home-automation-and-the-smart-home/index.html +++ b/blog/2014/12/26/home-control-home-automation-and-the-smart-home/index.html @@ -242,6 +242,12 @@ This article will try to explain how they all relate.

diff --git a/blog/2015/01/04/hey-pushbullet-nice-talking-to-you/index.html b/blog/2015/01/04/hey-pushbullet-nice-talking-to-you/index.html index 4ca66b84d2..405554cb50 100644 --- a/blog/2015/01/04/hey-pushbullet-nice-talking-to-you/index.html +++ b/blog/2015/01/04/hey-pushbullet-nice-talking-to-you/index.html @@ -226,6 +226,12 @@ api_key=ABCDEFGHJKLMNOPQRSTUVXYZ diff --git a/blog/2015/01/11/bootstrapping-your-setup-with-discovery/index.html b/blog/2015/01/11/bootstrapping-your-setup-with-discovery/index.html index 2b5370a0c6..4d7f14d22e 100644 --- a/blog/2015/01/11/bootstrapping-your-setup-with-discovery/index.html +++ b/blog/2015/01/11/bootstrapping-your-setup-with-discovery/index.html @@ -201,6 +201,12 @@ diff --git a/blog/2015/01/13/nest-in-da-house/index.html b/blog/2015/01/13/nest-in-da-house/index.html index e2cf912383..26b84fbacb 100644 --- a/blog/2015/01/13/nest-in-da-house/index.html +++ b/blog/2015/01/13/nest-in-da-house/index.html @@ -204,6 +204,12 @@ password=YOUR_PASSWORD diff --git a/blog/2015/01/24/release-notes/index.html b/blog/2015/01/24/release-notes/index.html index 05d345893e..6123c86e0b 100644 --- a/blog/2015/01/24/release-notes/index.html +++ b/blog/2015/01/24/release-notes/index.html @@ -210,6 +210,12 @@ Home Assistant now supports --open-ui and --demo-mode diff --git a/blog/2015/02/08/looking-at-the-past/index.html b/blog/2015/02/08/looking-at-the-past/index.html index a37e33f9ac..9d98896307 100644 --- a/blog/2015/02/08/looking-at-the-past/index.html +++ b/blog/2015/02/08/looking-at-the-past/index.html @@ -220,6 +220,12 @@ Events are saved in a local database. Google Graphs is used to draw the graph. D diff --git a/blog/2015/02/24/streaming-updates/index.html b/blog/2015/02/24/streaming-updates/index.html index 6ec51abce5..4b01b03ad2 100644 --- a/blog/2015/02/24/streaming-updates/index.html +++ b/blog/2015/02/24/streaming-updates/index.html @@ -203,6 +203,12 @@ diff --git a/blog/2015/03/01/home-assistant-migrating-to-yaml/index.html b/blog/2015/03/01/home-assistant-migrating-to-yaml/index.html index f5f6084816..9cdff92532 100644 --- a/blog/2015/03/01/home-assistant-migrating-to-yaml/index.html +++ b/blog/2015/03/01/home-assistant-migrating-to-yaml/index.html @@ -193,6 +193,12 @@ diff --git a/blog/2015/03/08/new-logo/index.html b/blog/2015/03/08/new-logo/index.html index eb92bec7d5..f93d82a418 100644 --- a/blog/2015/03/08/new-logo/index.html +++ b/blog/2015/03/08/new-logo/index.html @@ -194,6 +194,12 @@ The old logo, the new detailed logo and the new simple logo. diff --git a/blog/2015/03/11/release-notes/index.html b/blog/2015/03/11/release-notes/index.html index c5bbdbd637..0138a827b9 100644 --- a/blog/2015/03/11/release-notes/index.html +++ b/blog/2015/03/11/release-notes/index.html @@ -233,6 +233,12 @@ An initial version of voice control for Home Assistant has landed. The current i diff --git a/blog/2015/03/22/release-notes/index.html b/blog/2015/03/22/release-notes/index.html index ddf8ff40b1..145901b73b 100644 --- a/blog/2015/03/22/release-notes/index.html +++ b/blog/2015/03/22/release-notes/index.html @@ -270,6 +270,12 @@ I (Paulus) have contributed a scene component. A user can create scenes that cap diff --git a/blog/2015/04/25/release-notes/index.html b/blog/2015/04/25/release-notes/index.html index 7015e07768..ae7fda5c01 100644 --- a/blog/2015/04/25/release-notes/index.html +++ b/blog/2015/04/25/release-notes/index.html @@ -281,6 +281,12 @@ diff --git a/blog/2015/05/09/utc-time-zone-awareness/index.html b/blog/2015/05/09/utc-time-zone-awareness/index.html index dd446e59aa..4866602bc7 100644 --- a/blog/2015/05/09/utc-time-zone-awareness/index.html +++ b/blog/2015/05/09/utc-time-zone-awareness/index.html @@ -216,6 +216,12 @@ diff --git a/blog/2015/05/14/release-notes/index.html b/blog/2015/05/14/release-notes/index.html index bfb86bbb21..728c164e0a 100644 --- a/blog/2015/05/14/release-notes/index.html +++ b/blog/2015/05/14/release-notes/index.html @@ -308,6 +308,12 @@ Before diving into the newly supported devices and services, I want to highlight diff --git a/blog/2015/06/10/release-notes/index.html b/blog/2015/06/10/release-notes/index.html index baccfb2d48..f446b62747 100644 --- a/blog/2015/06/10/release-notes/index.html +++ b/blog/2015/06/10/release-notes/index.html @@ -361,6 +361,12 @@ This switch platform allows you to control your motion detection setting on your diff --git a/blog/2015/07/11/ip-cameras-arduino-kodi-efergy-support/index.html b/blog/2015/07/11/ip-cameras-arduino-kodi-efergy-support/index.html index 461c7547ff..b80af0aa9f 100644 --- a/blog/2015/07/11/ip-cameras-arduino-kodi-efergy-support/index.html +++ b/blog/2015/07/11/ip-cameras-arduino-kodi-efergy-support/index.html @@ -313,6 +313,12 @@ Fabian has added support for Forecast.io to g diff --git a/blog/2015/08/09/mqtt-raspberry-pi-squeezebox-asuswrt-support/index.html b/blog/2015/08/09/mqtt-raspberry-pi-squeezebox-asuswrt-support/index.html index 2614f0dbeb..88cd8967f9 100644 --- a/blog/2015/08/09/mqtt-raspberry-pi-squeezebox-asuswrt-support/index.html +++ b/blog/2015/08/09/mqtt-raspberry-pi-squeezebox-asuswrt-support/index.html @@ -302,6 +302,12 @@ Support for Temper temperature sensors has been contributed by +
  • + InfluxDB and Grafana +
    • + + +
  • 0.9: Rollershutters, locks, binary sensors and InfluxDB
    • @@ -325,12 +331,6 @@ Support for Temper temperature sensors has been contributed by - 0.7.6: Amazon FireTV, Radiotherm thermostats - - - diff --git a/blog/2015/08/17/verisure-and-modern-tp-link-router-support/index.html b/blog/2015/08/17/verisure-and-modern-tp-link-router-support/index.html index 6b2ec198c5..4e9d31cd62 100644 --- a/blog/2015/08/17/verisure-and-modern-tp-link-router-support/index.html +++ b/blog/2015/08/17/verisure-and-modern-tp-link-router-support/index.html @@ -212,6 +212,12 @@ diff --git a/blog/2015/08/26/laundry-automation-with-moteino-mqtt-and-home-assistant/index.html b/blog/2015/08/26/laundry-automation-with-moteino-mqtt-and-home-assistant/index.html index e31117971d..f6f66129a9 100644 --- a/blog/2015/08/26/laundry-automation-with-moteino-mqtt-and-home-assistant/index.html +++ b/blog/2015/08/26/laundry-automation-with-moteino-mqtt-and-home-assistant/index.html @@ -321,6 +321,12 @@ diff --git a/blog/2015/08/31/version-7-revamped-ui-and-improved-distribution/index.html b/blog/2015/08/31/version-7-revamped-ui-and-improved-distribution/index.html index 7e6a3b0655..9032b46d61 100644 --- a/blog/2015/08/31/version-7-revamped-ui-and-improved-distribution/index.html +++ b/blog/2015/08/31/version-7-revamped-ui-and-improved-distribution/index.html @@ -299,6 +299,12 @@ diff --git a/blog/2015/09/11/different-ways-to-use-mqtt-with-home-assistant/index.html b/blog/2015/09/11/different-ways-to-use-mqtt-with-home-assistant/index.html index accabdec1a..11ff8fbfbd 100644 --- a/blog/2015/09/11/different-ways-to-use-mqtt-with-home-assistant/index.html +++ b/blog/2015/09/11/different-ways-to-use-mqtt-with-home-assistant/index.html @@ -502,6 +502,12 @@ PubSubClient client(ethClient); diff --git a/blog/2015/09/13/home-assistant-meets-ifttt/index.html b/blog/2015/09/13/home-assistant-meets-ifttt/index.html index 7e4528d10c..6fc514efcb 100644 --- a/blog/2015/09/13/home-assistant-meets-ifttt/index.html +++ b/blog/2015/09/13/home-assistant-meets-ifttt/index.html @@ -361,6 +361,12 @@ diff --git a/blog/2015/09/18/monitoring-with-glances-and-home-assistant/index.html b/blog/2015/09/18/monitoring-with-glances-and-home-assistant/index.html index b52d06bbf8..b6c5089e75 100644 --- a/blog/2015/09/18/monitoring-with-glances-and-home-assistant/index.html +++ b/blog/2015/09/18/monitoring-with-glances-and-home-assistant/index.html @@ -262,6 +262,12 @@ Glances web server started on http://0.0.0.0:61208/ diff --git a/blog/2015/09/19/alarm-sonos-and-itunes-support/index.html b/blog/2015/09/19/alarm-sonos-and-itunes-support/index.html index 076322f0bf..6c805a573f 100644 --- a/blog/2015/09/19/alarm-sonos-and-itunes-support/index.html +++ b/blog/2015/09/19/alarm-sonos-and-itunes-support/index.html @@ -241,6 +241,12 @@ Automation has gotten a lot of love. It now supports conditions, multiple trigge diff --git a/blog/2015/10/05/home-assistant-goes-geo-with-owntracks/index.html b/blog/2015/10/05/home-assistant-goes-geo-with-owntracks/index.html index 835cc1b7f2..640d09fcd7 100644 --- a/blog/2015/10/05/home-assistant-goes-geo-with-owntracks/index.html +++ b/blog/2015/10/05/home-assistant-goes-geo-with-owntracks/index.html @@ -217,6 +217,12 @@ Map in Home Assistant showing two people and three zones (home, school, work) diff --git a/blog/2015/10/11/measure-temperature-with-esp8266-and-report-to-mqtt/index.html b/blog/2015/10/11/measure-temperature-with-esp8266-and-report-to-mqtt/index.html index 4cc1143907..e67c137fc5 100644 --- a/blog/2015/10/11/measure-temperature-with-esp8266-and-report-to-mqtt/index.html +++ b/blog/2015/10/11/measure-temperature-with-esp8266-and-report-to-mqtt/index.html @@ -548,6 +548,12 @@ Adafruit_HDC1000 hdc = Adafruit_HDC1000(); diff --git a/blog/2015/10/11/rfxtrx-blinkstick-and-snmp-support/index.html b/blog/2015/10/11/rfxtrx-blinkstick-and-snmp-support/index.html index 362b44cc6e..1767956a08 100644 --- a/blog/2015/10/11/rfxtrx-blinkstick-and-snmp-support/index.html +++ b/blog/2015/10/11/rfxtrx-blinkstick-and-snmp-support/index.html @@ -206,6 +206,12 @@ diff --git a/blog/2015/10/26/firetv-and-radiotherm-now-supported/index.html b/blog/2015/10/26/firetv-and-radiotherm-now-supported/index.html index 577bf11be8..9b68c0bee4 100644 --- a/blog/2015/10/26/firetv-and-radiotherm-now-supported/index.html +++ b/blog/2015/10/26/firetv-and-radiotherm-now-supported/index.html @@ -228,6 +228,12 @@ This makes more sense as most people run Home Assistant as a daemon

    diff --git a/blog/2015/11/16/zwave-switches-lights-and-honeywell-thermostats-now-supported/index.html b/blog/2015/11/16/zwave-switches-lights-and-honeywell-thermostats-now-supported/index.html index 92ad4e0723..8a6615f0e9 100644 --- a/blog/2015/11/16/zwave-switches-lights-and-honeywell-thermostats-now-supported/index.html +++ b/blog/2015/11/16/zwave-switches-lights-and-honeywell-thermostats-now-supported/index.html @@ -224,6 +224,12 @@ diff --git a/blog/2015/11/22/survey-november-2015/index.html b/blog/2015/11/22/survey-november-2015/index.html index fa8a8616f6..5bba03781c 100644 --- a/blog/2015/11/22/survey-november-2015/index.html +++ b/blog/2015/11/22/survey-november-2015/index.html @@ -287,6 +287,12 @@ diff --git a/blog/2015/12/05/community-highlights/index.html b/blog/2015/12/05/community-highlights/index.html index 0883e36862..4c089a72fc 100644 --- a/blog/2015/12/05/community-highlights/index.html +++ b/blog/2015/12/05/community-highlights/index.html @@ -197,6 +197,12 @@ diff --git a/blog/2015/12/06/locks-rollershutters-binary-sensors-and-influxdb-support/index.html b/blog/2015/12/06/locks-rollershutters-binary-sensors-and-influxdb-support/index.html index fd3bdb6156..ae89c7e3b0 100644 --- a/blog/2015/12/06/locks-rollershutters-binary-sensors-and-influxdb-support/index.html +++ b/blog/2015/12/06/locks-rollershutters-binary-sensors-and-influxdb-support/index.html @@ -206,6 +206,12 @@ diff --git a/blog/2015/12/07/influxdb-and-grafana/index.html b/blog/2015/12/07/influxdb-and-grafana/index.html new file mode 100644 index 0000000000..6d2c060983 --- /dev/null +++ b/blog/2015/12/07/influxdb-and-grafana/index.html @@ -0,0 +1,399 @@ + + + + + + + + + + + InfluxDB and Grafana - Home Assistant + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    + +
    + + Home Assistant + +
    + +
    + +
    + +
    +
    +
    + + + +
    +
    + +
    + + +
    + +
    + +

    InfluxDB and Grafana

    + + + +
    + + Fabian Affolter + two minutes reading time + + + + + + Comments + +
    + +
    + + +


    +The InfluxDB database is a so-called time series database primarly designed to store sensor data and real-time analytics.

    + +

    The influxdb component makes it possible to transfer all state changes from Home Assistant to an external InfluxDB database.

    + + + +

    The first step is to install the InfluxDB packages. If you are not running Fedora, check the installation section for further details.

    + +
    + 
    $ sudo dnf -y install http://influxdb.s3.amazonaws.com/influxdb-0.9.5.1-1.x86_64.rpm
+
    +
    +
    + +

    Launch the InfluxDB service.

    + +
    + 
    $ sudo systemctl start influxdb
+
    +
    +
    + +

    If everything went well, then the web interface of the ddatabase should be accessible at http://localhost:8083/. Create a database home_assistant to use with Home Assistant either with the web interface or the commandline tool influx.

    + +

    + + InfluxDB web frontend +

    + +
    + 
    $ influx
+Visit https://enterprise.influxdata.com to register for updates, InfluxDB server management, and monitoring.
+Connected to http://localhost:8086 version 0.9.5.1
+InfluxDB shell 0.9.5.1
+> CREATE DATABASE home_assistant
+
    +
    +
    + +

    An optional step is to create a user. Keep in mind to adjust the configuration (add username and password) in the next step if you prefer to go this way.

    + +
    + 
    > CREATE USER "home-assistant" WITH PASSWORD 'password'
+
    +
    +
    + +

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

    + +
    + 
    influxdb:
+  host: 127.0.0.1
+
    +
    +
    + +

    After you restart Home Assistant you should see that the InfluxDB database gets filled. The language to query the database is similar to SQL.

    + +
    + 
    $ influx
+[...]
+> USE home_assistant
+Using database home_assistant
+> SELECT * FROM binary_sensor
+name: binary_sensor
+-------------------
+time            domain        entity_id    value
+1449496577000000000    binary_sensor    bathroom_door    0
+1449496577000000000    binary_sensor    bathroom_window    0
+1449496577000000000    binary_sensor    basement_door    0
+1449496577000000000    binary_sensor    basement_window    0
+1449496684000000000    binary_sensor    bathroom_window    1
+[...]
+
    +
    +
    + +

    Grafana is a dashboard that can create graphs from different sources including InfluxDB. The installation is simple, and there are detailed steps for many different configurations on the Grafana installation page. For a recent system that is running Fedora:

    + +
    + 
    $ sudo dnf -y install https://grafanarel.s3.amazonaws.com/builds/grafana-2.5.0-1.x86_64.rpm
+
    +
    +
    + +

    Start the grafana server.

    + +
    + 
    $ sudo systemctl daemon-reload
+$ sudo systemctl start grafana-server
+$ sudo systemctl status grafana-server
+
    +
    +
    + +

    Login with the username admin and the password admin at http://localhost:3000/login. Now follow the InfluxDB setup instructions.

    + +

    Now you can start to create dashboards and graphs. You have various options to get the data from the graph. The next image just shows a screenshot of the setting for a temperature sensor.

    + +

    + + Grafana settings +

    + +

    If the graph is not showing up in the dashboard you need to adjust the time range in the right upper corner. The graph is created for all state changes recorded by Home Assistant.

    + +

    + + Grafana Temperature graph +

    +
    + + +
    +

    Comments

    +
    +
    + + +
    + + + + +
    +
    + + + + + + + + + + \ No newline at end of file diff --git a/blog/archives/index.html b/blog/archives/index.html index 3e63a148ea..0fb3e9c802 100644 --- a/blog/archives/index.html +++ b/blog/archives/index.html @@ -44,15 +44,19 @@ - Dec 06 + Dec 07 - 0.9: Rollershutters, locks, binary sensors and InfluxDB + InfluxDB and Grafana - ..."> + + + + + how-to..."> @@ -141,6 +145,38 @@

    2015

    +
    +
    + +
    + +
    +
    +

    InfluxDB and Grafana

    + +
    + + + + +
    + +
    +
    + +
    +
    + + +
    @@ -1267,6 +1303,12 @@ diff --git a/blog/categories/architecture/atom.xml b/blog/categories/architecture/atom.xml index 8bb1ccf813..27c03a7e9b 100644 --- a/blog/categories/architecture/atom.xml +++ b/blog/categories/architecture/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: architecture | Home Assistant]]> - 2015-12-06T21:41:08-08:00 + 2015-12-08T00:15:12-08:00 https://home-assistant.io/ diff --git a/blog/categories/architecture/index.html b/blog/categories/architecture/index.html index 069d83b76e..914c4764bd 100644 --- a/blog/categories/architecture/index.html +++ b/blog/categories/architecture/index.html @@ -199,6 +199,12 @@ diff --git a/blog/categories/branding/atom.xml b/blog/categories/branding/atom.xml index 2049ed10d5..2a0a6ebd1f 100644 --- a/blog/categories/branding/atom.xml +++ b/blog/categories/branding/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: branding | Home Assistant]]> - 2015-12-06T21:41:08-08:00 + 2015-12-08T00:15:12-08:00 https://home-assistant.io/ diff --git a/blog/categories/branding/index.html b/blog/categories/branding/index.html index ead2c4d479..104d931996 100644 --- a/blog/categories/branding/index.html +++ b/blog/categories/branding/index.html @@ -199,6 +199,12 @@ diff --git a/blog/categories/community/atom.xml b/blog/categories/community/atom.xml index 5afcd7f855..1718184f45 100644 --- a/blog/categories/community/atom.xml +++ b/blog/categories/community/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: community | Home Assistant]]> - 2015-12-06T21:41:08-08:00 + 2015-12-08T00:15:12-08:00 https://home-assistant.io/ diff --git a/blog/categories/community/index.html b/blog/categories/community/index.html index abee105835..6a7d8029d2 100644 --- a/blog/categories/community/index.html +++ b/blog/categories/community/index.html @@ -199,6 +199,12 @@ diff --git a/blog/categories/component/atom.xml b/blog/categories/component/atom.xml index b5ac731f48..3b6b72917c 100644 --- a/blog/categories/component/atom.xml +++ b/blog/categories/component/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: component | Home Assistant]]> - 2015-12-06T21:41:08-08:00 + 2015-12-08T00:15:12-08:00 https://home-assistant.io/ diff --git a/blog/categories/component/index.html b/blog/categories/component/index.html index d5948b81c6..7bc84f0c70 100644 --- a/blog/categories/component/index.html +++ b/blog/categories/component/index.html @@ -297,6 +297,12 @@ diff --git a/blog/categories/core/atom.xml b/blog/categories/core/atom.xml index 7956c92034..31a8192bd9 100644 --- a/blog/categories/core/atom.xml +++ b/blog/categories/core/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: core | Home Assistant]]> - 2015-12-06T21:41:08-08:00 + 2015-12-08T00:15:12-08:00 https://home-assistant.io/ diff --git a/blog/categories/core/index.html b/blog/categories/core/index.html index fc9ddb9266..ca516519a8 100644 --- a/blog/categories/core/index.html +++ b/blog/categories/core/index.html @@ -231,6 +231,12 @@ diff --git a/blog/categories/esp8266/atom.xml b/blog/categories/esp8266/atom.xml index 7cf2cb8981..4d58fd0776 100644 --- a/blog/categories/esp8266/atom.xml +++ b/blog/categories/esp8266/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: esp8266 | Home Assistant]]> - 2015-12-06T21:41:08-08:00 + 2015-12-08T00:15:12-08:00 https://home-assistant.io/ diff --git a/blog/categories/esp8266/index.html b/blog/categories/esp8266/index.html index 50107ddd87..c97eb28abb 100644 --- a/blog/categories/esp8266/index.html +++ b/blog/categories/esp8266/index.html @@ -203,6 +203,12 @@ diff --git a/blog/categories/frontend/atom.xml b/blog/categories/frontend/atom.xml index a604c9be81..087762dae8 100644 --- a/blog/categories/frontend/atom.xml +++ b/blog/categories/frontend/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: frontend | Home Assistant]]> - 2015-12-06T21:41:08-08:00 + 2015-12-08T00:15:12-08:00 https://home-assistant.io/ diff --git a/blog/categories/frontend/index.html b/blog/categories/frontend/index.html index 3e76874004..67706d0b79 100644 --- a/blog/categories/frontend/index.html +++ b/blog/categories/frontend/index.html @@ -233,6 +233,12 @@ diff --git a/blog/categories/how-to/atom.xml b/blog/categories/how-to/atom.xml index a79bcdd4d9..8b1071e005 100644 --- a/blog/categories/how-to/atom.xml +++ b/blog/categories/how-to/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: how-to | Home Assistant]]> - 2015-12-06T21:41:08-08:00 + 2015-12-08T00:15:12-08:00 https://home-assistant.io/ @@ -13,6 +13,126 @@ Octopress + + <![CDATA[InfluxDB and Grafana]]> + + 2015-12-07T06:15:13-08:00 + https://home-assistant.io/blog/2015/12/07/influxdb-and-grafana +
    +The InfluxDB database is a so-called time series database primarly designed to store sensor data and real-time analytics.

    + +

    The influxdb component makes it possible to transfer all state changes from Home Assistant to an external InfluxDB database.

    + + + +

    The first step is to install the InfluxDB packages. If you are not running Fedora, check the installation section for further details.

    + +
    + 
    $ sudo dnf -y install http://influxdb.s3.amazonaws.com/influxdb-0.9.5.1-1.x86_64.rpm
+
    +
    +
    + +

    Launch the InfluxDB service.

    + +
    + 
    $ sudo systemctl start influxdb
+
    +
    +
    + +

    If everything went well, then the web interface of the ddatabase should be accessible at http://localhost:8083/. Create a database home_assistant to use with Home Assistant either with the web interface or the commandline tool influx.

    + +

    + + InfluxDB web frontend +

    + +
    + 
    $ influx
+Visit https://enterprise.influxdata.com to register for updates, InfluxDB server management, and monitoring.
+Connected to http://localhost:8086 version 0.9.5.1
+InfluxDB shell 0.9.5.1
+> CREATE DATABASE home_assistant
+
    +
    +
    + +

    An optional step is to create a user. Keep in mind to adjust the configuration (add username and password) in the next step if you prefer to go this way.

    + +
    + 
    > CREATE USER "home-assistant" WITH PASSWORD 'password'
+
    +
    +
    + +

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

    + +
    + 
    influxdb:
+  host: 127.0.0.1
+
    +
    +
    + +

    After you restart Home Assistant you should see that the InfluxDB database gets filled. The language to query the database is similar to SQL.

    + +
    + 
    $ influx
+[...]
+> USE home_assistant
+Using database home_assistant
+> SELECT * FROM binary_sensor
+name: binary_sensor
+-------------------
+time            domain        entity_id    value
+1449496577000000000    binary_sensor    bathroom_door    0
+1449496577000000000    binary_sensor    bathroom_window    0
+1449496577000000000    binary_sensor    basement_door    0
+1449496577000000000    binary_sensor    basement_window    0
+1449496684000000000    binary_sensor    bathroom_window    1
+[...]
+
    +
    +
    + +

    Grafana is a dashboard that can create graphs from different sources including InfluxDB. The installation is simple, and there are detailed steps for many different configurations on the Grafana installation page. For a recent system that is running Fedora:

    + +
    + 
    $ sudo dnf -y install https://grafanarel.s3.amazonaws.com/builds/grafana-2.5.0-1.x86_64.rpm
+
    +
    +
    + +

    Start the grafana server.

    + +
    + 
    $ sudo systemctl daemon-reload
+$ sudo systemctl start grafana-server
+$ sudo systemctl status grafana-server
+
    +
    +
    + +

    Login with the username admin and the password admin at http://localhost:3000/login. Now follow the InfluxDB setup instructions.

    + +

    Now you can start to create dashboards and graphs. You have various options to get the data from the graph. The next image just shows a screenshot of the setting for a temperature sensor.

    + +

    + + Grafana settings +

    + +

    If the graph is not showing up in the dashboard you need to adjust the time range in the right upper corner. The graph is created for all state changes recorded by Home Assistant.

    + +

    + + Grafana Temperature graph +

    + +]]>     +     + <![CDATA[Report the temperature with ESP8266 to MQTT]]> diff --git a/blog/categories/how-to/index.html b/blog/categories/how-to/index.html index 3e79f0cf50..221f3f1690 100644 --- a/blog/categories/how-to/index.html +++ b/blog/categories/how-to/index.html @@ -110,6 +110,38 @@

    2015

    + + + +
    @@ -303,6 +335,12 @@ diff --git a/blog/categories/mqtt/atom.xml b/blog/categories/mqtt/atom.xml index cabe49ca1d..abd43d0909 100644 --- a/blog/categories/mqtt/atom.xml +++ b/blog/categories/mqtt/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: mqtt | Home Assistant]]> - 2015-12-06T21:41:08-08:00 + 2015-12-08T00:15:12-08:00 https://home-assistant.io/ diff --git a/blog/categories/mqtt/index.html b/blog/categories/mqtt/index.html index 5006aa0234..9098ccebdf 100644 --- a/blog/categories/mqtt/index.html +++ b/blog/categories/mqtt/index.html @@ -237,6 +237,12 @@ diff --git a/blog/categories/release-notes/atom.xml b/blog/categories/release-notes/atom.xml index 6a564d4559..f318a0850a 100644 --- a/blog/categories/release-notes/atom.xml +++ b/blog/categories/release-notes/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: release-notes | Home Assistant]]> - 2015-12-06T21:41:08-08:00 + 2015-12-08T00:15:12-08:00 https://home-assistant.io/ diff --git a/blog/categories/release-notes/index.html b/blog/categories/release-notes/index.html index 069741e253..9be316360b 100644 --- a/blog/categories/release-notes/index.html +++ b/blog/categories/release-notes/index.html @@ -681,6 +681,12 @@ diff --git a/blog/categories/survey/atom.xml b/blog/categories/survey/atom.xml index 24b93ed202..e6422bf74a 100644 --- a/blog/categories/survey/atom.xml +++ b/blog/categories/survey/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: survey | Home Assistant]]> - 2015-12-06T21:41:08-08:00 + 2015-12-08T00:15:12-08:00 https://home-assistant.io/ diff --git a/blog/categories/survey/index.html b/blog/categories/survey/index.html index f9e1f76900..b4d9db078e 100644 --- a/blog/categories/survey/index.html +++ b/blog/categories/survey/index.html @@ -199,6 +199,12 @@ diff --git a/blog/categories/user-stories/atom.xml b/blog/categories/user-stories/atom.xml index 802421e5dd..3b90c11f1a 100644 --- a/blog/categories/user-stories/atom.xml +++ b/blog/categories/user-stories/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: user-stories | Home Assistant]]> - 2015-12-06T21:41:08-08:00 + 2015-12-08T00:15:12-08:00 https://home-assistant.io/ diff --git a/blog/categories/user-stories/index.html b/blog/categories/user-stories/index.html index 99335b3382..3a760e1bc9 100644 --- a/blog/categories/user-stories/index.html +++ b/blog/categories/user-stories/index.html @@ -231,6 +231,12 @@ diff --git a/blog/categories/website/atom.xml b/blog/categories/website/atom.xml index 94a1870470..de39c4946e 100644 --- a/blog/categories/website/atom.xml +++ b/blog/categories/website/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: website | Home Assistant]]> - 2015-12-06T21:41:08-08:00 + 2015-12-08T00:15:12-08:00 https://home-assistant.io/ diff --git a/blog/categories/website/index.html b/blog/categories/website/index.html index 5223f7825d..b07bd1d3ba 100644 --- a/blog/categories/website/index.html +++ b/blog/categories/website/index.html @@ -199,6 +199,12 @@ diff --git a/blog/index.html b/blog/index.html index 8a6302b73f..c0244c918d 100644 --- a/blog/index.html +++ b/blog/index.html @@ -27,20 +27,26 @@ - 0.9: Rollershutters, locks, binary sensors and InfluxDB + InfluxDB and Grafana - December 6, 2015 - Paulus Schoutsen - less than one minute reading time + December 07, 2015 + Fabian Affolter + two minutes reading time - ..."> + + how-to + + + + + ..."> @@ -113,6 +119,53 @@ +
    +
    + +

    + InfluxDB and Grafana +

    + + + +
    + + Fabian Affolter + two minutes reading time + + + + + + Comments + +
    + +
    + + +
    +


    +The InfluxDB database is a so-called time series database primarly designed to store sensor data and real-time analytics.

    + +

    The influxdb component makes it possible to transfer all state changes from Home Assistant to an external InfluxDB database.

    + + + + Read on → + +
    +
    +
    +
    @@ -674,51 +727,6 @@ Map in Home Assistant showing two people and three zones (home, school, work)
    -
    -
    - -

    - Remote Monitoring with Glances -

    - - - -
    - - Fabian Affolter - two minutes reading time - - - - - - Comments - -
    - -
    - - -
    -


    -Inspried by a feature requests I started looking into the available options to do monitoring of remote hosts. The feature request is about displaying system information in a similar way than the systemmonitor sensor does it for the local system. After a while I started to think that it would be a nice addition for a small home network where no full-blown system monitoring setup is present.

    - - - - Read on → - -
    -
    -
    - -
    -
    - -
    -
    - -

    - Bootstrapping your setup with Discovery -

    - - - -
    - - Paulus Schoutsen - less than one minute reading time - - - - - - Comments - -
    - -
    - - -
    -

    Most people do not like configuring things. Things just have to work, out of the box. Reaching this scenario is the goal of what we are about to introduce: our new discovery component.

    - -

    The discovery component will scan the WiFi network from time to time for connected zeroconf/mDNS and uPnP devices. The intial introduction is mainly focussed on getting the right architecture in place and discovers Belkin WeMo switches and Google Chromecasts connected to your network. When found, it will load and notify the appropritate component and it will be ready to use within seconds.

    - -

    Most devices still require some sort of interaction from the user after being discovered - be it a button being pressed or some sort of authentication. This is a challenge that will be solved in the future.

    - -

    To enable the discovery component, add the following to your home-assistant.conf:

    - -
    - 
    [discovery]
-
    -
    -
    - -

    A new discovery section has been added to the Adding a new platform page with instructions how to make your platform discoverable.

    - -
    diff --git a/blog/posts/4/index.html b/blog/posts/4/index.html index 6944a24923..b634d1f7ca 100644 --- a/blog/posts/4/index.html +++ b/blog/posts/4/index.html @@ -27,23 +27,21 @@ - Hello PushBullet, nice talking to you + Bootstrapping your setup with Discovery - January 4, 2015 + January 11, 2015 Paulus Schoutsen - 1 minute reading time + less than one minute reading time - component - -..."> + co..."> @@ -116,6 +114,61 @@ +
    +
    + +

    + Bootstrapping your setup with Discovery +

    + + + +
    + + Paulus Schoutsen + less than one minute reading time + + + + + + Comments + +
    + +
    + + +
    +

    Most people do not like configuring things. Things just have to work, out of the box. Reaching this scenario is the goal of what we are about to introduce: our new discovery component.

    + +

    The discovery component will scan the WiFi network from time to time for connected zeroconf/mDNS and uPnP devices. The intial introduction is mainly focussed on getting the right architecture in place and discovers Belkin WeMo switches and Google Chromecasts connected to your network. When found, it will load and notify the appropritate component and it will be ready to use within seconds.

    + +

    Most devices still require some sort of interaction from the user after being discovered - be it a button being pressed or some sort of authentication. This is a challenge that will be solved in the future.

    + +

    To enable the discovery component, add the following to your home-assistant.conf:

    + +
    + 
    [discovery]
+
    +
    +
    + +

    A new discovery section has been added to the Adding a new platform page with instructions how to make your platform discoverable.

    + + +
    +
    +
    +
    diff --git a/components/influxdb/index.html b/components/influxdb/index.html index cf894d95a0..09e22e7d33 100644 --- a/components/influxdb/index.html +++ b/components/influxdb/index.html @@ -100,23 +100,33 @@
    -

    This component will allow you to record events to an InfluxDB database.

    +

    The influxdb component makes it possible to transfer all state changes to an external InfluxDB database.

    + +

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

    # Example configuration.yaml entry
 influxdb:
   host: DB_HOST_IP_ADDRESS
-  # Optional, default: 8086
   port: 20000
-  # Optional, default: home_assistant
   database: DB_TO_STORE_EVENTS
-  # Optional
-  username: MY_USER
-  password: MY_PASS
+  username: MY_USERNAME
+  password: MY_PASSWORD
    +

    Configuration variables:

    + +
      +
    • host (Required): IP address of your database host, eg. http://192.168.1.10.
      • +
    • port (Optional): Port to use. Defaults to 8086.
      • +
    • database (Optional): Name of the database to use. Defaults to home_assistant
      • +
    • username (Optional): The username of the database user.
      • +
    • password (Optional): The password for the database user account.
      • +
    + +
    diff --git a/components/zwave/index.html b/components/zwave/index.html index 3128b4129f..857136fb5c 100644 --- a/components/zwave/index.html +++ b/components/zwave/index.html @@ -123,6 +123,7 @@ $ pip3 install "cython<0.23" 
    # Example configuration.yaml entry
 zwave:
   usb_path: /dev/ttyUSB0
+  config_path: /usr/local/share/python-openzwave/config
    @@ -131,6 +132,7 @@ $ pip3 install "cython<0.23"

    To find the path of your Z-Wave stick, run:

    diff --git a/images/blog/2015-12-influxdb/grafana-graph.png b/images/blog/2015-12-influxdb/grafana-graph.png new file mode 100644 index 0000000000..6cbcf05288 Binary files /dev/null and b/images/blog/2015-12-influxdb/grafana-graph.png differ diff --git a/images/blog/2015-12-influxdb/grafana-settings.png b/images/blog/2015-12-influxdb/grafana-settings.png new file mode 100644 index 0000000000..48dce2a674 Binary files /dev/null and b/images/blog/2015-12-influxdb/grafana-settings.png differ diff --git a/images/blog/2015-12-influxdb/influxdb-frontend.png b/images/blog/2015-12-influxdb/influxdb-frontend.png new file mode 100644 index 0000000000..604a1d9063 Binary files /dev/null and b/images/blog/2015-12-influxdb/influxdb-frontend.png differ diff --git a/images/supported_brands/grafana.png b/images/supported_brands/grafana.png new file mode 100644 index 0000000000..18a431e478 Binary files /dev/null and b/images/supported_brands/grafana.png differ diff --git a/sitemap.xml b/sitemap.xml index 6a3daa0c66..b7057a4458 100644 --- a/sitemap.xml +++ b/sitemap.xml @@ -1,5 +1,9 @@ + + https://home-assistant.io/blog/2015/12/07/influxdb-and-grafana/ + 2015-12-07T06:15:13-08:00 + https://home-assistant.io/blog/2015/12/06/locks-rollershutters-binary-sensors-and-influxdb-support/ 2015-12-06T11:29:00-08:00 @@ -248,6 +252,15 @@ https://home-assistant.io/blog/categories/community/ + + + https://home-assistant.io/blog/posts/2/ + + + https://home-assistant.io/blog/posts/3/ + + + https://home-assistant.io/blog/posts/4/ https://home-assistant.io/components/automation/ @@ -822,6 +835,9 @@ https://home-assistant.io/blog/2015/12/06/locks-rollershutters-binary-sensors-and-influxdb-support/ + + https://home-assistant.io/blog/2015/12/07/influxdb-and-grafana/ + https://home-assistant.io/components/alarm_control_panel.html 2015-12-03T22:48:53-08:00