peterot/nest-graph

Nest指标收集器镜像

镜像概述

该镜像提供集成解决方案，用于收集Nest设备（恒温器、烟雾/CO报警器）的指标（温度、湿度、警报状态等），并通过Grafana可视化展示。镜像采用OpenTSDB存储时间序列数据，通过自定义Python收集器（运行在OpenTSDB tCollector服务中）实现数据采集，所有组件封装在自包含Docker容器中，可灵活部署。

核心功能

• 收集Nest设备多类指标：温度、湿度、目标温度、HVAC状态、在线状态、烟雾/CO警报状态等
• 基于OpenTSDB实现高效数据存储
• 通过Grafana提供可自定义的可视化仪表盘（含恒温器概览、烟雾/CO报警器状态示例）
• 支持数据持久化存储（通过卷映射）

使用场景

• 家庭环境监控Nest设备实时状态与历史数据趋势
• 小型办公场所集中监控Nest智能设备
• 个人用户自定义Nest数据可视化需求

配置说明

1. 安装Docker

参考Docker官方安装指南完成平台适配安装。

2. 创建Nest开发者账号

获取Nest API访问权限：

1. 访问Nest开发者平台登录/注册
2. 填写账号信息（公司信息可任意填写）
3. 进入“Products”页面，点击“Create New Product”
4. 填写产品名称（需唯一）及描述，勾选所有读取权限（描述需符合格式要求）
5. 创建后获取“Product ID”和“Product Secret”（作为client_id/client_secret）

3. Docker部署

拉取镜像

bash
docker pull peterot/nest-graph

启动容器

默认启动（数据存于容器内）：

bash
docker run -d -p 4242:4242 -p 3000:3000 --restart unless-stopped peterot/nest-graph

持久化存储（映射本地路径，如/Users/test/Temp/data）：

bash
docker run -d -p 4242:4242 -p 3000:3000 -v /Users/test/Temp/data:/data --restart unless-stopped peterot/nest-graph

记录启动后返回的容器ID。

4. 配置Nest API凭据

执行容器内脚本完成授权：

bash
docker exec -it [CONTAINER-ID] /usr/bin/python /opt/nest-auth.py

按提示输入Product ID/Secret，访问生成的URL完成授权并输入PIN码。

5. 访问Grafana

• 地址：http://localhost:3000
• 默认凭据：admin:admin
• 示例仪表盘：恒温器概览、烟雾/CO报警器状态

6. 访问OpenTSDB

控制台地址：http://localhost:4242

存储指标列表

• nest.away：离家状态（home=1, away=0, unknown=-1）
• nest.num_thermostats：恒温器数量
• nest.thermostat.temperature：当前温度
• nest.thermostat.humidity：当前湿度
• nest.thermostat.target：目标温度
• nest.thermostat.eco.temperature.low/high：eco模式阈值
• nest.thermostat.hvac_state HVAC状态（heating=1, off=0, cooling=-1）
• nest.thermostat.is_online：在线状态（online=1, offline=0）
• nest.smoke_co_alarm.co_status：CO状态（ok=0, warning=1, emergency=2）
• nest.smoke_co_alarm.smoke_status：烟雾状态（ok=0, warning=1, emergency=2）

致谢

依赖开源工具：Grafana（可视化）、OpenTSDB（存储）及python-nest（Nest API客户端）。