FAQ and Troubleshooting

Getting Started

1. Do I have to configure anything right away?
2. How is this different from a standard blueprint?
3. What devices should I globally mute?
4. How do I get my Daily Brief via email?
5. What's still missing?

How It Works

6. Why watch devices instead of entities?
7. What exactly is a "gap"?
8. How do you define a "bad signal day"?
9. Low Battery vs. Falling Battery: What's the difference?
10. Does the integration forget everything when I restart Home Assistant?
11. Will this slow down my Home Assistant server?

Understanding the Numbers

12. Why is my "Watched" count lower than my actual device count?
13. Why is my "Learned" count so low?
14. Why does the Status sensor just say "Learning"?
15. Why is a perfectly fine device showing up on the Signal Report?

Troubleshooting

16. I muted a device by accident. Does it have to re-learn everything?
17. What does "never reported" mean?
18. Why isn't a dead device showing in the "Device: Frozen" sensor?
19. My battery is slightly above the threshold, but still flagged as Low.
20. My Zigbee coordinator crashed. Will my phone explode?
21. Every MQTT device in my house died at the exact same second.
22. Error: Notification service not found.
23. My house lost power. Are my statistics ruined?
24. How do I put the Daily Brief on my dashboard?
25. I found a bug. What do you need?

---

Getting Started

1. Do I have to configure anything right away?

No. Install it, and it immediately starts watching every device in your house using sensible defaults. But to get the most out of it on day one, do two things: press the three Enable buttons on the Device Page, and tell it where to send your alerts under Notifications and Daily Brief.

2. How is this different from a standard blueprint?

Blueprints ask you to maintain a list of entities and guess a timeout value. Device Sentinel watches every device automatically and learns their unique reporting rhythms. A chatty motion sensor gets a tight window; a sleepy door sensor gets a generous one. No lists, no guessing.

3. What devices should I globally mute?

Anything you don't want to be bothered about: phones, tablets, smart watches (since they leave the house), network trackers, and TVs that nap. If you aren't sure, leave it watched. You can always mute it later with one click on the Exclusions and Muting screen.

4. How do I get my Daily Brief via email?

Configure Home Assistant's standard SMTP integration. Once that's done, your new notify service will appear in the dropdown under Send the Full Brief To on the Notifications screen.

5. What's still missing?

Two things. Signal alerting is experimental: it records and reports bad signal days, but won't alert your phone about a weak link until the logic is field-proven. And the running controller for Z-Wave isn't read yet, though integration outages are caught and its devices get time to rejoin when it returns. Check their respective pages to see how you can help us map them out.

How It Works

6. Why watch devices instead of entities?

Hardware fails as a whole unit. If any entity on a multisensor reports in, the physical device is clearly alive. Watching at the device level gives you one verdict per physical gadget, rather than thirty separate alerts for a single dead weather station.

7. What exactly is a "gap"?

It's the silence between two reports. A motion sensor might have a natural gap of a few seconds, while a guest room window sensor might sit quiet for a week. Device Sentinel tracks the longest gap a device produces each day to learn its true baseline rhythm.

8. How do you define a "bad signal day"?

A day when a device's radio link performs significantly worse than its own normal baseline. We look for a drop that is large in absolute terms (like 25 LQI points) and large compared to the device's usual jitter. This twin-gate approach judges steady links and bouncy links fairly. Check The Signal Report to see this in action.

9. Low Battery vs. Falling Battery: What's the difference?

Low means right now: the cell has crossed your flat percentage threshold. Falling predicts the future: the cell is dropping fast enough to hit zero within your warning horizon (like 30 days). A lithium battery might read 80% today but be completely dead by Friday; the Falling detector catches that cliff-edge.

10. Does the integration forget everything when I restart Home Assistant?

No. Rhythms, clocks, problem lists, and standing freeze verdicts are continuously saved to disk. A device that was silent for twenty hours before a reboot is still twenty hours silent when the system comes back up.

11. Will this slow down my Home Assistant server?

Not at all. Device Sentinel just listens to the events Home Assistant is already generating. It doesn't poll, it doesn't broadcast on your radio networks, and it batches its disk writes on a timer you control. Built to Be Efficient has the receipts.

Understanding the Numbers

12. Why is my "Watched" count lower than my actual device count?

Because Device Sentinel automatically ignores virtual junk. It sets aside service integrations, add-ons, cloud trackers, disabled devices, devices with no entities, and anything you've put on the Exclude list.

13. Why is my "Learned" count so low?

It takes seven days of history to arm a device. A brand new install will climb slowly. Also, devices without a natural heartbeat, like push-button remotes that only wake when you press them, never establish a rhythm, which is entirely by design.

14. Why does the Status sensor just say "Learning"?

Because not a single device has finished its 7-day learning window yet. It will flip to Watching the moment your first device arms. Don't worry, dead and unavailable detection is already live while it learns.

15. Why is a perfectly fine device showing up on the Signal Report?

The signal strip always shows at least five rows so you have context. If your fleet is perfectly healthy, those rows are simply the "least good" of a fine bunch. Look for the ringed cells: if a cell isn't ringed, the device didn't have a bad day.

Troubleshooting

16. I muted a device by accident. Does it have to re-learn everything?

No. Muting stops alerts, not learning. The moment you un-mute it, its full history is waiting and judgment resumes instantly.

17. What does "never reported" mean?

It means Device Sentinel has never seen the device speak since it was discovered. It's usually a dead battery, an unpowered device, or a ghost registry entry. Try pressing Enable Last Seen on the device page to see if that gives it a voice.

18. Why isn't a dead device showing in the "Device: Frozen" sensor?

Three possibilities: 1) You haven't enabled the sensor yet (it ships disabled by default), 2) The device is still in its 7-day learning phase, or 3) It's a button or remote with no heartbeat, which we deliberately don't judge for freezes.

19. My battery is slightly above the threshold, but still flagged as Low.

That is deliberate hysteresis. A flagged battery stays flagged until it climbs two points clear of the threshold. This stops a cell hovering exactly at the line from spamming you with alerts every time it fluctuates.

20. My Zigbee coordinator crashed. Will my phone explode?

No. Device Sentinel catches the coordinator failure directly. You get one row and one alert naming the coordinator and counting the casualties. The devices behind it are cleared of blame. When the coordinator comes back, that same row counts your devices home and gives the slow ones a few minutes before any of them is reported on its own.

21. Every MQTT device in my house died at the exact same second.

Your MQTT broker crashed or restarted. Device Sentinel watches the broker directly, so it will record the outage and blame the broker, not your seventy-four smart plugs.

22. Error: Notification service not found.

You probably renamed your phone or uninstalled the companion app. Head to the Notifications and Daily Brief screen and re-pick your valid targets. Device Sentinel also raises a Repair card offering to remove the dead targets for you.

23. My house lost power. Are my statistics ruined?

No. The integration recognizes the unclean shutdown when it boots back up. At most, you lose one write-interval of routine clock progress (about 15 minutes), which repairs itself the next time your devices check in. Nothing learned is lost.

24. How do I put the Daily Brief on my dashboard?

Add a standard Home Assistant Webpage card and point it to /local/device_sentinel/daily_brief.html. Do the same for signal_report.html and battery_report.html. The URLs never change.

25. I found a bug. What do you need?

Tell us what you expected to see versus what actually happened, and attach your diagnostics file (Settings > Devices and Services > Device Sentinel > ... > Download diagnostics). Then open an issue on GitHub.