The Problem List - TheThinkingHome/device_sentinel GitHub Wiki

The Problem List

This is where the integration stops watching and starts tapping you on the shoulder. It takes every frozen sensor, dying battery, and stuck signal it finds and puts them in one place you can actually act on: a standard Home Assistant To-do list (todo.device_sentinel_problem_list).

You can view it in your sidebar's To-do panel, in the companion app, or drop it straight onto a dashboard.

One Line per Device

A device appears exactly once, no matter how badly it is failing. If a temperature sensor is frozen and its battery is dead, you get one line leading with the device's name. It lists the freeze verdict first, the battery second, and the signal last.

Open items sort alphabetically by device name, so the active list reads like a roster rather than a messy timeline.

When the Plumbing Breaks

When your MQTT broker crashes or your Zigbee coordinator loses power, every device behind it goes quiet in the exact same second. A standard automation would fire seventy-four alerts at your phone. Device Sentinel gives you one.

The list will carry a single row reading Zigbee2MQTT down: 74 of 74 total devices unavailable. You fix the bridge; you don't chase the devices.

Those offline devices are still being judged and recorded behind the scenes, but this list only shows you the problem you can actually solve. When the coordinator comes back, the row says so and counts your devices home: Zigbee2MQTT is back: waiting for 14 devices to reconnect, then Zigbee2MQTT recovering: 3 of the 14 devices that went down remain unavailable as they return, and the row clears when they are all back.

The same happens when your Wi-Fi network drops or a whole integration fails and stays failed: one row naming the cause. A broker outage outranks a bridge outage, because a broker that is down takes every bridge with it. The Bridge and Broker Sensors covers what each one reads.

The two exceptions

Two devices will stubbornly keep their own rows during a network outage:

  1. A device that was already broken. It died well before the outage, so it doesn't get to hide inside it. A router integration may take a few minutes to fail, while some of its dependent devices often become unavailable beforehand. Device Sentinel includes those devices into the outage rather than reporting them separately.
  2. A device that doesn't wake up after the network returns. Everything else came back and this one didn't. This is the most useful row on the list.

The Checkbox Is the Acknowledgment

Checking an item off the list means, "I see this, stop yelling at me."

The device stays on the list, marked as completed, and instantly stops buzzing your phone or cluttering the daily brief.

Imagine you put a vibration sensor in a car that is currently at the mechanic. Leave it unchecked, and your house complains about a missing sensor every morning. Check the box, and it stays quiet in the background for as long as the car is in the shop.

Recovery is automatic. Checking the box does not mean the device is fixed. Device Sentinel clears the item itself the moment the hardware actually wakes up and reports in. If an acknowledged problem suddenly gets worse, like a low-battery device freezing entirely, the system won't alert you again, because you already said you knew it needed attention.

Unchecking vs. Deleting

Unchecking a completed item pulls it back into your active alerts.

However, deleting an item by hand while the hardware is still broken is a hard reset. On the next system tick, Device Sentinel will see the device is still dead, realize the list is missing the warning, and fire a brand new alert at your phone.

Muting Instead of Acknowledging

An acknowledgment is for a specific, temporary problem. If you find yourself checking the exact same device off the list every week, you are using the wrong tool. Use the Exclusions and Muting screen instead. Once muted, the device drops off the list entirely and stays off.

Setting Up Your Dashboard

Drop a standard Home Assistant to-do list card on your dashboard and point it at todo.device_sentinel_problem_list. It gives you the live report and the acknowledgment checkbox in one place.

Two pro-tips for the card:

  • Keep the completed section visible: This lets you see the items you have silenced.
  • Avoid the "Remove completed items" menu action: This hand-deletes all your acknowledgments at once. Because the devices are still broken, the next sync will just re-add every single one of them and fire fresh notifications for the whole pile.