在 Kibana 中可视化你的 Bosch Smart Home 数据

作者：来自 Elastic walterra

有没有想过你的智能家居里到底发生了什么？你的暖气什么时候启动？一天中湿度如何变化？每个房间的温度模式是什么？

如果你有 Bosch Smart Home Controller II，所有这些数据都在你的本地网络中流动 ------ 但它被锁在一个只能显示当前状态的应用里。假如你能捕捉这条事件流，并将其随时间可视化，会怎么样呢？

这正是 shc2es 的作用：它连接到你的 Bosch Smart Home Controller，通过长轮询收集实时设备事件，并将数据导入 Elasticsearch，以便在 Kibana 中进行时间序列可视化。

Bosch Smart Home Controller II 为私人非商业用途提供了本地 API。控制器的 API 使用长轮询实时推送设备状态变化。温度读数、湿度水平、门/窗状态、运动检测------所有数据都会以 JSON 事件流的形式传输。

shc2es 使用 bosch-smart-home-bridge 库接入这条事件流，将所有数据存储为 NDJSON 文件，然后使用合适的字段映射导入 Elasticsearch，并提供现成的仪表板。

入门

安装

复制代码

npm install -g shc2es

配置

在你的工作目录中创建一个 .env 文件：

复制代码

# Your controller's IP (find it in the Bosch app or your router)
BSH_HOST=192.168.1.100

# System password from Bosch Smart Home app
# (Settings → System → Smart Home Controller)
BSH_PASSWORD=your_password

首次运行：配对

第一次连接时，你需要与控制器配对。这是一次性的安全握手。在运行脚本前，按下控制器上的配对按钮。脚本会生成一个客户端证书，并在本地保存以供以后连接使用。

复制代码

shc2es poll

导入到 Elasticsearch

Poll 脚本现在会将你的智能家居数据保存为 NDJSON 文件。接下来，我们设置 Elastic Stack 来接收这些数据。首先，使用 start-local 搭建本地开发环境：

复制代码

curl -fsSL https://elastic.co/start-local | sh

在你的 .env 文件中添加 Elasticsearch 凭证：

复制代码

ES_NODE=http://localhost:9200
ES_PASSWORD=your_es_password
KIBANA_NODE=http://localhost:5601

现在运行设置并开始导入数据：

复制代码

# Fetch device/room names for enrichment
shc2es registry

# Create index template + import dashboard
shc2es ingest --setup

# Watch for new events and ingest in real-time
shc2es ingest --watch

打开 Kibana → 仪表板 → "Smart Home"，你就能看到数据生动呈现。预构建的仪表板会显示各房间的温度随时间的变化，以及暖气恒温阀开度的百分比。每个事件都带有人类可读的设备名称和房间信息，不必盯着难懂的设备 ID。

底层数据结构干净且易于查询：

复制代码

{
  "@timestamp": "2025-12-16T08:30:00.000Z",
  "device.name": "Living Room Thermostat",
  "device.type": "ROOM_CLIMATE_CONTROL",
  "room.name": "Living Room",
  "metric.name": "temperature",
  "metric.value": 21.5
}

这让你可以轻松创建自己的可视化或运行 ES|QL 查询：

复制代码

FROM smart-home-events-*
| WHERE metric.name == "temperature"
| STATS avg_temp = AVG(metric.value) BY room.name
| SORT avg_temp DESC

额外功能：OpenTelemetry 集成

对于使用 Elastic APM 的用户，shc2es 通过 EDOT Node.js 提供自动 OpenTelemetry 仪表化。在 .env 中添加你的 APM 端点，就可以获取轮询和导入过程的追踪和指标。

试一试

如果你有 Bosch Smart Home Controller II，可以体验一下：

GitHub: github.com/walterra/shc2es
npm: npm install -g shc2es

你是否在 Elastic Stack 中可视化智能家居数据？欢迎在评论中分享你的配置！

原文：https://discuss.elastic.co/t/dec-16th-2025-en-visualize-your-bosch-smart-home-data-in-kibana/384014