Join us at the Dash conference! July 16-17, NYC

HyperV

Agent Check Agent Check

Supported OS: Windows

Overview

This check monitors Hyper-V through the Datadog Agent.

Setup

Installation

The Hyper-V check is included in the Datadog Agent package. No additional installation is needed on your server.

Configuration

  1. Edit the hyperv.d/conf.yaml file, in the conf.d/ folder at the root of your Agent’s configuration directory to collect your Hyper-V performance data. See the sample hyperv.d/conf.yaml for all available configuration options.

  2. Restart the Agent.

Validation

Run the Agent’s status subcommand and look for hyperv under the Checks section.

Data Collected

Metrics

hyperv.dynamic_memory_balancer.available_memory
(gauge)
The amount of memory left on the node.
shown as byte
hyperv.dynamic_memory_balancer.average_pressure
(gauge)
This counter represents the average pressure in the VM.
shown as percent
hyperv.hypervisor_logical_processor.guest_run_time
(gauge)
The percentage of time spent by the processor in guest code.
shown as percent
hyperv.hypervisor_logical_processor.hypervisor_run_time
(gauge)
The percentage of time spent by the processor in hypervisor code.
shown as percent
hyperv.hypervisor_logical_processor.idle_time
(gauge)
The percentage of time spent by the processor in an idle state.
shown as percent
hyperv.hypervisor_logical_processor.total_run_time
(gauge)
The percentage of time spent by the processor in guest and hypervisor code.
shown as percent
hyperv.hypervisor_logical_processor.context_switches_per_sec
(gauge)
The combined rate at which all processors on the computer are switched from one thread to another.
shown as operation
hyperv.hypervisor_root_virtual_processor.guest_run_time
(gauge)
The percentage of time spent by the virtual processor in guest code.
shown as percent
hyperv.hypervisor_root_virtual_processor.hypervisor_run_time
(gauge)
The percentage of time spent by the virtual processor in hypervisor code.
shown as percent
hyperv.hypervisor_root_virtual_processor.total_run_time
(gauge)
The percentage of time spent by the virtual processor in guest and hypervisor code.
shown as percent
hyperv.hypervisor_virtual_processor.guest_run_time
(gauge)
The percentage of time spent by the virtual processor in guest code.
shown as percent
hyperv.hypervisor_virtual_processor.hypervisor_run_time
(gauge)
The percentage of time spent by the virtual processor in hypervisor code.
shown as percent
hyperv.hypervisor_virtual_processor.total_run_time
(gauge)
The percentage of time spent by the virtual processor in guest and hypervisor code.
shown as percent
hyperv.virtual_network_adapter.bytes_per_sec
(gauge)
The rate at which bytes are sent and received over each network adapter.
shown as byte
hyperv.vm_vid_partition.physical_pages_allocated
(gauge)
The number of physical pages allocated.
shown as block
hyperv.vm_vid_partition.remote_physical_pages
(gauge)
The number of physical pages not allocated from the preferred NUMA node.
shown as block

Service Checks

Hyper-V does not include any service checks.

Events

Hyper-V does not include any events.

Troubleshooting

Need help? Contact Datadog support.

Further Reading

Additional helpful documentation, links, and articles:


Mistake in the docs? Feel free to contribute!