Add MariaDB monitoring package to README with health sensors and dashboard snippet #341

config/lovelace/mariadb_dashboard.yaml

@@ -0,0 +1,103 @@
+######################################################################
+# @CCOSTAN - Follow Me on X
+# For more info visit https://www.vcloudinfo.com/click-here
+# Original Repo : https://github.com/CCOSTAN/Home-AssistantConfig
+# -------------------------------------------------------------------
+# MariaDB Dashboard - Lovelace stats overview
+#  Lovelace stack for MariaDB health metrics from SQL sensors.
+# -------------------------------------------------------------------
+# Notes: Paste this stack into a manual Lovelace view or card.
+# Notes: Uses Mushroom cards; swap to entities if the custom card is missing.
+######################################################################
+
+type: vertical-stack
+cards:
+  - type: entities
+    title: Database Statistics
+    entities:
+      - entity: sensor.database_size
+        name: Database Size
+        icon: mdi:database
+      - entity: sensor.database_tables_count
+        name: Number of Tables
+        icon: mdi:table
+      - entity: sensor.database_total_records
+        name: Total Records
+        icon: mdi:counter
+      - entity: sensor.database_records_per_day
+        name: Records per Day
+        icon: mdi:chart-line
+      - entity: sensor.database_oldest_record
+        name: Oldest Record
+        icon: mdi:clock-start
+  - type: entities
+    title: MariaDB Status
+    entities:
+      - entity: sensor.mariadb_status
+        name: Server Status
+        icon: mdi:database
+      - entity: sensor.mariadb_version
+        name: Version
+        icon: mdi:database-check
+      - entity: sensor.mariadb_performance
+        name: Performance
+        icon: mdi:chart-line
+      - entity: sensor.mariadb_uptime
+        name: Uptime
+        icon: mdi:timer-outline
+      - entity: sensor.mariadb_connections
+        name: Active Connections
+        icon: mdi:connection
+      - entity: sensor.mariadb_questions
+        name: Total Queries
+        icon: mdi:database-search
+  - type: grid
+    cards:
+      - type: custom:mushroom-template-card
+        primary: InnoDB Buffer Pool
+        secondary: "{{ states('sensor.mariadb_buffer_pool_size') }}"
+        icon: mdi:memory
+        layout: vertical
+        icon_color: blue
+      - type: custom:mushroom-template-card
+        primary: Max Connections
+        secondary: "{{ states('sensor.mariadb_max_connections') }}"
+        icon: mdi:account-multiple
+        layout: vertical
+        icon_color: green
+      - type: custom:mushroom-template-card
+        primary: Log File Size
+        secondary: "{{ states('sensor.mariadb_log_file_size') }}"
+        icon: mdi:file
+        layout: vertical
+        icon_color: orange
+      - type: custom:mushroom-template-card
+        primary: Temp Table Size
+        secondary: "{{ states('sensor.mariadb_tmp_table_size') }}"
+        icon: mdi:table
+        layout: vertical
+        icon_color: purple
+      - type: custom:mushroom-template-card
+        primary: IO Capacity
+        secondary: "{{ states('sensor.mariadb_io_capacity') }}"
+        icon: mdi:speedometer
+        layout: vertical
+        icon_color: red
+      - type: custom:mushroom-template-card
+        primary: IO Threads
+        secondary: "{{ states('sensor.mariadb_io_threads') }}"
+        icon: mdi:developer-board
+        layout: vertical
+        icon_color: cyan
+      - type: custom:mushroom-template-card
+        primary: Table Cache
+        secondary: "{{ states('sensor.mariadb_table_cache') }}"
+        icon: mdi:cached
+        layout: vertical
+        icon_color: amber
+      - type: custom:mushroom-template-card
+        primary: Buffer Sizes
+        secondary: "{{ states('sensor.mariadb_buffer_sizes') }}"
+        icon: mdi:buffer
+        layout: vertical
+        icon_color: teal

config/packages/README.md

@@ -44,6 +44,7 @@ Live collection of plug-and-play Home Assistant packages. Each YAML file in this
 | [holiday.yaml](holiday.yaml) | REST-driven US holiday + flag sensors that color scenes and exterior lighting. | `sensor.holiday`, `sensor.flag`, JSON feed at `config/json_data/holidays.json` |
 | [lightning.yaml](lightning.yaml) | Blitzortung lightning counter monitoring with snoozeable push actions. | `sensor.blitzortung_lightning_counter`, `input_boolean.snooze_lightning`, notify engine actions |
 | [logbook_activity_feed.yaml](logbook_activity_feed.yaml) | Dummy `sensor.activity_feed` + helper to write clean Activity entries (Issue #1550). | `sensor.activity_feed`, `script.send_to_logbook` |
+| [mariadb_monitoring.yaml](mariadb_monitoring.yaml) | MariaDB health sensors and Lovelace dashboard snippet for recorder stats. | `sensor.mariadb_status`, `sensor.database_size` |
 | [phynplus.yaml](phynplus.yaml) | Phyn shutoff automations with push + Activity feed + Repairs issues for leak events. | `valve.phyn_shutoff_valve`, `binary_sensor.phyn_leak_test_running`, `repairs.create` |
 | [powerwall.yaml](powerwall.yaml) | Track Tesla Powerwall grid status and shed loads automatically when off-grid (alerts include Activity feed + Repairs). | `binary_sensor.powerwall_grid_status`, `sensor.powerwall_*`, `repairs.create` |
 | [vacuum.yaml](vacuum.yaml) | Dreame vacuum orchestration with room tracking, push alerts, Activity feed, and Repairs issues on errors. | `input_select.l10s_vacuum_phase`, `sensor.l10s_vacuum_error`, `repairs.create` |

config/packages/mariadb_monitoring.yaml

@@ -0,0 +1,166 @@
+######################################################################
+# @CCOSTAN - Follow Me on X
+# For more info visit https://www.vcloudinfo.com/click-here
+# Original Repo : https://github.com/CCOSTAN/Home-AssistantConfig
+# -------------------------------------------------------------------
+# MariaDB Monitoring - SQL sensor bundle for DB health
+#  Recorder-backed metrics for MariaDB performance and capacity checks.
+# -------------------------------------------------------------------
+# Notes: Uses SQL integration against recorder_db_url.
+# Notes: COUNT(*) queries run every 6h; increase scan_interval or disable if slow.
+######################################################################
+
+sql:
+  - name: "MariaDB Status"
+    db_url: !secret recorder_db_url
+    query: >-
+      SELECT 'running' as status
+      FROM information_schema.GLOBAL_STATUS
+      WHERE VARIABLE_NAME = 'Uptime'
+        AND CAST(VARIABLE_VALUE AS UNSIGNED) > 0;
+    column: "status"
+    value_template: "{{ value if value else 'stopped' }}"
+
+  - name: "MariaDB Version"
+    db_url: !secret recorder_db_url
+    query: >-
+      SELECT @@version as version;
+    column: "version"
+
+  - name: "MariaDB Performance"
+    db_url: !secret recorder_db_url
+    query: >-
+      SELECT ROUND(
+        (SELECT VARIABLE_VALUE
+         FROM information_schema.GLOBAL_STATUS
+         WHERE VARIABLE_NAME = 'Queries') /
+        (SELECT VARIABLE_VALUE
+         FROM information_schema.GLOBAL_STATUS
+         WHERE VARIABLE_NAME = 'Uptime')
+      ) as performance;
+    column: "performance"
+    unit_of_measurement: "q/s"
+
+  - name: "Database Size"
+    db_url: !secret recorder_db_url
+    query: >-
+      SELECT ROUND(SUM(data_length + index_length) / 1024 / 1024, 2) as size
+      FROM information_schema.tables
+      WHERE table_schema = 'homeassistant';
+    column: "size"
+    unit_of_measurement: "MB"
+    value_template: "{{ value | float(0) }}"
+
+  - name: "Database Tables Count"
+    db_url: !secret recorder_db_url
+    query: >-
+      SELECT COUNT(*) as count
+      FROM information_schema.tables
+      WHERE table_schema = 'homeassistant';
+    column: "count"
+    unit_of_measurement: "tables"
+
+  - name: "Database Oldest Record"
+    db_url: !secret recorder_db_url
+    query: >-
+      SELECT DATE_FORMAT(MIN(last_updated), '%Y-%m-%d') as oldest
+      FROM states;
+    column: "oldest"
+
+  - name: "Database Total Records"
+    db_url: !secret recorder_db_url
+    query: >-
+      SELECT COUNT(*) as count
+      FROM states;
+    column: "count"
+    unit_of_measurement: "records"
+
+  - name: "Database Records Per Day"
+    db_url: !secret recorder_db_url
+    query: >-
+      SELECT ROUND(COUNT(*) / DATEDIFF(NOW(), MIN(last_updated)), 0) as avg
+      FROM states;
+    column: "avg"
+    unit_of_measurement: "records/day"
+
+  - name: "MariaDB Uptime"
+    db_url: !secret recorder_db_url
+    query: >-
+      SELECT VARIABLE_VALUE as value
+      FROM information_schema.GLOBAL_STATUS
+      WHERE VARIABLE_NAME = 'Uptime';
+    column: "value"
+    unit_of_measurement: "seconds"
+
+  - name: "MariaDB Connections"
+    db_url: !secret recorder_db_url
+    query: >-
+      SELECT VARIABLE_VALUE as value
+      FROM information_schema.GLOBAL_STATUS
+      WHERE VARIABLE_NAME = 'Threads_connected';
+    column: "value"
+    unit_of_measurement: "connections"
+
+  - name: "MariaDB Questions"
+    db_url: !secret recorder_db_url
+    query: >-
+      SELECT VARIABLE_VALUE as value
+      FROM information_schema.GLOBAL_STATUS
+      WHERE VARIABLE_NAME = 'Questions';
+    column: "value"
+    unit_of_measurement: "queries"
+
+  - name: "MariaDB Buffer Pool Size"
+    db_url: !secret recorder_db_url
+    query: >-
+      SELECT CONCAT(ROUND(@@innodb_buffer_pool_size / 1024 / 1024 / 1024, 1), ' GB') as value;
+    column: "value"
+
+  - name: "MariaDB Max Connections"
+    db_url: !secret recorder_db_url
+    query: >-
+      SELECT @@max_connections as value;
+    column: "value"
+
+  - name: "MariaDB Log File Size"
+    db_url: !secret recorder_db_url
+    query: >-
+      SELECT CONCAT(ROUND(@@innodb_log_file_size / 1024 / 1024, 0), ' MB') as value;
+    column: "value"
+
+  - name: "MariaDB Tmp Table Size"
+    db_url: !secret recorder_db_url
+    query: >-
+      SELECT CONCAT(ROUND(@@tmp_table_size / 1024 / 1024, 0), ' MB') as value;
+    column: "value"
+
+  - name: "MariaDB IO Capacity"
+    db_url: !secret recorder_db_url
+    query: >-
+      SELECT @@innodb_io_capacity as value;
+    column: "value"
+
+  - name: "MariaDB IO Threads"
+    db_url: !secret recorder_db_url
+    query: >-
+      SELECT CONCAT(
+        'Read: ', @@innodb_read_io_threads,
+        ', Write: ', @@innodb_write_io_threads
+      ) as value;
+    column: "value"
+
+  - name: "MariaDB Table Cache"
+    db_url: !secret recorder_db_url
+    query: >-
+      SELECT @@table_open_cache as value;
+    column: "value"
+
+  - name: "MariaDB Buffer Sizes"
+    db_url: !secret recorder_db_url
+    query: >-
+      SELECT CONCAT(
+        'Sort: ', ROUND(@@sort_buffer_size / 1024 / 1024, 0), 'M, ',
+        'Read: ', ROUND(@@read_buffer_size / 1024 / 1024, 0), 'M, ',
+        'Join: ', ROUND(@@join_buffer_size / 1024 / 1024, 0), 'M'
+      ) as value;
+    column: "value"