The hyperv collector exposes metrics about the Hyper-V hypervisor
| Metric name prefix | hyperv |
| Source | Performance counters |
| Enabled by default? | No |
Comma-separated list of collectors to use, for example:
--collectors.hyperv.enabled=dynamic_memory_balancer,dynamic_memory_vm,hypervisor_logical_processor,hypervisor_root_partition,hypervisor_root_virtual_processor,hypervisor_virtual_processor,legacy_network_adapter,virtual_machine_health_summary,virtual_machine_vid_partition,virtual_network_adapter,virtual_storage_device,virtual_switch.
Matching is case-sensitive.
This documentation outlines the available metrics for monitoring Hyper-V Datastore performance and resource usage using Prometheus. All metrics are prefixed with windows_hyperv_datastore.
| Metric Name | Description | Type | Labels |
|---|---|---|---|
windows_hyperv_datastore_fragmentation_ratio |
Represents the fragmentation ratio of the DataStore. | gauge | datastore |
windows_hyperv_datastore_sector_size_bytes |
Represents the sector size of the DataStore in bytes. | gauge | datastore |
windows_hyperv_datastore_data_alignment_bytes |
Represents the data alignment of the DataStore in bytes. | gauge | datastore |
windows_hyperv_datastore_current_replay_log_size_bytes |
Represents the current replay log size of the DataStore in bytes. | gauge | datastore |
windows_hyperv_datastore_available_entries |
Represents the number of available entries inside object tables. | gauge | datastore |
windows_hyperv_datastore_empty_entries |
Represents the number of empty entries inside object tables. | gauge | datastore |
windows_hyperv_datastore_free_bytes |
Represents the number of free bytes inside key tables. | gauge | datastore |
windows_hyperv_datastore_data_end_bytes |
Represents the data end of the DataStore in bytes. | gauge | datastore |
windows_hyperv_datastore_file_objects |
Represents the number of file objects in the DataStore. | gauge | datastore |
windows_hyperv_datastore_object_tables |
Represents the number of object tables in the DataStore. | gauge | datastore |
windows_hyperv_datastore_key_tables |
Represents the number of key tables in the DataStore. | gauge | datastore |
windows_hyperv_datastore_file_data_size_bytes |
Represents the file data size in bytes of the DataStore. | gauge | datastore |
windows_hyperv_datastore_table_data_size_bytes |
Represents the table data size in bytes of the DataStore. | gauge | datastore |
windows_hyperv_datastore_names_size_bytes |
Represents the names size in bytes of the DataStore. | gauge | datastore |
windows_hyperv_datastore_number_of_keys |
Represents the number of keys in the DataStore. | gauge | datastore |
windows_hyperv_datastore_reconnect_latency_microseconds |
Represents the reconnect latency in microseconds of the DataStore. | gauge | datastore |
windows_hyperv_datastore_disconnect_count |
Represents the disconnect count of the DataStore. | counter | datastore |
windows_hyperv_datastore_write_to_file_byte_latency_microseconds |
Represents the write-to-file byte latency in microseconds of the DataStore. | gauge | datastore |
windows_hyperv_datastore_write_to_file_byte_count |
Represents the write-to-file byte count of the DataStore. | counter | datastore |
windows_hyperv_datastore_write_to_file_count |
Represents the write-to-file count of the DataStore. | counter | datastore |
windows_hyperv_datastore_read_from_file_byte_latency_microseconds |
Represents the read-from-file byte latency in microseconds of the DataStore. | gauge | datastore |
windows_hyperv_datastore_read_from_file_byte_count |
Represents the read-from-file byte count of the DataStore. | counter | datastore |
windows_hyperv_datastore_read_from_file_count |
Represents the read-from-file count of the DataStore. | counter | datastore |
windows_hyperv_datastore_write_to_storage_byte_latency_microseconds |
Represents the write-to-storage byte latency in microseconds of the DataStore. | gauge | datastore |
windows_hyperv_datastore_write_to_storage_byte_count |
Represents the write-to-storage byte count of the DataStore. | counter | datastore |
windows_hyperv_datastore_write_to_storage_count |
Represents the write-to-storage count of the DataStore. | counter | datastore |
windows_hyperv_datastore_read_from_storage_byte_latency_microseconds |
Represents the read-from-storage byte latency in microseconds of the DataStore. | gauge | datastore |
windows_hyperv_datastore_read_from_storage_byte_count |
Represents the read-from-storage byte count of the DataStore. | counter | datastore |
windows_hyperv_datastore_read_from_storage_count |
Represents the read-from-storage count of the DataStore. | counter | datastore |
windows_hyperv_datastore_commit_byte_latency_microseconds |
Represents the commit byte latency in microseconds of the DataStore. | gauge | datastore |
windows_hyperv_datastore_commit_byte_count |
Represents the commit byte count of the DataStore. | counter | datastore |
windows_hyperv_datastore_commit_count |
Represents the commit count of the DataStore. | counter | datastore |
windows_hyperv_datastore_cache_update_operation_latency_microseconds |
Represents the cache update operation latency in microseconds of the DataStore. | gauge | datastore |
windows_hyperv_datastore_cache_update_operation_count |
Represents the cache update operation count of the DataStore. | counter | datastore |
windows_hyperv_datastore_commit_operation_latency_microseconds |
Represents the commit operation latency in microseconds of the DataStore. | gauge | datastore |
windows_hyperv_datastore_commit_operation_count |
Represents the commit operation count of the DataStore. | counter | datastore |
windows_hyperv_datastore_compact_operation_latency_microseconds |
Represents the compact operation latency in microseconds of the DataStore. | gauge | datastore |
windows_hyperv_datastore_compact_operation_count |
Represents the compact operation count of the DataStore. | counter | datastore |
windows_hyperv_datastore_load_file_operation_latency_microseconds |
Represents the load file operation latency in microseconds of the DataStore. | gauge | datastore |
windows_hyperv_datastore_load_file_operation_count |
Represents the load file operation count of the DataStore. | counter | datastore |
windows_hyperv_datastore_remove_operation_latency_microseconds |
Represents the remove operation latency in microseconds of the DataStore. | gauge | datastore |
windows_hyperv_datastore_remove_operation_count |
Represents the remove operation count of the DataStore. | counter | datastore |
windows_hyperv_datastore_query_size_operation_latency_microseconds |
Represents the query size operation latency in microseconds of the DataStore. | gauge | datastore |
windows_hyperv_datastore_query_size_operation_count |
Represents the query size operation count of the DataStore. | counter | datastore |
windows_hyperv_datastore_set_operation_latency_microseconds |
Represents the set operation latency in microseconds of the DataStore. | gauge | datastore |
windows_hyperv_datastore_set_operation_count |
Represents the set operation count of the DataStore. | counter | datastore |
Some metrics explained: https://learn.microsoft.com/en-us/archive/blogs/chrisavis/monitoring-dynamic-memory-in-windows-server-hyper-v-2012
| Name | Description | Type | Labels |
|---|---|---|---|
windows_hyperv_dynamic_memory_balancer_available_memory_bytes |
Represents the amount of memory left on the node. | gauge | balancer |
windows_hyperv_dynamic_memory_balancer_available_memory_for_balancing_bytes |
Represents the available memory for balancing purposes. | gauge | balancer |
windows_hyperv_dynamic_memory_balancer_average_pressure_ratio |
Represents the average system pressure on the balancer node among all balanced objects. | gauge | balancer |
windows_hyperv_dynamic_memory_balancer_system_current_pressure_ratio |
Represents the current pressure in the system. | gauge | balancer |
| Name | Description | Type | Labels |
|---|---|---|---|
windows_hyperv_dynamic_memory_vm_added_bytes_total |
Represents the cumulative amount of memory added to the VM. | counter | vm |
windows_hyperv_dynamic_memory_vm_pressure_current_ratio |
Represents the current pressure in the VM. | gauge | vm |
windows_hyperv_dynamic_memory_vm_guest_available_bytes |
Represents the current amount of available memory in the VM (reported by the VM). | gauge | vm |
windows_hyperv_dynamic_memory_vm_guest_visible_physical_memory_bytes |
Represents the amount of memory visible in the VM | gauge | vm |
windows_hyperv_dynamic_memory_vm_pressure_maximum_ratio |
Represents the maximum pressure band in the VM. | gauge | vm |
windows_hyperv_dynamic_memory_vm_add_operations_total |
Represents the total number of add operations for the VM. | counter | vm |
windows_hyperv_dynamic_memory_vm_remove_operations_total |
Represents the total number of remove operations for the VM. | counter | vm |
windows_hyperv_dynamic_memory_vm_pressure_minimum_ratio |
Represents the minimum pressure band in the VM. | gauge | vm |
windows_hyperv_dynamic_memory_vm_physical |
Represents the current amount of memory in the VM. | gauge | vm |
windows_hyperv_dynamic_memory_vm_removed_bytes_total |
Represents the cumulative amount of memory removed from the VM. | counter | vm |
| Name | Description | Type | Labels |
|---|---|---|---|
windows_hyperv_hypervisor_logical_processor_time_total |
Time that processor spent in different modes (hypervisor, guest, idle) | counter | core.state |
windows_hyperv_hypervisor_logical_processor_context_switches_total |
The rate of virtual processor context switches on the processor. | counter | core |
| Name | Description | Type | Labels |
|---|---|---|---|
windows_hyperv_root_partition_address_spaces |
The number of address spaces in the virtual TLB of the partition | gauge | None |
windows_hyperv_root_partition_attached_devices |
The number of devices attached to the partition | gauge | None |
windows_hyperv_root_partition_deposited_pages |
The number of pages deposited into the partition | gauge | None |
windows_hyperv_root_partition_device_dma_errors |
An indicator of illegal DMA requests generated by all devices assigned to the partition | gauge | None |
windows_hyperv_root_partition_device_interrupt_errors |
An indicator of illegal interrupt requests generated by all devices assigned to the partition | gauge | None |
windows_hyperv_root_partition_device_interrupt_mappings |
The number of device interrupt mappings used by the partition | gauge | None |
windows_hyperv_root_partition_device_interrupt_throttle_events |
The number of times an interrupt from a device assigned to the partition was temporarily throttled because the device was generating too many interrupts | gauge | None |
windows_hyperv_root_partition_preferred_numa_node_index |
The number of pages present in the GPA space of the partition (zero for root partition) | gauge | None |
windows_hyperv_root_partition_gpa_space_modifications |
The rate of modifications to the GPA space of the partition | counter | None |
windows_hyperv_root_partition_io_tlb_flush_cost |
The average time (in nanoseconds) spent processing an I/O TLB flush | gauge | None |
windows_hyperv_root_partition_io_tlb_flush |
The rate of flushes of I/O TLBs of the partition | counter | None |
windows_hyperv_root_partition_recommended_virtual_tlb_size |
The recommended number of pages to be deposited for the virtual TLB | gauge | None |
windows_hyperv_root_partition_physical_pages_allocated |
The number of timer interrupts skipped for the partition | gauge | None |
windows_hyperv_root_partition_1G_device_pages |
The number of 1G pages present in the device space of the partition | gauge | None |
windows_hyperv_root_partition_1G_gpa_pages |
The number of 1G pages present in the GPA space of the partition | gauge | None |
windows_hyperv_root_partition_2M_device_pages |
The number of 2M pages present in the device space of the partition | gauge | None |
windows_hyperv_root_partition_2M_gpa_pages |
The number of 2M pages present in the GPA space of the partition | gauge | None |
windows_hyperv_root_partition_4K_device_pages |
The number of 4K pages present in the device space of the partition | gauge | None |
windows_hyperv_root_partition_4K_gpa_pages |
The number of 4K pages present in the GPA space of the partition | gauge | None |
windows_hyperv_root_partition_virtual_tlb_flush_entries |
The rate of flushes of the entire virtual TLB | counter | None |
windows_hyperv_root_partition_virtual_tlb_pages |
The number of pages used by the virtual TLB of the partition | gauge | None |
| Name | Description | Type | Labels |
|---|---|---|---|
windows_hyperv_hypervisor_root_virtual_processor_time_total |
Time that processor spent in different modes (hypervisor, guest_run, guest_idle, remote, total) | counter | core.state |
windows_hyperv_hypervisor_root_virtual_cpu_wait_time_per_dispatch_total |
The average time (in nanoseconds) spent waiting for a virtual processor to be dispatched onto a logical processor | counter | core |
| Name | Description | Type | Labels |
|---|---|---|---|
windows_hyperv_legacy_network_adapter_bytes_dropped_total |
Bytes Dropped is the number of bytes dropped on the network adapter | counter | adapter |
windows_hyperv_legacy_network_adapter_bytes_received_total |
Bytes received is the number of bytes received on the network adapter | counter | adapter |
windows_hyperv_legacy_network_adapter_bytes_sent_total |
Bytes sent is the number of bytes sent over the network adapter | counter | adapter |
windows_hyperv_legacy_network_adapter_frames_dropped_total |
Frames Dropped is the number of frames dropped on the network adapter | counter | adapter |
windows_hyperv_legacy_network_adapter_frames_received_total |
Frames received is the number of frames received on the network adapter | counter | adapter |
windows_hyperv_legacy_network_adapter_frames_sent_total |
Frames sent is the number of frames sent over the network adapter | counter | adapter |
| Name | Description | Type | Labels |
|---|---|---|---|
windows_hyperv_hypervisor_virtual_processor_time_total |
Time that processor spent in different modes (hypervisor, guest_run, guest_idle, remote) | counter | vm, core |
windows_hyperv_hypervisor_virtual_processor_total_run_time_total |
Time that processor spent | counter | vm, core |
windows_hyperv_hypervisor_virtual_processor_cpu_wait_time_per_dispatch_total |
The average time (in nanoseconds) spent waiting for a virtual processor to be dispatched onto a logical processor. | counter | vm, core |
| Name | Description | Type | Labels |
|---|---|---|---|
windows_hyperv_virtual_network_adapter_received_bytes_total |
Represents the total number of bytes received per second by the network adapter | counter | adapter |
windows_hyperv_virtual_network_adapter_sent_bytes_total |
Represents the total number of bytes sent per second by the network adapter | counter | adapter |
windows_hyperv_virtual_network_adapter_incoming_dropped_packets_total |
Represents the total number of dropped packets per second in the incoming direction of the network adapter | counter | adapter |
windows_hyperv_virtual_network_adapter_outgoing_dropped_packets_total |
Represents the total number of dropped packets per second in the outgoing direction of the network adapter | counter | adapter |
windows_hyperv_virtual_network_adapter_received_packets_total |
Represents the total number of packets received per second by the network adapter | counter | adapter |
windows_hyperv_virtual_network_adapter_sent_packets_total |
Represents the total number of packets sent per second by the network adapter | counter | adapter |
| Name | Description | Type | Labels |
|---|---|---|---|
windows_hyperv_virtual_network_adapter_drop_reasons |
Hyper-V Virtual Network Adapter Drop Reasons | counter | adapter,direction,reason |
| Name | Description | Type | Labels |
|---|---|---|---|
windows_hyperv_virtual_smb_direct_mapped_sections |
Represents the number of direct-mapped sections in the virtual SMB` | gauge | instance |
windows_hyperv_virtual_smb_direct_mapped_pages |
Represents the number of direct-mapped pages in the virtual SMB` | gauge | instance |
windows_hyperv_virtual_smb_write_bytes_rdma |
Represents the number of bytes written per second using RDMA in the virtual SMB` | counter | instance |
windows_hyperv_virtual_smb_write_bytes |
Represents the number of bytes written per second in the virtual SMB` | counter | instance |
windows_hyperv_virtual_smb_read_bytes_rdma |
Represents the number of bytes read per second using RDMA in the virtual SMB` | counter | instance |
windows_hyperv_virtual_smb_read_bytes |
Represents the number of bytes read per second in the virtual SMB` | counter | instance |
windows_hyperv_virtual_smb_flush_requests |
Represents the number of flush requests per second in the virtual SMB` | counter | instance |
windows_hyperv_virtual_smb_write_requests_rdma |
Represents the number of write requests per second using RDMA in the virtual SMB` | counter | instance |
windows_hyperv_virtual_smb_write_requests |
Represents the number of write requests per second in the virtual SMB` | counter | instance |
windows_hyperv_virtual_smb_read_requests_rdma |
Represents the number of read requests per second using RDMA in the virtual SMB` | counter | instance |
windows_hyperv_virtual_smb_read_requests |
Represents the number of read requests per second in the virtual SMB` | counter | instance |
windows_hyperv_virtual_smb_current_pending_requests |
Represents the current number of pending requests in the virtual SMB` | gauge | instance |
windows_hyperv_virtual_smb_current_open_file_count |
Represents the current number of open files in the virtual SMB` | gauge | instance |
windows_hyperv_virtual_smb_tree_connect_count |
Represents the number of tree connects in the virtual SMB` | gauge | instance |
windows_hyperv_virtual_smb_requests |
Represents the number of requests per second in the virtual SMB` | counter | instance |
windows_hyperv_virtual_smb_sent_bytes |
Represents the number of bytes sent per second in the virtual SMB` | counter | instance |
windows_hyperv_virtual_smb_received_bytes |
Represents the number of bytes received per second in the virtual SMB` | counter | instance |
| Name | Description | Type | Labels |
|---|---|---|---|
windows_hyperv_vswitch_broadcast_packets_received_total |
Represents the total number of broadcast packets received per second by the virtual switch | counter | vswitch |
windows_hyperv_vswitch_broadcast_packets_sent_total |
Represents the total number of broadcast packets sent per second by the virtual switch | counter | vswitch |
windows_hyperv_vswitch_bytes_total |
Represents the total number of bytes per second traversing the virtual switch | counter | vswitch |
windows_hyperv_vswitch_bytes_received_total |
Represents the total number of bytes received per second by the virtual switch | counter | vswitch |
windows_hyperv_vswitch_bytes_sent_total |
Represents the total number of bytes sent per second by the virtual switch | counter | vswitch |
windows_hyperv_vswitch_directed_packets_received_total |
Represents the total number of directed packets received per second by the virtual switch | counter | vswitch |
windows_hyperv_vswitch_directed_packets_send_total |
Represents the total number of directed packets sent per second by the virtual switch | counter | vswitch |
windows_hyperv_vswitch_dropped_packets_incoming_total |
Represents the total number of packet dropped per second by the virtual switch in the incoming direction | counter | vswitch |
windows_hyperv_vswitch_dropped_packets_outcoming_total |
Represents the total number of packet dropped per second by the virtual switch in the outgoing direction | counter | vswitch |
windows_hyperv_vswitch_extensions_dropped_packets_incoming_total |
Represents the total number of packet dropped per second by the virtual switch extensions in the incoming direction | counter | vswitch |
windows_hyperv_vswitch_extensions_dropped_packets_outcoming_total |
Represents the total number of packet dropped per second by the virtual switch extensions in the outgoing direction | counter | vswitch |
windows_hyperv_vswitch_learned_mac_addresses_total |
Represents the total number of learned MAC addresses of the virtual switch | counter | vswitch |
windows_hyperv_vswitch_multicast_packets_received_total |
Represents the total number of multicast packets received per second by the virtual switch | counter | vswitch |
windows_hyperv_vswitch_multicast_packets_sent_total |
Represents the total number of multicast packets sent per second by the virtual switch | counter | vswitch |
windows_hyperv_vswitch_number_of_send_channel_moves_total |
Represents the total number of send channel moves per second on this virtual switch | counter | vswitch |
windows_hyperv_vswitch_number_of_vmq_moves_total |
Represents the total number of VMQ moves per second on this virtual switch | counter | vswitch |
windows_hyperv_vswitch_packets_flooded_total |
Represents the total number of packets flooded by the virtual switch | counter | vswitch |
windows_hyperv_vswitch_packets_total |
Represents the total number of packets per second traversing the virtual switch | counter | vswitch |
windows_hyperv_vswitch_packets_received_total |
Represents the total number of packets received per second by the virtual switch | counter | vswitch |
windows_hyperv_vswitch_packets_sent_total |
Represents the total number of packets send per second by the virtual switch | counter | vswitch |
windows_hyperv_vswitch_purged_mac_addresses_total |
Represents the total number of purged MAC addresses of the virtual switch | counter | vswitch |
| Name | Description | Type | Labels |
|---|---|---|---|
windows_hyperv_virtual_storage_device_error_count_total |
Represents the total number of errors that have occurred on this virtual device. | counter | device |
windows_hyperv_virtual_storage_device_queue_length |
Represents the average queue length on this virtual device. | gauge | device |
windows_hyperv_virtual_storage_device_bytes_read |
Represents the total number of bytes that have been read on this virtual device. | counter | device |
windows_hyperv_virtual_storage_device_operations_read_total |
Represents the total number of read operations that have occurred on this virtual device. | counter | device |
windows_hyperv_virtual_storage_device_bytes_written |
Represents the total number of bytes that have been written on this virtual device. | counter | device |
windows_hyperv_virtual_storage_device_operations_written_total |
Represents the total number of write operations that have occurred on this virtual device. | counter | device |
windows_hyperv_virtual_storage_device_latency_seconds |
Represents the average IO transfer latency for this virtual device. | gauge | device |
windows_hyperv_virtual_storage_device_throughput |
Represents the average number of 8KB IO transfers completed by this virtual device. | gauge | device |
windows_hyperv_virtual_storage_device_normalized_throughput |
Represents the average number of IO transfers completed by this virtual device. | gauge | device |
windows_hyperv_virtual_storage_device_lower_queue_length |
Represents the average queue length on the underlying storage subsystem for this device. | gauge | device |
windows_hyperv_virtual_storage_device_lower_latency_seconds |
Represents the average IO transfer latency on the underlying storage subsystem for this virtual device. | gauge | device |
windows_hyperv_virtual_storage_device_io_quota_replenishment_rate |
Represents the IO quota replenishment rate for this virtual device. | gauge | device |
| Name | Description | Type | Labels |
|---|---|---|---|
windows_hyperv_vid_physical_pages_allocated |
The number of physical pages allocated | gauge | vm |
windows_hyperv_vid_preferred_numa_node_index |
The preferred NUMA node index associated with this partition | gauge | vm |
windows_hyperv_vid_remote_physical_pages |
The number of physical pages not allocated from the preferred NUMA node | gauge | vm |
| Name | Description | Type | Labels |
|---|---|---|---|
windows_hyperv_virtual_machine_health_total_count |
Represents the number of virtual machines with health | gauge | None |
This collector does not yet have explained examples, we would appreciate your help adding them!
Percent of physical CPU resources used per VM (on instance "localhost")
(sum (rate(windows_hyperv_hypervisor_virtual_processor_time_total{state="hypervisor",instance="localhost"}[1m]))) / ignoring(state,vm) group_left max (windows_cpu_logical_processor{instance="localhost"}) / 100000
Percent of physical CPU resources used by all VMs (on all monitored hosts)
(sum by (instance)(rate(windows_hyperv_hypervisor_virtual_processor_total_run_time_total{}[1m]))) / max by (instance)(windows_cpu_logical_processor{}) / 100000
Percent of physical CPU resources by the hosts themselves (on all monitored hosts)
(sum by (instance)(rate(windows_hyperv_hypervisor_root_virtual_processor_total_run_time_total{state="total"}[1m]))) / sum by (instance)(windows_cpu_logical_processor{}) / 100000
Percent of physical CPU resources by the hypervisor (on all monitored hosts)
(sum by (instance)(rate(windows_hyperv_hypervisor_logical_processor_total_run_time_total{}[1m]))) / sum by (instance)(windows_cpu_logical_processor{}) / 100000
This collector does not yet have alerting examples, we would appreciate your help adding them!