2025.3.4
首页 ▸ Integrations ▸

分析

Home Assistant 允许用户通过分析集成分享他们的使用数据。汇总的数据可在 https://analytics.home-assistant.io 上获取。这些数据用于影响 Home Assistant 的开发优先级，以及说服制造商添加本地控制和注重隐私的功能。

数据收集

发送的信息取决于您选择的选项。您可以在入门时选择，也可以通过前往 设置 > 系统 > 分析 进行选择。

当启用时，数据将在每次启动后 15 分钟发送，并在启动后每 24 小时发送一次。发送的数据会记录在您的日志中。

基本分析

这包括：

  • 您系统的唯一标识符（确保每个安装只计算一次）
  • Home Assistant 版本
  • Home Assistant 安装类型
  • 您的国家代码（根据您的 IP 地址从服务器端推导），例如：“NO” 表示挪威。
    • 如果您住在美国，这还将包含地区（州）代码，例如：“CO” 如果您住在科罗拉多州。

如果您的系统包含 Supervisor，这还将包含：

  • 您的安装是否受支持
  • 您的安装是否健康
  • 您的安装架构

如果您正在运行 Home Assistant 操作系统，这还将包含：

  • 您使用的主板类型
  • 操作系统的版本
示例有效负载 
{
  "uuid": "12a3456bc78d90123ef4567g789012h3",
  "version": "2025.3.4",
  "installation_type": "Home Assistant OS",
  "supervisor": {
    "healthy": true,
    "supported": true,
    "arch": "amd64"
  },
  "operating_system": {
    "board": "odroid-n2",
    "version": ""
  }
}

使用分析

需要启用基本分析。

这包括：

  • 所有核心集成的名称
  • 所有自定义集成的名称和版本（如果有的话）
  • 记录集成 中使用的引擎名称和版本
  • 布尔值以指示 能源集成 是否已配置
  • 布尔值以指示 HTTP 证书 是否已配置

如果您的系统包含 Supervisor，这还将包含：

  • 每个附加组件
    • 名称
    • 版本
    • 是否启用保护模式
    • 是否启用自动更新
示例有效负载 
{
  "uuid": "12a3456bc78d90123ef4567g789012h3",
  "version": "2025.3.4",
  "installation_type": "Home Assistant OS",
  "supervisor": {
    "healthy": true,
    "supported": true,
    "arch": "amd64"
  },
  "operating_system": {
    "board": "odroid-n2",
    "version": ""
  },
  "integrations": ["awesome_integration"],
  "addons": [
      {
          "slug": "awesome_addon",
          "protected": true,
          "version": "1.0.0",
          "auto_update": false
      }
  ],
  "energy": {
    "configured": true
  },
  "recorder": {
    "engine": "sqlite",
    "version": "123"
  },
  "certificate": false
}

统计信息

需要启用基本分析。

这包括：

  • 集成数量
  • 用户数量
  • 实体数量
  • 自动化数量

如果您的系统包含 Supervisor，这还将包含：

  • 安装的附加组件数量
示例有效负载 
{
  "uuid": "12a3456bc78d90123ef4567g789012h3",
  "version": "2025.3.4",
  "installation_type": "Home Assistant OS",
  "supervisor": {
    "healthy": true,
    "supported": true,
    "arch": "amd64"
  },
  "operating_system": {
    "board": "odroid-n2",
    "version": ""
  },
  "state_count": 1,
  "automation_count": 2,
  "integration_count": 3,
  "addon_count": 4,
  "user_count": 5
}

诊断

如果启用，当发生意外错误时将收集崩溃报告，并上传到 Sentry。这些报告将帮助修复错误并改善性能和稳定性。

崩溃报告仅对 Home Assistant Core 开发者可见。此功能目前仅限于 Supervisor 和 OS-Agent。

数据存储与处理

所有数据都是由 Home Assistant Analytics Receiver 接收和处理的（源）。

当您的安装发送有效负载时，该有效负载包括一个唯一标识符。此标识符用于确保您的安装仅计算一次。

您的数据会安全地存储在 Cloudflare 的键值存储 中。它将自上次更新起最多存储 60 天。仅聚合数据会公开提供。

以下是信息存储方式的示例：

uuid:12a3456bc78d90123ef4567g789012h3

{‘version’: ‘2025.3.4’, ‘installation_type’: ‘Home Assistant OS’, ‘country’: ‘NO’}