mirror of
https://github.com/home-assistant/home-assistant.io.git
synced 2025-07-22 16:56:50 +00:00
Remove analytics from updater (#17189)
Co-authored-by: Franck Nijhof <git@frenck.dev>
This commit is contained in:
Joakim Sørensen
GitHub
parent
6a35fa5380
commit
3b38e3ae83
@ -1,52 +0,0 @@
|
||||
---
|
||||
title: "Updater"
|
||||
description: "Details what the updater integration is reporting about your Home Assistant instance."
|
||||
---
|
||||
|
||||
Starting with 0.31 the [updater component](/integrations/updater/) sends an optional report about Home Assistant instance.
|
||||
|
||||
If you want to opt-in to include integration information, add `include_used_components` to your configuration. 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.
|
||||
@ -122,7 +122,6 @@
|
||||
<b>{% active_link /docs/backend/ Backend %}</b>
|
||||
<ul>
|
||||
<li>{% active_link /docs/backend/database/ Database %}</li>
|
||||
<li>{% active_link /docs/backend/updater/ Updater %}</li>
|
||||
</ul>
|
||||
</li>
|
||||
<li>
|
||||
|
||||
@ -10,6 +10,7 @@ ha_iot_class: Calculated
|
||||
|
||||
This integration is a meta-component and configures a default set of integrations for Home Assistant to load. The integrations that will be loaded are:
|
||||
|
||||
- [Analytics](/integrations/analytics) (`analytics`)
|
||||
- [Automation](/integrations/automation/) (`automation`)
|
||||
- [Home Assistant Cloud](/integrations/cloud/) (`cloud`)
|
||||
- [Configuration](/integrations/config/) (`config`)
|
||||
|
||||
@ -15,8 +15,6 @@ ha_platforms:
|
||||
|
||||
The `updater` binary sensor will check daily for new releases. The state will be "on" when an update is available. Otherwise, the state will be "off". The newer version, as well as the link to the release notes, are attributes of the updater.
|
||||
|
||||
The updater integration will also collect basic information about the running Home Assistant instance and its environment. The information includes the current Home Assistant version, the time zone, Python version and operating system information. No identifiable information (i.e., IP address, GPS coordinates, etc.) will ever be collected. If you are concerned about your privacy, you are welcome to scrutinize the Python [source code](https://github.com/home-assistant/home-assistant/tree/dev/homeassistant/components/updater).
|
||||
|
||||
## Configuration
|
||||
|
||||
This integration is by default enabled, unless you've disabled or removed the [`default_config:`](/integrations/default_config/) line from your configuration. If that is the case, the following example shows you how to enable this integration manually:
|
||||
@ -25,38 +23,6 @@ This integration is by default enabled, unless you've disabled or removed the [`
|
||||
updater:
|
||||
```
|
||||
|
||||
{% configuration %}
|
||||
reporting:
|
||||
description: Whether or not to share system information when checking for updates.
|
||||
required: false
|
||||
type: boolean
|
||||
default: true
|
||||
include_used_components:
|
||||
description: Whether or not to report the integrations that you are using in Home Assistant.
|
||||
required: false
|
||||
type: boolean
|
||||
default: false
|
||||
{% endconfiguration %}
|
||||
|
||||
For further information about the Updater's data, please check the [detailed overview](/docs/backend/updater/). If you choose not to share any information when checking for updates, you can set `reporting: false`.
|
||||
|
||||
It is possible to report the integrations that you are using to the Home Assistant developers. This will help them focus on improving the popular ones. To enable this option, you have to add `include_used_components: true`.
|
||||
|
||||
```json
|
||||
"components": [
|
||||
"apcupsd",
|
||||
"api",
|
||||
"automation",
|
||||
"binary_sensor",
|
||||
"binary_sensor.zwave",
|
||||
"camera",
|
||||
"camera.uvc",
|
||||
"config",
|
||||
"config.core",
|
||||
...
|
||||
]
|
||||
```
|
||||
|
||||
## Notification
|
||||
|
||||
For an added bonus, an automation integration can be created to send a message with a notifier when that state of this component's entity changes.
|
||||
|
||||
@ -2020,6 +2020,7 @@
|
||||
# Moved documentation
|
||||
/details/database /docs/backend/database
|
||||
/details/updater /docs/backend/updater
|
||||
/docs/backend/updater /integrations/analytics
|
||||
/docs/ecosystem/ios/ https://companion.home-assistant.io/
|
||||
/docs/ecosystem/ios/devices_file https://companion.home-assistant.io/
|
||||
/docs/ecosystem/ios/integration https://companion.home-assistant.io/docs/integrations/integrations
|
||||
|
||||
Loading…
x
Reference in New Issue
Block a user