Device Sentinel

A smart home relies on its sensors, but Home Assistant can't tell the difference between a sensor that is quiet and a sensor that is dead. If a device drops off your network or its battery fails without an error, the last reported value stays on your dashboard forever. Everything looks fine, but nothing is.

Device Sentinel changes that.

Instead of waiting for an automation to fail or your freezer to thaw, Device Sentinel actively monitors your home's hardware. It catches frozen devices, unavailable sensors, weak radio links, and falling batteries before they cause problems.

Getting Started

If you are new to Device Sentinel, start here:

• Installation and Setup: How to install the integration, the initial steps required, and what to expect during its first week.

Configuration

Device Sentinel is designed to work out of the box with sensible defaults, but you can tailor it to your specific home.

• The Device Page: An overview of the main integration page, including the sensors and controls it creates.
• Notifications and Daily Brief: Configure where alerts are sent, set quiet hours, schedule your daily brief, and choose whether device names on reports link to their device pages.
• Exclusions and Muting: Tell Device Sentinel what not to watch. Exclude entire integrations or mute specific devices from reports.
• Low Battery: Adjust the low battery threshold and configure warnings for cells that are dropping quickly.
• Signal Strength: Define what constitutes a bad signal day for your devices.
• Freeze Detection: Fine-tune the grace periods the system gives a device before declaring it frozen.
• WiFi: Monitor the availability of your Wi-Fi network to detect home-wide outages instead of individual device failures.
• Advanced: Deep system tuning for data retention, debounce timers, and storage write intervals.
• Extended Diagnostics: Help build support for new hardware by providing raw readings to the developers.

The Reports

Device Sentinel generates clear, actionable reports to keep you informed about your network's health.

• The Problem List: The live Home Assistant To-Do list where active faults are tracked and acknowledged.
• The Daily Brief: A plain-English summary of what needs your attention right now and what happened in the last 24 hours.
• The Battery Report: See which batteries are failing, ranked by how much time they have left.
• The Signal Report: Identify devices struggling with unusually bad radio links, judged against their own history.
• The Diagnostic Reports: The raw data detailing exactly what rhythm Device Sentinel learned for each sensor.

Automations

• Automation Events: Learn how to trigger your own Home Assistant automations based on Device Sentinel's detections.

Understanding How It Works

Want to know the mechanics under the hood?

• How Device Sentinel Learns: Discover how the integration establishes a unique reporting rhythm for every device.
• Maintenance Mode: Learn how to prevent your manual battery swaps and repairs from polluting the system's learned statistics.
• The Bridge and Broker Sensors: Understand what the coordinator and MQTT broker sensors mean.
• What Is Recorded About Your House: An overview of the system-level events Device Sentinel monitors.
• Built to Be Efficient: How Device Sentinel minimizes disk writes to protect your server's storage hardware.

Coordinator Stacks

See what Device Sentinel can read from specific network coordinators.

• Zigbee2MQTT
• ZHA
• Z-Wave
• WiFi Devices

Help and Support

• Repairs: Troubleshoot issues with Device Sentinel itself.
• FAQ and Troubleshooting: Answers to the most common questions.
• Report an Issue: Open a ticket on GitHub if you need support.