Monitoring Agent for Microsoft Hyper-V Server Fix Pack 12. Reference IBM

Monitoring Agent for Microsoft Hyper-V Server 6.3.1 Fix Pack 12 Reference IBM

Monitoring Agent for Microsoft Hyper-V Server 6.3.1 Fix Pack 12 Reference IBM

Note Before using this information and the product it supports, read the information in Notices on page 131. This edition applies to version 6.3.1.12 of the Monitoring Agent for Microsoft Hyper-V Server and to all subsequent releases and modifications until otherwise indicated in new editions. Copyright IBM Corporation 2008, 2017. US Government Users Restricted Rights Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.

Contents Chapter 1. Monitoring Agent for Microsoft Hyper-V Server....... 1 Chapter 2. Dashboards........ 3 Default dashboards............ 3 Group widgets for the Default dashboards.... 4 Custom views.............. 9 Chapter 3. Thresholds........ 11 Predefined thresholds........... 11 Customized thresholds.......... 17 Chapter 4. Attributes......... 19 Data sets for the monitoring agent....... 20 Attribute descriptions........... 23 Availability data set.......... 23 Director data set............ 26 Disk data set............. 27 Enterprise Hyper-V Summary data set.... 29 Event Log data set........... 30 Hyper V Dynamic Memory Balancer data set.. 31 Hyper V Dynamic Memory VM data set.... 32 Hyper V Replica VM data set....... 34 Hyper V Replication Statistics data set.... 35 Hyper V Server Disk data set....... 37 Hyper V Server Network Interface data set... 38 Hyper-V Hypervisor Logical Processor data set 40 Hyper-V Hypervisor Partition data set.... 43 Hyper-V Hypervisor Root Partition data set.. 44 Hyper-V Hypervisor Root Virtual Processor data set................ 45 Hyper-V Hypervisor Root Virtual Processor More data set............... 48 Hyper-V Hypervisor Virtual Processor data set 57 Hyper-V Hypervisor Virtual Processor More data set................ 60 Hyper-V Legacy Network Adapter data set... 68 Hyper-V Summary data set........ 70 Hyper-V Task Manager Detail data set.... 71 Hyper-V Task Manager Recent Time data set.. 78 Hyper-V Virtual IDE Controller data set.... 86 Hyper-V Virtual IDE Controller Filter data set.. 87 Hyper-V Virtual IDE Controller Win2K12 data set 88 Hyper-V Virtual Machine Bus data set.... 89 Hyper-V Virtual Machine Health Summary data set................ 90 Hyper-V Virtual Machine Summary data set.. 90 Hyper-V Virtual Network Adapter data set... 92 Hyper-V Virtual Storage Device data set.... 94 Hyper-V Virtual Switch data set...... 95 Hyper-V Virtual Switch Port data set..... 97 Hyper-V VM Association with Virtual Network data set............... 99 Hyper-V VM IO APIC data set...... 100 Hyper-V VM Vid Partition data set..... 101 Hypervisor data set.......... 101 Memory data set........... 103 Memory in Percentage data set...... 104 Migration data set........... 105 Performance Object Status data set..... 105 Processor data set........... 108 Resource Metering data set........ 110 Thread Pool Status data set........ 111 Virtual Machine data set......... 113 Virtual Machine Details data set...... 116 Virtual Switch data set......... 122 VLAN Endpoint data set........ 123 VM Mig WO Cluster data set....... 124 VM Modification data set........ 125 VM Operating System data set...... 127 VM Storage Migration data set...... 127 Accessibility features........ 129 Notices.............. 131 Trademarks.............. 133 Terms and conditions for product documentation 133 IBM Online Privacy Statement........ 134 Index............... 135 Copyright IBM Corp. 2008, 2017 iii

iv Microsoft Hyper-V Server agent Reference

Chapter 1. Monitoring Agent for Microsoft Hyper-V Server The Monitoring Agent for Microsoft Hyper-V Server offers a central point of management for your Microsoft Hyper-V Server environment or application. The software provides a comprehensive means for gathering the information that is required to detect problems early and to prevent them. Information is standardized across the system. You can monitor multiple servers from a single console. By using the Microsoft Hyper-V Server agent you can easily collect and analyze Microsoft Hyper-V Server specific information. Installing and configuring the agent Install the monitoring agent on the system where the application that you want to monitor is located. For more information, see the following documentation in IBM Knowledge Center: v IBM Cloud Application Performance Management v IBM Cloud Application Performance Management, Private Copyright IBM Corp. 2008, 2017 1

2 Microsoft Hyper-V Server agent Reference

Chapter 2. Dashboards Open the Application Performance Dashboard in the Cloud APM console to see a status summary of all your applications. As you drill down to dashboards for specific applications and their supporting elements, more details are available about the selected item. Use the Microsoft Hyper-V Server agent dashboards to proactively monitor your Microsoft Hyper-V Server deployment. Each dashboard page contains views with key performance indicators. When an application that includes Microsoft Hyper-V Server managed resources (also referred to as managed systems) is selected, the navigator and the Status Overview tab show Microsoft Hyper-V Server in the Components group: v Click Components to see a single Microsoft Hyper-V Server group widget that is displayed along with a group widget for every other data source type in the application. v Click the Microsoft Hyper-V Server subgroup to see a group widget for each managed resource in the application. v Click inside a Microsoft Hyper-V Server group widget or click a Microsoft Hyper-V Server managed resource from the navigator Instances section to open a dashboard with KPIs from the selected managed resource. For more information about the KPIs, click in the view or click in the dashboard banner. Default dashboards Microsoft Hyper-V Server The Components page provides an overall status of the Hyper-V Server instance that is being monitored. Click anywhere in the group widget to get detailed information about the status and performance of Hyper-V Server instance. If the Events tab shows a warning or critical status indicator, open the tab to see the open events and status for the application. Microsoft Hyper-V Server Dashboard Use the MS Hyper- V Server dashboard page to know the following details: v v v v Historical data related to the server health and server memory usage. Historical data related to the server disk usage. Click the Used(%) column of any particular device to view the historical data related to the server disk usage of that device. Health state, Heart Beat, Enabled State, Processor Load, and VHD file path of all the virtual machines that are hosted on the Hyper-V Server. Click the virtual machine name in the Virtual Machines group widget to get detailed information about that particular virtual machine. Status of the Hyper-V Virtual Machine Management service. If the Events tab shows a warning or critical status indicator, open the tab to see the open events and status for the application. Virtual Machine Use the Virtual Machine page to know the following details: v v v v v The details of the virtual machine that is being monitored. The top 5 disks of the virtual machine for which the usage is high. The top 5 processes running on the virtual machine for which the CPU usage is high. The top 5 processes running on the virtual machine for which the memory usage is high. Historical data related to the CPU and memory usage. Copyright IBM Corp. 2008, 2017 3

Virtual Machine Use the Virtual Machine page to know the following details: v v v v v The details of the virtual machine that is being monitored. The top 5 disks of the virtual machine for which the usage is high. The top 5 processes running on the virtual machine for which the CPU usage is high. The top 5 processes running on the virtual machine for which the memory usage is high. Historical data related to the CPU and memory usage. Additional group widgets These pop-up group widgets are displayed after you click a group widget for more details. Some group widgets have links to more granular information in a popup widget, described here. Group widgets for the Default dashboards Microsoft Hyper-V Server The Components page provides an overall status of the Hyper-V Server instance that is being monitored. Click anywhere in the group widget to get detailed information about the status and performance of Hyper-V Server instance. If the Events tab shows a warning or critical status indicator, open the tab to see the open events and status for the application. The following group widgets are available in this dashboard: MS Hyper-V Server The MS Hyper-V Server group widget provides an HTML table that summarizes the overall health of the Hyper-V Server. The following KPIs for the group widget are derived from the attributes as described: v Disk status and count (Critical): Indicates the number of disks that are in the critical state. v Disk status and count (Normal): Indicates the number of disks that are in the normal state. v Disk status and count (Warning): Indicates the number of disks that are in the warning state. v Memory used (%): The percentage of memory that is utilized by the Hyper-V system. This data is derived from the MemoryUtilized attribute in the KHV HYPER V SUMMARY data set. v Processor used (%): The percentage of the processor that is utilized by the Hyper-V system. This data is derived from the SystemCPUUtilization attribute in the KHV HYPER V SUMMARY data set. v VM management service: The status of the application component. For processes 'UP', 'DOWN', 'WARNING', or 'PROCESS_DATA_NOT_AVAILABLE': 'PROCESS_DATA_NOT_AVAILABLE' is displayed for a process when the matching process is running but the resource use information cannot be collected for that process. For services 'UP', 'DOWN', or 'UNKNOWN': 'UNKNOWN' is displayed when the service is not installed. For functionality tests: 'PASSED' or 'FAILED' is displayed.. This data is derived from the Status attribute in the KHV AVAILABILITY data set. v VM status and count (Critical): Indicates the number of virtual machines that are in the critical state. v VM status and count (Normal): Indicates the number of virtual machines that are in the normal state. 4 Microsoft Hyper-V Server agent Reference

v VMs with high load: Indicates the number of virtual machines for which the virtual processor load is high. Microsoft Hyper-V Server Dashboard Use the MS Hyper- V Server dashboard page to know the following details: v v v v Historical data related to the server health and server memory usage. Historical data related to the server disk usage. Click the Used(%) column of any particular device to view the historical data related to the server disk usage of that device. Health state, Heart Beat, Enabled State, Processor Load, and VHD file path of all the virtual machines that are hosted on the Hyper-V Server. Click the virtual machine name in the Virtual Machines group widget to get detailed information about that particular virtual machine. Status of the Hyper-V Virtual Machine Management service. If the Events tab shows a warning or critical status indicator, open the tab to see the open events and status for the application. The following group widgets are available in this dashboard: Hyper-V Virtual Machine Management Service The Hyper-V Virtual Machine Management Service group widget provides an HTML table that summarizes the details of the Virtual Machine Management service. The following KPIs for the group widget are derived from the attributes as described: v Service name: The name of the process, service, or functionality test. This name matches the executable name of the process, the service short name or the name of the process used to test the application. This data is derived from the Name attribute in the KHV AVAILABILITY data set. v Status: The status of the application component. For processes 'UP', 'DOWN', 'WARNING', or 'PROCESS_DATA_NOT_AVAILABLE': 'PROCESS_DATA_NOT_AVAILABLE' is displayed for a process when the matching process is running but the resource use information cannot be collected for that process. For services 'UP', 'DOWN', or 'UNKNOWN': 'UNKNOWN' is displayed when the service is not installed. For functionality tests: 'PASSED' or 'FAILED' is displayed.. This data is derived from the Status attribute in the KHV AVAILABILITY data set. v Thread count: The number of threads currently allocated by this process. This attribute contains only valid data for processes. This data is derived from the Thread Count attribute in the KHV AVAILABILITY data set. v Working set (MB): The working set size of the process in MB. This attribute contains only valid data for processes. This data is derived from the Working Set Size attribute in the KHV AVAILABILITY data set. Server Disk Details The Server Disk Details group widget provides a grid widget that shows the usage details of all the disks of the server. Click the Used (%) column of any particular device to view the historical data related to the server disk usage of that device. The following KPIs for the group widget are derived from the attributes as described: v Device ID: The unique identifier of the logical disk. This data is derived from the Device ID attribute in the KHV HYPER V SERVER DISK data set. v File System: The file system on the logical disk. This data is derived from the File System attribute in the KHV HYPER V SERVER DISK data set. v Total Space (GB): The total size of the logical disk drive, in GB. This data is derived from the Total Size attribute in the KHV HYPER V SERVER DISK data set. Chapter 2. Dashboards 5

v Used (%): The percentage of space that is used on the server. v Used Space (GB): The total amount of used space in GB on the logical disk. This data is derived from the Used Space attribute in the KHV HYPER V SERVER DISK data set. Server Health The Server Health group widget provides a line chart that shows the percentage of server memory and processor usage during a specified period. The following KPIs for the group widget are derived from the attributes as described: v Server memory used: The percentage of memory that is utilized by the Hyper-V system. This data is derived from the MemoryUtilized attribute in the KHV HYPER V SUMMARY data set. v Server processor used: The percentage of the processor that is utilized by the Hyper-V system. This data is derived from the SystemCPUUtilization attribute in the KHV HYPER V SUMMARY data set. v Time: The local time at the agent when the data was collected. This data is derived from the Timestamp attribute in the KHV HYPER V SUMMARY data set. Virtual Machines The Virtual Machines group widget provides a grid widget that gives details, such as Health State, Heart Beat, Enabled State, Processor Load, and VHD file path of all the virtual machines that are hosted on the Hyper-V Server. Click the name of the virtual machine to view the Virtual Machine Details page. The following KPIs for the group widget are derived from the attributes as described: v Enabled State: The enabled and disabled states of an element. This data is derived from the EnabledState attribute in the KHV VIRTUAL MACHINE DETAILS data set. v Health State: The current health of the element. This data is derived from the HealthState attribute in the KHV VIRTUAL MACHINE DETAILS data set. v Heart Beat: The current heartbeat status for the virtual machine. This data is derived from the HeartBeat attribute in the KHV VIRTUAL MACHINE DETAILS data set. v Processor Load (%): The average processor load of the virtual machine. This data is derived from the AvgProcessorLoad attribute in the KHV PROCESSOR data set. v VHD file path: The path of the hard disk drive of the virtual machine.the interval for refreshing the attribute is 10 minutes. This data is derived from the VHDFilePath attribute in the KHV VIRTUAL MACHINE DETAILS data set. v Virtual Machine Name: The name of the virtual machine. This data is derived from the ElementName attribute in the KHV VIRTUAL MACHINE DETAILS data set. Virtual Machine Use the Virtual Machine page to know the following details: v v v v v The details of the virtual machine that is being monitored. The top 5 disks of the virtual machine for which the usage is high. The top 5 processes running on the virtual machine for which the CPU usage is high. The top 5 processes running on the virtual machine for which the memory usage is high. Historical data related to the CPU and memory usage. The following group widgets are available in this dashboard: CPU The CPU group widget provides a bar chart and a line chart. The bar chart shows the top 5 processes that are running on the virtual machine for which the CPU usage is high. The line chart shows the percentage of CPU usage during a specified period. The following KPIs for the group widget are derived from the attributes as described: v CPU used (%): The percentage of time the CPU was busy. v Process: The command line string of the process. 6 Microsoft Hyper-V Server agent Reference

v Process CPU percentage: The percentage of CPU used by this process in the last sampling interval normalized to account for multiple online processors.note that the attribute value is averaged in synchronization with the situation or historical collection interval. v Time: The local time at the agent when the data was collected. This data is derived from the Timestamp attribute in the CPU data set. Disk Utilization (%) - Top 5 The Disk group widget provides a bar chart that shows the top 5 disks of the virtual machine for which the usage is high. The following KPIs for the group widget are derived from the attributes as described: v Disk: The top 5 disks of the virtual machine for which the usage is high. v Used Percent: The amount of used space on a disk, expressed as a percentage. Memory The Memory group widget provides a bar chart and a line chart. The bar chart shows the top 5 processes that are running on the virtual machine for which the memory usage is high. The line chart shows the percentage of memory usage during a specified period. The following KPIs for the group widget are derived from the attributes as described: v Memory used (%): The amount of real memory used, expressed as a percentage. v Memory Utilization (MB): The size (in kilobytes) of the resident set size. v Net Memory used (%): The total physical memory used without considering the buffer memory and cached memory. The net memory used is expressed as a percentage. v Process: A concatenation of the process instance name and a unique ID Process number. Note that the ID Process numbers are reused, so they only identify a process for the lifetime of that process. v Time: The local time at the agent when the data was collected. Virtual Machine Details The Virtual Machine Details group widget provides an HTML table that summarizes the details of the virtual machine that is hosted on the Hyper-V Server. The following KPIs for the group widget are derived from the attributes as described: v Idle time (%): The percentage of the physical processor idle time. This data is derived from the PercentIdleTime attribute in the KHV VIRTUAL MACHINE DETAILS data set. v Memory allocated (MB): The physical memory in MB that is allocated to the virtual machine. This data is derived from the MemoryUsage attribute in the KHV VIRTUAL MACHINE DETAILS data set. v Operating System: The operating system that is running on the virtual machine. This data is derived from the VM Operating System attribute in the KHV VIRTUAL MACHINE DETAILS data set. v Up time: The amount of time since the virtual machine was last started.the format is DDHHMM, where DD indicates the number of days, HH indicates the number of hours, and MM indicates the number of minutes. This data is derived from the UpTimeDay attribute in the KHV VIRTUAL MACHINE DETAILS data set. v VHD file size (GB): The capacity (in GB) of the current hard disk drive.this attribute is superseded by the VHD FileSize V2 attribute.a negative value indicates that the VHD file does not exist or the VHD file path is not collected or the file path is too long.the interval for refreshing the attribute is 10 minutes. This data is derived from the VHDFileSize attribute in the KHV VIRTUAL MACHINE DETAILS data set. Virtual Machine Use the Virtual Machine page to know the following details: Chapter 2. Dashboards 7

v v v v v The details of the virtual machine that is being monitored. The top 5 disks of the virtual machine for which the usage is high. The top 5 processes running on the virtual machine for which the CPU usage is high. The top 5 processes running on the virtual machine for which the memory usage is high. Historical data related to the CPU and memory usage. The following group widgets are available in this dashboard: CPU The CPU group widget provides a bar chart and a line chart. The bar chart shows the top 5 processes that are running on the virtual machine for which the CPU usage is high. The line chart shows the percentage of CPU usage during a specified period. The following KPIs for the group widget are derived from the attributes as described: v Command: A concatenation of the process instance name and a unique ID Process number. Note that the ID Process numbers are reused, so they only identify a process for the lifetime of that process. v CPU Used (%): The percentage of processor use, as an average across all processors in the system. Note that the attribute value is averaged in synch with the threshold or historical collection interval. v CPU used (%): The sum of the percentages of elapsed time that a processor has been busy executing instructions in non-idle privileged mode and executing non-idle threads, and executing instructions in non-idle user mode. v Time: The date and time the agent collects information as set on the monitored system. Disk Utilization(%) - Top 5 The Disk group widget provides a bar chart that shows the top 5 disks of the virtual machine for which the usage is high. The following KPIs for the group widget are derived from the attributes as described: v Disk: The top 5 disks of the virtual machine for which the usage is high. v Used Percent: The percentage of disk volume that is used. Memory The Memory group widget provides a bar chart and a line chart. The bar chart shows the top 5 processes that are running on the virtual machine for which the memory usage is high. The line chart shows the percentage of memory usage during a specified period. The following KPIs for the group widget are derived from the attributes as described: v Command: A concatenation of the process instance name and a unique ID Process number. Note that the ID Process numbers are reused, so they only identify a process for the lifetime of that process. v Memory used (%): The percent of bytes of real memory used. v Memory Utilization (MB): The number of bytes of virtual address space that a process uses. v Time: The date and time the agent collects information as set on the monitored system. Virtual Machine Details The Virtual Machine Details group widget provides an HTML table that summarizes the details of the virtual machine that is hosted on the Hyper-V Server. The following KPIs for the group widget are derived from the attributes as described: v Idle time (%): The percentage of the physical processor idle time. This data is derived from the PercentIdleTime attribute in the KHV VIRTUAL MACHINE DETAILS data set. 8 Microsoft Hyper-V Server agent Reference

v Memory allocated (MB): The physical memory in MB that is allocated to the virtual machine. This data is derived from the MemoryUsage attribute in the KHV VIRTUAL MACHINE DETAILS data set. v Operating System: The operating system that is running on the virtual machine. This data is derived from the VM Operating System attribute in the KHV VIRTUAL MACHINE DETAILS data set. v Up time: The amount of time since the virtual machine was last started.the format is DDHHMM, where DD indicates the number of days, HH indicates the number of hours, and MM indicates the number of minutes. This data is derived from the UpTimeDay attribute in the KHV VIRTUAL MACHINE DETAILS data set. v VHD file size (GB): The capacity (in GB) of the current hard disk drive.this attribute is superseded by the VHD FileSize V2 attribute.a negative value indicates that the VHD file does not exist or the VHD file path is not collected or the file path is too long.the interval for refreshing the attribute is 10 minutes. This data is derived from the VHDFileSize attribute in the KHV VIRTUAL MACHINE DETAILS data set. Additional group widgets These pop-up group widgets are displayed after you click a group widget for more details. Some group widgets have links to more granular information in a popup widget, described here. The following group widgets are available in this dashboard: Server Disk Percent Used (history) The Server Disk Percent Used (history) pop-up shows a line chart that shows the percentage of server disk usage during a specified period. Custom views The following KPIs for the group widget are derived from the attributes as described: v Percent Used (%): The percentage of disk space that is used on the server. v Timestamp: The local time at the agent when the data was collected. This data is derived from the Timestamp attribute in the KHV HYPER V SERVER DISK data set. After you select an application that includes a Microsoft Hyper-V Server managed resource, select the Custom Views tab to create and display custom dashboard pages with attribute values from the Microsoft Hyper-V Server agent. You can quickly build monitoring pages for an application and save them for viewing by you alone or share with other users. Chapter 2. Dashboards 9

10 Microsoft Hyper-V Server agent Reference

Chapter 3. Thresholds Thresholds test for certain conditions on your managed systems, such as memory usage over 95%, and raise an event when the conditions have been met. The agent comes with predefined thresholds that you can use to monitor your Microsoft Hyper-V Server environment. You can create additional thresholds for the areas of interest. After you click System Configuration > Threshold Manager, select Microsoft Hyper-V Server as the data source type to see all the available thresholds. Predefined thresholds The thresholds are organized by the data set for which they were written. The Microsoft Hyper-V Server agent has the following predefined thresholds: KHV_HV_Disk_Utilization_Crit The percentage of server disk usage is greater than or equal to 80. The default configuration has the following SQL syntax: *IF *VALUE KHV_HYPER_V_SERVER_DISK.Disk_Utilization *GE 80.00 This threshold is evaluated every 4 minutes. The severity of this threshold is Critical. KHV_HV_Disk_Utilization_Warn The percentage of the server disk usage is 70-80. The default configuration has the following SQL syntax: *IF *VALUE KHV_HYPER_V_SERVER_DISK.Disk_Utilization *GE 70.00 *AND *VALUE KHV_HYPER_V_SERVER_DISK.Disk_Utilization *LT 80.00 This threshold is evaluated every 5 minutes 30 seconds. The severity of this threshold is Warning. KHV_HV_LP_ContextSwitches Logical processor context switches are going high. The default configuration has the following SQL syntax: *IF *VALUE KHV_HYPER_V_HYPERVISOR_LOGICAL_PROCESSOR.Context_Switches_Per_Sec *GE 15000 *AND *VALUE KHV_HYPER_V_HYPERVISOR_LOGICAL_PROCESSOR.Name *NE _Total This threshold is evaluated every 10 minutes. The severity of this threshold is Warning. KHV_HV_LP_Utilization_Warn The load on the logical processor of the Hypervisor is 70% or greater. The default configuration has the following SQL syntax: *IF *VALUE KHV_HYPER_V_HYPERVISOR_LOGICAL_PROCESSOR.Pct_Total_Run_Time *GE 70.00 *AND *VALUE KHV_HYPER_V_HYPERVISOR_LOGICAL_PROCESSOR.Name *NE _Total This threshold is evaluated every 4 minutes 30 seconds. Copyright IBM Corp. 2008, 2017 11

The severity of this threshold is Warning. KHV_HV_Memory_Utilization_Crit The percentage of memory usage of the server is greater than 95. The default configuration has the following SQL syntax: *IF *VALUE KHV_HYPER_V_SUMMARY.MemoryUtilized *GE 95 This threshold is evaluated every 4 minutes. The severity of this threshold is Critical. KHV_HV_Memory_Utilization_Warn The percentage of memory usage of the server is 75-95. The default configuration has the following SQL syntax: *IF *VALUE KHV_HYPER_V_SUMMARY.MemoryUtilized *GE 75 *AND *VALUE KHV_HYPER_V_SUMMARY.MemoryUtilized *LT 95 This threshold is evaluated every 5 minutes 30 seconds. The severity of this threshold is Warning. KHV_HV_NWAdapter_FramesDropped The network frames are dropped. The default configuration has the following SQL syntax: *IF *VALUE KHV_HYPER_V_LEGACY_NETWORK_ADAPTER.Frames_Dropped *GT 0.0 This threshold is evaluated every 5 minutes 30 seconds. The severity of this threshold is Warning. KHV_HV_PCPU_Utilization_Crit The percentage of system processor usage is greater than or equal to 90. The default configuration has the following SQL syntax: *IF *VALUE KHV_HYPER_V_SUMMARY.SystemCPUUtilization *GE 90 This threshold is evaluated every 3 minutes 30 seconds. The severity of this threshold is Critical. KHV_HV_PCPU_Utilization_Warn The percentage of system processor usage is 59-90. The default configuration has the following SQL syntax: *IF *VALUE KHV_HYPER_V_SUMMARY.SystemCPUUtilization *GT 59 *AND *VALUE KHV_HYPER_V_SUMMARY.SystemCPUUtilization *LT 90 This threshold is evaluated every 4 minutes 30 seconds. The severity of this threshold is Warning. KHV_HV_PDisk_Latency_Crit The physical disk latency is more than or equal to 25 ms. The default configuration has the following SQL syntax: *IF *VALUE KHV_HYPER_V_SUMMARY.DiskReadLatency *GE 25 *OR *VALUE KHV_HYPER_V_SUMMARY.DiskWriteLatency *GE 25 This threshold is evaluated every 3 minutes. The severity of this threshold is Critical. 12 Microsoft Hyper-V Server agent Reference

KHV_HV_PDisk_Latency_Warn The physical disk latency is 15 ms - 25 ms. The default configuration has the following SQL syntax: *IF *VALUE KHV_HYPER_V_SUMMARY.DiskReadLatency *GT 15 *OR *VALUE KHV_HYPER_V_SUMMARY.DiskReadLatency *LT 25 *OR *VALUE KHV_HYPER_V_SUMMARY.DiskWriteLatency *GT 15 *OR *VALUE KHV_HYPER_V_SUMMARY.DiskWriteLatency *LT 25 This threshold is evaluated every 3 minutes. The severity of this threshold is Warning. KHV_HV_PDisk_Usage_Crit The physical disk utilization is high. The default configuration has the following SQL syntax: *IF *VALUE KHV_EVENT_LOG.Event_ID *EQ 4096 *AND *VALUE KHV_EVENT_LOG.Event_Source *EQ Microsoft-Windows-Hyper-V-Integration-KvpExchange This threshold is evaluated every None. Data is analyzed when it becomes available.. The severity of this threshold is Critical. KHV_HV_PMemory_Available_Crit The available physical memory is less than 6%. The default configuration has the following SQL syntax: *IF *VALUE KHV_HYPER_V_SUMMARY.MemoryAvailable *LE 5 This threshold is evaluated every 4 minutes. The severity of this threshold is Critical. KHV_HV_PMemory_Available_Warn The available physical memory is 5% - 10%. The default configuration has the following SQL syntax: *IF *VALUE KHV_HYPER_V_SUMMARY.MemoryAvailable *LT 10 *AND *VALUE KHV_HYPER_V_SUMMARY.MemoryAvailable *GT 5 This threshold is evaluated every 4 minutes 30 seconds. The severity of this threshold is Warning. KHV_HV_PNW_Utilization_Crit The physical network utilization is more than or equal to 65%. The default configuration has the following SQL syntax: *IF *VALUE KHV_HYPER_V_SUMMARY.NetworkUtilization *GE 65 This threshold is evaluated every 3 minutes. The severity of this threshold is Critical. KHV_HV_PNW_Utilization_Warn The physical network interface utilization is 40% - 65%. The default configuration has the following SQL syntax: *IF *VALUE KHV_HYPER_V_SUMMARY.NetworkUtilization *GT 40 *AND *VALUE KHV_HYPER_V_SUMMARY.NetworkUtilization *LT 65 This threshold is evaluated every 3 minutes. Chapter 3. Thresholds 13

The severity of this threshold is Warning. KHV_HV_RVP_Utilization_Crit The root virtual processor load is more than or equal to 90%. The default configuration has the following SQL syntax: *IF *VALUE KHV_HYPER_V_HYPERVISOR_ROOT_VIRTUAL_PROCESSOR.Pct_Total_Run_Time *GE 90 This threshold is evaluated every 3 minutes 30 seconds. The severity of this threshold is Critical. KHV_HV_RVP_Utilization_Warn The hypervisor root virtual processor load is 59% - 90%. The default configuration has the following SQL syntax: *IF *VALUE KHV_HYPER_V_HYPERVISOR_ROOT_VIRTUAL_PROCESSOR.Pct_Total_Run_Time *GE 60.00 *AND *VALUE KHV_HYPER_V_HYPERVISOR_ROOT_VIRTUAL_PROCESSOR.Pct_Total_Run_Time *LT 90.00 This threshold is evaluated every 4 minutes 30 seconds. The severity of this threshold is Warning. KHV_HV_VM_ProcessorLoad_Crit The load on the virtual machine procesor has exceeded the critical threshold. The default configuration has the following SQL syntax: *IF *VALUE KHV_PROCESSOR.AvgProcessorLoad *GE 90.00 This threshold is evaluated every 3 minutes 30 seconds. The severity of this threshold is Critical. KHV_HV_VM_Status_Crit The status of the virtual machine is critical. The default configuration has the following SQL syntax: *IF *VALUE KHV_VIRTUAL_MACHINE.VMStatusCrit *EQ Critical This threshold is evaluated every 3 minutes 30 seconds. The severity of this threshold is Critical. KHV_HV_VP_Utilization_Crit The virtual machine processor load is more than or equal to 90%. The default configuration has the following SQL syntax: *IF *VALUE KHV_HYPER_V_HYPERVISOR_VIRTUAL_PROCESSOR.Total_Run_Time *GE 90 *AND *VALUE KHV_HYPER_V_HYPERVISOR_VIRTUAL_PROCESSOR.Name *NE _Total This threshold is evaluated every 3 minutes 30 seconds. The severity of this threshold is Critical. KHV_HV_VP_Utilization_Warn The virtual machine processor load is 59% - 90%. The default configuration has the following SQL syntax: *IF *VALUE KHV_HYPER_V_HYPERVISOR_VIRTUAL_PROCESSOR.Total_Run_Time *GE 60.00 *AND *VALUE KHV_HYPER_V_HYPERVISOR_VIRTUAL_PROCESSOR.Total_Run_Time *LT 90.00 *AND *VALUE KHV_HYPER_V_HYPERVISOR_VIRTUAL_PROCESSOR.Name *NE _Total This threshold is evaluated every 4 minutes 30 seconds. The severity of this threshold is Warning. 14 Microsoft Hyper-V Server agent Reference

KHV_HV_VStorageDevice_Warn An error occurred on the virtual storage device. The default configuration has the following SQL syntax: *IF *VALUE KHV_HYPER_V_VIRTUAL_STORAGE_DEVICE.Error_Count *GT 0 This threshold is evaluated every 10 minutes. The severity of this threshold is Warning. KHV_HV_VSwitch_PacketsFlooded The network packets are flooded. The default configuration has the following SQL syntax: *IF *VALUE KHV_HYPER_V_VIRTUAL_SWITCH.Packets_Flooded_Per_Sec *GT 0.0 This threshold is evaluated every 15 minutes. The severity of this threshold is Warning. KHV_Image_Mgmt_Service_Down Hyper-V Image Management Service is down. The default configuration has the following SQL syntax: *IF *VALUE KHV_AVAILABILITY.Name *EQ vhdsvc *AND *VALUE KHV_AVAILABILITY.Status *EQ DOWN This threshold is evaluated every 10 minutes. The severity of this threshold is Critical. KHV_Mem_On_Balancer_Node_Low Available memory on the balancer node is low. The default configuration has the following SQL syntax: *IF *VALUE KHV_MEMORY_IN_PERCENTAGE.PercentageAvailableMemory *LE 10 This threshold is evaluated every 5 minutes. The severity of this threshold is Critical. KHV_Network_Service_Down Hyper-V Networking Management Service is down. The default configuration has the following SQL syntax: *IF *VALUE KHV_AVAILABILITY.Name *EQ nvspwmi *AND *VALUE KHV_AVAILABILITY.Status *EQ DOWN This threshold is evaluated every 10 minutes. The severity of this threshold is Critical. KHV_VM_Disk_HealthState Health of the virtual disks running on virtual machines. The default configuration has the following SQL syntax: *IF *VALUE KHV_DISK.HealthState *EQ Non-Functional This threshold is evaluated every 5 minutes. The severity of this threshold is Critical. KHV_VM_Heartbeat_Crit Hyper-V Virtual Machine heartbeat failed. The default configuration has the following SQL syntax: Chapter 3. Thresholds 15

*IF *VALUE KHV_VIRTUAL_MACHINE.HeartBeat *EQ Error *OR *VALUE KHV_VIRTUAL_MACHINE.HeartBeat *EQ No_Contact *OR *VALUE KHV_VIRTUAL_MACHINE.HeartBeat *EQ Lost_Communication This threshold is evaluated every 3 minutes. The severity of this threshold is Critical. KHV_VM_Memory_HealthState Health of the virtual memory running on the virtual machine. The default configuration has the following SQL syntax: *IF *VALUE KHV_MEMORY.HealthState *EQ Non-Functional This threshold is evaluated every 5 minutes. The severity of this threshold is Critical. KHV_VM_Mgmt_Service_Down The Hyper-V Virtual Machine Management service is down. The default configuration has the following SQL syntax: *IF *VALUE KHV_AVAILABILITY.Name *EQ vmms *AND *VALUE KHV_AVAILABILITY.Status *EQ DOWN This threshold is evaluated every 5 minutes. The severity of this threshold is Critical. KHV_VM_ProcessorLoad_Crit Virtual machine processor load is more than or equal to 90%. The default configuration has the following SQL syntax: *IF *VALUE KHV_PROCESSOR.LoadPercentage *GE 90 This threshold is evaluated every 4 minutes. The severity of this threshold is Critical. KHV_VM_Processor_Warn The virtual machine processor load is between 70% and 90%. The default configuration has the following SQL syntax: *IF *VALUE KHV_PROCESSOR.LoadPercentage *GT 70 *AND *VALUE KHV_PROCESSOR.LoadPercentage *LT 90 This threshold is evaluated every 5 minutes. The severity of this threshold is Warning. KHV_VM_Replication_Health_Crit Replication health of the virtual machine is in critical state. The default configuration has the following SQL syntax: *IF *VALUE KHV_HYPER_V_REPLICATION_STATISTICS.Replication_Health *EQ Critical This threshold is evaluated every 4 minutes. The severity of this threshold is Critical. KHV_VM_Replication_Health_Warn Replication health of the virtual machine is in warning state. The default configuration has the following SQL syntax: *IF *VALUE KHV_HYPER_V_REPLICATION_STATISTICS.Replication_Health *EQ Warning 16 Microsoft Hyper-V Server agent Reference

This threshold is evaluated every 5 minutes 30 seconds. The severity of this threshold is Warning. KHV_VM_Switch_HealthState Health of the virtual switch running on the virtual machine. The default configuration has the following SQL syntax: *IF *VALUE KHV_VIRTUAL_SWITCH.HealthState *EQ Non-Functional This threshold is evaluated every 5 minutes. The severity of this threshold is Critical. Customized thresholds You can use the predefined thresholds as a starting point for event monitoring, and create your own thresholds as conditions arise that you want to monitor. Hover your mouse over a help icon to get user assistance for the field. Click the help tool to open the help system for the Threshold Manager help topic. The Microsoft Hyper-V Server agent has many data sets that you can use to create thresholds to monitor for specific conditions. Tip: If you are an IBM Tivoli Monitoring user, data sets are equivalent to attribute groups. Chapter 3. Thresholds 17

18 Microsoft Hyper-V Server agent Reference

Chapter 4. Attributes Attributes are the application properties that are being measured and reported by the Monitoring Agent for Microsoft Hyper-V Server. Attributes make up the key performance indicators (KPIs) that are reported, and you can use them to create thresholds for conditions that you want to monitor. About attributes Attributes are organized into data sets (also referred to as attribute groups). The values can be selectively displayed in dashboards or used to define a threshold. The most recent data sample of the attributes in the data set are used after you open a dashboard or start a threshold. Dashboards Attributes are displayed in the dashboards. The widgets specify which attribute values to request from a monitored resource. Thresholds You can define thresholds that monitor the state of your operating system, database, or application and open an event when the threshold is exceeded. You use attributes to define thresholds that describe a condition that you want to test. After the threshold is started, the values that are assigned to the attributes in the threshold definition are compared with the values collected by the Microsoft Hyper-V Server agent. After the condition is met, an event is registered and you are alerted by indicator icons in the Application Performance Dashboard navigator and the Events tab. The Microsoft Hyper-V Server agent comes with predefined thresholds that are enabled and started with the agent. If you edit a predefined threshold definition, such as to change a condition or severity, it is no longer treated as a predefined threshold but considered a custom threshold. Some attributes names display differently in the Threshold Editor, as shown in parentheses after the name, such as Object Count (OBJECT_COUNT). When the sampled values for the attributes that are referenced in a threshold meet the condition (such as attribute A is greater than 80%), an event is opened. Note the following conditions: v v v When no data can be collected for a data set, an empty result is returned (no rows of data) When a specific attribute cannot be collected, the value 0 or is returned unless otherwise specified in a particular attribute (for example, N/A ) Any numeric attribute value that is greater than the largest (positive or negative) number that can be represented by that type returns the corresponding maximum or minimum value. For example, the maximum value for a 32-bit number is 2,147,483,647. These values are displayed as text values that are defined by the data set, such as Value Exceeds Maximum or Value Exceeds Minimum. Historical data configurations The Microsoft Hyper-V Server agent collects historical data for key data sets that are shown in the dashboards. A dashboard page that includes historical views from the managed resource instance has a time selector tool for adjusting the time range. With line charts, you can also compare the values with a previous day, up to the number of days that have been saved. Numeric attributes have characteristics that are indicated in parentheses after the data type, such as (32-bit numeric property). A numeric attribute value can be 32-bit or 64-bit or some other size. The value type can be gauge, which means it varies, like a speedometer; counter, which counts and always increases; or numeric property, such as disk size. Copyright IBM Corp. 2008, 2017 19

Additional information about attributes For a list of the data sets, a list of the attributes in each data set, and descriptions of the attributes in the Microsoft Hyper-V Server agent, see Data sets for the monitoring agent and Attribute descriptions on page 23. Data sets for the monitoring agent The Microsoft Hyper-V Server agent contains the following data sets. v Data set name: Availability Table name: KHVAVAIL Historical table name: KHV_AVAILABILITY or KHVAVAIL v Data set name: Director Table name: KHVDIRECTO Historical table name: KHV_DIRECTOR or KHVDIRECTO v Data set name: Disk Table name: KHVGETDIS0 Historical table name: KHV_DISK or KHVGETDIS0 v Data set name: Enterprise Hyper-V Summary Table name: KHVVHYPERV Historical table name: KHV_ENTERPRISE_HYPER_V_SUMMARY or KHVVHYPERV v Data set name: Event Log Table name: KHVEVTLOG Historical table name: KHV_EVENT_LOG or KHVEVTLOG v Data set name: Hyper V Dynamic Memory Balancer Table name: KHVHYVDMMB Historical table name: KHV_HYPER_V_DYNAMIC_MEMORY_BALANCER or KHVHYVDMMB v Data set name: Hyper V Dynamic Memory VM Table name: KHVHYVDMVM Historical table name: KHV_HYPER_V_DYNAMIC_MEMORY_VM or KHVHYVDMVM v Data set name: Hyper V Replica VM Table name: KHVHYPERVR Historical table name: KHV_HYPER_V_REPLICA_VM or KHVHYPERVR v Data set name: Hyper V Replication Statistics Table name: KHVHYPVRST Historical table name: KHV_HYPER_V_REPLICATION_STATISTICS or KHVHYPVRST v Data set name: Hyper V Server Disk Table name: KHVHVSDISK Historical table name: KHV_HYPER_V_SERVER_DISK or KHVHVSDISK v Data set name: Hyper V Server Network Interface Table name: KHVHVSVNWI Historical table name: KHV_HYPER_V_SERVER_NETWORK_INTERFACE or KHVHVSVNWI v Data set name: Hyper-V Hypervisor Logical Processor Table name: KHVHYLPROC Historical table name: KHV_HYPER_V_HYPERVISOR_LOGICAL_PROCESSOR or KHVHYLPROC v Data set name: Hyper-V Hypervisor Partition 20 Microsoft Hyper-V Server agent Reference

Table name: KHVHYPART Historical table name: KHV_HYPER_V_HYPERVISOR_PARTITION or KHVHYPART v Data set name: Hyper-V Hypervisor Root Partition Table name: KHVHYRPART Historical table name: KHV_HYPER_V_HYPERVISOR_ROOT_PARTITION or KHVHYRPART v Data set name: Hyper-V Hypervisor Root Virtual Processor Table name: KHVHYRPROC Historical table name: KHV_HYPER_V_HYPERVISOR_ROOT_VIRTUAL_PROCESSOR or KHVHYRPROC v Data set name: Hyper-V Hypervisor Root Virtual Processor More Table name: KHVHYRPROM Historical table name: KHV_HYPER_V_HYPERVISOR_ROOT_VIRTUAL_PROCESSOR_MORE or KHVHYRPROM v Data set name: Hyper-V Hypervisor Virtual Processor Table name: KHVHYVPROC Historical table name: KHV_HYPER_V_HYPERVISOR_VIRTUAL_PROCESSOR or KHVHYVPROC v Data set name: Hyper-V Hypervisor Virtual Processor More Table name: KHVHYVPROM Historical table name: KHV_HYPER_V_HYPERVISOR_VIRTUAL_PROCESSOR_MORE or KHVHYVPROM v Data set name: Hyper-V Legacy Network Adapter Table name: KHVLEGNWAD Historical table name: KHV_HYPER_V_LEGACY_NETWORK_ADAPTER or KHVLEGNWAD v Data set name: Hyper-V Summary Table name: KHVHYPERV Historical table name: KHV_HYPER_V_SUMMARY or KHVHYPERV v Data set name: Hyper-V Task Manager Detail Table name: KHVTASKMD Historical table name: KHV_HYPER_V_TASK_MANAGER_DETAIL or KHVTASKMD v Data set name: Hyper-V Task Manager Recent Time Table name: KHVTASKMDR Historical table name: KHV_HYPER_V_TASK_MANAGER_RECENT_TIME or KHVTASKMDR v Data set name: Hyper-V Virtual IDE Controller Table name: KHVVIDECON Historical table name: KHV_HYPER_V_VIRTUAL_IDE_CONTROLLER or KHVVIDECON v Data set name: Hyper-V Virtual IDE Controller Filter Table name: KHVVIDECFL Historical table name: KHV_HYPER_V_VIRTUAL_IDE_CONTROLLER_FILTER or KHVVIDECFL v Data set name: Hyper-V Virtual IDE Controller Win2K12 Table name: KHVVIDECTK Historical table name: KHV_HYPER_V_VIRTUAL_IDE_CONTROLLER_WIN2K12 or KHVVIDECTK v Data set name: Hyper-V Virtual Machine Bus Table name: KHVVMBUS Historical table name: KHV_HYPER_V_VIRTUAL_MACHINE_BUS or KHVVMBUS v Data set name: Hyper-V Virtual Machine Health Summary Chapter 4. Attributes 21

Table name: KHVVMHESUM Historical table name: KHV_HYPER_V_VIRTUAL_MACHINE_HEALTH_SUMMARY or KHVVMHESUM v Data set name: Hyper-V Virtual Machine Summary Table name: KHVVMSUMMA Historical table name: KHV_HYPER_V_VIRTUAL_MACHINE_SUMMARY or KHVVMSUMMA v Data set name: Hyper-V Virtual Network Adapter Table name: KHVVIRNWAD Historical table name: KHV_HYPER_V_VIRTUAL_NETWORK_ADAPTER or KHVVIRNWAD v Data set name: Hyper-V Virtual Storage Device Table name: KHVVSTORDV Historical table name: KHV_HYPER_V_VIRTUAL_STORAGE_DEVICE or KHVVSTORDV v Data set name: Hyper-V Virtual Switch Table name: KHVVIRSWIT Historical table name: KHV_HYPER_V_VIRTUAL_SWITCH or KHVVIRSWIT v Data set name: Hyper-V Virtual Switch Port Table name: KHVVIRSWPO Historical table name: KHV_HYPER_V_VIRTUAL_SWITCH_PORT or KHVVIRSWPO v Data set name: Hyper-V VM Association with Virtual Network Table name: KHVVMAVCN Historical table name: KHV_HYPER_V_VM_ASSOCIATION_WITH_VIRTUAL_NETWORK or KHVVMAVCN v Data set name: Hyper-V VM IO APIC Table name: KHVVMIOAPI Historical table name: KHV_HYPER_V_VM_IO_APIC or KHVVMIOAPI v Data set name: Hyper-V VM Vid Partition Table name: KHVHYVIDP Historical table name: KHV_HYPER_V_VM_VID_PARTITION or KHVHYVIDP v Data set name: Hypervisor Table name: KHVHYPERVI Historical table name: KHV_HYPERVISOR or KHVHYPERVI v Data set name: Memory Table name: KHVGETMEM0 Historical table name: KHV_MEMORY or KHVGETMEM0 v Data set name: Memory in Percentage Table name: KHVMEMIPER Historical table name: KHV_MEMORY_IN_PERCENTAGE or KHVMEMIPER v Data set name: Migration Table name: KHVNVVMIGR Historical table name: KHV_MIGRATION or KHVNVVMIGR v Data set name: Performance Object Status Table name: KHVPOBJST Historical table name: KHV_PERFORMANCE_OBJECT_STATUS or KHVPOBJST v Data set name: Processor Table name: KHVGETPRO0 22 Microsoft Hyper-V Server agent Reference

Historical table name: KHV_PROCESSOR or KHVGETPRO0 v Data set name: Resource Metering Table name: KHVVMRESME Historical table name: KHV_RESOURCE_METERING or KHVVMRESME v Data set name: Thread Pool Status Table name: KHVTHPLST Historical table name: KHV_THREAD_POOL_STATUS or KHVTHPLST v Data set name: Virtual Machine Table name: KHVGETVIR0 Historical table name: KHV_VIRTUAL_MACHINE or KHVGETVIR0 v Data set name: Virtual Machine Details Table name: KHVVMOSJOI Historical table name: KHV_VIRTUAL_MACHINE_DETAILS or KHVVMOSJOI v Data set name: Virtual Switch Table name: KHVMSVMVI4 Historical table name: KHV_VIRTUAL_SWITCH or KHVMSVMVI4 v Data set name: VLAN Endpoint Table name: KHVMSVMVI5 Historical table name: KHV_VLAN_ENDPOINT or KHVMSVMVI5 v Data set name: VM Mig WO Cluster Table name: KHVVMMIGWC Historical table name: KHV_VM_MIG_WO_CLUSTER or KHVVMMIGWC v Data set name: VM Modification Table name: KHVVMMODF Historical table name: KHV_VM_MODIFICATION or KHVVMMODF v Data set name: VM Operating System Table name: KHVVMOS Historical table name: KHV_VM_OPERATING_SYSTEM or KHVVMOS v Data set name: VM Storage Migration Table name: KHVVMSTMIG Historical table name: KHV_VM_STORAGE_MIGRATION or KHVVMSTMIG Attribute descriptions Attributes in each Microsoft Hyper-V Server agent data set collect data that the agent uses for monitoring. The descriptions of the data sets contain information such as description, type, and names for each attribute in the data set. Some attributes are designated as key attributes. A key attribute is an identifier attribute for the data set. Availability data set The Availability data set contains the availability data for all processes and services that make up this application. This data set contains the following attributes: Chapter 4. Attributes 23