0.20.0 - System Metrics Chart for mem & cpu usage 📈 🧭

System Metrics Chart Feature

Overview

The Pi-hole Card now includes a new System Metrics Chart feature that displays real-time CPU and memory usage for your Pi-hole instance.

Features

CPU and Memory Usage Visualization

• 24-Hour Historical Data: View your Pi-hole's system resource usage over the last 24 hours
• Dual Metrics: Track both CPU usage and memory consumption in a single chart
• Automatic Data Fetching: Chart automatically retrieves statistics data from Home Assistant's recorder
• Real-time Updates: Chart updates automatically when data changes

Customizable Appearance

The chart supports multiple line style options to match your dashboard aesthetic:

• Normal (default): Standard solid lines with filled areas beneath
• Gradient: Beautiful gradient-colored lines with gradient-filled areas
• Gradient No Fill: Gradient lines without fill areas for a cleaner look
• No Fill: Solid lines without fill areas

Configuration Options

Exclude Chart Section:

exclude_sections:
  - chart

Customize Chart Line Style:

chart:
  line_type: gradient  # Options: normal, gradient, gradient_no_fill, no_fill

Requirements

• Home Assistant with the Recorder component enabled
• Pi-hole sensors for CPU and memory usage (sensor.pi_hole_cpu_use and sensor.pi_hole_memory_use)
• Statistics data must be available in Home Assistant's recorder

Technical Details

• Chart uses Chart.js for rendering
• Data is fetched from Home Assistant's recorder/statistics_during_period WebSocket API
• Chart displays 5-minute interval data points
• Responsive design adapts to card width
• Automatically handles missing or empty data gracefully

Benefits

• Performance Monitoring: Easily identify resource usage patterns and potential performance issues
• Visual Insights: Quickly spot CPU or memory spikes that might indicate problems
• Historical Context: Understand how your Pi-hole's resource usage changes over time
• Dashboard Integration: Seamlessly integrated into the existing Pi-hole Card layout

Backwards Compatibility Improvements

Entity Mapping Updates

• Added backwards compatibility mapping for ads_percentage_today entity translation key to map to ads_percentage_blocked_today

---

• chore: bumps version to 0.20.0 by @gh-action-bump-version
• ads_percentage_today key mapped for HA edge case by @warmfire540
• mem & cpu chart added to card bottom by @warmfire540
• chore: yarn (deps-dev): bump jsdom in the all-dependencies group (#78) by @dependabot[bot]
• chore: yarn (deps-dev): bump @types/chai in the all-dependencies group (#76) by @dependabot[bot]

What's Changed

• chore: yarn (deps-dev): bump @types/chai from 5.2.2 to 5.2.3 in the all-dependencies group by @dependabot[bot] in #76
• chore: yarn (deps-dev): bump jsdom from 27.0.1 to 27.1.0 in the all-dependencies group by @dependabot[bot] in #78
• System Metrics Chart for mem & cpu usage 📈 🧭 by @warmfire540 in #82

Full Changelog: 0.19.0...0.20.0