mirror of https://github.com/prometheus-community/windows_exporter.git synced 2026-10-17 10:09:05 +02:00

Files

T

Jan-Otto KröpkeandClaude Opus 5.5 2b21e74f0e storage_spaces: move storage pool and virtual disk metrics out of mscluster (#2646 )

Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>
Signed-off-by: Jan-Otto Kröpke <mail@jkroepke.de>

2026-10-10 16:50:35 +02:00

5.2 KiB

Raw Blame History

storage_spaces collector

The storage_spaces collector exposes metrics about Storage Spaces storage pools and virtual disks. It works on standalone hosts as well as on failover clusters using Storage Spaces Direct.


Metric name prefix	`storage_spaces`
Classes	`MSFT_StoragePool`, `MSFT_VirtualDisk`
Enabled by default?	No

Flags

`--collector.storage_spaces.enabled`

Comma-separated list of collectors to use, for example: --collector.storage_spaces.enabled=pool,virtual_disk. Matching is case-sensitive.

Metrics

Pool

Name	Description	Type	Labels
`windows_storage_spaces_pool_info`	Storage pool information (value is always 1)	gauge	`name`, `unique_id`
`windows_storage_spaces_pool_health_status`	Health status of the storage pool. 0: Healthy, 1: Warning, 2: Unhealthy, 5: Unknown	gauge	`name`, `unique_id`
`windows_storage_spaces_pool_size_bytes`	Total size of the storage pool in bytes	gauge	`name`, `unique_id`
`windows_storage_spaces_pool_allocated_size_bytes`	Allocated size of the storage pool in bytes	gauge	`name`, `unique_id`
`windows_storage_spaces_pool_operational_status`	Operational status codes reported for the storage pool (one series per status value)	gauge	`name`, `unique_id`, `status`
`windows_storage_spaces_pool_thin_provisioning_alert_thresholds`	Thin provisioning alert thresholds configured for the storage pool, in percent (one series per configured threshold)	gauge	`name`, `unique_id`, `threshold`

Virtual Disk

Name	Description	Type	Labels
`windows_storage_spaces_virtual_disk_info`	Virtual disk information (value is always 1)	gauge	`name`, `unique_id`
`windows_storage_spaces_virtual_disk_health_status`	Health status of the virtual disk. 0: Healthy, 1: Warning, 2: Unhealthy, 5: Unknown	gauge	`name`, `unique_id`
`windows_storage_spaces_virtual_disk_size_bytes`	Total size of the virtual disk in bytes	gauge	`name`, `unique_id`
`windows_storage_spaces_virtual_disk_allocated_size_bytes`	Allocated size of the virtual disk in bytes (capacity actually provisioned, excludes thin-provisioned unused capacity)	gauge	`name`, `unique_id`
`windows_storage_spaces_virtual_disk_footprint_on_pool_bytes`	Physical storage consumed by the virtual disk on the storage pool in bytes	gauge	`name`, `unique_id`
`windows_storage_spaces_virtual_disk_storage_efficiency_percent`	Storage efficiency percentage (AllocatedSize / FootprintOnPool * 100), omitted while FootprintOnPool is 0	gauge	`name`, `unique_id`

Example metric

windows_storage_spaces_pool_size_bytes{name="Pool01",unique_id="{8f2c...}"} 1.0995116277760e+12

Useful queries

Storage pool usage in percent

windows_storage_spaces_pool_allocated_size_bytes / windows_storage_spaces_pool_size_bytes * 100

Find virtual disks with low storage efficiency (over-provisioned)

windows_storage_spaces_virtual_disk_storage_efficiency_percent < 50

Calculate total virtual disk capacity vs physical usage

sum(windows_storage_spaces_virtual_disk_size_bytes) / sum(windows_storage_spaces_virtual_disk_footprint_on_pool_bytes) * 100

Alerting examples

Unhealthy storage pool

- alert: StoragePoolUnhealthy
  expr: windows_storage_spaces_pool_health_status != 0
  for: 10m
  labels:
    severity: warning
  annotations:
    summary: "Storage pool {{ $labels.name }} is not healthy"
    description: "Storage pool {{ $labels.name }} on {{ $labels.instance }} reports health status {{ $value }}."

5.2 KiB Raw Blame History