Monitoring
Monitoring
StorONE's monitoring commands give you both a live view of what the system is doing right now and a historical view of how it got there — health, capacity, performance, utilization, and tiering, at the system, pool, node, application, or volume level. Most monitoring views are read-only reports; a handful of the "live" ones stream continuously in an interactive CLI session or render as a chart.
This chapter is split into four pages:
- Health and capacity (this page) — the overall health snapshot, pool capacity (current and historical), thin-provisioning risk, and per-volume capacity.
- Live monitoring — real-time utilization, performance, drive-level statistics, and ALUA path state.
- Historical monitoring — performance and utilization trends over time, top-volume rankings, and reserve space.
- Tiering monitoring — autotiering evacuation activity and usage distribution.
Overall health
monitoring health current gives you a single summary of system health, split into four categories:
- Volumes — the percentage of volumes that are in a healthy state. A volume counts as unhealthy if it's Degraded, Not Available, Out of Space, Timing Out, Read-Only, or waiting for its encryption key.
- Hardware Resources — the percentage of hardware components (drives, memory, CPU, HBAs, NICs) across all nodes that are reporting healthy.
- Hardware Utilization — how busy your disks, CPU, and memory are, averaged together into one figure.
- Capacity Utilization — how much of your raw pool capacity is consumed, system-wide.
By default all four categories are shown as a single percentage each. Turning on Details for a category breaks it down further: for Volumes you get the healthy/unhealthy counts and which specific states are represented; for Hardware Resources you get the count of unhealthy components per resource type; for Hardware Utilization you get separate figures for drive, memory, and CPU; and for Capacity Utilization you get a per-pool breakdown along with the vRAID (N+K) combinations in use.
This is the view to check first when something seems off — it tells you which area needs attention before you dig into the more detailed pages.
Using the web interface
- Open Monitoring > Health.
- Use the category checkboxes — Volumes, Hardware Resources, Hardware Utilization, Capacity Utilization — to choose what to display. Leave all of them unchecked to see every category at once.
- Turn on Details to see the itemized breakdown instead of just a percentage.
Using the CLI
monitoring health current [--volumes] [--hardwareResources] [--hardwareUtilization] [--capacityUtilization] [--details]
| Option | Description |
|---|---|
--volumes |
Show volumes health. |
--hardwareResources |
Show hardware health. |
--hardwareUtilization |
Show hardware utilization. |
--capacityUtilization |
Show capacity utilization. |
--details |
Show a detailed breakdown for each selected category. |
Examples
Full health snapshot, one line per category:
monitoring health current
Just hardware resource health, broken down by resource type:
monitoring health current --hardwareResources --details
Volumes and capacity health together:
monitoring health current --volumes --capacityUtilization
Pool capacity — current
monitoring capacity pools current shows how much of your raw pool capacity is actually consumed right now. By default it shows a system-wide total; Details breaks it out per pool. Allocation adds a second figure alongside consumption: how much capacity has been provisioned to volumes (thin-provisioned, so this can exceed what's actually been written) versus how much has actually been consumed by written data.
Using the web interface
Open Monitoring > Capacity. The page shows a live capacity chart; use the toolbar to switch to the per-pool breakdown and to show allocation alongside consumption.
Using the CLI
monitoring capacity pools current [--details] [--allocation] [--interactiveChart | --saveChart]
| Option | Description |
|---|---|
--details |
Show capacity distribution information (per pool, instead of a system-wide total). |
--allocation |
Show allocation (provisioned capacity) in addition to consumption. |
--interactiveChart |
Create an interactive chart instead of text output. Windows CLI only. |
--saveChart |
Create a chart and save it to a file without displaying it. Windows CLI only. |
Examples
System-wide capacity summary:
monitoring capacity pools current
Per-pool breakdown, including how much capacity is provisioned versus actually consumed:
monitoring capacity pools current --details --allocation
Pool capacity — history
monitoring capacity pools history plots capacity consumption over time, which is the view you want for capacity planning — how fast are you actually filling up, and when will a pool run out. You can filter by pool type (HDD, SSD, NVMe, or manually defined pools); if you don't select any, every pool type your system actually uses is included.
If you set an end date in the future, StorONE extrapolates a growth trend from your historical data and projects it forward — useful for a quick "at this rate, when do I run out" answer. In the CLI you'll be asked to confirm before it does this (predictions can be wrong); pass --force to skip the prompt.
Using the web interface
- Open Monitoring > Capacity and switch to the historical view.
- Under Filter By Pools, choose which pool types to include — HDD, SSD, NVMe, and/or manually defined pools. Leave all unchecked to include everything.
- Set a date range and sampling interval, then confirm to view the chart.
Using the CLI
monitoring capacity pools history [--hdd] [--ssd] [--nvme] [--manualPools] [--fromDate=<date>] [--toDate=<date>] [--utcTime] [--interval=<interval>] [--interactiveChart | --saveChart] [--force]
| Option | Description |
|---|---|
--hdd |
Show HDD pool capacity. |
--ssd |
Show SSD pool capacity. |
--nvme |
Show NVMe pool capacity. |
--manualPools |
Show manually defined pool capacity. |
--fromDate=<date> |
Start of the date range, in ISO 8601 format (YYYY-MM-DDTHH:MM:SS). Defaults to 30 days ago. |
--toDate=<date> |
End of the date range, in ISO 8601 format. Defaults to now. A future date triggers a projected growth trend. |
--utcTime |
Show timestamps in UTC instead of local time. |
--interval=<interval> |
Sampling interval, in minutes. |
--interactiveChart |
Create an interactive chart instead of text output. Windows CLI only. |
--saveChart |
Create a chart and save it to a file without displaying it. Windows CLI only. |
--force |
Don't ask for confirmation when the results include predicted (projected) values. |
Examples
Capacity history for the last 30 days (the default range), all pool types:
monitoring capacity pools history
HDD pool history for a specific month, sampled every hour:
monitoring capacity pools history --hdd --fromDate 2026-01-01T00:00:00 --toDate 2026-01-31T23:59:59 --interval 60
Project SSD pool capacity six months into the future based on recent growth, without the confirmation prompt:
monitoring capacity pools history --ssd --toDate 2026-09-01T00:00:00 --force
Thin-provisioning risk
monitoring capacity provisioning is a quick risk check for pools that use thin provisioning: for each pool, it reports whether the pool is comfortably within its physical capacity, approaching a soft threshold (a warning, or a point where the pool becomes read-only), or has hit a hard limit — along with the free space percentage and the vRAID (N+K) fragment combinations in use on that pool. Because volumes are thin-provisioned, the capacity promised to volumes can exceed the pool's actual physical capacity; this view is how you catch a pool that's about to become a problem before it does.
It takes no parameters — it always reports every pool.
Using the web interface
Open Monitoring > Capacity and switch to the provisioning view.
Using the CLI
monitoring capacity provisioning
Example
monitoring capacity provisioning
Volume capacity
monitoring capacity volumes lists capacity allocation and consumption for every volume in the system (equivalent to running applications volumes list with capacity statistics turned on, but scoped to monitoring rather than volume management). It takes no parameters.
Using the web interface
Open Monitoring > Capacity and switch to the per-volume view — or open Application Volumes > Volumes and enable the capacity column.
Using the CLI
monitoring capacity volumes
Example
monitoring capacity volumes
Next: Live monitoring — utilization, performance, drives, and ALUA statistics in real time.