Grafana 接入 Home Assistant 数据的主流3种方案

Grafana 没有官方原生 HA 直连数据源插件，必须通过时序数据库中转实现长期存储 + 可视化，下面按推荐优先级说明：

方案 1：InfluxDB（智能家居最主流，首选）

原理链路

Home Assistant → InfluxDB（时序库存传感器历史）→ Grafana（查询绘图）

优势

• 专门存储温度、电量、湿度等时序数据，查询速度远超 HA 自带 SQLite
• 支持长期留存数月 / 数年数据，做年度对比、能耗统计
• HA 官方原生集成，配置简单，HA OS 可一键安装 InfluxDB 插件

极简部署流程（HA OS 用户）

1. HA 附加商店安装 InfluxDB、Grafana 插件
2. 打开 HA → 设置 → 集成 → 添加 InfluxDB，填入数据库地址、Token、Bucket
3. 配置configuration.yaml筛选需要写入的传感器：

   influxdb:
     api_version: 2
     host: a0d7b954-influxdb
     port: 8086
     token: "你的influxdb全权限token"
     organization: homeassistant
     bucket: ha_data
     include:
       entities:
         - sensor.temp_living
         - sensor.power_total

4. Grafana 添加数据源 InfluxDB，填入连接信息，即可绘制曲线、能耗图表

方案 2：Prometheus（适合服务器 / 设备监控，兼顾 HA 指标）

链路

HA 开启 Prometheus 导出 → Prometheus 抓取指标 → Grafana 读取 Prometheus 数据源

适用场景

不仅看智能家居，还要监控 HA 硬件、CPU、内存、容器负载；适合多设备统一监控栈。

基础配置

1. HA 配置configuration.yaml开启导出：

   prometheus:
     namespace: homeassistant
     filter:
       include_domains:
         - sensor
         - climate

2. Prometheus 配置抓取 HA 接口 http://HA_IP:8123/api/prometheus，携带长期访问 Token 鉴权
3. Grafana 添加 Prometheus 数据源，直接查询设备指标

方案 3：临时直读 HA API（不推荐，仅短期查看）

网上部分第三方非官方插件声称直连 HA API，但存在致命缺陷：

1. 不持久化历史：关闭 HA 后无法看过去数据
2. 大量传感器时卡顿、超时，不支持长时间区间查询
3. 社区维护差，新版本 HA 容易失效 仅适合临时看实时数值，不适合做长期监控面板。

补充：双向联动（Grafana 图表嵌入 HA 界面）

配置 Grafana 允许 iframe 嵌入后，复制面板 Embed 链接，用 HA 的iframe卡片把 Grafana 曲线图放到 HA 仪表盘里展示：

1. Grafana 配置开启嵌入：GF_SECURITY_ALLOW_EMBEDDING=true
2. 面板分享 → Embed，复制 HTML 链接
3. HA 新建面板，类型 iframe，填入地址即可

三种方案对比

总结

日常智能家居可视化优先选 InfluxDB 方案，是圈内最成熟稳定的 HA+Grafana 组合；如果你同时需要监控服务器、容器性能，再搭配 Prometheus。