252 lines
15 KiB
HTML
252 lines
15 KiB
HTML
<!doctype html>
|
|
<!--[if lt IE 7]> <html class="no-js lt-ie9 lt-ie8 lt-ie7"> <![endif]-->
|
|
<!--[if IE 7]> <html class="no-js lt-ie9 lt-ie8"> <![endif]-->
|
|
<!--[if IE 8]> <html class="no-js lt-ie9"> <![endif]-->
|
|
<!--[if gt IE 8]><!--> <html> <!--<![endif]-->
|
|
<head>
|
|
<meta charset="utf-8">
|
|
<meta http-equiv="X-UA-Compatible" content="IE=edge,chrome=1">
|
|
<title>InfluxDB and Grafana - Home Assistant</title>
|
|
<meta name="author" content="Fabian Affolter">
|
|
<meta name="description" content="A step by step guide to start recording data from Home Assistant in InfluxDB and visualizing it using Grafana.">
|
|
<meta name="viewport" content="width=device-width">
|
|
<link rel="canonical" href="https://home-assistant.io/blog/2015/12/07/influxdb-and-grafana/">
|
|
<meta property="fb:app_id" content="338291289691179">
|
|
<meta property="og:title" content="InfluxDB and Grafana">
|
|
<meta property="og:site_name" content="Home Assistant">
|
|
<meta property="og:url" content="https://home-assistant.io/blog/2015/12/07/influxdb-and-grafana/">
|
|
<meta property="og:type" content="article">
|
|
<meta property="og:description" content="A step by step guide to start recording data from Home Assistant in InfluxDB and visualizing it using Grafana.">
|
|
<meta property="og:image" content="https://home-assistant.io/images/blog/2015-12-influxdb/grafana-graph.png">
|
|
<meta name="twitter:card" content="summary_large_image">
|
|
<meta name="twitter:site" content="@home_assistant">
|
|
<meta name="twitter:title" content="InfluxDB and Grafana">
|
|
<meta name="twitter:description" content="A step by step guide to start recording data from Home Assistant in InfluxDB and visualizing it using Grafana.">
|
|
<meta name="twitter:image" content="https://home-assistant.io/images/blog/2015-12-influxdb/grafana-graph.png">
|
|
<link href="/stylesheets/screen.css" media="screen, projection" rel="stylesheet">
|
|
<link href="/atom.xml" rel="alternate" title="Home Assistant" type="application/atom+xml">
|
|
<link rel='shortcut icon' href='/images/favicon.ico' />
|
|
<link rel='icon' type='image/png' href='/images/favicon-192x192.png' sizes='192x192' />
|
|
</head>
|
|
<body >
|
|
<header>
|
|
<div class="grid-wrapper">
|
|
<div class="grid">
|
|
<div class="grid__item three-tenths lap-two-sixths palm-one-whole ha-title">
|
|
<a href="/" class="site-title">
|
|
<img width='40' src='/demo/favicon-192x192.png'>
|
|
<span>Home Assistant</span>
|
|
</a>
|
|
</div>
|
|
<div class="grid__item seven-tenths lap-four-sixths palm-one-whole">
|
|
<nav>
|
|
<input type="checkbox" id="toggle">
|
|
<label for="toggle" class="toggle" data-open="Main Menu" data-close="Close Menu"></label>
|
|
<ul class="menu pull-right">
|
|
<li><a href="/getting-started/">Getting started</a></li>
|
|
<li><a href="/components/">Components</a></li>
|
|
<li><a href="/docs/">Docs</a></li>
|
|
<li><a href="/cookbook/">Examples</a></li>
|
|
<li><a href="/developers/">Developers</a></li>
|
|
<li><a href="/blog/">Blog</a></li>
|
|
<li><a href="/help/">Need help?</a></li>
|
|
</ul>
|
|
</nav>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
</header>
|
|
<div class="grid-wrapper">
|
|
<div class="grid grid-center">
|
|
<div class="grid__item two-thirds lap-one-whole palm-one-whole">
|
|
<article class="post">
|
|
<header>
|
|
<h1 class="title indent">InfluxDB and Grafana</h1>
|
|
<div class="meta clearfix">
|
|
<time datetime="2015-12-07T14:15:13+00:00" pubdate data-updated="true"><i class="icon-calendar"></i> December 07, 2015</time>
|
|
<span class="byline author vcard"><i class='icon-user'></i> Fabian Affolter</span>
|
|
<span><i class='icon-time'></i> two minutes reading time</span>
|
|
<span>
|
|
<i class="icon-tags"></i>
|
|
<ul class="tags unstyled">
|
|
<li>How-To</li>
|
|
</ul>
|
|
</span>
|
|
<a class='comments'
|
|
href="#disqus_thread"
|
|
>Comments</a>
|
|
</div>
|
|
</header>
|
|
<p><img src="/images/supported_brands/influxdb.png" style="clear: right; border:none; box-shadow: none; float: right; margin-bottom: 12px;" width="200" /><img src="/images/supported_brands/grafana.png" style="clear: right; border:none; box-shadow: none; float: right; margin-bottom: 12px;" width="200" />
|
|
The <a href="https://influxdb.com/">InfluxDB</a> database is a so-called time series database primarly designed to store sensor data and real-time analytics.</p>
|
|
<p>The <code class="highlighter-rouge">influxdb</code> component makes it possible to transfer all state changes from Home Assistant to an external <a href="https://influxdb.com/">InfluxDB</a> database.</p>
|
|
<a name="read-more"></a>
|
|
<p>The first step is to install the InfluxDB packages. If you are not running Fedora, check the <a href="https://influxdb.com/docs/v0.9/introduction/installation.html">installation</a> section for further details.</p>
|
|
<div class="language-bash highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>sudo dnf -y install http://influxdb.s3.amazonaws.com/influxdb-0.9.5.1-1.x86_64.rpm
|
|
</code></pre>
|
|
</div>
|
|
<p>Launch the InfluxDB service.</p>
|
|
<div class="language-bash highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>sudo systemctl start influxdb
|
|
</code></pre>
|
|
</div>
|
|
<p>If everything went well, then the web interface of the database should be accessible at <a href="http://localhost:8083/">http://localhost:8083/</a>. Create a database <code class="highlighter-rouge">home_assistant</code> to use with Home Assistant either with the web interface or the commandline tool <code class="highlighter-rouge">influx</code>.</p>
|
|
<p class="img">
|
|
<img src="/images/blog/2015-12-influxdb/influxdb-frontend.png" />
|
|
InfluxDB web frontend
|
|
</p>
|
|
<div class="language-bash highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>influx
|
|
Visit https://enterprise.influxdata.com to register <span class="k">for </span>updates, InfluxDB server management, and monitoring.
|
|
Connected to http://localhost:8086 version 0.9.5.1
|
|
InfluxDB shell 0.9.5.1
|
|
<span class="gp">> </span>CREATE DATABASE home_assistant
|
|
</code></pre>
|
|
</div>
|
|
<p>An optional step is to create a user. Keep in mind to adjust the configuration (add <code class="highlighter-rouge">username</code> and <code class="highlighter-rouge">password</code>) in the next step if you prefer to go this way.</p>
|
|
<div class="language-bash highlighter-rouge"><pre class="highlight"><code><span class="gp">> </span>CREATE USER <span class="s2">"home-assistant"</span> WITH PASSWORD <span class="s1">'password'</span>
|
|
</code></pre>
|
|
</div>
|
|
<p>To use the <code class="highlighter-rouge">influxdb</code> component in your installation, add the following to your <code class="highlighter-rouge">configuration.yaml</code> file:</p>
|
|
<div class="language-yaml highlighter-rouge"><pre class="highlight"><code><span class="s">influxdb</span><span class="pi">:</span>
|
|
<span class="s">host</span><span class="pi">:</span> <span class="s">127.0.0.1</span>
|
|
</code></pre>
|
|
</div>
|
|
<p>After you restart Home Assistant you should see that the InfluxDB database gets filled. The <a href="https://influxdb.com/docs/v0.9/query_language/index.html">language</a> to query the database is similar to SQL.</p>
|
|
<div class="language-bash highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>influx
|
|
<span class="o">[</span>...]
|
|
<span class="gp">> </span>USE home_assistant
|
|
Using database home_assistant
|
|
<span class="gp">> </span>SELECT <span class="k">*</span> FROM binary_sensor
|
|
name: binary_sensor
|
|
-------------------
|
|
<span class="nb">time </span>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
|
|
<span class="o">[</span>...]
|
|
</code></pre>
|
|
</div>
|
|
<p><a href="http://grafana.org/">Grafana</a> 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 <a href="http://docs.grafana.org/installation/">Grafana installation</a> page. For a recent system that is running Fedora:</p>
|
|
<div class="language-bash highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>sudo dnf -y install https://grafanarel.s3.amazonaws.com/builds/grafana-2.5.0-1.x86_64.rpm
|
|
</code></pre>
|
|
</div>
|
|
<p>Start the grafana server.</p>
|
|
<div class="language-bash highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>sudo systemctl daemon-reload
|
|
<span class="gp">$ </span>sudo systemctl start grafana-server
|
|
<span class="gp">$ </span>sudo systemctl status grafana-server
|
|
</code></pre>
|
|
</div>
|
|
<p>Login with the username <code class="highlighter-rouge">admin</code> and the password <code class="highlighter-rouge">admin</code> at <a href="http://localhost:3000/login">http://localhost:3000/login</a>. Now follow the <a href="http://docs.grafana.org/datasources/influxdb/">InfluxDB setup instructions</a>.</p>
|
|
<p>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.</p>
|
|
<p class="img">
|
|
<img src="/images/blog/2015-12-influxdb/grafana-settings.png" />
|
|
Grafana settings
|
|
</p>
|
|
<p>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.</p>
|
|
<p class="img">
|
|
<img src="/images/blog/2015-12-influxdb/grafana-graph.png" />
|
|
Grafana Temperature graph
|
|
</p>
|
|
</article>
|
|
<section id="disqus">
|
|
<h3 class="indent title">Comments</h3>
|
|
<div id="disqus_thread" aria-live="polite"><noscript>Please enable JavaScript to view the <a href="http://disqus.com/?ref_noscript">comments powered by Disqus.</a></noscript></div>
|
|
</section>
|
|
</div>
|
|
<aside id="sidebar" class="grid__item one-third lap-one-whole palm-one-whole">
|
|
<div class="grid">
|
|
<section class="aside-module grid__item one-whole lap-one-half">
|
|
<h1 class="title delta">About Home Assistant</h1>
|
|
<ul class="divided">
|
|
<li>
|
|
Home Assistant is an open-source home automation platform running on Python 3. Track and control all devices at home and automate control.
|
|
</li>
|
|
<li><a href='/getting-started/'>Get started with Home Assistant</a></li>
|
|
<li><a href='/demo/'>Try the online demo</a></li>
|
|
<li><a class="twitter-follow-button" href="https://twitter.com/Home_Assistant">Follow Home Assistant on Twitter</a></li>
|
|
<li><div class="fb-like" data-href="https://www.facebook.com/homeassistantio/" data-layout="standard" data-action="like" data-size="small" data-show-faces="true" data-share="false"></div></li>
|
|
</ul>
|
|
</section>
|
|
<div id="fb-root"></div>
|
|
<script>!function(d,s,id){var js,fjs=d.getElementsByTagName(s)[0];if(!d.getElementById(id)){js=d.createElement(s);js.id=id;js.async=true;js.src='//platform.twitter.com/widgets.js';fjs.parentNode.insertBefore(js,fjs);}}(document, 'script', 'twitter-wjs');</script>
|
|
<script>(function(d,s,id){var js,fjs=d.getElementsByTagName(s)[0];if(d.getElementById(id)){return;}js=d.createElement(s);js.id=id;js.async=true;js.src="//connect.facebook.net/en_US/all.js#appId=338291289691179&xfbml=1";fjs.parentNode.insertBefore(js,fjs);}(document,'script','facebook-jssdk'));</script>
|
|
<section class="sharing aside-module grid__item one-whole lap-one-half">
|
|
<h1 class="title delta">Share this post</h1>
|
|
<a href="//twitter.com/share"
|
|
class="twitter-share-button"
|
|
data-via="home_assistant"
|
|
data-related="home_assistant"
|
|
data-url="https://home-assistant.io/blog/2015/12/07/influxdb-and-grafana/"
|
|
data-counturl="https://home-assistant.io/blog/2015/12/07/influxdb-and-grafana/" >Tweet</a>
|
|
<div class="fb-share-button" style='top: -6px;'
|
|
data-href="https://home-assistant.io/blog/2015/12/07/influxdb-and-grafana/"
|
|
data-layout="button_count">
|
|
</div>
|
|
<div class="g-plusone" data-size="standard"></div>
|
|
</section>
|
|
<script src="https://apis.google.com/js/platform.js" async defer></script>
|
|
<section id="recent-posts" class="aside-module grid__item one-whole lap-one-half">
|
|
<h1 class="title delta">Recent Posts</h1>
|
|
<ul class="divided">
|
|
<li class="post">
|
|
<a href="/blog/2017/06/17/release-47/">0.47: Python Scripts, Sesame Smart Lock, Gitter, Onvif cameras</a>
|
|
</li>
|
|
<li class="post">
|
|
<a href="/blog/2017/06/15/zwave-entity-ids/">ZWave Entity IDs</a>
|
|
</li>
|
|
<li class="post">
|
|
<a href="/blog/2017/06/10/interview-with-jupiter-broadcasting/">Linux Action Show special about Home Assistant</a>
|
|
</li>
|
|
<li class="post">
|
|
<a href="/blog/2017/06/04/release-46/">0.46: Rachio sprinklers, Netgear Arlo cameras and Z-Wave fans</a>
|
|
</li>
|
|
<li class="post">
|
|
<a href="/blog/2017/06/02/home-assistant-podcast-1/">Home Assistant Podcast 1</a>
|
|
</li>
|
|
</ul>
|
|
</section>
|
|
</div>
|
|
</aside>
|
|
</div>
|
|
</div>
|
|
<footer>
|
|
<div class="grid-wrapper">
|
|
<div class="grid">
|
|
<div class="grid__item">
|
|
<div class="copyright">
|
|
<a rel="me" href='https://twitter.com/home_assistant'><i class="icon-twitter"></i></a>
|
|
<a rel="me" href='https://facebook.com/homeassistantio'><i class="icon-facebook"></i></a>
|
|
<a rel="me" href='https://plus.google.com/110560654828510104551'><i class="icon-google-plus"></i></a>
|
|
<a rel="me" href='https://github.com/home-assistant/home-assistant'><i class="icon-github"></i></a>
|
|
<div class="credit">
|
|
Contact us at <a href='mailto:hello@home-assistant.io'>hello@home-assistant.io</a> (no support!).<br>
|
|
Website powered by <a href='http://jekyllrb.com/'>Jekyll</a> and the <a href='https://github.com/coogie/oscailte'>Oscalite theme</a>.<br />
|
|
Hosted by <a href='https://pages.github.com/'>GitHub</a> and served by <a href='https://cloudflare.com'>CloudFlare</a>.
|
|
</div>
|
|
<a rel="license" href="http://creativecommons.org/licenses/by-nc-sa/4.0/"><img alt="Creative Commons License" style="border-width:0" src="https://i.creativecommons.org/l/by-nc-sa/4.0/88x31.png" /></a><br /><span xmlns:dct="http://purl.org/dc/terms/" property="dct:title">home-assistant.io</span> is licensed under a <a rel="license" href="http://creativecommons.org/licenses/by-nc-sa/4.0/">Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International License</a>.
|
|
</div>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
</footer>
|
|
<script>
|
|
var _gaq=[['_setAccount','UA-57927901-1'],['_trackPageview']];
|
|
(function(d,t){var g=d.createElement(t),s=d.getElementsByTagName(t)[0];
|
|
g.src=('https:'==location.protocol?'//ssl':'//www')+'.google-analytics.com/ga.js';
|
|
s.parentNode.insertBefore(g,s)}(document,'script'));
|
|
</script>
|
|
<script>
|
|
var disqus_shortname = 'home-assistant';
|
|
// var disqus_developer = 1;
|
|
var disqus_identifier = 'https://home-assistant.io/blog/2015/12/07/influxdb-and-grafana/';
|
|
var disqus_url = 'https://home-assistant.io/blog/2015/12/07/influxdb-and-grafana/';
|
|
var disqus_script = 'embed.js';
|
|
(function () {
|
|
var dsq = document.createElement('script'); dsq.type = 'text/javascript'; dsq.async = true;
|
|
dsq.src = '//' + disqus_shortname + '.disqus.com/' + disqus_script;
|
|
(document.getElementsByTagName('head')[0] || document.getElementsByTagName('body')[0]).appendChild(dsq);
|
|
}());
|
|
</script>
|
|
</body>
|
|
</html>
|