diff --git a/collector/logical_disk.go b/collector/logical_disk.go index 2f9d8eea..cf463d3c 100644 --- a/collector/logical_disk.go +++ b/collector/logical_disk.go @@ -103,14 +103,14 @@ func NewLogicalDiskCollector() (Collector, error) { FreeSpace: prometheus.NewDesc( prometheus.BuildFQName(Namespace, subsystem, "free_bytes"), - "Free space in bytes (LogicalDisk.PercentFreeSpace)", + "Free space in bytes, updates every 10-15 min (LogicalDisk.PercentFreeSpace)", []string{"volume"}, nil, ), TotalSpace: prometheus.NewDesc( prometheus.BuildFQName(Namespace, subsystem, "size_bytes"), - "Total space in bytes (LogicalDisk.PercentFreeSpace_Base)", + "Total space in bytes, updates every 10-15 min (LogicalDisk.PercentFreeSpace_Base)", []string{"volume"}, nil, ), diff --git a/docs/collector.logical_disk.md b/docs/collector.logical_disk.md index 489af4b2..479ee2b2 100644 --- a/docs/collector.logical_disk.md +++ b/docs/collector.logical_disk.md @@ -30,11 +30,15 @@ Name | Description | Type | Labels `writes_total` | Rate of write operations on the disk | counter | `volume` `read_seconds_total` | Seconds the disk was busy servicing read requests | counter | `volume` `write_seconds_total` | Seconds the disk was busy servicing write requests | counter | `volume` -`free_bytes` | Unused space of the disk in bytes | gauge | `volume` -`size_bytes` | Total size of the disk in bytes | gauge | `volume` +`free_bytes` | Unused space of the disk in bytes (not real time, updates every 10-15 min) | gauge | `volume` +`size_bytes` | Total size of the disk in bytes (not real time, updates every 10-15 min) | gauge | `volume` `idle_seconds_total` | Seconds the disk was idle (not servicing read/write requests) | counter | `volume` `split_ios_total` | Number of I/Os to the disk split into multiple I/Os | counter | `volume` +### Warning about size metrics +The `free_bytes` and `size_bytes` metrics are not updated in real time and might have a delay of 10-15min. +This is the same behavior as the windows performance counters. + ### Example metric Query the rate of write operations to a disk ``` diff --git a/tools/e2e-output.txt b/tools/e2e-output.txt index 305f599f..c36e5e7e 100644 --- a/tools/e2e-output.txt +++ b/tools/e2e-output.txt @@ -119,7 +119,7 @@ windows_exporter_collector_timeout{collector="system"} 0 windows_exporter_collector_timeout{collector="textfile"} 0 # HELP windows_exporter_perflib_snapshot_duration_seconds Duration of perflib snapshot capture # TYPE windows_exporter_perflib_snapshot_duration_seconds gauge -# HELP windows_logical_disk_free_bytes Free space in bytes (LogicalDisk.PercentFreeSpace) +# HELP windows_logical_disk_free_bytes Free space in bytes, updates every 10-15 min (LogicalDisk.PercentFreeSpace) # TYPE windows_logical_disk_free_bytes gauge # HELP windows_logical_disk_idle_seconds_total Seconds that the disk was idle (LogicalDisk.PercentIdleTime) # TYPE windows_logical_disk_idle_seconds_total counter @@ -135,7 +135,7 @@ windows_exporter_collector_timeout{collector="textfile"} 0 # TYPE windows_logical_disk_reads_total counter # HELP windows_logical_disk_requests_queued The number of requests queued to the disk (LogicalDisk.CurrentDiskQueueLength) # TYPE windows_logical_disk_requests_queued gauge -# HELP windows_logical_disk_size_bytes Total space in bytes (LogicalDisk.PercentFreeSpace_Base) +# HELP windows_logical_disk_size_bytes Total space in bytes, updates every 10-15 min (LogicalDisk.PercentFreeSpace_Base) # TYPE windows_logical_disk_size_bytes gauge # HELP windows_logical_disk_split_ios_total The number of I/Os to the disk were split into multiple I/Os (LogicalDisk.SplitIOPerSec) # TYPE windows_logical_disk_split_ios_total counter