container collector

May 18, 2025 ยท View on GitHub

The container collector exposes metrics about containers running on a Hyper-V system

Metric name prefixcontainer
Data sourceHCS
Enabled by default?No

Flags

None

Metrics

NameDescriptionTypeLabels
windows_container_availableAvailablecountercontainer_id,namespace,pod,container,
windows_container_countNumber of containersgaugecontainer_id,namespace,pod,container,
windows_container_cpu_usage_seconds_kernelmodeRun time in Kernel mode in Secondscountercontainer_id,namespace,pod,container,
windows_container_cpu_usage_seconds_usermodeRun Time in User mode in Secondscountercontainer_id,namespace,pod,container,
windows_container_cpu_usage_seconds_totalTotal Run time in Secondscountercontainer_id,namespace,pod,container,
windows_container_memory_usage_commit_bytesMemory Usage Commit Bytesgaugecontainer_id,namespace,pod,container,
windows_container_memory_usage_commit_peak_bytesMemory Usage Commit Peak Bytesgaugecontainer_id,namespace,pod,container,
windows_container_memory_usage_private_working_set_bytesMemory Usage Private Working Set Bytesgaugecontainer_id,namespace,pod,container,
windows_container_network_receive_bytes_totalBytes Received on Interfacecountercontainer_id,namespace,pod,container,interface
windows_container_network_receive_packets_totalPackets Received on Interfacecountercontainer_id,namespace,pod,container,interface
windows_container_network_receive_packets_dropped_totalDropped Incoming Packets on Interfacecountercontainer_id,namespace,pod,container,interface
windows_container_network_transmit_bytes_totalBytes Sent on Interfacecountercontainer_id,namespace,pod,container,interface
windows_container_network_transmit_packets_totalPackets Sent on Interfacecountercontainer_id,namespace,pod,container,interface
windows_container_network_transmit_packets_dropped_totalDropped Outgoing Packets on Interfacecountercontainer_id,namespace,pod,container,interface
windows_container_storage_read_count_normalized_totalRead Count Normalizedcountercontainer_id,namespace,pod,container,
windows_container_storage_read_size_bytes_totalRead Size Bytescountercontainer_id,namespace,pod,container,
windows_container_storage_write_count_normalized_totalWrite Count Normalizedcountercontainer_id,namespace,pod,container,
windows_container_storage_write_size_bytes_totalWrite Size Bytescountercontainer_id,namespace,pod,container,

Example metric

windows_container_network_receive_bytes_total{container_id="docker://1bd30e8b8ac28cbd76a9b697b4d7bb9d760267b0733d1bc55c60024e98d1e43e",interface="822179E7-002C-4280-ABBA-28BCFE401826"} 9.3305343e+07

This metric means that total 9.3305343e+07 bytes received on interface 822179E7-002C-4280-ABBA-28BCFE401826 for container docker://1bd30e8b8ac28cbd76a9b697b4d7bb9d760267b0733d1bc55c60024e98d1e43e

Useful queries

Attach labels namespace/pod/container fow windows container metrics.

# kube_pod_container_info(a metric of kube-state-metrics) has labels namespace/pod/container/container_id for a container, while windows container metrics only have container_id.
# Attaching labels namespace/pod/container for windows container metrics, is useful to query for windows pods.
windows_container_network_receive_bytes_total * on(container_id) group_left(namespace, pod, container) kube_pod_container_info{container_id!=""}

Alerting examples

This collector does not yet have alerting examples, we would appreciate your help adding them!