HA-Pulse/home-assistant-global-health-score v2.0

v2.0.0: The Hygiene Standard – Database, Logs & Deep Labeling

on GitHub

v2.0.0 marks a significant architectural shift for HAGHS. This release transforms the score from a passive health monitor into an active system hygiene administrator. It introduces deep monitoring for database bloating and log file flooding—the two most common causes of system instability—while simplifying configuration through native Home Assistant Labels.

New Features

• Database Hygiene Monitoring: Now monitors the size of 'home-assistant_v2.db'. Penalties apply for databases exceeding 1GB (Warning) and 2.5GB (Critical).
• Log File Hygiene: Now monitors 'home-assistant.log'. Penalties apply for logs exceeding 20MB, helping identify silent error loops and I/O stress.
• Deep Label Support (haghs_ignore): Removed hardcoded regex filters. You can now simply assign the 'haghs_ignore' label to any Device or Entity. HAGHS effectively "whitelists" all entities belonging to a labeled device automatically.
• Core Age Penalty: Introduced a specific penalty for systems where the Core version lags behind by 2 months or more.
• Cumulative Updates: Pending updates are now counted cumulatively (capped at 35 points) rather than a flat penalty.

Critical Prerequisites (Breaking Change)

To utilize the new Database and Log monitoring, you must allow Home Assistant to read its own configuration directory.

1. Add this to your 'configuration.yaml' and restart Home Assistant:

   homeassistant:
     allowlist_external_dirs:
       - "/config"

2. Add the File Size integration (via Settings > Devices & Services) and track:
   • '/config/home-assistant_v2.db'
   • '/config/home-assistant.log'

How to Update

1. Copy the new code from 'haghs.yaml'.
2. Update the 'variables' section with your entity IDs (especially the new 'db_size_id' and 'log_size_id').
3. Create a label named 'haghs_ignore' in Home Assistant and tag your sleeping devices (e.g., tablets, battery sensors).