IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Hyper-V Server Agent Version Fix Pack 2.

Transcription

1 IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Hyper-V Server Agent Version Fix Pack 2 Reference

2

3 IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Hyper-V Server Agent Version Fix Pack 2 Reference

4 Note Before using this information and the product it supports, read the information in Notices on page 295. This edition applies to version of IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Hyper-V Server Agent (product number 5724-U17) and to all subsequent releases and modifications until otherwise indicated in new editions. Copyright IBM Corporation 2008, US Government Users Restricted Rights Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.

5 Contents Tables v Chapter 1. Workspaces reference Cross-linked workspaces Predefined workspaces Workspace descriptions Microsoft Hyper-V Server navigator item Availability navigator item Disk navigator item Event Log navigator item Hypervisor navigator item Memory navigator item Migration navigator item Network navigator item Processor navigator item Virtual Machine navigator item VM Modification navigator item Chapter 2. Attributes reference Attribute groups for the monitoring agent Attributes in each attribute group Availability attribute group Director attribute group Disk attribute group Enterprise Hyper-V Summary attribute group.. 28 Event Log attribute group Hyper V Dynamic Memory Balancer attribute group Hyper V Dynamic Memory VM attribute group 34 Hyper V Replica VM attribute group Hyper V Replication Statistics attribute group.. 40 Hyper V Server Disk attribute group Hyper V Server Network Interface attribute group Hyper-V Hypervisor Logical Processor attribute group Hyper-V Hypervisor Partition attribute group.. 54 Hyper-V Hypervisor Root Partition attribute group Hyper-V Hypervisor Root Virtual Processor attribute group Hyper-V Hypervisor Root Virtual Processor More attribute group Hyper-V Hypervisor Virtual Processor attribute group Hyper-V Hypervisor Virtual Processor More attribute group Hyper-V Legacy Network Adapter attribute group Hyper-V Summary attribute group Hyper-V Task Manager Detail attribute group 110 Hyper-V Task Manager Recent Time attribute group Hyper-V Virtual IDE Controller attribute group 136 Hyper-V Virtual IDE Controller Filter attribute group Hyper-V Virtual IDE Controller Win2K12 attribute group Hyper-V Virtual Machine Bus attribute group 141 Hyper-V Virtual Machine Health Summary attribute group Hyper-V Virtual Machine Summary attribute group Hyper-V Virtual Network Adapter attribute group Hyper-V Virtual Storage Device attribute group 152 Hyper-V Virtual Switch attribute group Hyper-V Virtual Switch Port attribute group Hyper-V VM Association with Virtual Network attribute group Hyper-V VM IO APIC attribute group Hyper-V VM Vid Partition attribute group Hypervisor attribute group Memory attribute group Memory in Percentage attribute group Migration attribute group Performance Object Status attribute group Processor attribute group Resource Metering attribute group Thread Pool Status attribute group Virtual Machine attribute group Virtual Switch attribute group VLAN Endpoint attribute group VM Mig WO Cluster attribute group VM Modification attribute group VM Storage Migration attribute group Disk capacity planning for historical data Chapter 3. Situations reference Predefined situations Situation descriptions Microsoft Hyper-V Server navigator item Availability navigator item Disk navigator item Event Log navigator item Hypervisor navigator item Memory navigator item Migration navigator item Network navigator item Processor navigator item Virtual Machine navigator item VM Modification navigator item Chapter 4. Take Action commands reference Predefined Take Action commands Take Action command descriptions Enable VM Resource Metering action Copyright IBM Corp. 2008, 2014 iii

6 Start Hyper-V Image Management Service action Start Hyper-V Networking Management Service action Start Hyper-V Virtual Machine action Start Hyper-V Virtual Machine Management Service action Stop Hyper-V Image Management Service action Stop Hyper-V Networking Management Service action Stop Hyper-V Virtual Machine action Stop Hyper-V Virtual Machine Management Service action Chapter 5. Policies reference Predefined policies Policy descriptions Chapter 6. Tivoli Common Reporting for the monitoring agent Cognos-based report packages Prerequisites for installing and running packages Extracting the package Importing Cognos report packages Cognos data models and reports Appendix A. Event mapping Appendix B. Discovery Library Adapter for the Microsoft Hyper-V Server agent DLA data model class types represented in CDM 283 DLA data model classes for Microsoft Hyper-V Server agent OperatingSystem class WindowsComputerSystem class ComputerSystem class StorageExtent class LocalFileSystem class Appendix C. Integration with Tivoli Business Service Manager Components for integrating with Tivoli Business Service Manager Tasks to integrate the agent with Tivoli Business Service Manager Installing the Discovery Library Toolkit on the Tivoli Business Service Manager Configuring the Tivoli Event Integration Facility (EIF) probe to enrich events Creating a service in Tivoli Business Service Manager Creating a data source mapping for each data source Configuring additional IBM Tivoli Monitoring web services Viewing data in the Tivoli Enterprise Portal Appendix D. ITCAM for Microsoft Applications documentation library Prerequisite publications Related publications Tivoli Monitoring Community on Service Management Connect Other sources of documentation Notices Trademarks Privacy policy considerations Index iv Microsoft Hyper-V Server agent Reference

7 Tables 1. Cross-linked workspaces within the Hyper-V agent Cross-linked workspaces to the Cluster Server agent Cross-linked workspaces to the Windows OS agent Cross-linked workspaces to the Linux OS agent 4 5. Capacity planning for historical data logged by the Microsoft Hyper-V Server agent Hyper-V Agent Reports Prerequisites Scanner Top N Hyper-V Server Utilization report Heartbeat Availability for Virtual Machine report Hyper-V Service Availability report Top N Virtual Machines report Hyper-V Service Virtual Size and Working Set Size report Hyper-V Service CPU Utilization Summary report Hyper-V Service CPU Utilization Heat Map report Byte and Packet Transaction on Virtual Switch report Top N Hypervisor Logical Processor report Byte and Packet Transaction on Virtual Network Adapter report CPU Utilization Comparisons for Multiple Hyper-V Services report Top Hyper-V Services by Availability on Single Server report Copyright IBM Corp. 2008, 2014 v

8 vi Microsoft Hyper-V Server agent Reference

9 Chapter 1. Workspaces reference A workspace is the working area of the Tivoli Enterprise Portal application window. The Navigator tree contains a list of the workspaces provided by the agent. About workspaces Use the Navigator tree to select the workspace you want to see. As part of the application window, the status bar shows the Tivoli Enterprise Portal Server name and port number to which the displayed information applies and the ID of the current user. When you select an item in the Navigator tree, a default workspace is displayed. When you right-click a Navigator item, a menu that includes a Workspace item is displayed. The Workspace item contains a list of workspaces for that Navigator item. Each workspace has at least one view. Some views have links to other workspaces. You can also use the Workspace Gallery tool as described in the Tivoli Enterprise Portal User's Guide to open workspaces. The workspaces in the Navigator are displayed in a Physical view that shows your enterprise as a physical mapping or a dynamically populated logical view that is agent-specific. You can also create a Logical view. The Physical view is the default view. To select the dynamically populated logical view, select Hyper-V from the View list in the Navigator. To view the dynamically populated Hyper-V logical view, you must log in to the Tivoli Enterprise Portal as a system administrator. This monitoring agent provides predefined workspaces. You cannot modify or delete the predefined workspaces, but you can create new workspaces by editing them and saving the changes with a different name. Workspace views can be any combination of query-based views, event views, and special purpose views. Additional information about workspaces For more information about creating, customizing, and working with workspaces, see "Using workspaces" in the Tivoli Enterprise Portal User's Guide. For a list of the predefined workspaces for this monitoring agent and a description of each workspace, see Predefined workspaces and the information about each individual workspace. Some attribute groups for this monitoring agent might not be represented in the predefined workspaces or views for this agent. For a full list of the attribute groups, see Attribute groups for the monitoring agent on page 15. Cross-linked workspaces This section contains cross-links within the Hyper-V agent and from the Hyper-V Server agent navigator items and workspaces to the Cluster Server, Windows OS, and Linux OS agent workspaces. Table 1 on page 2, Table 2 on page 3, Table 3 on page 3, and Table 4 on page 4 contain source, target, and filtering criteria for the cross-linked workspaces. Copyright IBM Corp. 2008,

10 Table 1. Cross-linked workspaces within the Hyper-V agent Link name Availability IDE Controller Virtual Disk Virtual Processor Load VM Virtual Processor Details Virtual Machine Partition Virtual Memory Local Hyper-V Dashboard Local Hyper-V Dashboard Local Hyper-V Dashboard Local Hyper-V Dashboard Local Hyper-V Dashboard VM Virtual Processor Details Root Virtual Processor Load VM Virtual Processor Load Hyper-V Logical Processor Load Source navigator item Microsoft Hyper-V Server Microsoft Hyper-V Server Microsoft Hyper-V Server Microsoft Hyper-V Server Microsoft Hyper-V Server Microsoft Hyper-V Server Microsoft Hyper-V Server Microsoft Hyper-V Server Microsoft Hyper-V Server Microsoft Hyper-V Server Microsoft Hyper-V Server Microsoft Hyper-V Server Microsoft Hyper-V Server Microsoft Hyper-V Server Microsoft Hyper-V Server Microsoft Hyper-V Server Source workspace name Hyper-V Services and Virtual Machine Details Hyper-V Services and Virtual Machine Details Hyper-V Services and Virtual Machine Details Hyper-V Services and Virtual Machine Details Hyper-V Services and Virtual Machine Details Hyper-V Services and Virtual Machine Details Hyper-V Services and Virtual Machine Details Enterprise Dashboard Enterprise Network Utilization Dashboard Enterprise Memory Dashboard Enterprise Disk Dashboard Enterprise Processor Dashboard Local Hyper-V Dashboard Local Hyper-V Dashboard Local Hyper-V Dashboard Local Hyper-V Dashboard Source view name Hyper-V Services Status Virtual Machines State Virtual Machines State Virtual Machines State Virtual Machines State Virtual Machines State Virtual Machines State Enterprise Hyper-V Details Hyper-V Network Utilization Details Hyper-V System Memory Details Hyper-V System Disk Read Write Details Hyper-V System Processor Details Hyper-V System Details Hyper-V System Details Hyper-V System Details Hyper-V System Details Target workspace name Filter Availability IDE Controller Virtual Disk Hyper-V Virtual Processor Load VM Virtual Processor Details Partition Virtual Memory Local Hyper-V Dashboard Local Hyper-V Dashboard Local Hyper-V Dashboard Local Hyper-V Dashboard Local Hyper-V Dashboard VM Virtual Processor Details Root Virtual Processor Load Hyper-V Logical Processor Load Hyper-V Logical Processor Load Service Name Virtual Machine Name Virtual Machine Name Virtual Machine Name Virtual Machine Name Virtual Machine Name Virtual Machine Name Node Name Node Name Node Name Node Name Node Name N.A N.A N.A N.A 2 Microsoft Hyper-V Server agent Reference

11 Table 1. Cross-linked workspaces within the Hyper-V agent (continued) Link name Logical Processor Load Logical Processor Load Virtual Processor Load Virtual Processor Load Virtual Machine Details Virtual Network IBM Systems Director IBM Systems Director Source navigator item Microsoft Hyper-V Server Microsoft Hyper-V Server Microsoft Hyper-V Server Microsoft Hyper-V Server Virtual Machine Microsoft Hyper-V Server Source workspace name Local Hyper-V Dashboard Local Hyper-V Dashboard Local Hyper-V Dashboard Local Hyper-V Dashboard Virtual Machine Summary Hyper-V Services and Virtual Machine Details Source view name Top 3 Logical Processors Having High Processor Usage Bottom 3 Logical Processors Having Low Processor Usage Top 3 Virtual Processors Having High Processor Usage Bottom 3 Virtual Processors Having Low Processor Usage Virtual Machine Health Summary Virtual Machine State Virtual Machine Virtual Machine Virtual Machine Details Hypervisor Hypervisor Hyper-V System Load Details Target workspace name Filter Hyper-V Logical Processor Load Hyper-V Logical Processor Load Hyper-V Virtual Processor Load Hyper-V Virtual Processor Load Virtual Machine Details VM Association with Virtual Network IBM Systems Director IBM Systems Director Logical Processor Name Logical Processor Name Virtual Processor Name Virtual Processor Name N.A. Virtual Machine Name linkisenabled, URL linkisenabled, URL Table 2. Cross-linked workspaces to the Cluster Server agent Link name Cluster Migration Summary Cluster Dashboard Source navigator item Microsoft Hyper-V Server Source workspace name Source view name Target workspace name N.A. N.A. Resource Group Associations Migration Migration Cluster Virtual machine Cluster Dashboard Filter N.A. Cluster Name Table 3. Cross-linked workspaces to the Windows OS agent Link name Source navigator item Source workspace name Source view name Windows OS Virtual Machine Virtual Machine Virtual Machine Details Target workspace name Windows OS Filter N.A. Chapter 1. Workspaces reference 3

12 Table 4. Cross-linked workspaces to the Linux OS agent Source navigator item Source workspace name Source view name Linux OS Virtual Machine Virtual Machine Details Target workspace name Linux OS Filter N.A. Predefined workspaces The Microsoft Hyper-V Server agent provides predefined workspaces, which are organized by navigator item. v Microsoft Hyper-V Server navigator item Microsoft Hyper-V Server workspace Enterprise Dashboard workspace Enterprise Disk Dashboard workspace Enterprise Memory Dashboard workspace Enterprise Network Utilization Dashboard workspace Enterprise Processor Dashboard workspace IBM Systems Director workspace Local Hyper-V Dashboard workspace v Availability navigator item Availability workspace Performance Object Status workspace v Disk navigator item Disk workspace IDE Controller workspace Virtual Storage Device Details workspace VM Storage Migration workspace v Event Log navigator item Event Log workspace v Hypervisor navigator item Hypervisor workspace v Memory navigator item Dynamic Memory workspace Memory workspace VM VID Partition workspace v Migration navigator item Migration workspace v Network navigator item Legacy Network Adapter workspace Network workspace Virtual Network Adapter workspace Virtual Switch Port workspace VLAN EndPoint workspace VM Association with Virtual Network workspace v Processor navigator item 4 Microsoft Hyper-V Server agent Reference

13 Hyper V Logical Processor Load workspace Processor workspace Root Virtual Processor Load workspace VM Virtual Processor Details workspace VM Virtual Processor Load workspace v Virtual Machine navigator item Partition workspace Resource Metering workspace Task Manager Details workspace Virtual Machine workspace Virtual Machine Summary workspace VM Replication workspace v VM Modification navigator item VM Modification workspace Workspace descriptions Each workspace description provides information about the workspace such as the purpose and a list of views in the workspace. Workspaces are listed under navigator items. Microsoft Hyper-V Server navigator item The workspace descriptions are organized by the navigator item to which the workspaces are relevant. Microsoft Hyper-V Server workspace This workspace displays the details of the Microsoft Hyper-V services and the state of the virtual machine. This workspace contains the following views: Hyper-V Services Status Displays the status of the Hyper-V services. Virtual Machines State Displays the state of the virtual machines. Hyper V Details Displays the version and the statistical information about the hypervisor. Virtual Machine Summary Displays the statistical information about the hypervisor management services. Enterprise Dashboard workspace This workspace displays the details of the physical resources that are utilized by the all the Hyper-V systems in the enterprise. This workspace contains the following views: Situation Event Console Displays the details of all situations that are triggered. Enterprise Hyper-V Details Displays the details of the physical resource that is utilized by the Hyper-V system. Top 5 Hyper-V Systems Having High Processor Usage Displays the percentage of the five Hyper-V systems that have maximum processor utilization. Top 5 Hyper-V System Memory Usage Displays the percentage of the five Hyper-V systems that have maximum memory utilization. Chapter 1. Workspaces reference 5

14 Top 5 Hyper-V System Network Utilization Percentage Displays the percentage of the five Hyper-V systems that have maximum network utilization. Top 5 Hyper-V System Disk Read Rate Displays five Hyper-V systems that have maximum disk read rate. Enterprise Disk Dashboard workspace This workspace displays the latencies for read and write disk operations for all the Hyper-V systems in the enterprise. This workspace contains the following views: Disk Read Write Details Displays the latency for the read and write disk operations, in milliseconds. Top 5 Hyper-V System Disk Read Rate Displays five Hyper-V systems that have maximum disk read rate. Top 5 Hyper-V System Disk Write Rate Displays five Hyper-V systems that have maximum disk write rate. Enterprise Memory Dashboard workspace This workspace displays the details of the memory utilized by all the Hyper-V systems in the enterprise. This workspace contains the following views: Hyper-V System Memory Details Displays the details of the memory utilized by all the Hyper-V systems in the enterprise. Top 5 Hyper-V System Memory Usage Displays the percentage of the five Hyper-V systems that have maximum memory utilization. Bottom 5 Hyper-V System Memory Usage Displays the percentage of the five Hyper-V systems that have minimum memory utilization. Enterprise Network Utilization Dashboard workspace This workspace displays the details of the network utilized by all the Hyper-V systems in the enterprise. This workspace contains the following views: Hyper-V Network Utilization Details Displays the details of the network utilized by all the Hyper-V systems in the enterprise. Top 5 Hyper-V System Network Utilization Displays the percentage of the five Hyper-V systems that have maximum network utilization. Bottom 5 Hyper-V System Network Utilization Displays the percentage of the five Hyper-V systems that have minimum network utilization. Enterprise Processor Dashboard workspace This workspace displays the details of the processor utilized by all the Hyper-V systems in the enterprise. This workspace contains the following views: Top 5 Hyper-V Systems Having High Processor Usage Displays the percentage of the five Hyper-V systems that have maximum physical processor utilization. Bottom 5 Hyper-V Systems Having Low Processor Usage Displays the percentage of the five Hyper-V systems that have minimum physical processor utilization. Top 5 Logical Processors Having High Processor Usage Displays the percentage of the five Hyper-V systems that have maximum logical processor utilization. 6 Microsoft Hyper-V Server agent Reference

15 Top 5 Virtual Processors Having High Processor Usage Displays the percentage of the five Hyper-V systems whose virtual machines have maximum virtual processor utilization. IBM Systems Director workspace This workspace displays the IBM Systems Director console. This workspace contains the following view: IBM Systems Director Displays the IBM Systems Director console if the Director parameters are correctly configured with the agent and IBM Tivoli Monitoring (IBM) version is or later. Local Hyper-V Dashboard workspace This workspace displays the details of the physical resources that are utilized by the Hyper-V system. This workspace contains the following views: Hyper-V System Details Displays the details of the physical resource that is utilized by the Hyper-V system. Top 3 Logical Processors Having High Processor Usage Displays the percentage of the three logical processors that have maximum processor utilization. Bottom 3 Logical Processors Having Low Processor Usage Displays the percentage of the three logical processors that have minimum processor utilization. Top 3 Virtual Processors Having High Processor Usage Displays the percentage of the three virtual processors that have maximum processor utilization. Bottom 3 Virtual Processors Having Low Processor Usage Displays the percentage of the three virtual processors that have minimum processor utilization. Availability navigator item The workspace descriptions are organized by the navigator item to which the workspaces are relevant. Availability workspace The Availability workspace displays the overall health of the application. This workspace contains the following views: Availability Displays the state of each component in the application. Each service is displayed using a descriptive name, the short name of the service, and the state of the service (UP, DOWN, or UNKNOWN). The state is UP if the service is running, DOWN if the service exists but is not running. UNKNOWN indicates that the service is not installed, so these elements are filtered from the view. When the state of the component is DOWN (for a process, or service) it is highlighted with a red background. Processor Displays the amount of CPU used by each process that is a component of the application. This displays the 2 main components of CPU usage, privileged time which is time spent in the kernel on behalf of the process and user mode time, which is the time spent running the process code. Threads Displays the number of threads used by each process that is a component of the application. Memory Displays the amount of memory being consumed by each process that is a component of the application. This total (virtual) size of the process and the size of the process in memory (working set) are displayed. Performance Object Status workspace This workspace displays the overall health of the application. Chapter 1. Workspaces reference 7

16 This workspace contains the following view: Performance Object Status Displays the status of the data collection from the application. Usually this will display NO ERROR indicating that the agent is collecting application data correctly. If some of the other views contain no data, then this view will isolate the cause of the failure. Object name displays the data source object class name such as script name, WMI class, and so on. Disk navigator item The workspace descriptions are organized by the navigator item to which the workspaces are relevant. Disk workspace This workspace displays the details of hard drives within a virtual machine. This workspace contains the following views: Disk Allocated Displays the total disk space in GB, assigned to the virtual disk for the virtual machine. Virtual Disk Details Displays the details of the hard drive within a virtual machine. IDE Controller workspace This workspace displays the details about the IDE controller of the virtual machine. This workspace contains the following views: IDE Controller Details Displays the details of the disks that are attached to the IDE controller. Bytes Displays the number of bytes read from and written to the disks that are attached to the IDE controller. Sectors Displays the number of sectors read from and written to the disks that are attached to the IDE controller. Virtual Storage Device Details workspace This workspace displays the details of the virtual storage device. This workspace contains the following views: Virtual Storage Device Details Displays the details of the virtual storage device. Error Count Bytes Displays the total number of errors that occurred on the virtual storage device. Displays the total number of bytes that are read and written per second on the virtual storage device. VM Storage Migration workspace This workspace displays the information about the migration of the virtual machine's storage. This workspace contains the following view: VM Storage Migration Displays the information about the migration of the virtual machine's storage. Event Log navigator item The workspace descriptions are organized by the navigator item to which the workspaces are relevant. Event Log workspace This workspace displays the details of the critical, error, and warning events that are specific to the Hyper-V system. This workspace contains the following view: Event Log Displays the details of the critical, error, and warning events that are specific to the Hyper-V system. 8 Microsoft Hyper-V Server agent Reference

17 Hypervisor navigator item The workspace descriptions are organized by the navigator item to which the workspaces are relevant. Hypervisor workspace This workspace displays the Hyper-V system details. This workspace contains the following views: Hyper-V System Details Displays the version and the statistical information about the hypervisor. Hyper-V System Load Details Displays the information about the physical resource utilization by the Hyper-V system. Hyper-V Server Disk Displays the information about the Hyper-V Server Disk. Hyper-V Server Network Interface Displays the information about the Hyper-V Server Network Interface. Memory navigator item The workspace descriptions are organized by the navigator item to which the workspaces are relevant. Dynamic Memory workspace This workspace displays information about Dynamic Memory. This workspace contains the following views: Dynamic Memory VM Displays information about the Dynamic Memory of VMs. Pressure in Virtual Machines Displays pressure in the VMs. Dynamic Memory Balancer Displays data that is gathered from the Hyper-V Dynamic Memory Balancer. Available Memory Displays the total amount of memory that is available on the Hyper-V Server, and the memory that is available on the balancer node but not allocated to the VMs. Memory workspace This workspace displays the details of the memory currently allocated to a virtual machine. This workspace contains the following views: Maximum Memory Allocated Displays the virtual memory in MB, allocated to the virtual machine. Virtual Memory Details Displays the details of memory currently allocated to a virtual machine. VM VID Partition workspace This workspace displays the total guest address space and additional memory that is required by the VID to manage the virtual machine. This workspace contains the following view: VM VID Partition Displays the total number of guest pages and VID pages that are required to manage the virtual machine and NUMA nodes. Migration navigator item The workspace descriptions are organized by the navigator item to which the workspaces are relevant. Migration workspace This workspace displays the summary of the migration task that is performed on the virtual machine. This workspace contains the following views: VM Migration Tasks Displays the total number of tasks that are completed and are in progress. Chapter 1. Workspaces reference 9

18 VM Migration Time Taken Displays the time taken for the recent migration task. Clustered Virtual Machines Displays the list of clustered virtual machines and their current owners. Network navigator item The workspace descriptions are organized by the navigator item to which the workspaces are relevant. Legacy Network Adapter workspace This workspace displays the details of the Ethernet controller of the virtual machine. This workspace contains the following views: Legacy Network Adapter Details Displays the details of the Ethernet controller of the virtual machine. Bytes Displays the total number of bytes sent and received per second on the network adapter. Frames Displays the total number of frames sent and received per second on the network adapter. Network workspace This workspace displays the attributes that show the details of the virtual switch and the data transferred on that switch. This workspace contains the following views: Virtual Switch Details Displays the details of the virtual switch. Network Utilization Details Displays the statistics for the virtual switch. Packets Displays the details of the packets received and sent on the virtual switch. Bytes Displays the details of the bytes received and sent on the virtual switch. Virtual Network Adapter workspace This workspace displays the statistical details of the virtual network adapter. This workspace contains the following views: Virtual Network Adapter Displays the statistical details of the virtual network adapter. Bytes Displays the total number of bytes that traversed the network adapter per second. Packets Displays the total number of packets that traversed the network adapter per second. Virtual Switch Port workspace This workspace displays the statistical details of the virtual switch port. This workspace contains the following views: Virtual Switch Port Displays the statistical details of the virtual switch port. Bytes Displays the total number of bytes that traversed the virtual switch port per second. Packets Displays the total number of packets that traversed the virtual switch port per second. VLAN EndPoint workspace This workspace displays the details of the VLAN endpoint of a switch port. This workspace contains the following view: VLAN EndPoint Details Displays the details of VLAN endpoint of a switch port. VM Association with Virtual Network workspace This workspace displays the virtual machine association with virtual network. This workspace contains the following view: 10 Microsoft Hyper-V Server agent Reference

19 VM Association with Virtual Network Displays the virtual machine association with virtual network. Processor navigator item The workspace descriptions are organized by the navigator item to which the workspaces are relevant. Hyper V Logical Processor Load workspace This workspace displays the details of the logical processor of the hypervisor. This workspace contains the following views: Logical Processor Details Displays the details of the logical processor of the hypervisor. Total Interrupts Displays the number of interrupts that the logical processor processes. Processor Run Time Displays the percentage of time for which the guest code and hypervisor code run on a virtual processor. Processor workspace This workspace displays the top five virtual machines that show the highest utilization of the virtual and physical processors. This workspace contains the following views: Top 5 VMs Having High Virtual Processor Load Displays the top five virtual machines with a high virtual processor load on the virtual processor. Top 5 VMs Utilizing High Physical Processor Displays the top five virtual machines that show the highest utilization of the physical processor. Root Virtual Processor Load workspace This workspace displays the details of the root virtual processor of the hypervisor. This workspace contains the following views: Root Virtual Processor Details Displays the details of the root virtual processor of the hypervisor. Virtual Interrupts Displays the rate of all virtual interrupts that are delivered to the virtual processor. Processor Run Time Displays the percentage of time for which the guest virtual processor runs in the non-hypervisor and hypervisor code on a logical processor. VM Virtual Processor Details workspace This workspace displays the details of the virtual processor that is assigned to each virtual machine. This workspace contains the following views: Virtual Processor Details Displays the current percentage of the total processing power that is consumed by the virtual machine. Assertions Displays the information about the number of interrupt assertions that the I/O APIC device sent to the virtual machine. VM Virtual Processor Load workspace This workspace displays the load details of the virtual processor that is assigned to each virtual machine. This workspace contains the following views: Virtual Processor Load Displays the virtual processor load that is assigned to each virtual machine. Virtual Interrupts Displays the rate of all virtual interrupts that are delivered to the virtual processor. Chapter 1. Workspaces reference 11

20 Processor Run Time Displays the percentage of time for which the guest virtual processor runs in the non-hypervisor and hypervisor code on a logical processor. Virtual Machine navigator item The workspace descriptions are organized by the navigator item to which the workspaces are relevant. Partition workspace This workspace displays the details of the root partition and the hypervisor partition. This workspace contains the following views: Root Partition Displays the details of the root partition. Hypervisor Partition Displays the details of the hypervisor partition. Resource Metering workspace This workspace provides information about the data that is related to the Resource Metering of all the virtual machines that are hosted on the Hyper-V server. This workspace contains the following view: Resource Metering Displays detailed information about the resources that are used by each virtual machine. Task Manager Details workspace This workspace displays the statistics for the Virtual Machine Management service and the Task Manager. This workspace contains the following views: Virtual Machine Resources Task Displays the details of resource tasks of the virtual machine. Disk Task Displays the details of the disk tasks. Service Settings Tasks Displays the details of the service settings tasks. Virtual Machine Management Task Displays the details of the virtual machine management tasks. Virtual Machine Startup Task Displays the details of the virtual machine startup tasks. Virtual Machine Snapshot Tasks Displays the details of the virtual machine snapshot tasks. Virtual Machine workspace This workspace displays the details of all virtual machines. This workspace contains the following view: Virtual Machine Details Displays the attributes that show the virtual machine details, status, and health. Virtual Machine Summary workspace This workspace displays the statistical details of the virtual machine management service. This workspace contains the following views: Virtual Machine Health Summary Displays the health details of the Virtual Machine Management Service. Virtual Machine Bus Displays the statistics of the virtual machine bus. Virtual Machine Summary Displays the statistical details of the virtual machine management service. VM Replication workspace This workspace provides information about the replication of virtual machines. This workspace contains the following views: 12 Microsoft Hyper-V Server agent Reference

21 VM Replication Displays detailed information about the replication of virtual machines. VM Replication Statistics Displays detailed information about the replication statistics of virtual machine. VM Modification navigator item The workspace descriptions are organized by the navigator item to which the workspaces are relevant. VM Modification workspace This workspace displays the information about the modification tasks that are performed on the virtual machine. This workspace contains the following views: VM Modification Displays all modification tasks such as migration, modification, and deletion. VM Migration without Cluster Displays information about the virtual machines that are migrated without clustered environment. Chapter 1. Workspaces reference 13

22 14 Microsoft Hyper-V Server agent Reference

23 Chapter 2. Attributes reference Attributes are the application properties that are being measured and reported by the IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Hyper-V Server Agent. About attributes Attributes are organized into attribute groups. Attributes in an attribute group relate to a single object such as an application, or to a single kind of data such as status information. Attributes in a group can be used in queries, query-based views, situations, policy workflows, take action definitions, and launch application definitions. Chart or table views and situations are two examples of how attributes in a group can be used: v Chart or table views Attributes are displayed in chart and table views. The chart and table views use queries to specify which attribute values to request from a monitoring agent. You use the Properties editor to apply filters and set styles to define the content and appearance of a view based on an existing query. v Situations You use attributes to create situations that monitor the state of your operating system, database, or application. A situation describes a condition you want to test. When you start a situation, the values you assign to the situation attributes are compared with the values collected by the Microsoft Hyper-V Server agent and registers an event if the condition is met. You are alerted to events by indicator icons that are displayed in the Navigator. Additional information about attributes For more information about using attributes and attribute groups, see the Tivoli Enterprise Portal User's Guide. For a list of the attribute groups, a list of the attributes in each attribute group, and descriptions of the attributes for this monitoring agent, see Attribute groups for the monitoring agent and Attributes in each attribute group on page 19. Attribute groups for the monitoring agent The Microsoft Hyper-V Server agent contains the following attribute groups. The table name depends on the maximum table name limits of the target database being used for the Tivoli Data Warehouse. If the maximum name is 30 characters, any warehouse table name longer than 30 characters is shortened to 30 characters. v Attribute group name: Availability Table name: KHVAVAIL Warehouse table name: KHV_AVAILABILITY or KHVAVAIL v Attribute group name: Director Table name: KHVDIRECTO Warehouse table name: KHV_DIRECTOR or KHVDIRECTO v Attribute group name: Disk Table name: KHVGETDIS0 Warehouse table name: KHV_DISK or KHVGETDIS0 v Attribute group name: Enterprise Hyper-V Summary Copyright IBM Corp. 2008,

24 Table name: KHVVHYPERV Warehouse table name: KHV_ENTERPRISE_HYPER_V_SUMMARY or KHVVHYPERV v Attribute group name: Event Log Table name: KHVEVTLOG Warehouse table name: KHV_EVENT_LOG or KHVEVTLOG v Attribute group name: Hyper V Dynamic Memory Balancer Table name: KHVHYVDMMB Warehouse table name: KHV_HYPER_V_DYNAMIC_MEMORY_BALANCER or KHVHYVDMMB v Attribute group name: Hyper V Dynamic Memory VM Table name: KHVHYVDMVM Warehouse table name: KHV_HYPER_V_DYNAMIC_MEMORY_VM or KHVHYVDMVM v Attribute group name: Hyper V Replica VM Table name: KHVHYPERVR Warehouse table name: KHV_HYPER_V_REPLICA_VM or KHVHYPERVR v Attribute group name: Hyper V Replication Statistics Table name: KHVHYPVRST Warehouse table name: KHV_HYPER_V_REPLICATION_STATISTICS or KHVHYPVRST v Attribute group name: Hyper V Server Disk Table name: KHVHVSDISK Warehouse table name: KHV_HYPER_V_SERVER_DISK or KHVHVSDISK v Attribute group name: Hyper V Server Network Interface Table name: KHVHVSVNWI Warehouse table name: KHV_HYPER_V_SERVER_NETWORK_INTERFACE or KHVHVSVNWI v Attribute group name: Hyper-V Hypervisor Logical Processor Table name: KHVHYLPROC Warehouse table name: KHV_HYPER_V_HYPERVISOR_LOGICAL_PROCESSOR or KHVHYLPROC v Attribute group name: Hyper-V Hypervisor Partition Table name: KHVHYPART Warehouse table name: KHV_HYPER_V_HYPERVISOR_PARTITION or KHVHYPART v Attribute group name: Hyper-V Hypervisor Root Partition Table name: KHVHYRPART Warehouse table name: KHV_HYPER_V_HYPERVISOR_ROOT_PARTITION or KHVHYRPART v Attribute group name: Hyper-V Hypervisor Root Virtual Processor Table name: KHVHYRPROC Warehouse table name: KHV_HYPER_V_HYPERVISOR_ROOT_VIRTUAL_PROCESSOR or KHVHYRPROC v Attribute group name: Hyper-V Hypervisor Root Virtual Processor More Table name: KHVHYRPROM Warehouse table name: KHV_HYPER_V_HYPERVISOR_ROOT_VIRTUAL_PROCESSOR_MORE or KHVHYRPROM v Attribute group name: Hyper-V Hypervisor Virtual Processor Table name: KHVHYVPROC Warehouse table name: KHV_HYPER_V_HYPERVISOR_VIRTUAL_PROCESSOR or KHVHYVPROC v Attribute group name: Hyper-V Hypervisor Virtual Processor More Table name: KHVHYVPROM 16 Microsoft Hyper-V Server agent Reference

25 Warehouse table name: KHV_HYPER_V_HYPERVISOR_VIRTUAL_PROCESSOR_MORE or KHVHYVPROM v Attribute group name: Hyper-V Legacy Network Adapter Table name: KHVLEGNWAD Warehouse table name: KHV_HYPER_V_LEGACY_NETWORK_ADAPTER or KHVLEGNWAD v Attribute group name: Hyper-V Summary Table name: KHVHYPERV Warehouse table name: KHV_HYPER_V_SUMMARY or KHVHYPERV v Attribute group name: Hyper-V Task Manager Detail Table name: KHVTASKMD Warehouse table name: KHV_HYPER_V_TASK_MANAGER_DETAIL or KHVTASKMD v Attribute group name: Hyper-V Task Manager Recent Time Table name: KHVTASKMDR Warehouse table name: KHV_HYPER_V_TASK_MANAGER_RECENT_TIME or KHVTASKMDR v Attribute group name: Hyper-V Virtual IDE Controller Table name: KHVVIDECON Warehouse table name: KHV_HYPER_V_VIRTUAL_IDE_CONTROLLER or KHVVIDECON v Attribute group name: Hyper-V Virtual IDE Controller Filter Table name: KHVVIDECFL Warehouse table name: KHV_HYPER_V_VIRTUAL_IDE_CONTROLLER_FILTER or KHVVIDECFL v Attribute group name: Hyper-V Virtual IDE Controller Win2K12 Table name: KHVVIDECTK Warehouse table name: KHV_HYPER_V_VIRTUAL_IDE_CONTROLLER_WIN2K12 or KHVVIDECTK v Attribute group name: Hyper-V Virtual Machine Bus Table name: KHVVMBUS Warehouse table name: KHV_HYPER_V_VIRTUAL_MACHINE_BUS or KHVVMBUS v Attribute group name: Hyper-V Virtual Machine Health Summary Table name: KHVVMHESUM Warehouse table name: KHV_HYPER_V_VIRTUAL_MACHINE_HEALTH_SUMMARY or KHVVMHESUM v Attribute group name: Hyper-V Virtual Machine Summary Table name: KHVVMSUMMA Warehouse table name: KHV_HYPER_V_VIRTUAL_MACHINE_SUMMARY or KHVVMSUMMA v Attribute group name: Hyper-V Virtual Network Adapter Table name: KHVVIRNWAD Warehouse table name: KHV_HYPER_V_VIRTUAL_NETWORK_ADAPTER or KHVVIRNWAD v Attribute group name: Hyper-V Virtual Storage Device Table name: KHVVSTORDV Warehouse table name: KHV_HYPER_V_VIRTUAL_STORAGE_DEVICE or KHVVSTORDV v Attribute group name: Hyper-V Virtual Switch Table name: KHVVIRSWIT Warehouse table name: KHV_HYPER_V_VIRTUAL_SWITCH or KHVVIRSWIT v Attribute group name: Hyper-V Virtual Switch Port Table name: KHVVIRSWPO Chapter 2. Attributes reference 17

26 Warehouse table name: KHV_HYPER_V_VIRTUAL_SWITCH_PORT or KHVVIRSWPO v Attribute group name: Hyper-V VM Association with Virtual Network Table name: KHVVMAVCN Warehouse table name: KHV_HYPER_V_VM_ASSOCIATION_WITH_VIRTUAL_NETWORK or KHVVMAVCN v Attribute group name: Hyper-V VM IO APIC Table name: KHVVMIOAPI Warehouse table name: KHV_HYPER_V_VM_IO_APIC or KHVVMIOAPI v Attribute group name: Hyper-V VM Vid Partition Table name: KHVHYVIDP Warehouse table name: KHV_HYPER_V_VM_VID_PARTITION or KHVHYVIDP v Attribute group name: Hypervisor Table name: KHVHYPERVI Warehouse table name: KHV_HYPERVISOR or KHVHYPERVI v Attribute group name: Memory Table name: KHVGETMEM0 Warehouse table name: KHV_MEMORY or KHVGETMEM0 v Attribute group name: Memory in Percentage Table name: KHVMEMIPER Warehouse table name: KHV_MEMORY_IN_PERCENTAGE or KHVMEMIPER v Attribute group name: Migration Table name: KHVNVVMIGR Warehouse table name: KHV_MIGRATION or KHVNVVMIGR v Attribute group name: Performance Object Status Table name: KHVPOBJST Warehouse table name: KHV_PERFORMANCE_OBJECT_STATUS or KHVPOBJST v Attribute group name: Processor Table name: KHVGETPRO0 Warehouse table name: KHV_PROCESSOR or KHVGETPRO0 v Attribute group name: Resource Metering Table name: KHVVMRESME Warehouse table name: KHV_RESOURCE_METERING or KHVVMRESME v Attribute group name: Thread Pool Status Table name: KHVTHPLST Warehouse table name: KHV_THREAD_POOL_STATUS or KHVTHPLST v Attribute group name: Virtual Machine Table name: KHVGETVIR0 Warehouse table name: KHV_VIRTUAL_MACHINE or KHVGETVIR0 v Attribute group name: Virtual Switch Table name: KHVMSVMVI4 Warehouse table name: KHV_VIRTUAL_SWITCH or KHVMSVMVI4 v Attribute group name: VLAN Endpoint Table name: KHVMSVMVI5 Warehouse table name: KHV_VLAN_ENDPOINT or KHVMSVMVI5 v Attribute group name: VM Mig WO Cluster 18 Microsoft Hyper-V Server agent Reference

27 Table name: KHVVMMIGWC Warehouse table name: KHV_VM_MIG_WO_CLUSTER or KHVVMMIGWC v Attribute group name: VM Modification Table name: KHVVMMODF Warehouse table name: KHV_VM_MODIFICATION or KHVVMMODF v Attribute group name: VM Storage Migration Table name: KHVVMSTMIG Warehouse table name: KHV_VM_STORAGE_MIGRATION or KHVVMSTMIG Attributes in each attribute group Attributes in each Microsoft Hyper-V Server agent attribute group collect data that the agent uses for monitoring. The descriptions of the attribute groups contain the following information: Historical group Whether the attribute group is a historical type that you can roll off to a data warehouse. Attribute descriptions Information such as description, type, source, and warehouse name, as applicable, for each attribute in the attribute group. Some attributes are designated as key attributes. A key attribute is an attribute that is used in warehouse aggregation to identify rows of data that represent the same object. Availability attribute group The Availability attribute group contains the availability data for all processes and services that make up this application. Historical group This attribute group is eligible for use with Tivoli Data Warehouse. Attribute descriptions The following list contains information about each attribute in the Availability attribute group: Node attribute: This attribute is a key attribute. The managed system name of the agent. NODE Timestamp attribute The local time at the agent when the data was collected. TIMESTAMP Application Component attribute: This attribute is a key attribute. The descriptive name of a part of the application. APPLICATION_COMPONENT or COMPONENT Name attribute Chapter 2. Attributes reference 19

28 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. with enumerated values. The strings are displayed in the Tivoli Enterprise The warehouse and queries return the values that are shown in parentheses. The v N/A (N/A) NAME Status attribute The status of the application component. v 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. v For services 'UP', 'DOWN', or 'UNKNOWN': 'UNKNOWN' is displayed when the service is not installed. v For functionality tests: 'PASSED' or 'FAILED' is displayed. Integer with enumerated values. The strings are displayed in the Tivoli Enterprise The warehouse and queries return the values that are shown in parentheses. The v DOWN (0) v UP (1) v WARNING (2) v UNKNOWN (3) v PASSED (4) v FAILED (5) v PROCESS DATA NOT AVAILABLE (6) STATUS Full Name attribute The full name of the process including the path. with enumerated values. The strings are displayed in the Tivoli Enterprise The warehouse and queries return the values that are shown in parentheses. The v N/A (N/A) FULL_NAME or FULLNAME attribute The type of the application component. Components are processes, services, or functionality tests. 20 Microsoft Hyper-V Server agent Reference