Microsoft Hyper-V, an important part of the enterprise IT infrastructure environment is a hypervisor-based virtualization solution. Integrating Hyper-V to OpsRamp allows you to:

  • View and monitor infrastructure resources managed by Hyper-V hosts.
  • Manage bottlenecks and optimize performance.
  • Improve system performance.
  • Track and observe resources to ensure zero downtime.
  • Eliminate overall system performance degradation and SLAs.

You can use local or domain users while authenticating the target Hyper-V host and get the monitoring updates.

Prerequisite

  • On the gateway resource:
    • Enable WinRM services.
    • Allow WinRM service through the firewall.
    • Enable PowerShell remoting using the command: Enable-PSRemoting -Force.
    • Set PowerShell environment variable on the gateway resource.

If the target device is not in the same domain, add the target device domain to the trusted hosts (The device is discovered in an IP range).

  • On the target resource:
    • Enable WinRM service.
    • Allow WinRM service through the firewall.
    • Enable PowerShell remoting using the command: Enable-PSRemoting -Force.
  • Windows gateway version 9.0 or later.
  • Port(5985) is in Open state.

Monitor Hyper-V

Monitoring Hyper-V hosts involves:

  1. Creating credentials.
  2. Installing and configuring the integration.
  3. Adding a discovery profile.
  4. Viewing the Hyper-V infrastructure details
  5. Assigning a monitoring template.
  6. Viewing resource metrics.

Step 1: Create credentials

To create credentials:

  1. Go to Setup > Accounts > Clients.
  2. Click a Client Name.
  3. From the client Credentials tab, click + Add and enter the following details:
    • Name: Enter a name for the credentials.
    • Description: Enter a brief description of the purpose of the credentials.
    • Type: Select Windows credential type.
    • Domain Name: Enter the domain details according to the credential type.
    • Username and password: Enter credentials to access Hyper-V.
  4. Click Save.
    The Credentials tab displays the credential details.

Step 2: Install and configure an integration

  1. From All Clients, select a client.
  2. Go to Setup > Integrations > Integrations.
  3. From Available Integrations, select Compute > Microsoft Hyper-V.
  4. Click Install.
  5. From Install Microsoft Hyper-V Integrations, enter the following details:
    • Name: Enter a name for the integration.
    • IP Address: Enter the IP address of Hyper-V
    • Credentials: Select the credentials from the list of credentials displayed in the drop-down menu.
  6. Click Save.
Install Microsoft Hyper-V Integrations

Step 3: Add a discovery profile

To add a discovery profile:

  1. From the Discovery Profiles tab, click + Add.
  2. From the Add Discovery Profile window, enter the following Profile Details:
    • Profile Name: Enter a name for the discovery profile.
    • Select Profile: Select a management profile from the list of profiles listed in the drop-down menu.
    • IP Address: Displays the IP address of Hyper-V.
  3. From the Filter Criteria section, filter for resources that you want to discover using one of the following:
    • Smart Filters: To filter resources based on the resource type. Select one of the following:
      • All Resources
      • Hyper-V Host (Default selection and cannot be changed)
      • Virtual Machines
    • Resource Filters: To filter resources based on certain resource attributes.
      • Select matching criteria to match Any or All rules.
      • Filter for resources using the following attributes: resource type, attribute name, logical operator, and value.
        Use regular expressions to filter resources using logical operator Regex.
  4. From the Perform Actions section, select Manage Device to set the resources as managed.
  5. From the Discovery Schedule section, schedule the discovery process using the recurrence pattern.
    To schedule the discovery process:
    1. Select the Discovery Schedule checkbox.
    2. From Recurrence Pattern, select one of the following:
      • Hourly
      • Daily
      • Weekly
      • Monthly
        Set the time intervals depending on the recurrence pattern option selected.
  6. Click Save.
    Discovery triggers based on the scheduled time.
Discovery Profile

Step 4: View the Hyper-V Infrastructure details

Hyper-V is now successfully integrated and is displayed in the Infrastructure > Microsoft Hyper-V category. Click the name to view details. The monitoring is enabled according to the configured metric criteria.

Hyper-V Infrastructure

/home/gvh/devel/0_opsramp/src/stagingHotfix/docs/content/solutions/monitoring/assign-templates.md

Step 5: Assign the monitoring template

To assign monitoring templates to Hyper-V, see Assigning Templates. Monitoring Hyper-V provides the following details:

  • Hypervisor CPU Usage: Tracks if the CPUs are running at full capacity or underutilized.
  • Hyper-V System Services: Monitors the availability and status of critical Hyper-V services such as Hyper-V Image management service, Virtual Machine Management, and Networking management service.
  • Memory Usage: Notifies when the memory usage is high or critically low.
  • Networking and Virtual Network Statistics: Monitors the health and status of the network interfaces, virtual network adapters, legacy virtual network adapters, and virtual switch.
  • Storage and Virtual Storage Metrics: Metrics to track the saturated drives.
  • Hyper-V Performance Monitoring: Monitors the overall performance of Hyper-V servers over some time and analyzes possible trends to ensure high up-time.

For more information on Hyper-V templates, see Hyper-V.

Step 6: View resource metrics

To confirm the monitoring of Hyper-V resource, review the following:

  • The graph is plotted for each metric that is enabled in the configuration.
  • Alerts are generated for metrics that are configured as per defined integration.
Metric Graphs

Supported metrics

The following table shows the supported resource components and corresponding metrics.

Hyper-V Component NameMetric NameDisplay NameUnits
Hyper-V Hosthyperv_system_services_Networking_Management_ServiceHyperv Networking Management Service-
hyperv_system_services_Virtual_System_Management_ServiceHyperv Virtual System Management Service-
hyperv_system_services_Image_Management_ServiceHyperv Image Management Service-
hyperv_memory_usage_Total_Remote_Physical_PagesTotal Remote Physical Pagescount
hyperv_memory_usage_Deposited_PagesDeposited PagesCount
hyperv_memory_usage_Virtual_Memory_In_GBVirtual MemoryGiga Bytes(GB)
hyperv_memory_usage_Virtual_TLB_PagesVirtual TLB PagesCount
hyperv_memory_usage_Available_MBytesAvailable MBytesMega Bytes(MB)
hyperv_memory_usage_Total_Physical_Memory_In_GBTotal Physical MemoryGiga Bytes(GB)
hyperv_memory_usage_Page_File_UsagePage File UsageCount
hyperv_memory_usage_SwapMemoryUsage_In_GBSwap Memory UsageGiga Bytes(GB)
hyperv_cpu_usage_Idle_CPU_UtilizationIdle CPU UtilizationPercentage(%)
hyperv_cpu_usage_Guest_CPU_UtilizationGuest CPU UtilizationPercentage(%)
hyperv_cpu_usage_Hypervisor_CPU_UtilizationHypervisor CPU UtilizationPercentage(%)
hyperv_cpu_usage_Total_CPU_UtilizationTotal CPU UtilizationPercentage(%)
hyperv_network_statistice_Network_Adapters_Packets_Per_Sec-Packets/sec
hyperv_network_statistics_Legacy_Network_Adapters_Bytes_Received_Per_SecLegacy Network Adapters Bytes ReceivedBytes/sec
hyperv_network_statistics_Network_Adapters_Packets_Sent_Per_SecNetwork Adapters Packets SentPackets/sec
hyperv_network_statistics_Network_Adapters_Bytes_Total_Per_SecNetwork Adapters Total BytesBytes/sec
hyperv_network_statistics_Virtual_Switch_Bytes_Sent_Per_SecVirtual Switch Bytes SentBytes/sec
hyperv_network_statistics_Virtual_Switch_Packets_Sent_Per_SecVirtual Switch Packets SentPackets/sec
hyperv_network_statistics_Virtual_Switch_Packets_Received_Per_SecVirtual Switch Packets ReceivedPackets/sec
hyperv_network_statistics_Virtual_Switch_Packets_Per_SecVirtual Switch Total PacketsPackets/sec
hyperv_network_statistics_Virtual_Switch_Bytes_Per_SecVirtual Switch Bytes Per SecBytes/sec
hyperv_network_statistics_Virtual_Switch_Bytes_Received_Per_SecVirtual Switch Bytes ReceivedBytes/sec
hyperv_network_statistics_Legacy_Network_Adapters_Bytes_DroppedLegacy Network Adapters Bytes DroppedBytes/sec
hyperv_network_statistics_Network_Adapter_Packets_Received_Per_Sec-Packets/sec
hyperv_network_statistics_Network_Adapters_Bytes_Sent_Per_SecNetwork Adapters Bytes SentBytes/sec
hyperv_network_statistics_Legacy_Network_Adapters_Bytes_Sent_Per_SecLegacy Network Adapters Bytes SentBytes/sec
hyperv_network_statistics_Legacy_Network_Adapters_Frames_Sent_Per_SecLegacy Network Adapters Frames SentFrames/sec
hyperv_network_statistics_Network_Adapters_Bytes_Received_Per_SecNetwork Adapters Bytes ReceivedBytes/sec
Hyperv_Storage_Diskhyperv_storage_disk_Healthy_StatusStorage Disk Healthy Status-
hyperv_storage_disk_Operational_StatusStorage Disk Operational Status-
hyperv_storage_disk_UtilizationStorage Disk UtilizationPercentage(%)
hyperv_storage_statistics_Physical_Disk_Transfer_Per_SecPhysical Disk TransferTransfer/sec
hyperv_storage_statistics_Logical_Disk_Transfer_Per_SecLogical Disk TransferTransfer/sec
hyperv_storage_statistics_Physical_Disk_Bytes_Per_SecPhysical Disk Bytes Per SecBytes/sec
hyperv_storage_statistics_Logical_Disk_Bytes_Per_SecLogical Disk Bytes Per SecBytes/sec
hyperv_storage_statistics_Physical_Disk_Queue_LengthPhysical Disk Queue Length-
hyperv_storage_statistics_Logical_Disk_Queue_LengthLogical Disk Queue Length-

Constraints

  • The resource type of hyper-v host changes to “server” on the Infrastructure listing page while installing agent on Hyper-V host. As an alternative, use remote monitoring capabilities to monitor the system performance.
  • For discovered virtual machines, you can collect the additional metrics through agent or gateway-based remote monitoring.