google-cloud-filestore-autoscale

Inspects Filestore capacity utilization and scales instance storage up or down against tier thresholds.

19.1k|1.5k|Updated Mar 31, 2026
One-click install
npx skills add https://github.com/google/skills --skill google-cloud-filestore-autoscale
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: google-cloud-filestore-autoscale
Source: https://github.com/google/skills/tree/main/skills/cloud/google-cloud-filestore-autoscale
Command: npx skills add https://github.com/google/skills --skill google-cloud-filestore-autoscale

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Filestore instances risk out-of-space outages when free space runs low, or wasted spend when over-provisioned. This Skill automates capacity inspection, threshold evaluation, and resizing of Google Cloud Filestore instances so storage stays right-sized without manual monitoring.

Core Features & Use Cases

  • Fleet Capacity Inspection: Discovers Filestore instances via MCP tools or gcloud CLI and fetches used_bytes metrics from Cloud Monitoring to compute free space percentages.
  • Threshold-Based Autoscaling: Evaluates instances against scale-up (<15% free) and scale-down (>30% free) thresholds, respecting tier-specific floors, ceilings, and step increments.
  • Safe Execution Workflow: Produces a summary table with one of five verdicts per instance and requires explicit user confirmation before running any gcloud update command.
  • Use Case: A platform engineer asks the agent to check all Filestore instances in project analytics-prod; the Skill reports that a Basic HDD volume at 90% utilization needs scale-up and proposes the exact attributed gcloud command, waiting for confirmation before executing.

Quick Start

Ask the agent to inspect Filestore capacity in your GCP project and recommend scaling actions for any instances outside the healthy free-space range.

Frequently Asked Questions about google-cloud-filestore-autoscale

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I autoscale Google Cloud Filestore instance capacity?

Inspect instances with gcloud filestore instances list or Filestore MCP tools, fetch the used_bytes metric from Cloud Monitoring, then compare free space against thresholds. Scale up when free space drops below 15% and scale down when it exceeds 30%, rounding targets to the tier's step increment.

How to check Filestore free space and utilization?

Query the file.googleapis.com/nfs/server/used_bytes metric from the Cloud Monitoring API using a 5-minute average, then compute free space as (total_bytes - used_bytes) / total_bytes * 100. Provisioned capacity comes from the instance description or the total_bytes metric.

Can Basic tier Filestore instances scale down?

No, Basic HDD and Basic SSD instances are scale-up only because they are backed by single Persistent Disks that cannot be shrunk. To reduce capacity you must migrate data to a new smaller instance or move to a Zonal or Regional scale-out tier.

Why does Filestore scale-down fail with capacity errors?

Scale-down fails when the target is below the tier minimum floor (1 TiB or 10 TiB depending on band) or below current used_bytes. Set the target capacity above the used_bytes metric with buffer and within the tier's allowed capacity band.

What IAM permissions are needed to resize Filestore instances?

Resizing requires roles/file.editor or roles/file.admin on the project. PERMISSION_DENIED errors indicate missing IAM bindings, and RESOURCE_EXHAUSTED errors indicate insufficient regional filestore quota requiring a quota increase request.