mirror of
https://github.com/home-assistant/home-assistant.io.git
synced 2025-05-01 16:57:34 +00:00
60 lines
4.8 KiB
Markdown
60 lines
4.8 KiB
Markdown
---
|
|
layout: page
|
|
title: "Updater"
|
|
description: "Details what the updater component is reporting about your Home Assistant instance."
|
|
date: 2016-10-22 08:00
|
|
sidebar: true
|
|
comments: false
|
|
sharing: true
|
|
footer: true
|
|
redirect_from: /details/updater/
|
|
---
|
|
|
|
Starting with 0.31 the [updater component](/components/updater/) sends an optional report about Home Assistant instance.
|
|
|
|
If you want to opt-in to include component information, add `include_used_components` to your config. This will allow the Home Assistant developers to focus development efforts on the most popular components.
|
|
|
|
```yaml
|
|
updater:
|
|
include_used_components: true
|
|
```
|
|
|
|
We are only collecting this information to better understand our user base to provide better long term support and feature development.
|
|
|
|
| Name | Description | Example | Data Source |
|
|
|-----------------------|--------------------------------------------|------------------------------------|----------------|
|
|
| `arch` | CPU Architecture | `x86_64` | Local Instance |
|
|
| `distribution` | Linux Distribution name (only Linux) | `Ubuntu` | Local Instance |
|
|
| `docker` | True if running inside Docker | `false` | Local Instance |
|
|
| `first_seen_datetime` | First time instance ID was submitted | `2016-10-22T19:56:03.542Z` | Update Server |
|
|
| `geo_city` | GeoIP determined city | `Oakland` | Update Server |
|
|
| `geo_country_code` | GeoIP determined country code | `US` | Update Server |
|
|
| `geo_country_name` | GeoIP determined country name | `United States` | Update Server |
|
|
| `geo_latitude` | GeoIP determined latitude | `37.8047` | Update Server |
|
|
| `geo_longitude` | GeoIP determined longitude | `-122.2124` | Update Server |
|
|
| `geo_metro_code` | GeoIP determined metro code | `807` | Update Server |
|
|
| `geo_region_code` | GeoIP determined region code | `CA` | Update Server |
|
|
| `geo_region_name` | GeoIP determined region name | `California` | Update Server |
|
|
| `geo_time_zone` | GeoIP determined time zone | `America/Los_Angeles` | Update Server |
|
|
| `geo_zip_code` | GeoIP determined zip code | `94602` | Update Server |
|
|
| `last_seen_datetime` | Most recent time instance ID was submitted | `2016-10-22T19:56:03.542Z` | Update Server |
|
|
| `os_name` | Operating system name | `Darwin` | Local Instance |
|
|
| `os_version` | Operating system version | `10.12` | Local Instance |
|
|
| `python_version` | Python version | `3.5.2` | Local Instance |
|
|
| `timezone` | Timezone | `America/Los_Angeles` | Local Instance |
|
|
| `user_agent` | User agent used to submit analytics | `python-requests/2.11.1` | Local Instance |
|
|
| `uuid` | Unique identifier | `10321ee6094d4a2ebb5ed55c675d5f5e` | Local Instance |
|
|
| `version` | Home Assistant version | `0.31.0` | Local Instance |
|
|
| `virtualenv` | True if running inside virtualenv | `true` | Local Instance |
|
|
|
|
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: __The Home Assistant updater does not: store your IP address in a database and also does not submit the location information from your `configuration.yaml`.__
|
|
|
|
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).
|
|
|
|
The server also adds two timestamps to the data:
|
|
|
|
- the original date your instance UUID was first seen
|
|
- the timestamp of the last time we have seen your instance
|
|
|
|
We will never publicly expose individual gathered data. We might however publish aggregated stats about our user base (example: 70% of all users use Linux). We will never sell or allow the use of this information for non-Home Assistant development purposes.
|