btrfs_health
Check BTRFS filesystem health by monitoring disk usage, error statistics, scrub and balance status, and space allocation.
Instructions
Check BTRFS filesystem health and status. Monitor disk usage, errors, and maintenance operations.
Actions:
usage: Comprehensive filesystem space usage
devices: List devices in the BTRFS array
stats: Device error statistics (corruption, read/write errors)
scrub_status: Status of scrub operation (data integrity check)
balance_status: Status of balance operation (data redistribution)
df: Space allocation by data type (Data, Metadata, System)
filesystem_show: Filesystem information and device list
Current default mount: / Using sudo: True
Examples:
Check usage: action="usage", mount_point="/"
Check for errors: action="stats", mount_point="/"
Scrub status: action="scrub_status", mount_point="/"
Show filesystem: action="filesystem_show"
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| action | Yes | The btrfs action: usage (space usage), devices (list devices), stats (error statistics), scrub_status (scrub progress), balance_status (balance progress), df (data/metadata usage), filesystem_show (filesystem info) | |
| mount_point | No | BTRFS mount point (e.g., '/', '/home'). Uses default from SNAPPER_MCP_DEFAULT_MOUNT if not specified. | |
| device | No | Specific device path for stats action (e.g., '/dev/sda1'). If not specified, uses mount point. |