What Is Recorded About Your House - TheThinkingHome/device_sentinel GitHub Wiki

What Is Recorded About Your House

Sensors do not float in a vacuum. They rely on layers of plumbing beneath them: Home Assistant, MQTT brokers, Zigbee coordinators, and your Wi-Fi network. When a sensor goes quiet, it might be the sensor's fault, or it might be that the floor just fell out from under it.

Most of this wiki describes what Device Sentinel knows about your individual devices. This page covers what it knows about the house itself.

To understand why this matters, look at a real-world example: on our test system, the MQTT broker stopped working for sixteen minutes. That single failure took 75 devices offline. Without house-level recording, the daily brief would look like a disaster movie, warning you that more than half your home spontaneously died at the exact same second without explaining why.

Because Device Sentinel monitors the system itself, that disaster is collapsed into a single, obvious fix: The MQTT broker went down.

The Layers We Watch

Every time the floor drops out, we record it as a system event. This gives you the context in your daily brief, and it prevents those massive, forced silences from ruining the learned rhythms of your devices.

  • Home Assistant Restarts and Crashes: If Home Assistant restarts or loses power, it stops listening. We record these blackouts (and unclean shutdowns) so the resulting gaps in your sensors' timelines are blamed on the blackout, not the sensors.
  • The MQTT Broker: Home Assistant doesn't have a native "MQTT Broker" sensor, making broker crashes practically invisible. Device Sentinel watches the broker directly. When the broker stops, the integration knows every device behind it is an innocent victim.
  • The Coordinators (Zigbee2MQTT, ZHA): We watch the bridges. We track when they drop offline, and we watch for pairing windows or configuration events so your manual re-pairing efforts aren't mistakenly learned as a natural device freeze. (See The Bridge and Broker Sensors).
  • The Wi-Fi Network: If you configure Wi-Fi watching, we record when the network drops and comes back. A network drop takes out a dozen smart plugs at once; we count the casualties so you know to fix the router, not the plugs. (See WiFi).
  • Integration Outages and Reloads: If a specific integration crashes and stays down, we record the outage, including one that failed to start when Home Assistant restarts. And if an integration reloads, causing every device it owns to reload at once, we recognize that burst as a reload rather than an organic network event.
  • Your Own Hands: When you open a Maintenance Mode window, change a setting, or wipe a device's history using the data trim tool, we write it down. A week from now, when you wonder why a device's history started over on a Tuesday, your daily brief will remind you exactly when you pressed the button.

Every one of these events is visible in the Last 24 Hours table of your daily brief, and the silences they explain are marked in the silence episodes report.