Skip to content

docs(kb): drive utilization over 100% in Prometheus/Grafana is an I/O metric - #496

Open
CarlRodabaugh wants to merge 1 commit into
mainfrom
docs/kb-prometheus-drive-util
Open

CarlRodabaugh wants to merge 1 commit into
mainfrom
docs/kb-prometheus-drive-util

Conversation

@CarlRodabaugh

Copy link
Copy Markdown
Collaborator

Summary

New KB article: knowledge-base/posts/prometheus-drive-util-is-io-not-capacity.md.

Customers monitoring with the Prometheus exporter see vergeos_drive_util at or above 100% on one drive per node and read it as a full drive, or as vSAN not spreading data. The article covers:

  • the fact that vergeos_drive_util measures I/O load, not how full the drive is
  • why one drive per node is often the busiest one
  • which metric to alert on for capacity: vergeos_vsan_tier_used_pct, or a Storage Tiers subscription
  • where to see per-drive fill in the UI: Infrastructure → Nodes → node → Drives → Usage

Verification

  • Metric names match the Prometheus Exporter page.
  • The UI path and labels were checked on a 26.1.8 system.
  • Rendered locally with mkdocs serve.
  • All links return 200 on docs.verge.io.

Reviewer note

Engineering: please confirm that vergeos_drive_util can exceed 100% and that it measures I/O the way vergeos_vm_disk_util does. The exporter's metric list gives the drive metric no description.

🤖 Generated with Claude Code

… metric

Troubleshooting article for vergeos_drive_util reading at or above 100% on
one drive per node while the others sit near 0%. Explains that the metric
reflects drive I/O load, not fullness, and points capacity alerting at
vergeos_vsan_tier_used_pct or a Storage Tiers subscription instead.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant