Advanced - TheThinkingHome/device_sentinel GitHub Wiki

Advanced

These settings have sensible defaults and most houses never need to touch them. Two of them protect your server's storage, one decides how soon a device is named a repeat offender, and one sets how long your repair window stays open.

Two settings on this page, the storage write interval and history retention, control your server's storage footprint. If you run Home Assistant from an SD card, turning down the write frequency and keeping less history will protect your hardware from burnout. If you run on a fast mini-PC with an SSD, you can keep the defaults or tune them for maximum detail. Built to Be Efficient covers the economics of these choices in detail.

Repeat Offender Threshold

Your Daily Brief carries a table called Repeat Offenders for devices whose interruptions keep having no clear explanation. Because the system can't guess why a TV goes unavailable when turned off or why a dying coin cell triggers repeatedly, it names the pattern and lets you decide.

An interruption counts toward this table only when it is truly unexplained, meaning no restart, bridge outage, or maintenance window accounts for it.

This slider controls how many unexplained interruptions inside a week put a device in the table (default is 2).

  • Lower it: Devices are named sooner, on weaker patterns.
  • Raise it: The table waits for a stronger, more persistent pattern before naming anything.

How Much History to Keep

Device Sentinel keeps a concise daily record per device (longest gap, lowest signal, battery level) to help you spot slow-moving trends over time, like battery decay or seasonal radio degradation.

The setting ranges from 30 days to a full year (default is 90 days).

  • On an SD Card: Drop this to 30 days to keep your storage footprint microscopic.
  • On an SSD: Leave it at 90 or scale it up if you love long-term charts.

Lowering this setting takes effect at the next midnight, not the moment you move the slider, so a mistake can be undone before any history is lost.

Storage Write Interval

Routine activity clocks are held in memory and flushed to disk on a schedule rather than every time a sensor blinks (default is 15 minutes).

Important events, like a new problem, a recovery, or an acknowledgment, are always written immediately.

  • On an SD Card: Crank this up to 30 or 60 minutes to maximize card longevity.
  • On an SSD: Leave it at 15 (or drop to 5) to narrow the tiny window of routine clock progress exposed to a sudden power cut.

Maintenance Window in Minutes

When you manually service hardware, you press the Maintenance Mode button so your repair isn't mistakenly learned as normal downtime. This slider sets how long that maintenance window stays open once pressed (default is 10 minutes).

Data Trim

At the foot of the screen sit the data trim pickers. Use these only when support asks you to, or when you know a device's record has gone wrong and you want it to start over from scratch.

What it erases: A device's statistics, silence episodes, incidents, and Problem List entries.

What survives: The device itself (which is rediscovered instantly with a fresh 7-day arming period), all mutes, all exclusions, and system-wide plumbing events.

The safeguards: Before anything touches deletion, an automatic backup of your storage files is safely stashed away in config/device_sentinel/trim_backups. If that backup cannot be written, nothing is deleted. The pickers also empty themselves after the save, so saving another setting later cannot repeat the erasure.