---
title: HyperV
description: Monitor Microsoft's Hyper-V virtualization technology.
breadcrumbs: Docs > Integrations > HyperV
---

# HyperV
Supported OS Integration version3.3.0
## Overview{% #overview %}

This check monitors [Hyper-V](https://docs.microsoft.com/en-us/windows-server/virtualization/hyper-v/hyper-v-on-windows-server) through the Datadog Agent.

**Minimum Agent version:** 6.9.0

## Setup{% #setup %}

### Installation{% #installation %}

The Hyper-V check is included in the [Datadog Agent](https://app.datadoghq.com/account/settings/agent/latest) package. No additional installation is needed on your server.

### Configuration{% #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](https://github.com/DataDog/integrations-core/blob/master/hyperv/datadog_checks/hyperv/data/conf.yaml.example) for all available configuration options.

1. [Restart the Agent](https://docs.datadoghq.com/agent/guide/agent-commands/#start-stop-and-restart-the-agent).

**Note**: Versions 1.5.0 or later of this check use a new implementation for metric collection, which requires Python 3. For hosts that are unable to use Python 3, or if you would like to use a legacy version of this check, refer to the following [config](https://github.com/DataDog/integrations-core/blob/7.33.x/hyperv/datadog_checks/hyperv/data/conf.yaml.example).

### Validation{% #validation %}

[Run the Agent's status subcommand](https://docs.datadoghq.com/agent/guide/agent-commands/#agent-status-and-information) and look for `hyperv` under the Checks section.

## Data Collected{% #data-collected %}

### Metrics{% #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.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\_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\_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{% #service-checks %}

Hyper-V does not include any service checks.

### Events{% #events %}

Hyper-V does not include any events.

## Troubleshooting{% #troubleshooting %}

Need help? Contact [Datadog support](https://docs.datadoghq.com/help/).

## Further Reading{% #further-reading %}

- [Monitor Microsoft Hyper-V with Datadog](https://www.datadoghq.com/blog/monitor-microsoft-hyperv-with-datadog)