Site updated at 2016-10-22 22:37:41 UTC
This commit is contained in:
Travis CI
parent
ab857e95a7
commit
860912100c
408 changed files with 11332 additions and 1691 deletions
|
|
@ -261,6 +261,12 @@ group.all_switches 8018
|
|||
<ul class="divided">
|
||||
|
||||
|
||||
<li class="post">
|
||||
<a href="/blog/2016/10/22/flash-briefing-updater-hacktoberfest/">0.31: Reading you the news, some serious business, spooky hackery and a breaking Z-Wave change</a>
|
||||
</li>
|
||||
|
||||
|
||||
|
||||
<li class="post">
|
||||
<a href="/blog/2016/10/08/hassbian-rest-digital-ocean/">0.30: More Async, HASSbian, Digital Ocean, statistics, REST</a>
|
||||
</li>
|
||||
|
|
@ -284,12 +290,6 @@ group.all_switches 8018
|
|||
</li>
|
||||
|
||||
|
||||
|
||||
<li class="post">
|
||||
<a href="/blog/2016/09/10/notify-group-reload-api-pihole/">0.28: Reload automation and groups, API documentation, car tracking, Pi-Hole stats</a>
|
||||
</li>
|
||||
|
||||
|
||||
</ul>
|
||||
</section>
|
||||
|
||||
|
|
|
|||
|
|
@ -94,6 +94,9 @@
|
|||
<p>Home Assistant is built from many small building blocks that together offer a powerful and customizable system. This page is a collection of the more advanced topics.</p>
|
||||
|
||||
<ul>
|
||||
<li>
|
||||
<p><a href="/topics/updater_details/">Details about the updater</a></p>
|
||||
</li>
|
||||
<li>
|
||||
<p><a href="/topics/webserver_details/">Details about the web server</a></p>
|
||||
</li>
|
||||
|
|
|
|||
|
|
@ -256,6 +256,23 @@ customize.yaml
|
|||
<li><code class="highlighter-rouge">!include_dir_merge_named</code> will return the content of a directory as a dictionary by loading each file and merging it into 1 big dictionary.</li>
|
||||
</ul>
|
||||
|
||||
<p>These work recursively. As an example using <code class="highlighter-rouge">!include_dir_* automation</code>, will include all 6 files shown below:</p>
|
||||
|
||||
<div class="language-bash highlighter-rouge"><pre class="highlight"><code>.
|
||||
└── .homeassistant
|
||||
├── automation
|
||||
│ ├── lights
|
||||
│ │ ├── turn_light_off_bedroom.yaml
|
||||
│ │ ├── turn_light_off_lounge.yaml
|
||||
│ │ ├── turn_light_on_bedroom.yaml
|
||||
│ │ └── turn_light_on_lounge.yaml
|
||||
│ ├── say_hello.yaml
|
||||
│ └── sensors
|
||||
│ └── react.yaml
|
||||
└── configuration.yaml <span class="o">(</span>not included<span class="o">)</span>
|
||||
</code></pre>
|
||||
</div>
|
||||
|
||||
<h4><a class="title-link" name="example-include_dir_list" href="#example-include_dir_list"></a> Example: <code class="highlighter-rouge">!include_dir_list</code></h4>
|
||||
|
||||
<p><code class="highlighter-rouge">configuration.yaml</code></p>
|
||||
|
|
@ -435,7 +452,6 @@ customize.yaml
|
|||
<span class="s">action</span><span class="pi">:</span>
|
||||
<span class="s">service</span><span class="pi">:</span> <span class="s">light.turn_on</span>
|
||||
<span class="s">entity_id</span><span class="pi">:</span> <span class="s">light.entryway</span>
|
||||
|
||||
<span class="pi">-</span> <span class="s">alias</span><span class="pi">:</span> <span class="s">Automation 2</span>
|
||||
<span class="s">trigger</span><span class="pi">:</span>
|
||||
<span class="s">platform</span><span class="pi">:</span> <span class="s">state</span>
|
||||
|
|
|
|||
300
topics/updater_details/index.html
Normal file
300
topics/updater_details/index.html
Normal file
|
|
@ -0,0 +1,300 @@
|
|||
<!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>Details about the updater - Home Assistant</title>
|
||||
<meta name="author" content="Home Assistant">
|
||||
<meta name="description" content="Details what the updater component is reporting about your Home Assistant instance.">
|
||||
|
||||
<meta name="viewport" content="width=device-width">
|
||||
<link rel="canonical" href="https://home-assistant.io/topics/updater_details/">
|
||||
|
||||
<meta property="fb:app_id" content="338291289691179">
|
||||
<meta property="og:title" content="Details about the updater">
|
||||
<meta property="og:site_name" content="Home Assistant">
|
||||
<meta property="og:url" content="https://home-assistant.io/topics/updater_details/">
|
||||
<meta property="og:type" content="article">
|
||||
<meta property="og:description" content="Details what the updater component is reporting about your Home Assistant instance.">
|
||||
<meta property="og:image" content="https://home-assistant.io/images/default-social.png">
|
||||
|
||||
<meta name="twitter:card" content="summary_large_image">
|
||||
<meta name="twitter:site" content="@home_assistant">
|
||||
|
||||
<meta name="twitter:title" content="Details about the updater">
|
||||
<meta name="twitter:description" content="Details what the updater component is reporting about your Home Assistant instance.">
|
||||
<meta name="twitter:image" content="https://home-assistant.io/images/default-social.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='/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="page">
|
||||
|
||||
|
||||
<div class='edit-github'><a href='https://github.com/home-assistant/home-assistant.github.io/tree/current/source/_topics/updater_details.markdown'>Edit this page on GitHub</a></div>
|
||||
|
||||
|
||||
|
||||
<header>
|
||||
<h1 class="title indent">
|
||||
Details About the Updater
|
||||
</h1>
|
||||
</header>
|
||||
<hr class="divider">
|
||||
|
||||
|
||||
<p>Starting with 0.31 the <a href="/components/updater/">updater component</a> sends an optional report about Home Assistant instance.</p>
|
||||
|
||||
<p>We are only collecting this information to better understand our user base to provide better long term support and feature development.</p>
|
||||
|
||||
<table>
|
||||
<thead>
|
||||
<tr>
|
||||
<th>Name</th>
|
||||
<th>Description</th>
|
||||
<th>Example</th>
|
||||
<th>Data Source</th>
|
||||
</tr>
|
||||
</thead>
|
||||
<tbody>
|
||||
<tr>
|
||||
<td><code class="highlighter-rouge">arch</code></td>
|
||||
<td>CPU Architecture</td>
|
||||
<td><code class="highlighter-rouge">x86_64</code></td>
|
||||
<td>Local Instance</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td><code class="highlighter-rouge">distribution</code></td>
|
||||
<td>Linux Distribution name (only Linux)</td>
|
||||
<td><code class="highlighter-rouge">Ubuntu</code></td>
|
||||
<td>Local Instance</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td><code class="highlighter-rouge">docker</code></td>
|
||||
<td>True if running inside Docker</td>
|
||||
<td><code class="highlighter-rouge">false</code></td>
|
||||
<td>Local Instance</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td><code class="highlighter-rouge">first_seen_datetime</code></td>
|
||||
<td>First time instance ID was submitted</td>
|
||||
<td><code class="highlighter-rouge">2016-10-22T19:56:03.542Z</code></td>
|
||||
<td>Update Server</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td><code class="highlighter-rouge">geo_city</code></td>
|
||||
<td>GeoIP determined city</td>
|
||||
<td><code class="highlighter-rouge">Oakland</code></td>
|
||||
<td>Update Server</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td><code class="highlighter-rouge">geo_country_code</code></td>
|
||||
<td>GeoIP determined country code</td>
|
||||
<td><code class="highlighter-rouge">US</code></td>
|
||||
<td>Update Server</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td><code class="highlighter-rouge">geo_country_name</code></td>
|
||||
<td>GeoIP determined country name</td>
|
||||
<td><code class="highlighter-rouge">United States</code></td>
|
||||
<td>Update Server</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td><code class="highlighter-rouge">geo_latitude</code></td>
|
||||
<td>GeoIP determined latitude</td>
|
||||
<td><code class="highlighter-rouge">37.8047</code></td>
|
||||
<td>Update Server</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td><code class="highlighter-rouge">geo_longitude</code></td>
|
||||
<td>GeoIP determined longitude</td>
|
||||
<td><code class="highlighter-rouge">-122.2124</code></td>
|
||||
<td>Update Server</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td><code class="highlighter-rouge">geo_metro_code</code></td>
|
||||
<td>GeoIP determined metro code</td>
|
||||
<td><code class="highlighter-rouge">807</code></td>
|
||||
<td>Update Server</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td><code class="highlighter-rouge">geo_region_code</code></td>
|
||||
<td>GeoIP determined region code</td>
|
||||
<td><code class="highlighter-rouge">CA</code></td>
|
||||
<td>Update Server</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td><code class="highlighter-rouge">geo_region_name</code></td>
|
||||
<td>GeoIP determined region name</td>
|
||||
<td><code class="highlighter-rouge">California</code></td>
|
||||
<td>Update Server</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td><code class="highlighter-rouge">geo_time_zone</code></td>
|
||||
<td>GeoIP determined time zone</td>
|
||||
<td><code class="highlighter-rouge">America/Los_Angeles</code></td>
|
||||
<td>Update Server</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td><code class="highlighter-rouge">geo_zip_code</code></td>
|
||||
<td>GeoIP determined zip code</td>
|
||||
<td><code class="highlighter-rouge">94602</code></td>
|
||||
<td>Update Server</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td><code class="highlighter-rouge">last_seen_datetime</code></td>
|
||||
<td>Most recent time instance ID was submitted</td>
|
||||
<td><code class="highlighter-rouge">2016-10-22T19:56:03.542Z</code></td>
|
||||
<td>Update Server</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td><code class="highlighter-rouge">os_name</code></td>
|
||||
<td>Operating system name</td>
|
||||
<td><code class="highlighter-rouge">Darwin</code></td>
|
||||
<td>Local Instance</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td><code class="highlighter-rouge">os_version</code></td>
|
||||
<td>Operating system version</td>
|
||||
<td><code class="highlighter-rouge">10.12</code></td>
|
||||
<td>Local Instance</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td><code class="highlighter-rouge">python_version</code></td>
|
||||
<td>Python version</td>
|
||||
<td><code class="highlighter-rouge">3.5.2</code></td>
|
||||
<td>Local Instance</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td><code class="highlighter-rouge">timezone</code></td>
|
||||
<td>Timezone</td>
|
||||
<td><code class="highlighter-rouge">America/Los_Angeles</code></td>
|
||||
<td>Local Instance</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td><code class="highlighter-rouge">user_agent</code></td>
|
||||
<td>User agent used to submit analytics</td>
|
||||
<td><code class="highlighter-rouge">python-requests/2.11.1</code></td>
|
||||
<td>Local Instance</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td><code class="highlighter-rouge">uuid</code></td>
|
||||
<td>Unique identifier</td>
|
||||
<td><code class="highlighter-rouge">10321ee6094d4a2ebb5ed55c675d5f5e</code></td>
|
||||
<td>Local Instance</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td><code class="highlighter-rouge">version</code></td>
|
||||
<td>Home Assistant version</td>
|
||||
<td><code class="highlighter-rouge">0.31.0</code></td>
|
||||
<td>Local Instance</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td><code class="highlighter-rouge">virtualenv</code></td>
|
||||
<td>True if running inside virtualenv</td>
|
||||
<td><code class="highlighter-rouge">true</code></td>
|
||||
<td>Local Instance</td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
|
||||
<p>In addition to the above collected data, the server will also use your IP address to do a geographic IP address lookup to determine a general geographic area that your address is located in. To be extremely, extremely clear about this bit: <strong>The Home Assistant updater does not: store your IP address in a database and also does not submit the location information from your <code class="highlighter-rouge">configuration.yaml</code>.</strong></p>
|
||||
|
||||
<p>Our tests showed that at best, we get 4 digits of accuracy on your IP address location which is a 5 mile radius of your actual IP location, assuming that it is even correct in the first place (geo IP lookups are very hit or miss).</p>
|
||||
|
||||
<p>The server also adds two timestamps to the data:</p>
|
||||
|
||||
<ul>
|
||||
<li>the original date your instance UUID was first seen</li>
|
||||
<li>the timestamp of the last time we have seen your instance</li>
|
||||
</ul>
|
||||
|
||||
<p>There are currently no plans to publicly expose any of this information. If we did do such a thing in the future we would of course notify you in advance. It must also be stated that we will never sell or allow the use of this information for non-Home Assistant purposes.</p>
|
||||
|
||||
|
||||
</article>
|
||||
|
||||
|
||||
</div>
|
||||
|
||||
|
||||
</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>.<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>
|
||||
</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>
|
||||
</body>
|
||||
</html>
|
||||
Loading…
Add table
Add a link
Reference in a new issue