Sie sind auf Seite 1von 268

Tivoli IBM Tivoli Monitoring for Microsoft Applications, V6.2.

0 Interim Feature 1:
Microsoft Hyper-V Server Agent V6.2.0.1
Users Guide
SC27-2319-01

Tivoli IBM Tivoli Monitoring for Microsoft Applications, V6.2.0 Interim Feature 1:
Microsoft Hyper-V Server Agent V6.2.0.1
Users Guide
SC27-2319-01

Note
Before using this information and the product it supports, read the information in Appendix D, Notices, on page 243.
This edition applies to version 6.2.0.1 of IBM Tivoli Monitoring 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 International Business Machines Corporation 2008, 2009.
US Government Users Restricted Rights Use, duplication or disclosure restricted by GSA ADP Schedule Contract
with IBM Corp.
Contents
Tables . . . . . . . . . . . . . . . v
Chapter 1. Overview of the Monitoring
Agent for Microsoft Hyper-V Server . . . 1
IBM Tivoli Monitoring overview. . . . . . . . 1
Features of the monitoring agent . . . . . . . 1
Functions of the monitoring agent . . . . . . . 1
New in this release . . . . . . . . . . . . 2
Components of the IBM Tivoli Monitoring
environment . . . . . . . . . . . . . . 5
User interface options . . . . . . . . . . . 6
Chapter 2. Requirements and
agent-specific installation and
configuration information for the
monitoring agent . . . . . . . . . . . 7
Requirements for the monitoring agent . . . . . 7
Installing language packs . . . . . . . . . . 9
Windows systems. . . . . . . . . . . . 9
UNIX or Linux systems. . . . . . . . . . 9
Agent-specific installation and configuration . . . 10
Configuration values . . . . . . . . . . 10
Remote installation and configuration . . . . 10
Chapter 3. Workspaces reference . . . 11
About workspaces . . . . . . . . . . . . 11
More information about workspaces . . . . . . 11
Cross-linked workspaces . . . . . . . . . . 11
Predefined workspaces . . . . . . . . . . 14
Agent Navigator items . . . . . . . . . . 15
Microsoft Hyper-V Server Navigator item . . . 15
Availability Navigator item . . . . . . . . 17
Disk Navigator item . . . . . . . . . . 18
Event Log Navigator item . . . . . . . . 18
Hypervisor Navigator item . . . . . . . . 19
Memory Navigator item . . . . . . . . . 19
Network Navigator item . . . . . . . . . 19
Processor Navigator item. . . . . . . . . 20
Virtual Machine Navigator item . . . . . . 22
Chapter 4. Attributes reference . . . . 23
About attributes . . . . . . . . . . . . . 23
More information about attributes . . . . . . . 23
Attribute groups and attributes for the Monitoring
Agent for Microsoft Hyper-V Server . . . . . . 23
Availability attribute group . . . . . . . . . 26
Disk attribute group . . . . . . . . . . . 30
Enterprise Hyper-V Summary attribute group . . . 33
Event Log attribute group . . . . . . . . . 35
Hyper-V Hypervisor Logical Processor attribute
group . . . . . . . . . . . . . . . . 37
Hyper-V Hypervisor Partition attribute group . . . 43
Hyper-V Hypervisor Root Partition attribute group 45
Hyper-V Hypervisor Root Virtual Processor
attribute group . . . . . . . . . . . . . 47
Hyper-V Hypervisor Root Virtual Processor More
attribute group . . . . . . . . . . . . . 53
Hyper-V Hypervisor Virtual Processor attribute
group . . . . . . . . . . . . . . . . 70
Hyper-V Hypervisor Virtual Processor More
attribute group . . . . . . . . . . . . . 76
Hyper-V Legacy Network Adapter attribute group 93
Hyper-V Summary attribute group . . . . . . 95
Hyper-V Task Manager Detail attribute group . . . 97
Hyper-V Task Manager Recent Time attribute
group . . . . . . . . . . . . . . . . 109
Hyper-V Virtual IDE Controller attribute group 122
Hyper-V Virtual Machine Bus attribute group . . 124
Hyper-V Virtual Machine Health Summary
attribute group . . . . . . . . . . . . . 126
Hyper-V Virtual Machine Summary attribute group 127
Hyper-V Virtual Network Adapter attribute group 132
Hyper-V Virtual Switch attribute group . . . . 135
Hyper-V Virtual Switch Port attribute group . . . 139
Hyper-V VM IO APIC attribute group . . . . . 143
Hypervisor attribute group . . . . . . . . . 144
Memory attribute group. . . . . . . . . . 145
Performance Object Status attribute group. . . . 148
Processor attribute group . . . . . . . . . 152
Thread Pool Status attribute group . . . . . . 155
Virtual Machine attribute group . . . . . . . 158
Virtual Switch attribute group . . . . . . . . 161
VLAN Endpoint attribute group . . . . . . . 164
Disk capacity planning for historical data . . . . 166
Chapter 5. Situations reference. . . . 169
About situations . . . . . . . . . . . . 169
More information about situations . . . . . . 169
Predefined situations . . . . . . . . . . . 170
Microsoft Hyper-V Server Navigator item . . . . 171
Availability Navigator item. . . . . . . . . 171
KHV_Image_Mgmt_Service_Down situation . . 171
KHV_Network_Service_Down situation . . . 172
KHV_VM_Mgmt_Service_Down situation . . . 172
Disk Navigator item . . . . . . . . . . . 173
KHV_VM_Disk_HealthState situation . . . . 173
Event Log Navigator item . . . . . . . . . 173
KHV_HV_PDisk_Usage_Crit situation . . . . 173
Hypervisor Navigator item. . . . . . . . . 174
KHV_HV_PNW_Utilization_Warn situation . . 174
KHV_HV_PNW_Utilization_Crit situation. . . 174
KHV_HV_PCPU_Utilization_Warn situation . . 175
KHV_HV_PCPU_Utilization_Crit situation . . 176
KHV_HV_PMemory_Available_Warn situation 176
KHV_HV_PMemory_Available_Crit situation 177
KHV_HV_PDisk_Latency_Crit situation . . . 177
KHV_HV_PDisk_Latency_Warn situation . . . 178
Memory Navigator item. . . . . . . . . . 178
Copyright IBM Corp. 2008, 2009 iii
KHV_VM_Memory_HealthState situation . . . 178
Network Navigator item . . . . . . . . . 179
KHV_VM_Switch_HealthState situation . . . 179
KHV_HV_NWAdapter_FramesDropped
situation . . . . . . . . . . . . . . 179
KHV_HV_VSwitch_PacketsFlooded situation 180
Processor Navigator item . . . . . . . . . 180
KHV_VM_ProcessorLoad_Crit situation . . . 180
KHV_VM_Processor_Warn situation. . . . . 181
KHV_HV_LP_Utilization_Warn situation . . . 182
KHV_HV_LP_Utilization_Crit situation. . . . 182
KHV_HV_LP_ContextSwitches situation . . . 183
KHV_HV_RVP_Utilization_Warn situation . . 183
KHV_HV_RVP_Utilization_Crit situation . . . 184
KHV_HV_VP_Utilization_Crit situation . . . 184
KHV_HV_VP_Utilization_Warn situation . . . 185
Virtual Machine Navigator item . . . . . . . 185
KHV_VM_Heartbeat_Crit situation . . . . . 185
Chapter 6. Take Action commands
reference . . . . . . . . . . . . . 187
About Take Action commands. . . . . . . . 187
More information about Take Action commands 187
Predefined Take Action commands . . . . . . 187
Start Hyper-V Image Management Service action 188
Start Hyper-V Networking Management Service
action . . . . . . . . . . . . . . . . 188
Start Hyper-V Virtual Machine action . . . . . 189
Start Hyper-V Virtual Machine Management
Service action . . . . . . . . . . . . . 190
Stop Hyper-V Image Management Service action 191
Stop Hyper-V Networking Management Service
action . . . . . . . . . . . . . . . . 191
Stop Hyper-V Virtual Machine action . . . . . 191
Stop Hyper-V Virtual Machine Management
Service action . . . . . . . . . . . . . 192
Chapter 7. Policies reference. . . . . 195
About policies . . . . . . . . . . . . . 195
More information about policies . . . . . . . 195
Predefined policies . . . . . . . . . . . 195
Chapter 8. Troubleshooting . . . . . 197
Gathering product information for IBM Software
Support . . . . . . . . . . . . . . . 197
Built-in troubleshooting features . . . . . . . 197
Problem classification. . . . . . . . . . . 198
Trace logging . . . . . . . . . . . . . 198
Using KHVEventReader to retrieve events. . . 198
Overview of log file management . . . . . 199
Principal trace log files . . . . . . . . . 199
Setting RAS trace parameters . . . . . . . 202
Problems and workarounds . . . . . . . . 204
Installation and configuration troubleshooting 205
Remote deployment troubleshooting . . . . 206
Agent troubleshooting . . . . . . . . . 207
Workspace troubleshooting . . . . . . . . 208
Situation troubleshooting . . . . . . . . 210
Take Action commands troubleshooting . . . 213
Support information . . . . . . . . . . . 213
Informational, warning, and error messages . . . 214
Message format . . . . . . . . . . . 214
Monitoring Agent for Microsoft Hyper-V Server
messages . . . . . . . . . . . . . . 215
Appendix A. IBM Tivoli Enterprise
Console event mapping . . . . . . . 219
Appendix B. Documentation library 237
Monitoring Agent for Microsoft Hyper-V Server
library. . . . . . . . . . . . . . . . 237
Prerequisite publications. . . . . . . . . . 237
Related publications . . . . . . . . . . . 238
Other sources of documentation . . . . . . . 238
Appendix C. Accessibility . . . . . . 241
Navigating the interface using the keyboard . . . 241
Magnifying what is displayed on the screen . . . 241
Appendix D. Notices . . . . . . . . 243
Trademarks . . . . . . . . . . . . . . 245
Index . . . . . . . . . . . . . . . 247
iv Monitoring Agent for Microsoft Hyper-V Server: Users Guide
Tables
1. Supported operating system and application
versions . . . . . . . . . . . . . . 7
2. Cross-linked workspaces to the Hyper-V agent 12
3. Cross-linked workspaces to the Cluster Server
agent. . . . . . . . . . . . . . . 14
4. Capacity planning for historical data logged
by IBM Tivoli Monitoring for Microsoft
Applications, V6.2.0 Interim Feature 1:
Microsoft Hyper-V Server Agent V6.2.0.1 . . 167
5. Information to gather before contacting IBM
Software Support . . . . . . . . . . 197
6. Trace log files for troubleshooting agents 200
7. Problems and solutions for installation and
configuration . . . . . . . . . . . 205
8. General problems and solutions for
uninstallation . . . . . . . . . . . 206
9. Remote deployment problems and solutions 207
10. Agent problems and solutions . . . . . . 207
11. Workspace problems and solutions . . . . 209
12. General situation problems and solutions 211
13. Problems with configuring situations that you
solve in the Situation Editor. . . . . . . 211
14. Problems with configuration of situations that
you solve in the Workspace area . . . . . 213
15. Take Action commands problems and
solutions . . . . . . . . . . . . . 213
Copyright IBM Corp. 2008, 2009 v
vi Monitoring Agent for Microsoft Hyper-V Server: Users Guide
Chapter 1. Overview of the Monitoring Agent for Microsoft
Hyper-V Server
The Monitoring Agent for Microsoft Hyper-V Server provides you with the
capability to monitor Microsoft Hyper-V Server, and to perform basic actions with
Microsoft Hyper-V Server. This chapter provides a description of the features,
components, and interface options for the Monitoring Agent for Microsoft Hyper-V
Server.
IBM Tivoli Monitoring overview
IBM Tivoli Monitoring is the base software for the Monitoring Agent for Microsoft
Hyper-V Server. IBM Tivoli Monitoring provides a way to monitor the availability
and performance of all the systems in your enterprise from one or several
designated workstations. It also provides useful historical data that you can use to
track trends and to troubleshoot system problems.
You can use IBM Tivoli Monitoring to perform the following tasks:
v Monitor for alerts on the systems that you are managing by using predefined
situations or custom situations.
v Establish your own performance thresholds.
v Trace the causes leading to an alert.
v Gather comprehensive data about system conditions.
v Use policies to perform actions, schedule work, and automate manual tasks.
The Tivoli Enterprise Portal is the interface for IBM Tivoli Monitoring products. By
providing a consolidated view of your environment, the Tivoli Enterprise Portal
permits you to monitor and resolve performance issues throughout the enterprise.
See the IBM Tivoli Monitoring publications listed in Prerequisite publications on
page 237 for complete information about IBM Tivoli Monitoring and the Tivoli
Enterprise Portal.
Features of the monitoring agent
The Monitoring Agent for Microsoft Hyper-V Server software can identify, notify
you of, and correct common problems with the application that it monitors. The
software includes the following features:
v Monitoring
v Data gathering
v Operations management
Functions of the monitoring agent
The Monitoring Agent for Microsoft Hyper-V Server provides the following
functions:
Availability Monitoring
Monitors the following services:
v Hyper-V Image Management Service
Copyright IBM Corp. 2008, 2009 1
v Hyper-V Networking Management Service
v Hyper-V Virtual Machine Management Service
Configuration Information
Provides Hyper-V configuration and virtual machine configuration
information such as the number of virtual machines, the state of the virtual
machines, the number of allocated virtual disks, the allocated virtual
memory, the number of allocated virtual processors, and so on.
Performance Monitoring
Collects performance attributes in the following areas, providing situations
where appropriate:
v Event Log
v Root Virtual Processor
v Virtual Processor
v Logical Processor
v Hypervisor Root Partition
v Hypervisor Partition
v Virtual Machine
v Virtual Disk
v Virtual Memory
v Virtual Network
Enterprise Dashboard
Displays the enterprise level information for all the Hyper-V systems in the
following areas:
v Physical Processor Utilization
v Memory Utilization
v Network Utilization
v Disk Operations Rate
v Logical Processor Utilization
v Virtual Processor Utilization
Actions
Provides actions to start and stop the Hyper-V services and virtual
machines.
High Availability Monitoring
Monitors the high availability of virtual machines. The agent uses the
following crosslink and attributes to monitor the high availability of virtual
machines:
v Cluster Migration Summary crosslink that is available on the Microsoft

Hyper-V Server navigator item to provide information about the active


node, where the clustered virtual machines are present.
v The following attributes in the Task Manager Details workspace:
Migrate Virtual Machine Tasks Completed
Migrate Virtual Machine Tasks In Progress
Migrate Virtual Machine Tasks Recent Time
New in this release
For version 6.2.0.1 of the Monitoring Agent for Microsoft Hyper-V Server, the
following enhancements have been made since version 6.2:
2 Monitoring Agent for Microsoft Hyper-V Server: Users Guide
v Additional supported operating systems as listed in Requirements for the
monitoring agent on page 7
v New attribute groups
Hyper-V Summary
Event Log
Hyper-V Hypervisor
Hyper-V Virtual Machine Summary
Hyper-V Virtual IDE Controller
Hyper-V Hypervisor Partition
Hyper-V Hypervisor Root Partition
Hyper-V Hypervisor Logical Processor
Hyper-V Hypervisor Virtual Processor
Hyper-V Hypervisor Virtual Processor More
Hyper-V VM IO APIC
Hyper-V Hypervisor Root Virtual Processor
Hyper-V Hypervisor Root Virtual Processor More
Hyper-V Virtual Machine Health Summary
Hyper-V Virtual Machine Bus
Hyper-V Task Manager Detail
Hyper-V Task Manager Recent Time
Hyper-V Legacy Network Adapter
Hyper-V Virtual Switch
Hyper-V Virtual Switch Port
Hyper-V Virtual Network Adapter
v New workspaces
Enterprise Dashboard
Enterprise Memory Dashboard
Enterprise Disk Dashboard
Enterprise Network Utilization Dashboard
Enterprise Processor Dashboard
Hyper-V Dashboard
Event Log
IDE Controller
Partition
VM Virtual Processor Load
Root Virtual Processor Load
Hyper-V Logical Processor Load
Virtual Machine Summary
Task Manager Details
Legacy Network Adapter
Virtual Switch Port
Virtual Network Adapter
Hypervisor
v New views
Situation Event Console
Chapter 1. Overview of the Monitoring Agent for Microsoft Hyper-V Server 3
Top 5 Hyper-V System CPU %
Top 5 Hyper-V System Memory Usage %
Top 5 Hyper-V Network Utilization %
Top 5 Hyper-V Disk Read Rate
Enterprise Hyper-V Details
Bottom 5 Hyper-V Memory Usage %
Hyper-V System Memory details
Top 5 Hyper-V System Disk Read Rate %
Top 5 Hyper-V System Disk Write Rate %
Hyper-V System Disk Read Write details
Top 5 Hyper-V System Network Utilization %
Bottom 5 Hyper-V System Network Utilization %
Hyper-V Network Utilization details
Bottom 5 Hyper-V System CPU %
Top 5 Hyper-V System Logical Processor CPU %
Top 5 Hyper-V System Virtual Processor CPU %
Hyper-V System CPU details
Hyper-V System Details
Top 3 Logical Processor CPU %
Bottom 3 Logical Processor CPU %
Top 3 Virtual Processor CPU %
Bottom 3 Virtual Processor CPU %
Event Log
Bytes
Sectors
IDE Controller Details
Hypervisor Partition
Hypervisor Root Partition
Virtual Processor Load
Processor Run Time
Virtual Interrupts
Root Virtual Processor Details
Processor Run Time
Virtual Interrupts
Logical Processor Details
Total Interrupts
Virtual Machine Health Summary
Virtual Machine Summary
Virtual Machine Bus
Virtual Machine Management Task
Virtual Machine Startup Task
Virtual Machine Snapshot Task
Virtual Machine Resources Task
Disk Task
Service Settings Task
4 Monitoring Agent for Microsoft Hyper-V Server: Users Guide
Frames
Legacy Network Adapter Details
Virtual Switch Port Details
Packets
Virtual Network Adapter
v New situations
HV_VP_Utilization_Crit
HV_VP_Utilization_Warn
HV_LP_Utilization_Warn
HV_LP_Utilization_Crit
HV_LP_ContextSwitches
HV_RVP_Utilization_Warn
HV_RVP_Utilization_Crit
HV_VSwitch_PacketsFlooded
HV_NWAdapter_FramesDropped
HV_PDisk_Usage_Crit
HV_PNW_Utilization_Warn
HV_PNW_Utilization_Crit
HV_PCPU_Utilization_Warn
HV_PCPU_Utilization_Crit
HV_PMemory_Available_Warn
HV_PMemory_Available_Crit
HV_PDisk_Latency_Warn
HV_PDisk_Latency_Crit
v Updated khv.baroc file to support TEC event mapping
v Other new function
Components of the IBM Tivoli Monitoring environment
After you install and set up the Monitoring Agent for Microsoft Hyper-V Server,
you have an environment that contains the client, server, and monitoring agent
implementation for IBM Tivoli Monitoring that contains the following components:
v Tivoli Enterprise Portal client with a Java

-based user interface for viewing and


monitoring your enterprise.
v Tivoli Enterprise Portal Server that is placed between the client and the Tivoli
Enterprise Monitoring Server and enables retrieval, manipulation, and analysis
of data from the monitoring agents. The Tivoli Enterprise Portal Server is the
central repository for all user data.
v Tivoli Enterprise Monitoring Server that acts as a collection and control point for
alerts received from the monitoring agents, and collects their performance and
availability data. The Tivoli Enterprise Monitoring Server is also a repository for
historical data.
v IBM Tivoli Enterprise Console is an optional component, which acts as a central
collection point for events from a variety of sources, including those from other
Tivoli

software applications, Tivoli partner applications, custom applications,


network management platforms, and relational database systems. You can view
these events through the Tivoli Enterprise Portal (using the event viewer), and
you can forward events from IBM Tivoli Monitoring situations to the IBM Tivoli
Enterprise Console component.
Chapter 1. Overview of the Monitoring Agent for Microsoft Hyper-V Server 5
User interface options
Installation of the base software and other integrated applications provides the
following interfaces that you can use to work with your resources and data:
Tivoli Enterprise Portal browser client interface
The browser client interface is automatically installed with the Tivoli
Enterprise Portal Server. To start the Tivoli Enterprise Portal browser client
in your Internet browser, enter the URL for a specific Tivoli Enterprise
Portal browser client installed on your Web server.
Tivoli Enterprise Portal desktop client interface
The desktop client interface is a Java-based graphical user interface (GUI)
on a Windows

or Linux

workstation.
IBM Tivoli Enterprise Console
An event management application that integrates system, network,
database, and application management to help ensure the optimal
availability of an IT services for an organization.
Manage Tivoli Enterprise Monitoring Services window
The window for the Manage Tivoli Enterprise Monitoring Services utility is
used for configuring the agent and starting Tivoli services not already
designated to start automatically.
6 Monitoring Agent for Microsoft Hyper-V Server: Users Guide
Chapter 2. Requirements and agent-specific installation and
configuration information for the monitoring agent
This chapter contains information about the requirements for the Monitoring Agent
for Microsoft Hyper-V Server, and agent-specific information related to installation
and configuration of the agent.
To install and configure the Monitoring Agent for Microsoft Hyper-V Server, use
the procedures for installing monitoring agents in the IBM Tivoli Monitoring
Installation and Setup Guide along with the information in this chapter.
If you are performing a silent installation using a response file, see the information
about performing a silent installation in the IBM Tivoli Monitoring Installation and
Setup Guide.
Requirements for the monitoring agent
In addition to the requirements described in the IBM Tivoli Monitoring Installation
and Setup Guide, the Monitoring Agent for Microsoft Hyper-V Server has the
following requirements:
v The monitoring agent runs on any of these operating systems:
Table 1. Supported operating system and application versions
Operating system versions Microsoft Hyper-V 2008
Windows Web Edition 2003 (32 bit) with
Service Pack 1
No
Windows Server 2003 SE (32 bit) with Service
Pack 1 or Service Pack 2
No
Windows Server 2003 EE (32 bit) with Service
Pack 1 or Service Pack 2
No
Windows Server 2003 Datacenter Edition (32
bit) with Service Pack 1
No
Windows Server 2003 SE (64 bit) with Service
Pack 1 or Service Pack 2
No
Windows Server 2003 EE (64 bit) with Service
Pack 1 or Service Pack 2
No
Windows Server 2003 Datacenter Edition (64
bit) with Service Pack 1
No
Windows Server 2003 on Itanium2 (IA64)
with Service Pack 2
No
Windows Web Edition 2008 (32 bit) with
Service Pack 1
No
Windows Server 2008 SE (32 bit) with Service
Pack 1
No
Windows Server 2008 EE (32 bit) with Service
Pack 1
No
Windows Server 2008 Datacenter Edition (32
bit) with Service Pack 1
No
Copyright IBM Corp. 2008, 2009 7
Table 1. Supported operating system and application versions (continued)
Operating system versions Microsoft Hyper-V 2008
Windows Web Edition 2008 (64 bit) with
Service Pack 1
No
Windows Server 2008 SE (64 bit) with Service
Pack 2
Yes
Windows Server 2008 EE (64 bit) with Service
Pack 2
Yes
Windows Server 2008 Datacenter Edition (64
bit) with Service Pack 2
Yes
Windows Server 2008 on Itanium2 (IA64)
with Service Pack 1
No
Windows Server 2008 Datacenter on Itanium2
(IA64)
No
Microsoft Hyper-V Server 2008 (64 bit) Yes
Required Microsoft OS hotfixes
The following Microsoft OS hotfix must be installed to support the agent and
retrieve the data for the perfmon-based attribute groups:
http://support.microsoft.com/kb/960751
The following OS hotfix is required to support the Hyper-V Summary
attribute group: http://support.microsoft.com/kb/961730
The operating system user account must have administrative privileges. The
agent service runs under the operating system user account.
Note: For the most current information about the operating systems that are
supported, see http://www-306.ibm.com/software/sysmgmt/products/
support/Tivoli_Supported_Platforms.html.
v This agent monitors the following versions:
Microsoft Hyper-V Server 2008
v A single computer that hosts the hub monitoring server, portal server, and a
monitoring agent requires approximately 300 MB of space. A computer that
hosts only the monitoring agent requires approximately 30 MB of space,
including the specific enablement code for the monitoring agent. More space is
required for each additional monitoring agent that you deploy on the
monitoring computer.
v The monitoring agent must be connected to the following software:
IBM

Tivoli Monitoring V6.2.0 Fix Pack 1 or later.


After you install the prerequisite software, install the following software, which
is required for the Monitoring Agent for Microsoft Hyper-V Server to operate:
Monitoring Agent for Microsoft Hyper-V Server
Monitoring Agent for Microsoft Hyper-V Server for Tivoli Enterprise
Monitoring Server support
Monitoring Agent for Microsoft Hyper-V Server for Tivoli Enterprise Portal
Server support
Monitoring Agent for Microsoft Hyper-V Server for Tivoli Enterprise Portal
Desktop Client support
Monitoring Agent for Microsoft Hyper-V Server for Tivoli Enterprise Portal
Browser Client support
8 Monitoring Agent for Microsoft Hyper-V Server: Users Guide
Installing language packs
To install a language pack for the agent support files on the Tivoli Enterprise
Monitoring Server, the Tivoli Enterprise Monitoring Agent, and the Tivoli
Enterprise Portal Server, first make sure that you have already installed the
product in English, then perform the following steps depending on which
operating system you are using.
Windows systems
1. Double-click lpinstaller.bat in the language pack CD to launch the installation
program.
2. Select the language of the installer and click OK.
3. Click Next on the Introduction panel.
4. Click Add/Update and click Next.
5. Select the folder in which the National Language Support package
(NLSPackage) files are located.
Note: Usually the NLSPackage files are located in the nlspackage folder
where the installer executable is located.
6. Select the language support for the agent of your choice and click Next.
Note: Hold down the Ctrl key for multiple selections.
7. Select the languages that you want to install and click Next.
8. Examine the installation summary page and click Next to begin installation.
9. Click Finish after installation completes to exit the installer.
10. Restart Tivoli Enterprise Portal Desktop Client, Tivoli Enterprise Portal Server,
and Eclipse Help Server if any of these components are installed.
UNIX or Linux systems
1. Run the following command to create a temporary directory on the computer.
Make sure that the full path of the directory does not contain any spaces:
mkdir dir_name
2. Mount the language pack CD to the temporary directory you just created.
3. Run the following command to launch the installation program:
cd dir_name
lpinstaller.sh -c ITM Home Directory
Where ITM Home Directory is where you installed IBM Tivoli Monitoring.
Usually it is /opt/IBM/ITM for AIX

and Linux.
4. Select the language of the installer and click OK.
5. Click Next on the Introduction panel.
6. Click Add/Update and click Next.
7. Select the folder in which the National Language Support package
(NLSPackage) files are located.
Note: Usually, the NLSPackage files are located in the nlspackage folder
where the installer executable is located.
8. Select the language support for the agent of your choice and click Next.
Note: Hold down the Ctrl key for multiple selections.
Chapter 2. Requirements and agent-specific installation and configuration information for the monitoring agent 9
9. Select the languages that you want to install and click Next.
10. Examine the installation summary page and click Next to begin installation.
11. Click Finish after installation completes to exit the installer.
12. Restart Tivoli Enterprise Portal Desktop Client, Tivoli Enterprise Portal Server,
and Eclipse Help Server if any of these components are installed.
Agent-specific installation and configuration
In addition to the installation and configuration information in the IBM Tivoli
Monitoring Installation and Setup Guide, use the information in this section to install
and configure the Monitoring Agent for Microsoft Hyper-V Server.
No special setup is necessary to manage this application.
Configuration values
For both local and remote configuration, provide the configuration values for the
agent to operate. When configuring an agent, a panel is displayed so you can enter
each value. When there is a default value, this value is pre-entered into the field. If
a field represents a password, two entry fields are displayed. You must enter the
same value in each field. The values you type are not displayed to help maintain
the security of these values.
Remote installation and configuration
When installing the agent remotely, you must provide the configuration values for
the agent to operate. See Configuration values.
See the tacmd describeSystemType section in the IBM Tivoli Monitoring Command
Reference for information on displaying the configuration options that are available
to use with the configureSystem or addSystem commands.
You can install the monitoring agent remotely from the Tivoli Enterprise Portal or
from the command line. To install from the portal, see the IBM Tivoli Monitoring
Installation and Setup Guide.
If using the command line, the following command is an example of remote
installation and configuration for Windows operating systems:
tacmd addSystem -t HV -n Primary:sample.node.name:NT
-p
10 Monitoring Agent for Microsoft Hyper-V Server: Users Guide
Chapter 3. Workspaces reference
This chapter contains an overview of workspaces, references for detailed
information about workspaces, and descriptions of the predefined workspaces
included in this monitoring agent.
About workspaces
A workspace is the working area of the Tivoli Enterprise Portal application
window. At the left of the workspace is a Navigator that you use to select the
workspace you want to see. As part of the application window, the right side of
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.
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.
A table view within a workspace corresponds to a group of attributes; the columns
in the table view show some or all of the attributes available in the attribute group.
More information about workspaces
For more information about creating, customizing, and working with workspaces,
see the IBM Tivoli Monitoring Users Guide.
For a list of the predefined workspaces for this monitoring agent and a description
of each workspace, refer to the Predefined workspaces section in this chapter and
the information in that section for 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 the Attributes reference section.
Cross-linked workspaces
This section contains cross-links from the Hyper-V Server agent navigator items
and workspaces to the Hyper-V Server and Cluster Server agent workspaces.
Table 2 on page 12 and Table 3 on page 14 contains source, target, and filtering
criteria for the cross-linked workspaces.
Copyright IBM Corp. 2008, 2009 11
Table 2. Cross-linked workspaces to the Hyper-V agent
Source
navigator
item
Source
workspace
name
Source view
name
Target
Navigator
Item
Target
workspace
name Filter
Microsoft
Hyper-V
Server
Hyper-V
Services and
Virtual
Machine
Details
Hyper-V
Services
Status
Availability Availability Service Name
Microsoft
Hyper-V
Server
Hyper-V
Services and
Virtual
Machine
Details
Virtual
Machines
State
Disk IDE
Controller
Virtual
Machine
Name
Microsoft
Hyper-V
Server
Hyper-V
Services and
Virtual
Machine
Details
Virtual
Machines
State
Disk Virtual Disk Virtual
Machine
Name
Microsoft
Hyper-V
Server
Hyper-V
Services and
Virtual
Machine
Details
Virtual
Machines
State
Processor Hyper-V
Logical
Processor
Load
Virtual
Machine
Name
Microsoft
Hyper-V
Server
Hyper-V
Services and
Virtual
Machine
Details
Virtual
Machines
State
Processor VM Virtual
Processor
Load
Virtual
Machine
Name
Microsoft
Hyper-V
Server
Hyper-V
Services and
Virtual
Machine
Details
Virtual
Machines
State
Virtual
Machine
Partition Virtual
Machine
Name
Microsoft
Hyper-V
Server
Hyper-V
Services and
Virtual
Machine
Details
Virtual
Machines
State
Memory Virtual
Memory
Virtual
Machine
Name
Microsoft
Hyper-V
Server
Enterprise
Dashboard
Enterprise
Hyper-V
Details
Microsoft
Hyper-V
Server
Local
Hyper-V
Dashboard
N.A
Microsoft
Hyper-V
Server
Enterprise
Network
Utilization
Dashboard
Hyper-V
Network
Utilization
details
Microsoft
Hyper-V
Server
Local
Hyper-V
Dashboard
N.A
Microsoft
Hyper-V
Server
Enterprise
Memory
Dashboard
Hyper-V
System
Memory
details
Microsoft
Hyper-V
Server
Local
Hyper-V
Dashboard
N.A
Microsoft
Hyper-V
Server
Enterprise
Disk
Dashboard
Hyper-V
System Disk
Read Write
details
Microsoft
Hyper-V
Server
Local
Hyper-V
Dashboard
N.A
12 Monitoring Agent for Microsoft Hyper-V Server: Users Guide
Table 2. Cross-linked workspaces to the Hyper-V agent (continued)
Source
navigator
item
Source
workspace
name
Source view
name
Target
Navigator
Item
Target
workspace
name Filter
Microsoft
Hyper-V
Server
Enterprise
Processor
Dashboard
Hyper-V
System
Processor
details
Microsoft
Hyper-V
Server
Local
Hyper-V
Dashboard
N.A
Microsoft
Hyper-V
Server
Local
Hyper-V
Dashboard
Hyper-V
System
Details
Processor VM Virtual
Processor
Details
N.A
Microsoft
Hyper-V
Server
Local
Hyper-V
Dashboard
Hyper-V
System
Details
Processor Hyper-V
Logical
Processor
Load
N.A
Microsoft
Hyper-V
Server
Local
Hyper-V
Dashboard
Hyper-V
System
Details
Processor Root Virtual
Processor
Load
N.A
Microsoft
Hyper-V
Server
Local
Hyper-V
Dashboard
Hyper-V
System
Details
Processor Hyper-V
Logical
Processor
Load
N.A
Microsoft
Hyper-V
Server
Local
Hyper-V
Dashboard
Top 3 Logical
Processors
Having High
Processor
Usage
Processor Hyper-V
Logical
Processor
Load
Logical
Processor
Name
Microsoft
Hyper-V
Server
Local
Hyper-V
Dashboard
Bottom 3
Logical
Processors
Having Low
Processor
Usage
Processor Hyper-V
Logical
Processor
Load
Logical
Processor
Name
Microsoft
Hyper-V
Server
Local
Hyper-V
Dashboard
Top 3 Virtual
Processors
Having High
Processor
Usage
Processor Hyper-V
Logical
Processor
Load
Virtual
Processor
Name
Microsoft
Hyper-V
Server
Local
Hyper-V
Dashboard
Bottom 3
Virtual
Processors
Having Low
Processor
Usage
Processor Hyper-V
Logical
Processor
Load
Virtual
Processor
Name
Virtual
Machine
Virtual
Machine
Summary
Virtual
Machine
Health
Summary
Virtual
Machine
Virtual
Machine
N.A.
Chapter 3. Workspaces reference 13
Table 3. Cross-linked workspaces to the Cluster Server agent
Source
navigator
item
Source
workspace
name
Source view
name
Target
Navigator
Item
Target
workspace
name Filter
Microsoft
Hyper-V
Server
N.A. N.A. Resource
Groups
Resource
Group
Associations
N.A.
Predefined workspaces
The Monitoring Agent for Microsoft Hyper-V Server provides the following
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
Local Hyper-V Dashboard workspace
v Availability Navigator item
Availability workspace
Performance Object Status workspace
v Disk Navigator item
Disk workspace
IDE Controller workspace
v Event Log Navigator item
Event Log workspace
v Hypervisor Navigator item
Hypervisor workspace
v Memory Navigator item
Memory workspace
v Network Navigator item
Legacy Network Adapter workspace
Network workspace
Virtual Network Adapter workspace
Virtual Switch Port workspace
VLAN EndPoint workspace
v Processor Navigator item
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
14 Monitoring Agent for Microsoft Hyper-V Server: Users Guide
Partition workspace
Task Manager Details workspace
Virtual Machine workspace
Virtual Machine Summary workspace
Agent Navigator items
This section contains descriptions of predefined workspaces. The workspaces are
organized by the Navigator item to which the workspaces are relevant.
Microsoft Hyper-V Server Navigator item
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.
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.
Chapter 3. Workspaces reference 15
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.
16 Monitoring Agent for Microsoft Hyper-V Server: Users Guide
Top 5 Logical Processors Having High Processor Usage
Displays the percentage of the five Hyper-V systems that have
maximum logical processor utilization.
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.
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
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.
Chapter 3. Workspaces reference 17
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.
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
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.
Event Log Navigator item
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.
18 Monitoring Agent for Microsoft Hyper-V Server: Users Guide
Hypervisor Navigator item
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.
Memory Navigator item
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.
Network Navigator item
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.
Chapter 3. Workspaces reference 19
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 Network Adapter
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.
Processor Navigator item
Hyper V Logical Processor Load workspace
This workspace displays the details of the logical processor of the
hypervisor.
This workspace contains the following views:
Root Virtual 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.
20 Monitoring Agent for Microsoft Hyper-V Server: Users Guide
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.
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.
Chapter 3. Workspaces reference 21
Virtual Machine Navigator item
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.
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.
22 Monitoring Agent for Microsoft Hyper-V Server: Users Guide
Chapter 4. Attributes reference
This chapter contains an overview of attributes, references for detailed information
about attributes, and descriptions of the attributes for each attribute group
included in this monitoring agent.
About attributes
Attributes are the application properties being measured and reported by the
Monitoring Agent for Microsoft Hyper-V Server.
Attributes are organized into groups according to their purpose. The attributes in a
group can be used in the following two ways:
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 Query editor to create a new query, modify an existing query, or
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 Tivoli Enterprise Portal compares the values
you have assigned to the situation attributes with the values collected by the
Monitoring Agent for Microsoft Hyper-V Server and registers an event if the
condition is met. You are alerted to events by indicator icons that are displayed
in the Navigator.
More information about attributes
For more information about using attributes and attribute groups, see the IBM
Tivoli Monitoring Users Guide.
For a list of the attributes groups, a list of the attributes in each attribute group,
and descriptions of the attributes for this monitoring agent, see the Attribute
groups and attributes section in this chapter.
Attribute groups and attributes for the Monitoring Agent for Microsoft
Hyper-V Server
This monitoring 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, then any
warehouse table name longer than 30 characters is shortened to the table name.
v Attribute group name: Availability
Table name: KHVAVAIL
Warehouse table name: KHV_AVAILABILITY or KHVAVAIL
v Attribute group name: Disk
Table name: KHVGETDIS0
Warehouse table name: KHV_DISK or KHVGETDIS0
Copyright IBM Corp. 2008, 2009 23
v Attribute group name: Enterprise Hyper-V Summary
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 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
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
24 Monitoring Agent for Microsoft Hyper-V Server: Users Guide
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 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 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
Warehouse table name: KHV_HYPER-V_VIRTUAL_SWITCH_PORT or
KHVVIRSWPO
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: 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: 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
Chapter 4. Attributes reference 25
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
The remaining sections of this chapter contain descriptions of these attribute
groups, which are listed alphabetically. The following information is provided for
each attribute group:
Historical group
Whether the attribute group is a historical type that you can roll off to a
data warehouse
Attribute descriptions
Description and type 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. If the warehouse default setting is enabled,
data for this attribute group is stored in Tivoli Data Warehouse.
Historical group
This attribute group is part of the default historical group, and 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.
Description
The managed system name of the agent.
Type String
Timestamp attribute
Description
The local time at the agent when the data was collected.
Type String
Application Component attribute - This attribute is a key attribute.
26 Monitoring Agent for Microsoft Hyper-V Server: Users Guide
Description
The descriptive name of a part of the application.
Type String
Name attribute
Description
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.
Type String with enumerated values. The strings are displayed in the
Tivoli Enterprise Portal. The warehouse and queries return the
values shown in parentheses. The following values are defined:
v N/A (N/A)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Status attribute
Description
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.
Type Integer with enumerated values. The strings are displayed in the
Tivoli Enterprise Portal. The warehouse and queries return the
values shown in parentheses. The following values are defined:
v DOWN (0)
v UP (1)
v WARNING (2)
v UNKNOWN (3)
v PASSED (4)
v FAILED (5)
v PROCESS_DATA_NOT_AVAILABLE (6)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Full Name attribute
Description
The full name of the process including the path.
Type String with enumerated values. The strings are displayed in the
Tivoli Enterprise Portal. The warehouse and queries return the
values shown in parentheses. The following values are defined:
v N/A (N/A)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Chapter 4. Attributes reference 27
Type attribute
Description
The type of the application component. Components are processes,
services, or functionality tests.
Type Integer with enumerated values. The strings are displayed in the
Tivoli Enterprise Portal. The warehouse and queries return the
values shown in parentheses. The following values are defined:
v PROCESS (0)
v SERVICE (1)
v FUNCTIONALITY_TEST (2)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Virtual Size attribute
Description
The virtual size (in MB) of the process.
Type Integer (Gauge)
Page Faults per Sec attribute
Description
The rate of page faults for the process measured in faults per
second. This attribute only contains valid data for processes.
Type Integer (Gauge)
Working Set Size attribute
Description
The working set size of the process in MB. This attribute only
contains valid data for processes.
Type Integer (Gauge)
Thread Count attribute
Description
The number of threads currently allocated by this process. This
attribute only contains valid data for processes.
Type Integer (Gauge)
PID attribute
Description
The process ID associated with the process. This attribute only
contains valid data for processes.
Type Integer (Gauge)
Percent Privileged Time attribute
Description
The percentage of the available CPU time that is being used by this
process for privileged operation.
Type Integer (Gauge)
Percent User Mode Time attribute
28 Monitoring Agent for Microsoft Hyper-V Server: Users Guide
Description
The percentage of the available CPU time that is being used by this
process for user mode operation.
Type Integer (Gauge)
Percent Processor Time attribute
Description
The percentage of the elapsed time that this process used the
processor to execute instructions.
Type Integer (Gauge)
Command Line attribute
Description
The program name and any arguments specified on the command
line when the process was started. This has the value N/A if this is
a Service, or Functionality test.
Type String with enumerated values. The strings are displayed in the
Tivoli Enterprise Portal. The warehouse and queries return the
values shown in parentheses. The following values are defined:
v N/A (N/A)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Functionality Test Status attribute
Description
The return code of the functionality test. When the monitored
application is running correctly, SUCCESS is displayed.
NOT_RUNNING is displayed when it is not running correctly.
N/A is displayed when the row does not represent a
functionality test.
Type Integer with enumerated values. The strings are displayed in the
Tivoli Enterprise Portal. The warehouse and queries return the
values shown in parentheses. The following values are defined:
v SUCCESS (0)
v N/A (1)
v GENERAL_ERROR (2)
v WARNING (3)
v NOT_RUNNING (4)
v DEPENDENT_NOT_RUNNING (5)
v ALREADY_RUNNING (6)
v PREREQ_NOT_RUNNING (7)
v TIMED_OUT (8)
v DOESNT_EXIST (9)
v UNKNOWN (10)
v DEPENDENT_STILL_RUNNING (11)
v INSUFFICIENT_USER_AUTHORITY (12)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Functionality Test Message attribute
Chapter 4. Attributes reference 29
Description
The text message that corresponds to the Functionality Test Status.
This is only valid for functionality tests.
Type String with enumerated values. The strings are displayed in the
Tivoli Enterprise Portal. The warehouse and queries return the
values shown in parentheses. The following values are defined:
v N/A (N/A)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Disk attribute group
The Disk attribute group represents a hard drive within a virtual machine. If the
warehouse default setting is enabled, data for this attribute group is stored in
Tivoli Data Warehouse.
Historical group
This attribute group is part of the default historical group, and is eligible for use
with Tivoli Data Warehouse.
Attribute descriptions
The following list contains information about each attribute in the Disk attribute
group:
Node attribute - This attribute is a key attribute.
Description
The managed system name of the agent.
Type String
Timestamp attribute
Description
The local time at the agent when the data was collected.
Type String
Virtual Machine Name attribute
Description
Name of the virtual machine
Type String
Availability attribute
Description
Status of the device
Type Integer with enumerated values. The strings are displayed in the
Tivoli Enterprise Portal. The warehouse and queries return the
values shown in parentheses. The following values are defined:
v Other (1)
v Unknown (2)
v Running/Full Power (3)
v Warning (4)
v In_Test (5)
30 Monitoring Agent for Microsoft Hyper-V Server: Users Guide
v Not_Applicable (6)
v Power_Off (7)
v Off_Line (8)
v Off_Duty (9)
v Degraded (10)
v Not_Installed (11)
v Install_Error (12)
v Power_Save_-_Unknown (13)
v Power_Save_-_Low_Power_Mode (14)
v Power_Save_-_Standby (15)
v Power_Cycle (16)
v Power_Save_-_Warning (17)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
HealthState attribute
Description
The current health of the element
Type Integer with enumerated values. The strings are displayed in the
Tivoli Enterprise Portal. The warehouse and queries return the
values shown in parentheses. The following values are defined:
v Healthy (5)
v Non-Functional (30)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
EnabledState attribute
Description
The enabled and disabled states of an element
Type Integer with enumerated values. The strings are displayed in the
Tivoli Enterprise Portal. The warehouse and queries return the
values shown in parentheses. The following values are defined:
v Unknown (0)
v Other (1)
v Enabled (2)
v Disabled (3)
v Shutting_Down (4)
v Not_Applicable (5)
v Enabled_but_Offline (6)
v In_Test (7)
v Deferred (8)
v Quiesce (9)
v Starting (10)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
MaxDiskAllocated attribute
Chapter 4. Attributes reference 31
Description
The total disk space in GB, assigned to the virtual disk for the
virtual machine.This is equal to (NumberOfBlocks*BlockSize)/
1073741824
Type Integer (Numeric Property) with enumerated values. The strings
are displayed in the Tivoli Enterprise Portal. The warehouse and
queries return the values shown in parentheses. The following
values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
DefaultBlockSize attribute
Description
The default block size, in bytes, for the device
Type Integer (Numeric Property) with enumerated values. The strings
are displayed in the Tivoli Enterprise Portal. The warehouse and
queries return the values shown in parentheses. The following
values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
LoadTime attribute
Description
The amount of time that the media takes, from loading until being
able to read or write to media, in milliseconds
Type Integer (Gauge) with enumerated values. The strings are displayed
in the Tivoli Enterprise Portal. The warehouse and queries return
the values shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
TotalMountTime attribute
Description
For removable media, the total time in seconds required for data
transfer or to clean the device and for non removable media, this
property is not applicable and must be set to 0
Type Integer (Counter) with enumerated values. The strings are
displayed in the Tivoli Enterprise Portal. The warehouse and
queries return the values shown in parentheses. The following
values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
32 Monitoring Agent for Microsoft Hyper-V Server: Users Guide
FreePhysicalDisk attribute
Description
The free physical disk space available, in GB
Type Integer (Gauge) with enumerated values. The strings are displayed
in the Tivoli Enterprise Portal. The warehouse and queries return
the values shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Virtual Machine ID attribute - This attribute is a key attribute.
Description
The unique identifier for the virtual machine
Type String
Device ID attribute - This attribute is a key attribute.
Description
The unique identifier for the disk drive
Type String
Enterprise Hyper-V Summary attribute group
Provides the data that is contained in the Hyper-V Summary attribute group for all
the monitored Microsoft Hyper-V Server systems in the enterprise. The data is
collected from each agent in the environment every 10 minutes. The Hyper-V
Summary attribute group provides information about the physical resource
utilization by the Hyper-V system. If the warehouse default setting is enabled, data
for this attribute group is not stored in Tivoli Data Warehouse.
Historical group
This attribute group is not part of the default historical group, and is eligible for
use with Tivoli Data Warehouse.
Attribute descriptions
The following list contains information about each attribute in the Enterprise
Hyper-V Summary attribute group:
Node attribute - This attribute is a key attribute.
Description
The managed system name of the agent.
Type String
Timestamp attribute
Description
The local time at the agent when the data was collected.
Type String
SystemProcessorUtilization attribute
Chapter 4. Attributes reference 33
Description
The percentage of the processor that is utilized by the Hyper-V
system.
Type Integer (Gauge) with enumerated values. The strings are displayed
in the Tivoli Enterprise Portal. The warehouse and queries return
the values shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
MemoryAvailable attribute
Description
The memory available in percentage on the Hyper-V system.
Type Integer (Gauge) with enumerated values. The strings are displayed
in the Tivoli Enterprise Portal. The warehouse and queries return
the values shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
MemoryUtilized attribute
Description
The percentage of memory that is utilized by the Hyper-V system.
Type Integer (Gauge) with enumerated values. The strings are displayed
in the Tivoli Enterprise Portal. The warehouse and queries return
the values shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
DiskReadLatency attribute
Description
The latency of the read operations on the disk, in milliseconds.
Type Integer (Gauge) with enumerated values. The strings are displayed
in the Tivoli Enterprise Portal. The warehouse and queries return
the values shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
DiskWriteLatency attribute
Description
The latency of the write operations on the disk, in milliseconds.
Type Integer (Gauge) with enumerated values. The strings are displayed
34 Monitoring Agent for Microsoft Hyper-V Server: Users Guide
in the Tivoli Enterprise Portal. The warehouse and queries return
the values shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
NetworkUtilization attribute
Description
Maximum network utilization by the network interface
Type Integer (Gauge) with enumerated values. The strings are displayed
in the Tivoli Enterprise Portal. The warehouse and queries return
the values shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
MaxLogicalProcessor attribute
Description
The maximum processor utilization in percentage by the logical
processor.
Type Integer (Gauge) with enumerated values. The strings are displayed
in the Tivoli Enterprise Portal. The warehouse and queries return
the values shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
MaxVirtualProcessor attribute
Description
The maximum virtual processor utilization in percentage by the
virtual machine.
Type Integer (Gauge) with enumerated values. The strings are displayed
in the Tivoli Enterprise Portal. The warehouse and queries return
the values shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Event Log attribute group
The Event Log attribute group provides information about the critical, error, and
warning events that are specific to the Hyper-V system. If the warehouse default
setting is enabled, data for this attribute group is not stored in Tivoli Data
Warehouse.
Chapter 4. Attributes reference 35
Historical group
This attribute group is not part of the default historical group, and is eligible for
use with Tivoli Data Warehouse.
Attribute descriptions
The following list contains information about each attribute in the Event Log
attribute group:
Node attribute - This attribute is a key attribute.
Description
The managed system name of the agent.
Type String
Timestamp attribute
Description
The local time at the agent when the data was collected.
Type String
Log Name attribute
Description
The name of the event log for a specific application.
Type String
Event Source attribute
Description
The event source that is defined by the Hyper-V server role.
Type String
Event ID attribute
Description
The ID of the event.
Type Integer (Gauge) with enumerated values. The strings are displayed
in the Tivoli Enterprise Portal. The warehouse and queries return
the values shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Event Type attribute
Description
The type of the event, for example, Critical, Error, and Warning.
Type Integer with enumerated values. The strings are displayed in the
Tivoli Enterprise Portal. The warehouse and queries return the
values shown in parentheses. The following values are defined:
v Critical (1)
v Error (2)
v Warning (3)
v Information (4)
36 Monitoring Agent for Microsoft Hyper-V Server: Users Guide
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Event Category attribute
Description
The task category of the event.
Type Integer with enumerated values. The strings are displayed in the
Tivoli Enterprise Portal. The warehouse and queries return the
values shown in parentheses. The following values are defined:
v None (0)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Time Generated attribute
Description
The time when the event is generated.
Type String
Message attribute
Description
The description of the event.
Type String
Hyper-V Hypervisor Logical Processor attribute group
The Hyper-V Hypervisor Logical Processor attribute group provides information
about the logical processors of the hypervisor. If the warehouse default setting is
enabled, data for this attribute group is stored in Tivoli Data Warehouse.
Historical group
This attribute group is part of the default historical group, and is eligible for use
with Tivoli Data Warehouse.
Attribute descriptions
The following list contains information about each attribute in the Hyper-V
Hypervisor Logical Processor attribute group:
Node attribute - This attribute is a key attribute.
Description
The managed system name of the agent.
Type String
Timestamp attribute
Description
The local time at the agent when the data was collected.
Type String
Percent C1 Time attribute
Description
The percentage of time for which the processor is in the C1
low-power idle state.
Chapter 4. Attributes reference 37
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Percent C2 Time attribute
Description
The percentage of time for which the processor is in the C2
low-power idle state.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Percent C3 Time attribute
Description
The percentage of time for which the processor is in the C3
low-power idle state.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Percent Guest Run Time attribute
Description
The percentage of time that the guest code takes to run on a logical
processor.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Percent Hypervisor Run Time attribute
38 Monitoring Agent for Microsoft Hyper-V Server: Users Guide
Description
The percentage of time that the hypervisor takes to run on a logical
processor.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Percent Idle Time attribute
Description
The percentage of time for which the logical processor is idle.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Percent Total Run Time attribute
Description
The percentage of the total runtime on each virtual processor,
where total runtime is the sum of the Percentage Guest Time and
the Percentage Hypervisor Runtime attributes.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
C1 Transitions Per Sec attribute
Description
The rate at which the processor entered the C1 low-power idle
state.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Chapter 4. Attributes reference 39
C2 Transitions Per Sec attribute
Description
The rate at which the processor entered the C2 low-power idle
state.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
C3 Transitions Per Sec attribute
Description
The rate at which the processor entered the C3 low-power idle
state.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Context Switches Per Sec attribute
Description
The rate at which the virtual processor switches context.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Hardware Interrupts Per Sec attribute
Description
The rate of hardware interrupts (excluding the hypervisor
interrupts) to the processor.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
40 Monitoring Agent for Microsoft Hyper-V Server: Users Guide
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Inter Processor Interrupts Per Sec attribute
Description
The rate at which the processor sends the interprocessor interrupts.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Inter Processor Interrupts Sent Per Sec attribute
Description
The rate at which the hypervisor inter-processor interrupts are
delivered to the processor.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Monitor Transition Cost In NS attribute
Description
The cost in nanoseconds to monitor a transition.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Monitor Transition Cost In MS attribute
Description
The cost in microseconds to monitor a transition.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Chapter 4. Attributes reference 41
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Scheduler Interrupts Per Sec attribute
Description
The rate at which the hypervisor scheduler interrupts the
processor.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Timer Interrupts Per Sec attribute
Description
The rate at which the hypervisor timer interrupts the processor.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Total Interrupts Per Sec attribute
Description
The total number of interrupts that the logical processor processes.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Name attribute - This attribute is a key attribute.
Description
The name of the instance.
Type String
42 Monitoring Agent for Microsoft Hyper-V Server: Users Guide
Hyper-V Hypervisor Partition attribute group
The Hyper-V Hypervisor Partition attribute group provides information about the
virtual processors, memory space, and so on of the virtual machines. If the
warehouse default setting is enabled, data for this attribute group is stored in
Tivoli Data Warehouse.
Historical group
This attribute group is part of the default historical group, and is eligible for use
with Tivoli Data Warehouse.
Attribute descriptions
The following list contains information about each attribute in the Hyper-V
Hypervisor Partition attribute group:
Node attribute - This attribute is a key attribute.
Description
The managed system name of the agent.
Type String
Timestamp attribute
Description
The local time at the agent when the data was collected.
Type String
Address Spaces attribute
Description
The number of address spaces in the virtual Translation Lookaside
Buffer (TLB) of the partition.
Type Integer (Gauge) with enumerated values. The strings are displayed
in the Tivoli Enterprise Portal. The warehouse and queries return
the values shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Deposited Pages attribute
Description
The number of pages that are deposited in the partition.
Type Integer (Gauge) with enumerated values. The strings are displayed
in the Tivoli Enterprise Portal. The warehouse and queries return
the values shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
GPA Pages attribute
Chapter 4. Attributes reference 43
Description
The number of pages that are present in the Guest Physical
Address (GPA) space of the partition.
Type Integer (Gauge) with enumerated values. The strings are displayed
in the Tivoli Enterprise Portal. The warehouse and queries return
the values shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
GPA Space Modifications Per Sec attribute
Description
The rate at which modifications are made to the GPA space of the
partition.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Virtual Processors attribute
Description
The number of virtual processors that are present in the partition.
Type Integer (Numeric Property) with enumerated values. The strings
are displayed in the Tivoli Enterprise Portal. The warehouse and
queries return the values shown in parentheses. The following
values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Virtual TLB Flush Entires Per Sec attribute
Description
The rate at which the virtual TLB is flushed.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Virtual TLB Pages attribute
44 Monitoring Agent for Microsoft Hyper-V Server: Users Guide
Description
The number of pages that are used by the virtual TLB of the
partition.
Type Integer (Gauge) with enumerated values. The strings are displayed
in the Tivoli Enterprise Portal. The warehouse and queries return
the values shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Name attribute - This attribute is a key attribute.
Description
The name of the instance.
Type String
Hyper-V Hypervisor Root Partition attribute group
The Hyper-V Hypervisor Root Partition attribute group provides information about
the virtual processors, memory space, and so on of the root partition. If the
warehouse default setting is enabled, data for this attribute group is not stored in
Tivoli Data Warehouse.
Historical group
This attribute group is not part of the default historical group, and is eligible for
use with Tivoli Data Warehouse.
Attribute descriptions
The following list contains information about each attribute in the Hyper-V
Hypervisor Root Partition attribute group:
Node attribute - This attribute is a key attribute.
Description
The managed system name of the agent.
Type String
Timestamp attribute
Description
The local time at the agent when the data was collected.
Type String
Address Spaces attribute
Description
The number of address spaces in the virtual TLB of the partition.
Type Integer (Gauge) with enumerated values. The strings are displayed
in the Tivoli Enterprise Portal. The warehouse and queries return
the values shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Chapter 4. Attributes reference 45
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Deposited Pages attribute
Description
The number of pages that are deposited in the partition.
Type Integer (Gauge) with enumerated values. The strings are displayed
in the Tivoli Enterprise Portal. The warehouse and queries return
the values shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Virtual Processors attribute
Description
The number of virtual processors that exist in the partition.
Type Integer (Numeric Property) with enumerated values. The strings
are displayed in the Tivoli Enterprise Portal. The warehouse and
queries return the values shown in parentheses. The following
values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Virtual TLB Flush Entires Per Sec attribute
Description
The rate at which virtual TLB pages are flushed.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Virtual TLB Pages attribute
Description
The number of pages that are used by the virtual TLB in the
partition.
Type Integer (Gauge) with enumerated values. The strings are displayed
in the Tivoli Enterprise Portal. The warehouse and queries return
the values shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
46 Monitoring Agent for Microsoft Hyper-V Server: Users Guide
Name attribute - This attribute is a key attribute.
Description
The name of the instance.
Type String
Hyper-V Hypervisor Root Virtual Processor attribute group
The Hyper-V Hypervisor Root Virtual Processor attribute group provides
information about the root virtual processor of the hypervisor. If the warehouse
default setting is enabled, data for this attribute group is not stored in Tivoli Data
Warehouse.
Historical group
This attribute group is not part of the default historical group, and is eligible for
use with Tivoli Data Warehouse.
Attribute descriptions
The following list contains information about each attribute in the Hyper-V
Hypervisor Root Virtual Processor attribute group:
Node attribute - This attribute is a key attribute.
Description
The managed system name of the agent.
Type String
Timestamp attribute
Description
The local time at the agent when the data was collected.
Type String
Percent Guest Run Time attribute
Description
The percentage of time that the root virtual processor takes to run
the non-hypervisor code on a logical processor.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Percent Hypervisor Run Time attribute
Description
The percentage of time that the root virtual processor takes to run
the hypervisor code on a logical processor.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Chapter 4. Attributes reference 47
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Percent Total Run Time attribute
Description
The percentage of the total runtime on each virtual processor,
where total runtime is the sum of the Percentage Guest Runtime
and the Percentage Hypervisor Runtime attributes.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
CPUID Instructions Per Sec attribute
Description
The rate at which the guest code runs the CPU Identification
(CPUID) instructions on the root virtual processor.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
CPUID Instructions Cost In NS attribute
Description
The average time spent in nanoseconds to process a CPUID
instruction.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
CPUID Instructions Cost In MS attribute
48 Monitoring Agent for Microsoft Hyper-V Server: Users Guide
Description
The average time spent in microseconds to process a CPUID
instruction.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
GPA Space Hypercalls Per Sec attribute
Description
The rate at which the guest code makes the GPA space hypercalls
on the root virtual processor.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Guest Page Table Maps Per Sec attribute
Description
The rate at which the map operations are performed on the guest
page table.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Page Fault Intercepts Per Sec attribute
Description
The rate at which the hypervisor intercepts page fault exceptions
while running the guest code on the root virtual processor.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Chapter 4. Attributes reference 49
Page Invalidations Per Sec attribute
Description
The rate at which the guest code runs the Invalid TLB Entry
(INVLPG) instructions on the root virtual processor.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Page Invalidations Cost In NS attribute
Description
The average time spent in nanoseconds to process an INVLPG
instruction.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Page Invalidations Cost In MS attribute
Description
The average time spent in microseconds to process an INVLPG
instruction.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Total Intercepts Per Sec attribute
Description
The rate at which the total intercepts are made.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
50 Monitoring Agent for Microsoft Hyper-V Server: Users Guide
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Total Intercepts Cost In NS attribute
Description
The average time spent in nanoseconds to process the total number
of interrupts.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Total Intercepts Cost In MS attribute
Description
The average time spent in microseconds to process the total
number of interrupts.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Total Messages Per Sec attribute
Description
The rate at which messages are sent and received .
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Virtual Interrupt Hypercalls Per Sec attribute
Description
The rate at which the guest code makes virtual interrupt hypercalls
on the root virtual processor.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
Chapter 4. Attributes reference 51
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Virtual Interrupts Per Sec attribute
Description
The rate at which the virtual interrupts are delivered to the root
virtual processor.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Virtual MMU Hypercalls Per Sec attribute
Description
The rate at which the guest code makes virtual Memory
Management Unit (MMU) hypercalls on the root virtual processor.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Virtual Processor Hypercalls Per Sec attribute
Description
The rate at which the guest code makes virtual processor
hypercalls on the root virtual processor.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Name attribute - This attribute is a key attribute.
Description
The name of the instance.
Type String
52 Monitoring Agent for Microsoft Hyper-V Server: Users Guide
Hyper-V Hypervisor Root Virtual Processor More attribute group
The Hyper-V Hypervisor Root Virtual Processor More attribute group provides
information about the root virtual processor of the hypervisor. If the warehouse
default setting is enabled, data for this attribute group is not stored in Tivoli Data
Warehouse.
Historical group
This attribute group is not part of the default historical group, and is eligible for
use with Tivoli Data Warehouse.
Attribute descriptions
The following list contains information about each attribute in the Hyper-V
Hypervisor Root Virtual Processor More attribute group:
Node attribute - This attribute is a key attribute.
Description
The managed system name of the agent.
Type String
Timestamp attribute
Description
The local time at the agent when the data was collected.
Type String
Address Domain Flushes Per Sec attribute
Description
The rate at which the guest code flushes the virtual TLB on the
root virtual processor.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Address Space Evictions Per Sec attribute
Description
The rate at which the address space is evicted from the virtual
TLB.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Chapter 4. Attributes reference 53
Address Space Flushes Per Sec attribute
Description
The rate at which the guest code flushes an address space on the
root virtual processor.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Address Space Switches Per Sec attribute
Description
The rate at which the guest code switches an address space on the
root virtual processor.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
APIC EOI Accesses Per Sec attribute
Description
The rate at which the guest code writes the Advanced
Programmable Interrupt Controller (APIC) End of Interrupt (EOI)
register on the root virtual processor.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
APIC IPIs Sent Per Sec attribute
Description
The rate at which the root virtual processor sends the APIC
interprocessor interrupts.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
54 Monitoring Agent for Microsoft Hyper-V Server: Users Guide
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
APIC MMIO Accesses Per Sec attribute
Description
The rate at which the guest code accesses the APIC
Memory-Mapped I/O (MMIO) register on the root virtual
processor.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
APIC Self IPIs Sent Per Sec attribute
Description
The rate at which the root virtual processor sends the APIC
interrupts to itself.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
APIC TPR Accesses Per Sec attribute
Description
The rate at which the guest code accesses the APIC Task Priority
Register (TPR) on the root virtual processor.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Control Register Accesses Per Sec attribute
Description
The rate at which the guest code accesses the control register on
the root virtual processor.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
Chapter 4. Attributes reference 55
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Control Register Accesses Cost In NS attribute
Description
The average time spent in nanoseconds to access the control
register.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Control Register Accesses Cost In MS attribute
Description
The average time spent in microseconds to access the control
register.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Debug Register Accesses Per Sec attribute
Description
The rate at which the guest code accesses the debug register on the
root virtual processor.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Debug Register Accesses Cost In NS attribute
Description
The average time spent in nanoseconds to handle an access to the
debug register.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
56 Monitoring Agent for Microsoft Hyper-V Server: Users Guide
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Debug Register Accesses Cost In MS attribute
Description
The average time spent in microseconds to handle an access to the
debug register.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Emulated Instructions Per Sec attribute
Description
The rate at which the guest code emulates the instructions on the
root virtual processor.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Emulated Instructions Cost In NS attribute
Description
The average time spent in nanoseconds to emulate an instruction.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Emulated Instructions Cost In MS attribute
Description
The average time spent in microseconds to emulate an instruction.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Chapter 4. Attributes reference 57
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
External Interrupts Per Sec attribute
Description
The rate at which the hypervisor receives external interrupts while
executing the guest code on the root virtual processor.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
External Interrupts Cost In NS attribute
Description
The average time spent in nanoseconds to process an external
interrupt.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
External Interrupts Cost In MS attribute
Description
The average time spent in microseconds to process an external
interrupt.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Global GVA Range Flushes Per Sec attribute
Description
The rate at which the guest code flushes a virtual address range in
all the address spaces on the root virtual processor.
58 Monitoring Agent for Microsoft Hyper-V Server: Users Guide
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
HLT Instructions Per Sec attribute
Description
The rate at which the guest code runs the Halt (HLT) instructions
on the root virtual processor.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
HLT Instructions Cost In NS attribute
Description
The average spent time in nanoseconds to process an HLT
instruction.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
HLT Instructions Cost In MS attribute
Description
The average time spent in microseconds to process an HLT
instruction.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Hypercalls Per Sec attribute
Chapter 4. Attributes reference 59
Description
The rate at which the guest code makes hypercalls on the root
virtual processor.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Hypercalls Cost In NS attribute
Description
The average time spent in nanoseconds to process a hypercall.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Hypercalls Cost In Ms attribute
Description
The average time spent in microseconds to process a hypercall.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
IO Instructions Per Sec attribute
Description
The rate at which the guest code runs the I/O instructions on the
root virtual processor.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
IO Instructions Cost In NS attribute
60 Monitoring Agent for Microsoft Hyper-V Server: Users Guide
Description
The average time spent in nanoseconds to process an I/O
instruction.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
IO Instructions Cost In MS attribute
Description
The average time spent in microseconds to process an I/O
instruction.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
IO Intercept Messages Per Sec attribute
Description
The rate at which the I/O intercept messages are sent to the parent
partition.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Large Page TLB Fills Per Sec attribute
Description
The rate of the virtual TLB misses on large pages.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Chapter 4. Attributes reference 61
Local Flushed GVA Ranges Per Sec attribute
Description
The rate at which the guest code flushes a virtual address range in
all the address spaces on the root virtual processor.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Logical Processor Hypercalls Per Sec attribute
Description
The rate at which the logical processor runs the hypercalls.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Logical Processor Migrations Per Sec attribute
Description
The rate at which the root virtual processor migrates to a different
logical processor.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Long Spin Wait Hypercalls Per Sec attribute
Description
The rate at which the guest code makes the Long Spin Wait
hypercalls on the root virtual processor.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
62 Monitoring Agent for Microsoft Hyper-V Server: Users Guide
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Memory Intercept Messages Per Sec attribute
Description
The rate at which the memory intercept messages are sent to the
parent partition.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
MSR Accesses Per Sec attribute
Description
The rate at which the guest code runs the Model Specific Register
(MSR) instructions on the root virtual processor.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
MSR Accesses Cost In NS attribute
Description
The average time spent in nanoseconds to process a MSR
instruction.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
MSR Accesses Cost In MS attribute
Description
The average time spent in microseconds to process a MSR
instruction.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
Chapter 4. Attributes reference 63
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
MWAIT Instructions Per Sec attribute
Description
The rate at which the guest code runs the Monitor Wait (MWAIT)
instructions on the root virtual processor.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
MWAIT Instructions Cost In NS attribute
Description
The average time spent in nanoseconds to process a MWAIT
instruction.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
MWAIT Instructions Cost In MS attribute
Description
The average time spent in microseconds to process a MWAIT
instruction.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Other Hypercalls Per Sec attribute
Description
The rate at which the hypercalls are run.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
64 Monitoring Agent for Microsoft Hyper-V Server: Users Guide
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Other Intercepts Per Sec attribute
Description
The rate at which the guest code triggeres the other intercepts on
the root virtual processor.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Other Intercepts Cost In NS attribute
Description
The average time spent in nanoseconds to process the other
intercepts.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Other Intercepts Cost In MS attribute
Description
The average time spent in microseconds to process the other
intercepts.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Other Messages Per Sec attribute
Description
The rate at which the other intercept messages are sent to the
parent partition.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Chapter 4. Attributes reference 65
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Page Fault Intercepts Cost In NS attribute
Description
The average time spent in nanoseconds to process a page fault
intercept.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Page Fault Intercepts Cost In MS attribute
Description
The average time spent in microseconds to process a page fault
intercept.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Page Table Allocations Per Sec attribute
Description
The rate at which the page tables are allocated in the virtual TLB.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Page Table Eviction Per Sec attribute
Description
The rate at which the page tables are evicted from the virtual TLB.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
66 Monitoring Agent for Microsoft Hyper-V Server: Users Guide
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Page Table Reclamations Per Sec attribute
Description
The rate at which the unreferenced page tables are recovered in the
virtual TLB.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Page Table Resets Per Sec attribute
Description
The rate at which the page table is reset in the virtual TLB.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Page Table Validations Per Sec attribute
Description
The rate at which the page table validations remove old entries in
the virtual TLB.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Page Table Write Intercepts Per Sec attribute
Description
The rate at which the guest code sends write intercepts to the guest
page tables on the root virtual processor.
Type Real number (Gauge) with 2 decimal places of precision with
Chapter 4. Attributes reference 67
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Pending Interrupts Per Sec attribute
Description
The rate at which interrupts are pending on the root virtual
processor because of a TPR made by the guest code.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Pending Interrupts Cost In NS attribute
Description
The average time spent in nanoseconds to process a pending
interrupt intercept.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Pending Interrupts Cost In MS attribute
Description
The average time spent in microseconds to process a pending
interrupt intercept.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Reflected Guest Page Faults Per Sec attribute
68 Monitoring Agent for Microsoft Hyper-V Server: Users Guide
Description
The rate at which the page fault exceptions are delivered to the
guest code.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Small Page TLB Fills Per Sec attribute
Description
The rate of the virtual TLB misses on the virtual pages.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Synthetic Interrupt Hypercalls Per Sec attribute
Description
The rate at which the guest code makes the synthetic interrupts
hypercalls on the root virtual processor.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Synthetic Interrupts Per Sec attribute
Description
The rate at which synthetic interrupts are delivered to the root
virtual processor.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Chapter 4. Attributes reference 69
Name attribute - This attribute is a key attribute.
Description
The name of the instance.
Type String
Hyper-V Hypervisor Virtual Processor attribute group
The Hyper-V Hypervisor Virtual Processor attribute group provides information
about the virtual processor that is assigned to the virtual machines. If the
warehouse default setting is enabled, data for this attribute group is stored in
Tivoli Data Warehouse.
Historical group
This attribute group is part of the default historical group, and is eligible for use
with Tivoli Data Warehouse.
Attribute descriptions
The following list contains information about each attribute in the Hyper-V
Hypervisor Virtual Processor attribute group:
Node attribute - This attribute is a key attribute.
Description
The managed system name of the agent.
Type String
Timestamp attribute
Description
The local time at the agent when the data was collected.
Type String
Percent Guest Run Time attribute
Description
The percentage of time that the guest virtual processor takes to run
the non-hypervisor code on a logical processor.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Percent Hypervisor Run Time attribute
Description
The percentage of time that the guest virtual processor takes to run
the hypervisor code on a logical processor.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
70 Monitoring Agent for Microsoft Hyper-V Server: Users Guide
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Percent Total Run Time attribute
Description
The sum of the values of the Percentage Guest Run Time and
Percentage Hypervisor Run Time attributes on an individual
virtual processor.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
CPUID Instructions Per Sec attribute
Description
The rate at which the guest code runs CPUID instructions on the
virtual processor.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
CPUID Instructions Cost In NS attribute
Description
The average time spent in nanoseconds to process a CPUID
instruction.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
CPUID Instructions Cost In MS attribute
Chapter 4. Attributes reference 71
Description
The average time spent in microseconds to process a CPUID
instruction.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
GPA Space Hypercalls Per Sec attribute
Description
The rate at which the guest code makes GPA space hypercalls on
the virtual processor.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Guest Page Table Maps Per Sec attribute
Description
The rate at which the map operations are performed on the guest
page table
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Page Fault Intercepts Per Sec attribute
Description
The rate at which the hypervisor intercepts page fault exceptions
while running the guest code on the virtual processor.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
72 Monitoring Agent for Microsoft Hyper-V Server: Users Guide
Page Fault Intercepts Cost In NS attribute
Description
The average time spent in nanoseconds to process a page fault
intercept.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Page Fault Intercepts Cost In MS attribute
Description
The average time spent in microseconds to process a page fault
intercept.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Page Invalidations Per Sec attribute
Description
The rate at which the guest code runs the INVLPG instructions on
the virtual processor.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Page Invalidations Cost In NS attribute
Description
The average time spent in nanoseconds to process an INVLPG
instruction.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Chapter 4. Attributes reference 73
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Page Invalidations Cost In MS attribute
Description
The average time spent in microseconds to process an INVLPG
instruction.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Total Intercepts Per Sec attribute
Description
The rate at which the guest code processes total intercepts on the
virtual processor.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Total Intercepts Cost In NS attribute
Description
The average time spent in nanoseconds to process the total number
of intercepts.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Total Intercepts Cost In MS attribute
Description
The average time spent in microseconds to process the total
number of intercepts.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
74 Monitoring Agent for Microsoft Hyper-V Server: Users Guide
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Total Messages Per Sec attribute
Description
The rate at which the guest code processes the total messages on
the virtual processor.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Virtual Interrupt Hypercalls Per Sec attribute
Description
The rate at which hypercall virtual interrupts occur.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Virtual Interrupts Per Sec attribute
Description
The rate at which virtual interrupts are delivered to the virtual
processor.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Virtual MMU Hypercalls Per Sec attribute
Description
The rate of the virtual MMU hypercalls.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
Chapter 4. Attributes reference 75
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Virtual Processor Hypercalls Per Sec attribute
Description
The rate at which the guest code makes virtual processor
hypercalls on the virtual processor.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Name attribute - This attribute is a key attribute.
Description
The name of the instance.
Type String
Hyper-V Hypervisor Virtual Processor More attribute group
The Hyper-V Hypervisor Virtual Processor More attribute group provides
information about the virtual processor that is assigned to virtual machines. If the
warehouse default setting is enabled, data for this attribute group is stored in
Tivoli Data Warehouse.
Historical group
This attribute group is part of the default historical group, and is eligible for use
with Tivoli Data Warehouse.
Attribute descriptions
The following list contains information about each attribute in the Hyper-V
Hypervisor Virtual Processor More attribute group:
Node attribute - This attribute is a key attribute.
Description
The managed system name of the agent.
Type String
Timestamp attribute
Description
The local time at the agent when the data was collected.
Type String
Address Domain Flushes Per Sec attribute
Description
The rate at which the guest code flushes the virtual TLB on the
virtual processor.
76 Monitoring Agent for Microsoft Hyper-V Server: Users Guide
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Address Space Evictions Per Sec attribute
Description
The rate at which the address space is evicted from the virtual
TLB.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Address Space Flushes Per Sec attribute
Description
The rate at which the guest code flushes the address space on the
virtual processor.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Address Space Switches Per Sec attribute
Description
The rate at which the guest code switches the address space on the
virtual processor.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
APIC EOI Accesses Per Sec attribute
Chapter 4. Attributes reference 77
Description
The rate at which the guest code writes the APIC EOI register on
the virtual processor.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
APIC IPIs Sent Per Sec attribute
Description
The rate at which the virtual processor sends APIC interprocessor
interrupts.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
APIC MMIO Accesses Per Sec attribute
Description
The rate at which the guest code accesses the APIC MMIO
registers on the virtual processor.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
APIC Self IPIs Sent Per Sec attribute
Description
The rate at which the virtual processor sends APIC interrupts to
itself.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
78 Monitoring Agent for Microsoft Hyper-V Server: Users Guide
APIC TPR Accesses Per Sec attribute
Description
The rate at which the guest code accesses the APIC TPR on the
virtual processor.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Control Register Accesses Per Sec attribute
Description
The rate at which the guest code accesses the control register on
the virtual processor.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Control Register Accesses Cost In NS attribute
Description
The average time spent in nanoseconds to process a control register
access.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Control Register Accesses Cost In MS attribute
Description
The average time spent in microseconds to process a control
register access.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Chapter 4. Attributes reference 79
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Debug Register Accesses Per Sec attribute
Description
The rate at which the guest code accesses the debug register on the
virtual processor.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Debug Register Accesses Cost In NS attribute
Description
The average time spent in nanoseconds to handle an access to the
debug register.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Debug Register Accesses Cost In MS attribute
Description
The average time spent in microseconds to handle an access to the
debug register.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Emulated Instructions Per Sec attribute
Description
The rate at which the instructions are emulated while running the
guest code on the virtual processor.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
80 Monitoring Agent for Microsoft Hyper-V Server: Users Guide
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Emulated Instructions Cost In NS attribute
Description
The average time spent in nanoseconds to emulate an instruction.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Emulated Instructions Cost In MS attribute
Description
The average time spent in microseconds to emulate an instruction.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
External Interrupts Per Sec attribute
Description
The rate at which the hypervisor receives external interrupts while
executing the guest code on the root virtual processor.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
External Interrupts Cost In NS attribute
Description
The average time spent in nanoseconds to process an external
interrupt.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
Chapter 4. Attributes reference 81
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
External Interrupts Cost In MS attribute
Description
The average time spent in microseconds to process an external
interrupt.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Global GVA Range Flushes Per Sec attribute
Description
The rate at which the guest code flushes an address range (in all
the address spaces) on the virtual processor.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
HLT Instructions Per Sec attribute
Description
The rate at which the guest code runs HLT instructions on the
virtual processor.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
HLT Instructions Cost In NS attribute
Description
The average time spent in nanoseconds to process an HLT
instruction.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
82 Monitoring Agent for Microsoft Hyper-V Server: Users Guide
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
HLT Instructions Cost In MS attribute
Description
The average time spent in microseconds to process an HLT
instruction.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Hypercalls Per Sec attribute
Description
The rate at which the guest code makes hypercalls on the virtual
processor.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Hypercalls Cost In NS attribute
Description
The average time spent in nanoseconds to process a hypercall.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Hypercalls Cost In MS attribute
Description
The average time spent in microseconds to process a hypercall.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Chapter 4. Attributes reference 83
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
IO Instructions Per Sec attribute
Description
The rate at which the guest code runs I/O instructions on the
virtual processor.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
IO Instructions Cost In NS attribute
Description
The average time spent in nanoseconds to process an I/O
instruction.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
IO Instructions Cost In MS attribute
Description
The average time spent in microseconds to process an I/O
instruction.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
IO Intercept Messages Per Sec attribute
Description
The rate at which the I/O intercept messages are sent to the parent
partition.
84 Monitoring Agent for Microsoft Hyper-V Server: Users Guide
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Large Page TLB Fills Per Sec attribute
Description
The rate of the virtual TLB misses on the large pages.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Local Flushed GVA Ranges Per Sec attribute
Description
The rate at which the guest code flushes a virtual address range in
an address space on the virtual processor.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Logical Processor Hypercalls Per Sec attribute
Description
The rate at which the logical processor runs the hypercalls.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Logical Processor Migrations Per Sec attribute
Description
The rate at which the virtual processor migrates to a different
logical processor.
Chapter 4. Attributes reference 85
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Long Spin Wait Hypercalls Per Sec attribute
Description
The rate at which the guest code makes the Long Spin Wait
hypercalls on the virtual processor.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Memory Intercept Messages Per Sec attribute
Description
The rate at which the memory intercept messages are sent to the
parent partition.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
MSR Accesses Per Sec attribute
Description
The rate at which the guest code runs MSR instructions on the
virtual processor.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
MSR Accesses Cost In NS attribute
86 Monitoring Agent for Microsoft Hyper-V Server: Users Guide
Description
The average time spent in nanoseconds to process a MSR
instruction.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
MSR Accesses Cost In MS attribute
Description
The average time spent in microseconds to process a MSR
instruction.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
MWAIT Instructions Per Sec attribute
Description
The rate at which the guest code runs MWAIT instructions on the
virtual processor.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
MWAIT Instructions Cost In NS attribute
Description
The average time spent in nanoseconds to process a MWAIT
instruction.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Chapter 4. Attributes reference 87
MWAIT Instructions Cost In MS attribute
Description
The average time spent in microseconds to process a MWAIT
instruction.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Other Hypercalls Per Sec attribute
Description
The rate at which the hypercalls are run.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Other Intercepts Per Sec attribute
Description
The rate at which the guest code triggers the intercepts on the
virtual processor.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Other Intercepts Cost In NS attribute
Description
The average time spent in nanoseconds to process the other
intercepts.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
88 Monitoring Agent for Microsoft Hyper-V Server: Users Guide
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Other Intercepts Cost In MS attribute
Description
The average time spent in microseconds to process the other
intercepts.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Other Messages Per Sec attribute
Description
The rate at which the other messages are sent to the parent
partition.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Page Table Allocations Per Sec attribute
Description
The rate at which the page tables are allocated in the virtual TLB.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Page Table Eviction Per Sec attribute
Description
The rate at which the page tables are evicted from the virtual TLB.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Chapter 4. Attributes reference 89
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Page Table Reclamations Per Sec attribute
Description
The rate at which the unreferenced page tables are recovered in the
virtual TLB.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Page Table Resets Per Sec attribute
Description
The rate at which the page table is reset in the virtual TLB.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Page Table Validations Per Sec attribute
Description
The rate at which a page table is validated to remove the old
entries in the virtual TLB.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Page Table Write Intercepts Per Sec attribute
Description
The rate at which the guest code sends write intercepts to the guest
page tables on the virtual processor.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
90 Monitoring Agent for Microsoft Hyper-V Server: Users Guide
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Pending Interrupts Per Sec attribute
Description
The rate at which interrupts are pending on the virtual processor
because of a TPR made by the guest code.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Pending Interrupts Cost In NS attribute
Description
The average time spent in nanoseconds to process a pending
interrupt intercept.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Pending Interrupts Cost In MS attribute
Description
The average time spent in microseconds to process a pending
interrupt intercept.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Reflected Guest Page Faults Per Sec attribute
Description
The rate at which page fault exceptions are delivered to the guest
code.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Chapter 4. Attributes reference 91
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Small Page TLB Fills Per Sec attribute
Description
The rate of the virtual TLB misses on the virtual pages.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Synthetic Interrupt Hypercalls Per Sec attribute
Description
The rate at which the guest code makes the synthetic interrupts
hypercalls on the virtual processor.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Synthetic Interrupts Per Sec attribute
Description
The rate at which synthetic interrupts are delivered to the virtual
processor.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Name attribute - This attribute is a key attribute.
Description
The name of the instance.
Type String
92 Monitoring Agent for Microsoft Hyper-V Server: Users Guide
Hyper-V Legacy Network Adapter attribute group
The Hyper-V Legacy Network Adapter attribute group represents the ethernet
controller of the virtual machine. If the warehouse default setting is enabled, data
for this attribute group is stored in Tivoli Data Warehouse.
Historical group
This attribute group is part of the default historical group, and is eligible for use
with Tivoli Data Warehouse.
Attribute descriptions
The following list contains information about each attribute in the Hyper-V Legacy
Network Adapter attribute group:
Node attribute - This attribute is a key attribute.
Description
The managed system name of the agent.
Type String
Timestamp attribute
Description
The local time at the agent when the data was collected.
Type String
Bytes Dropped attribute
Description
The number of bytes that are dropped on the network adapter.
Type Integer (Gauge) with enumerated values. The strings are displayed
in the Tivoli Enterprise Portal. The warehouse and queries return
the values shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Bytes Received Per Sec attribute
Description
The number of bytes that are received per second on the network
adapter.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Bytes Sent Per Sec attribute
Chapter 4. Attributes reference 93
Description
The number of bytes that are sent per second on the network
adapter.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Frames Dropped attribute
Description
The number of frames that are dropped on the network adapter.
Type Integer (Gauge) with enumerated values. The strings are displayed
in the Tivoli Enterprise Portal. The warehouse and queries return
the values shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Frames Received Per Sec attribute
Description
The number of frames that are received per second on the network
adapter.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Frames Sent Per Sec attribute
Description
The number of frames that are sent per second over the network
adapter.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Name attribute - This attribute is a key attribute.
94 Monitoring Agent for Microsoft Hyper-V Server: Users Guide
Description
The name of the instance.
Type String
Hyper-V Summary attribute group
The Hyper-V Summary attribute group provides information about the physical
resource utilization by the Hyper-V system. If the warehouse default setting is
enabled, data for this attribute group is not stored in Tivoli Data Warehouse.
Historical group
This attribute group is not part of the default historical group, and is eligible for
use with Tivoli Data Warehouse.
Attribute descriptions
The following list contains information about each attribute in the Hyper-V
Summary attribute group:
Node attribute - This attribute is a key attribute.
Description
The managed system name of the agent.
Type String
Timestamp attribute
Description
The local time at the agent when the data was collected.
Type String
SystemProcessorUtilization attribute
Description
The percentage of the processor that is utilized by the Hyper-V
system.
Type Integer (Gauge) with enumerated values. The strings are displayed
in the Tivoli Enterprise Portal. The warehouse and queries return
the values shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
MemoryAvailable attribute
Description
The memory available in percentage on the Hyper-V system.
Type Integer (Gauge) with enumerated values. The strings are displayed
in the Tivoli Enterprise Portal. The warehouse and queries return
the values shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Chapter 4. Attributes reference 95
MemoryUtilized attribute
Description
The percentage of memory that is utilized by the Hyper-V system.
Type Integer (Gauge) with enumerated values. The strings are displayed
in the Tivoli Enterprise Portal. The warehouse and queries return
the values shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
DiskReadLatency attribute
Description
The latency of the read operations on the disk, in milliseconds.
Type Integer (Gauge) with enumerated values. The strings are displayed
in the Tivoli Enterprise Portal. The warehouse and queries return
the values shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
DiskWriteLatency attribute
Description
The latency of the write operations on the disk, in milliseconds.
Type Integer (Gauge) with enumerated values. The strings are displayed
in the Tivoli Enterprise Portal. The warehouse and queries return
the values shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
NetworkUtilization attribute
Description
Maximum network utilization by the network interface
Type Integer (Gauge) with enumerated values. The strings are displayed
in the Tivoli Enterprise Portal. The warehouse and queries return
the values shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
MaxLogicalProcessor attribute
Description
The maximum processor utilization in percentage by the logical
processor.
Type Integer (Gauge) with enumerated values. The strings are displayed
96 Monitoring Agent for Microsoft Hyper-V Server: Users Guide
in the Tivoli Enterprise Portal. The warehouse and queries return
the values shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
MaxVirtualProcessor attribute
Description
The maximum virtual processor utilization in percentage by the
virtual machine.
Type Integer (Gauge) with enumerated values. The strings are displayed
in the Tivoli Enterprise Portal. The warehouse and queries return
the values shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Hyper-V Task Manager Detail attribute group
The Hyper-V Task Manager Detail attribute group gives the summary statistics of
the Virtual Machine Management service and the Task Manager. If the warehouse
default setting is enabled, data for this attribute group is not stored in Tivoli Data
Warehouse.
Historical group
This attribute group is not part of the default historical group, and is eligible for
use with Tivoli Data Warehouse.
Attribute descriptions
The following list contains information about each attribute in the Hyper-V Task
Manager Detail attribute group:
Node attribute - This attribute is a key attribute.
Description
The managed system name of the agent.
Type String
Timestamp attribute
Description
The local time at the agent when the data was collected.
Type String
Add Resources Tasks Completed attribute
Description
The total number of the Add Resources Virtual Machine tasks that
are completed.
Type Integer (Counter) with enumerated values. The strings are
Chapter 4. Attributes reference 97
displayed in the Tivoli Enterprise Portal. The warehouse and
queries return the values shown in parentheses. The following
values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Add Resources Tasks In Progress attribute
Description
The number of the Add Resources Virtual Machine tasks that are in
progress.
Type Integer (Gauge) with enumerated values. The strings are displayed
in the Tivoli Enterprise Portal. The warehouse and queries return
the values shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Apply Snapshot Tasks Completed attribute
Description
The total number of the Apply Snapshot Virtual Machine tasks that
are completed.
Type Integer (Counter) with enumerated values. The strings are
displayed in the Tivoli Enterprise Portal. The warehouse and
queries return the values shown in parentheses. The following
values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Apply Snapshot Tasks In Progress attribute
Description
The number of the Apply Snapshot Virtual Machine tasks that are
in progress.
Type Integer (Gauge) with enumerated values. The strings are displayed
in the Tivoli Enterprise Portal. The warehouse and queries return
the values shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Clone Tasks Completed attribute
Description
The total number of the Clone Virtual Machine tasks that are
completed.
Type Integer (Counter) with enumerated values. The strings are
98 Monitoring Agent for Microsoft Hyper-V Server: Users Guide
displayed in the Tivoli Enterprise Portal. The warehouse and
queries return the values shown in parentheses. The following
values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Clone Tasks In Progress attribute
Description
The number of the Clone Virtual Machine tasks that are in
progress.
Type Integer (Gauge) with enumerated values. The strings are displayed
in the Tivoli Enterprise Portal. The warehouse and queries return
the values shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Create VSS Snapshot Set Tasks Completed attribute
Description
The total number of the Create VSS Snapshot Set tasks that are
completed.
Type Integer (Counter) with enumerated values. The strings are
displayed in the Tivoli Enterprise Portal. The warehouse and
queries return the values shown in parentheses. The following
values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Create VSS Snapshot Set Tasks In Progress attribute
Description
The number of the Create VSS Snapshot Set tasks that are in
progress.
Type Integer (Gauge) with enumerated values. The strings are displayed
in the Tivoli Enterprise Portal. The warehouse and queries return
the values shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Define Tasks Completed attribute
Description
The total number of the Define Virtual Machine tasks that are
completed.
Type Integer (Counter) with enumerated values. The strings are
Chapter 4. Attributes reference 99
displayed in the Tivoli Enterprise Portal. The warehouse and
queries return the values shown in parentheses. The following
values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Define Tasks In Progress attribute
Description
The number of the Define Virtual Machine tasks that are in
progress.
Type Integer (Counter) with enumerated values. The strings are
displayed in the Tivoli Enterprise Portal. The warehouse and
queries return the values shown in parentheses. The following
values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Destroy Snapshot Tasks Completed attribute
Description
The total number of the Destroy Snapshot Virtual Machine tasks
that are completed.
Type Integer (Counter) with enumerated values. The strings are
displayed in the Tivoli Enterprise Portal. The warehouse and
queries return the values shown in parentheses. The following
values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Destroy Snapshot Tasks In Progress attribute
Description
The number of the Destroy Snapshot Virtual Machine tasks that are
in progress.
Type Integer (Gauge) with enumerated values. The strings are displayed
in the Tivoli Enterprise Portal. The warehouse and queries return
the values shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Destroy Tasks Completed attribute
Description
The total number of the Destroy Virtual Machine tasks that are
completed.
100 Monitoring Agent for Microsoft Hyper-V Server: Users Guide
Type Integer (Counter) with enumerated values. The strings are
displayed in the Tivoli Enterprise Portal. The warehouse and
queries return the values shown in parentheses. The following
values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Destroy Tasks In Progress attribute
Description
The number of the Destroy Virtual Machine tasks that are in
progress.
Type Integer (Gauge) with enumerated values. The strings are displayed
in the Tivoli Enterprise Portal. The warehouse and queries return
the values shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Export Tasks Completed attribute
Description
The total number of the Export Virtual Machine tasks that are
completed.
Type Integer (Counter) with enumerated values. The strings are
displayed in the Tivoli Enterprise Portal. The warehouse and
queries return the values shown in parentheses. The following
values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Export Tasks In Progress attribute
Description
The number of the Export Virtual Machine tasks that are in
progress.
Type Integer (Gauge) with enumerated values. The strings are displayed
in the Tivoli Enterprise Portal. The warehouse and queries return
the values shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Import Tasks Completed attribute
Description
The total number of the Import Virtual Machine tasks that are
completed.
Chapter 4. Attributes reference 101
Type Integer (Counter) with enumerated values. The strings are
displayed in the Tivoli Enterprise Portal. The warehouse and
queries return the values shown in parentheses. The following
values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Import Tasks In Progress attribute
Description
The number of the Import Virtual Machine tasks that are in
progress.
Type Integer (Gauge) with enumerated values. The strings are displayed
in the Tivoli Enterprise Portal. The warehouse and queries return
the values shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Merge Disk Tasks Completed attribute
Description
The total number of the Merge Disk tasks that are completed.
Type Integer (Counter) with enumerated values. The strings are
displayed in the Tivoli Enterprise Portal. The warehouse and
queries return the values shown in parentheses. The following
values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Merge Disk Tasks In Progress attribute
Description
The number of the Merge Disk tasks that are in progress.
Type Integer (Gauge) with enumerated values. The strings are displayed
in the Tivoli Enterprise Portal. The warehouse and queries return
the values shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Migrate Tasks Completed attribute
Description
The total number of the Migrate Virtual Machine tasks that are
completed.
Type Integer (Counter) with enumerated values. The strings are
102 Monitoring Agent for Microsoft Hyper-V Server: Users Guide
displayed in the Tivoli Enterprise Portal. The warehouse and
queries return the values shown in parentheses. The following
values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Migrate Tasks In Progress attribute
Description
The number of the Migrate Virtual Machine tasks that are in
progress.
Type Integer (Gauge) with enumerated values. The strings are displayed
in the Tivoli Enterprise Portal. The warehouse and queries return
the values shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Modify Resources Tasks Completed attribute
Description
The total number of the Modify Resources Virtual Machine tasks
that are completed.
Type Integer (Counter) with enumerated values. The strings are
displayed in the Tivoli Enterprise Portal. The warehouse and
queries return the values shown in parentheses. The following
values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Modify Resources Tasks In Progress attribute
Description
The number of the Modify Resources Virtual Machine tasks that
are in progress.
Type Integer (Gauge) with enumerated values. The strings are displayed
in the Tivoli Enterprise Portal. The warehouse and queries return
the values shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Modify Service Settings Tasks Complete attribute
Description
The total number of the Modify Service Settings tasks that are
completed.
Type Integer (Counter) with enumerated values. The strings are
Chapter 4. Attributes reference 103
displayed in the Tivoli Enterprise Portal. The warehouse and
queries return the values shown in parentheses. The following
values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Modify Service Settings Tasks In Progress attribute
Description
The number of the Modify Service Settings tasks that are in
progress.
Type Integer (Gauge) with enumerated values. The strings are displayed
in the Tivoli Enterprise Portal. The warehouse and queries return
the values shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Modify Tasks Completed attribute
Description
The total number of the Modify Virtual Machine tasks that are
completed.
Type Integer (Counter) with enumerated values. The strings are
displayed in the Tivoli Enterprise Portal. The warehouse and
queries return the values shown in parentheses. The following
values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Modify Tasks In Progress attribute
Description
The number of the Modify Virtual Machine tasks that are in
progress.
Type Integer (Gauge) with enumerated values. The strings are displayed
in the Tivoli Enterprise Portal. The warehouse and queries return
the values shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Pause Tasks Completed attribute
Description
The total number of the Pause Virtual Machine tasks that are
completed.
Type Integer (Counter) with enumerated values. The strings are
104 Monitoring Agent for Microsoft Hyper-V Server: Users Guide
displayed in the Tivoli Enterprise Portal. The warehouse and
queries return the values shown in parentheses. The following
values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Pause Tasks In Progress attribute
Description
The number of the Pause Virtual Machine tasks that are in
progress.
Type Integer (Gauge) with enumerated values. The strings are displayed
in the Tivoli Enterprise Portal. The warehouse and queries return
the values shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Remove Resources Tasks Completed attribute
Description
The total number of the Remove Resources Virtual Machine tasks
that are completed.
Type Integer (Counter) with enumerated values. The strings are
displayed in the Tivoli Enterprise Portal. The warehouse and
queries return the values shown in parentheses. The following
values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Remove Resources Tasks In Progress attribute
Description
The number of the Remove Resources Virtual Machine tasks that
are in progress.
Type Integer (Gauge) with enumerated values. The strings are displayed
in the Tivoli Enterprise Portal. The warehouse and queries return
the values shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Reset Tasks Completed attribute
Description
The total number of the Reset Virtual Machine tasks that are
completed.
Type Integer (Counter) with enumerated values. The strings are
Chapter 4. Attributes reference 105
displayed in the Tivoli Enterprise Portal. The warehouse and
queries return the values shown in parentheses. The following
values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Reset Tasks In Progress attribute
Description
The number of the Reset Virtual Machine tasks that are in progress.
Type Integer (Gauge) with enumerated values. The strings are displayed
in the Tivoli Enterprise Portal. The warehouse and queries return
the values shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Restore Tasks Completed attribute
Description
The total number of the Restore Virtual Machine tasks that are
completed.
Type Integer (Counter) with enumerated values. The strings are
displayed in the Tivoli Enterprise Portal. The warehouse and
queries return the values shown in parentheses. The following
values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Restore Tasks In Progress attribute
Description
The number of the Restore Virtual Machine tasks that are in
progress.
Type Integer (Gauge) with enumerated values. The strings are displayed
in the Tivoli Enterprise Portal. The warehouse and queries return
the values shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Resume Tasks Completed attribute
Description
The total number of the Resume Virtual Machine tasks that are
completed.
Type Integer (Counter) with enumerated values. The strings are
106 Monitoring Agent for Microsoft Hyper-V Server: Users Guide
displayed in the Tivoli Enterprise Portal. The warehouse and
queries return the values shown in parentheses. The following
values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Resume Tasks In Progress attribute
Description
The number of the Resume Virtual Machine tasks that are in
progress.
Type Integer (Gauge) with enumerated values. The strings are displayed
in the Tivoli Enterprise Portal. The warehouse and queries return
the values shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Save Tasks Completed attribute
Description
The total number of the Save Virtual Machine tasks that are
completed.
Type Integer (Counter) with enumerated values. The strings are
displayed in the Tivoli Enterprise Portal. The warehouse and
queries return the values shown in parentheses. The following
values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Save Tasks In Progress attribute
Description
The number of the Save Virtual Machine tasks that are in progress.
Type Integer (Gauge) with enumerated values. The strings are displayed
in the Tivoli Enterprise Portal. The warehouse and queries return
the values shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Shutdown Tasks Completed attribute
Description
The total number of the Shutdown Virtual Machine tasks that are
completed.
Type Integer (Counter) with enumerated values. The strings are
Chapter 4. Attributes reference 107
displayed in the Tivoli Enterprise Portal. The warehouse and
queries return the values shown in parentheses. The following
values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Shutdown Tasks In Progress attribute
Description
The number of the Shutdown Virtual Machine tasks that are in
progress.
Type Integer (Gauge) with enumerated values. The strings are displayed
in the Tivoli Enterprise Portal. The warehouse and queries return
the values shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Snapshot Tasks Completed attribute
Description
The total number of the Snapshot Virtual Machine tasks that are
completed.
Type Integer (Counter) with enumerated values. The strings are
displayed in the Tivoli Enterprise Portal. The warehouse and
queries return the values shown in parentheses. The following
values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Snapshot Tasks In Progress attribute
Description
The number of the Snapshot Virtual Machine tasks that are in
progress.
Type Integer (Gauge) with enumerated values. The strings are displayed
in the Tivoli Enterprise Portal. The warehouse and queries return
the values shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Start Tasks Completed attribute
Description
The total number of the Start Virtual Machine tasks that are
completed.
Type Integer (Counter) with enumerated values. The strings are
108 Monitoring Agent for Microsoft Hyper-V Server: Users Guide
displayed in the Tivoli Enterprise Portal. The warehouse and
queries return the values shown in parentheses. The following
values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Start Tasks In Progress attribute
Description
The number of the Start Virtual Machine tasks that are in progress.
Type Integer (Gauge) with enumerated values. The strings are displayed
in the Tivoli Enterprise Portal. The warehouse and queries return
the values shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Waiting to Start Tasks Completed attribute
Description
The total number of the Waiting To Start Virtual Machine tasks that
are completed.
Type Integer (Counter) with enumerated values. The strings are
displayed in the Tivoli Enterprise Portal. The warehouse and
queries return the values shown in parentheses. The following
values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Waiting to Start Tasks In Progress attribute
Description
The number of the Waiting To Start Virtual Machine tasks that are
in progress.
Type Integer (Gauge) with enumerated values. The strings are displayed
in the Tivoli Enterprise Portal. The warehouse and queries return
the values shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Hyper-V Task Manager Recent Time attribute group
The Hyper-V Task Manager Recent Time attribute group gives the summary
statistics of the Virtual Machine Management service and the Task Manager. If the
warehouse default setting is enabled, data for this attribute group is not stored in
Tivoli Data Warehouse.
Chapter 4. Attributes reference 109
Historical group
This attribute group is not part of the default historical group, and is eligible for
use with Tivoli Data Warehouse.
Attribute descriptions
The following list contains information about each attribute in the Hyper-V Task
Manager Recent Time attribute group:
Node attribute - This attribute is a key attribute.
Description
The managed system name of the agent.
Type String
Timestamp attribute
Description
The local time at the agent when the data was collected.
Type String
Waiting To Start Virtual Machine Tasks Recent Time In NS attribute
Description
The time spent in nanoseconds to perform the Waiting To Start
Virtual Machine tasks.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Waiting To Start Virtual Machine Tasks Recent Time In MS attribute
Description
The time spent in microseconds to perform the Waiting To Start
Virtual Machine tasks.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Add Resources Virtual Machine Tasks Recent Time In NS attribute
Description
The time spent in nanoseconds to perform the Add Resources
Virtual Machine tasks.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
110 Monitoring Agent for Microsoft Hyper-V Server: Users Guide
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Apply Snapshot Virtual Machine Tasks Recent Time In NS attribute
Description
The time spent in nanoseconds to perform the Apply Snapshot
Virtual Machine tasks.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Clone Virtual Machine Tasks Recent Time In NS attribute
Description
The time spent in nanoseconds to perform the Clone Virtual
Machine tasks.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Create VSS Snapshot Set Tasks Recent Time In NS attribute
Description
The time spent in nanoseconds to perform the Create VSS Snapshot
Set tasks.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Define Virtual Machine Tasks Recent Time In NS attribute
Description
The time spent in nanoseconds to perform the Define Virtual
Machine tasks.
Chapter 4. Attributes reference 111
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Destroy Snapshot Virtual Machine Tasks Recent Time In NS attribute
Description
The time spent in nanoseconds to perform the Destroy Snapshot
Virtual Machine tasks.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Destroy Virtual Machine Tasks Recent Time In NS attribute
Description
The time spent in nanoseconds to perform the Destroy Virtual
Machine tasks.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Export Virtual Machine Tasks Recent Time In NS attribute
Description
The time spent in nanoseconds to perform the Export Virtual
Machine tasks.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Import Virtual Machine Tasks Recent Time In NS attribute
112 Monitoring Agent for Microsoft Hyper-V Server: Users Guide
Description
The time spent in nanoseconds to perform the Import Virtual
Machine tasks.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Merge Disk Tasks Recent Time In NS attribute
Description
The time spent in nanoseconds to perform the Merge Disk tasks.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Migrate Virtual Machine Tasks Recent Time In NS attribute
Description
The time spent in nanoseconds to perform the Migrate Virtual
Machine tasks.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Modify Resources Virtual Machine Tasks Recent Time In NS attribute
Description
The time spent in nanoseconds to perform the Modify Resources
Virtual Machine tasks.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Chapter 4. Attributes reference 113
Modify Service Settings Tasks Recent Time In NS attribute
Description
The time spent in nanoseconds to perform the Modify Service
Settings tasks.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Modify Virtual Machine Tasks Recent Time In NS attribute
Description
The time spent in nanoseconds to perform the Modify Virtual
Machine tasks.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Pause Virtual Machine Tasks Recent Time In NS attribute
Description
The time spent in nanoseconds to perform the Pause Virtual
Machine tasks.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Remove Resources Virtual Machine Tasks Recent Time In NS attribute
Description
The time spent in nanoseconds to perform the Remove Resources
Virtual Machine tasks.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
114 Monitoring Agent for Microsoft Hyper-V Server: Users Guide
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Reset Virtual Machine Tasks Recent Time In NS attribute
Description
The time spent in nanoseconds to perform the Reset Virtual
Machine tasks.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Restore Virtual Machine Tasks Recent Time In NS attribute
Description
The time spent in nanoseconds to perform the Restore Virtual
Machine tasks.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Resume Virtual Machine Tasks Recent Time In NS attribute
Description
The time spent in nanoseconds to perform the Resume Virtual
Machine tasks.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Save Virtual Machine Tasks Recent Time In NS attribute
Description
The time spent in nanoseconds to perform the Save Virtual
Machine tasks.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
Chapter 4. Attributes reference 115
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Shutdown Virtual Machine Tasks Recent Time In NS attribute
Description
The time spent in nanoseconds to perform the Shutdown Virtual
Machine tasks.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Snapshot Virtual Machine Tasks Recent Time In NS attribute
Description
The time spent in nanoseconds to perform the Snapshot Virtual
Machine tasks.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Start Virtual Machine Tasks Recent Time In NS attribute
Description
The time spent in nanoseconds to perform the Start Virtual
Machine tasks.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Add Resources Virtual Machine Tasks Recent Time In MS attribute
Description
The time spent in microseconds to perform the Add Resources
Virtual Machine tasks.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
116 Monitoring Agent for Microsoft Hyper-V Server: Users Guide
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Apply Snapshot Virtual Machine Tasks Recent Time In MS attribute
Description
The time spent in microseconds to perform the Apply Snapshot
Virtual Machine tasks.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Clone Virtual Machine Tasks Recent Time In MS attribute
Description
The time spent in microseconds to perform the Clone Virtual
Machine tasks.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Create VSS Snapshot Set Tasks Recent Time In MS attribute
Description
The time spent in microseconds to perform the Create VSS
Snapshot Set tasks.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Define Virtual Machine Tasks Recent Time In MS attribute
Description
The time spent in microseconds to perform the Define Virtual
Machine tasks.
Chapter 4. Attributes reference 117
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Destroy Snapshot Virtual Machine Tasks Recent Time In MS attribute
Description
The time spent in microseconds to perform the Destroy Snapshot
Virtual Machine tasks.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Destroy Virtual Machine Tasks Recent Time In MS attribute
Description
The time spent in microseconds to perform the Destroy Virtual
Machine tasks.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Export Virtual Machine Tasks Recent Time In MS attribute
Description
The time spent in microseconds to perform the Export Virtual
Machine tasks.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Import Virtual Machine Tasks Recent Time In MS attribute
118 Monitoring Agent for Microsoft Hyper-V Server: Users Guide
Description
The time spent in microseconds to perform the Import Virtual
Machine tasks.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Merge Disk Tasks Recent Time In MS attribute
Description
The time spent in microseconds to perform the Merge Disk tasks.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Migrate Virtual Machine Tasks Recent Time In MS attribute
Description
The time spent in microseconds to perform the Migrate Virtual
Machine tasks.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Modify Resources Virtual Machine Tasks Recent Time In MS attribute
Description
The time spent in microseconds to perform the Modify Resources
Virtual Machine tasks.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Chapter 4. Attributes reference 119
Modify Service Settings Tasks Recent Time In MS attribute
Description
The time spent in microseconds to perform the Modify Service
Settings tasks.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Modify Virtual Machine Tasks Recent Time In MS attribute
Description
The time spent in microseconds to perform the Modify Virtual
Machine tasks.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Pause Virtual Machine Tasks Recent Time In MS attribute
Description
The time spent in microseconds to perform the Pause Virtual
Machine tasks.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Remove Resources Virtual Machine Tasks Recent Time In MS attribute
Description
The time spent in microseconds to perform the Remove Resources
Virtual Machine tasks.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
120 Monitoring Agent for Microsoft Hyper-V Server: Users Guide
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Reset Virtual Machine Tasks Recent Time In MS attribute
Description
The time spent in microseconds to perform the Reset Virtual
Machine tasks.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Restore Virtual Machine Tasks Recent Time In MS attribute
Description
The time spent in microseconds to perform the Restore Virtual
Machine tasks.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Resume Virtual Machine Tasks Recent Time In MS attribute
Description
The time spent in microseconds to perform the Resume Virtual
Machine tasks.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Save Virtual Machine Tasks Recent Time In MS attribute
Description
The time spent in microseconds to perform the Save Virtual
Machine tasks.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
Chapter 4. Attributes reference 121
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Shutdown Virtual Machine Tasks Recent Time In MS attribute
Description
The time spent in microseconds to perform the Shutdown Virtual
Machine tasks.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Snapshot Virtual Machine Tasks Recent Time In MS attribute
Description
The time spent in microseconds to perform the Snapshot Virtual
Machine tasks.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Start Virtual Machine Tasks Recent Time In MS attribute
Description
The time spent in microseconds to perform the Start Virtual
Machine tasks.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Hyper-V Virtual IDE Controller attribute group
The Hyper-V Virtual IDE Controller attribute group represents the details about
the IDE controller of the virtual machine. If the warehouse default setting is
enabled, data for this attribute group is stored in Tivoli Data Warehouse.
122 Monitoring Agent for Microsoft Hyper-V Server: Users Guide
Historical group
This attribute group is part of the default historical group, and is eligible for use
with Tivoli Data Warehouse.
Attribute descriptions
The following list contains information about each attribute in the Hyper-V Virtual
IDE Controller attribute group:
Node attribute - This attribute is a key attribute.
Description
The managed system name of the agent.
Type String
Timestamp attribute
Description
The local time at the agent when the data was collected.
Type String
Read Bytes Per Sec attribute
Description
The number of bytes read per second from the disks that are
attached to the Integrated Drive Electronics (IDE) controller.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Read Sectors Per Sec attribute
Description
The number of sectors read per second from the disks that are
attached to the IDE controller.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Write Bytes Per Sec attribute
Description
The number of bytes written per second to the disks that are
attached to the IDE controller.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Chapter 4. Attributes reference 123
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Written Sectors Per Sec attribute
Description
The number of sectors written per second to the disks that are
attached to the IDE controller.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Name attribute - This attribute is a key attribute.
Description
The name of the instance.
Type String
Hyper-V Virtual Machine Bus attribute group
The Hyper-V Virtual Machine Bus attribute group represents the statistics for the
virtual machine bus. If the warehouse default setting is enabled, data for this
attribute group is not stored in Tivoli Data Warehouse.
Historical group
This attribute group is not part of the default historical group, and is eligible for
use with Tivoli Data Warehouse.
Attribute descriptions
The following list contains information about each attribute in the Hyper-V Virtual
Machine Bus attribute group:
Node attribute - This attribute is a key attribute.
Description
The managed system name of the agent.
Type String
Timestamp attribute
Description
The local time at the agent when the data was collected.
Type String
Interrupts Received attribute
124 Monitoring Agent for Microsoft Hyper-V Server: Users Guide
Description
The total number of interrupts received.This value is reset to the
initial value on the server startup.
Type Integer (Counter) with enumerated values. The strings are
displayed in the Tivoli Enterprise Portal. The warehouse and
queries return the values shown in parentheses. The following
values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Change In Interrupts Received attribute
Description
The change in the total number of interrupts received.This value is
reset to the initial value on the server startup.
Type Integer (difference between successive values) with enumerated
values. The strings are displayed in the Tivoli Enterprise Portal.
The warehouse and queries return the values shown in
parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Interrupts Sent attribute
Description
The total number of interrupts sent.This value is reset to the initial
value on the server startup.
Type Integer (Counter) with enumerated values. The strings are
displayed in the Tivoli Enterprise Portal. The warehouse and
queries return the values shown in parentheses. The following
values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Change In Interrupts Sent attribute
Description
The change in the number of interrupts sent.This value is reset to
the initial value on server startup.
Type Integer (difference between successive values) with enumerated
values. The strings are displayed in the Tivoli Enterprise Portal.
The warehouse and queries return the values shown in
parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Chapter 4. Attributes reference 125
Throttle Events attribute
Description
The total number of times that a partition is throttled.This value is
reset to the initial value on the server startup.
Type Integer (Counter) with enumerated values. The strings are
displayed in the Tivoli Enterprise Portal. The warehouse and
queries return the values shown in parentheses. The following
values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Change In Throttle Events attribute
Description
The change in the number of times that a partition is throttled.This
value is reset to the initial value on the server startup.
Type Integer (difference between successive values) with enumerated
values. The strings are displayed in the Tivoli Enterprise Portal.
The warehouse and queries return the values shown in
parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Hyper-V Virtual Machine Health Summary attribute group
The Hyper-V Virtual Machine Heatlh Summary attribute group represents the
health summary statistics for the Virtual Machine Management Service. If the
warehouse default setting is enabled, data for this attribute group is not stored in
Tivoli Data Warehouse.
Historical group
This attribute group is not part of the default historical group, and is eligible for
use with Tivoli Data Warehouse.
Attribute descriptions
The following list contains information about each attribute in the Hyper-V Virtual
Machine Health Summary attribute group:
Node attribute - This attribute is a key attribute.
Description
The managed system name of the agent.
Type String
Timestamp attribute
Description
The local time at the agent when the data was collected.
Type String
126 Monitoring Agent for Microsoft Hyper-V Server: Users Guide
Health Critical attribute
Description
The number of virtual machines that display the state as critical.
Type Integer (Gauge) with enumerated values. The strings are displayed
in the Tivoli Enterprise Portal. The warehouse and queries return
the values shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Health Ok attribute
Description
The number of virtual machines that display the state as OK.
Type Integer (Gauge) with enumerated values. The strings are displayed
in the Tivoli Enterprise Portal. The warehouse and queries return
the values shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Hyper-V Virtual Machine Summary attribute group
The Hyper-V Virtual Machine Summary attribute group represents the summary
statistics for the Virtual Machine Management service. If the warehouse default
setting is enabled, data for this attribute group is not stored in Tivoli Data
Warehouse.
Historical group
This attribute group is not part of the default historical group, and is eligible for
use with Tivoli Data Warehouse.
Attribute descriptions
The following list contains information about each attribute in the Hyper-V Virtual
Machine Summary attribute group:
Node attribute - This attribute is a key attribute.
Description
The managed system name of the agent.
Type String
Timestamp attribute
Description
The local time at the agent when the data was collected.
Type String
Applying SnapShot attribute
Chapter 4. Attributes reference 127
Description
The number of virtual machines for which the Hyper-V system is
taking a snapshot.
Type Integer (Gauge) with enumerated values. The strings are displayed
in the Tivoli Enterprise Portal. The warehouse and queries return
the values shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Deleting attribute
Description
The number of virtual machines that are being deleted.
Type Integer (Gauge) with enumerated values. The strings are displayed
in the Tivoli Enterprise Portal. The warehouse and queries return
the values shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Deleting Saved State attribute
Description
The number of virtual machines in saved state that the Hyper-V
system is deleting.
Type Integer (Gauge) with enumerated values. The strings are displayed
in the Tivoli Enterprise Portal. The warehouse and queries return
the values shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Deleting Snapshot attribute
Description
The number of virtual machines for which the Hyper-V system is
deleting a snapshot.
Type Integer (Gauge) with enumerated values. The strings are displayed
in the Tivoli Enterprise Portal. The warehouse and queries return
the values shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Exporting attribute
Description
The number of virtual machines that the Hyper-V system is
exporting.
128 Monitoring Agent for Microsoft Hyper-V Server: Users Guide
Type Integer (Gauge) with enumerated values. The strings are displayed
in the Tivoli Enterprise Portal. The warehouse and queries return
the values shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Merging Disks attribute
Description
The number of virtual machines that are merging disks.
Type Integer (Gauge) with enumerated values. The strings are displayed
in the Tivoli Enterprise Portal. The warehouse and queries return
the values shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Paused attribute
Description
The number of virtual machines that are in a paused state.
Type Integer (Gauge) with enumerated values. The strings are displayed
in the Tivoli Enterprise Portal. The warehouse and queries return
the values shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Pausing attribute
Description
The number of virtual machines that are in a pausing state.
Type Integer (Gauge) with enumerated values. The strings are displayed
in the Tivoli Enterprise Portal. The warehouse and queries return
the values shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Resetting attribute
Description
The number of virtual machines that are resetting.
Type Integer (Gauge) with enumerated values. The strings are displayed
in the Tivoli Enterprise Portal. The warehouse and queries return
the values shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Chapter 4. Attributes reference 129
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Resuming attribute
Description
The number of virtual machines that are in a resuming state.
Type Integer (Gauge) with enumerated values. The strings are displayed
in the Tivoli Enterprise Portal. The warehouse and queries return
the values shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Running attribute
Description
The number of virtual machines that are in a running state.
Type Integer (Gauge) with enumerated values. The strings are displayed
in the Tivoli Enterprise Portal. The warehouse and queries return
the values shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Saved attribute
Description
The number of virtual machines that are saved.
Type Integer (Gauge) with enumerated values. The strings are displayed
in the Tivoli Enterprise Portal. The warehouse and queries return
the values shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Saving attribute
Description
The number of virtual machines that are being saved.
Type Integer (Gauge) with enumerated values. The strings are displayed
in the Tivoli Enterprise Portal. The warehouse and queries return
the values shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Starting attribute
Description
The number of virtual machines that are being started.
130 Monitoring Agent for Microsoft Hyper-V Server: Users Guide
Type Integer (Gauge) with enumerated values. The strings are displayed
in the Tivoli Enterprise Portal. The warehouse and queries return
the values shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Stopping attribute
Description
The number of virtual machines that are being stopped.
Type Integer (Gauge) with enumerated values. The strings are displayed
in the Tivoli Enterprise Portal. The warehouse and queries return
the values shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Taking Snapshot attribute
Description
The number of virtual machines that are taking a snapshot.
Type Integer (Gauge) with enumerated values. The strings are displayed
in the Tivoli Enterprise Portal. The warehouse and queries return
the values shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Turned Off attribute
Description
The number of virtual machines that are turned off.
Type Integer (Gauge) with enumerated values. The strings are displayed
in the Tivoli Enterprise Portal. The warehouse and queries return
the values shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Waiting To Start attribute
Description
The number of virtual machines that are in a queue to start.
Type Integer (Gauge) with enumerated values. The strings are displayed
in the Tivoli Enterprise Portal. The warehouse and queries return
the values shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Chapter 4. Attributes reference 131
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Hyper-V Virtual Network Adapter attribute group
The Hyper-V Virtual Network Adapter attribute group represents the statistics for
the virtual network adapter. If the warehouse default setting is enabled, data for
this attribute group is not stored in Tivoli Data Warehouse.
Historical group
This attribute group is not part of the default historical group, and is eligible for
use with Tivoli Data Warehouse.
Attribute descriptions
The following list contains information about each attribute in the Hyper-V Virtual
Network Adapter attribute group:
Node attribute - This attribute is a key attribute.
Description
The managed system name of the agent.
Type String
Timestamp attribute
Description
The local time at the agent when the data was collected.
Type String
Broadcast Packets Received Per Sec attribute
Description
The total number of broadcast packets that the network adapter
received per second.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Broadcast Packets Sent Per Sec attribute
Description
The total number of broadcast packets that the network adapter
sent per second.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
132 Monitoring Agent for Microsoft Hyper-V Server: Users Guide
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Bytes Per Sec attribute
Description
The total number of bytes that traversed the network adapter per
second.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Bytes Received Per Sec attribute
Description
The total number of bytes that the network adapter received per
second.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Bytes Sent Per Sec attribute
Description
The total number of bytes that the network adapter sent per
second.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Directed Packets Received Per Sec attribute
Description
The total number of directed packets that the network adapter
received per second.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
Chapter 4. Attributes reference 133
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Directed Packets Sent Per Sec attribute
Description
The total number of directed packets that the network adapter sent
per second.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Multicast Packets Received Per Sec attribute
Description
The total number of multicast packets that the network adapter
received per second.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Multicast Packets Sent Per Sec attribute
Description
The total number of multicast packets that the network adapter
sent per second.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Packets Per Sec attribute
Description
The total number of packets that traverse the network adapter per
second.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
134 Monitoring Agent for Microsoft Hyper-V Server: Users Guide
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Packets Received Per Sec attribute
Description
The total number of packets that the network adapter received per
second.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Packets Sent Per Sec attribute
Description
The total number of packets that the network adapter sent per
second.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Name attribute - This attribute is a key attribute.
Description
The name of the instance.
Type String
Hyper-V Virtual Switch attribute group
The Hyper-V Virtual Switch attribute group represents the statistics for the
Hyper-V virtual switch. If the warehouse default setting is enabled, data for this
attribute group is stored in Tivoli Data Warehouse.
Historical group
This attribute group is part of the default historical group, and is eligible for use
with Tivoli Data Warehouse.
Chapter 4. Attributes reference 135
Attribute descriptions
The following list contains information about each attribute in the Hyper-V Virtual
Switch attribute group:
Node attribute - This attribute is a key attribute.
Description
The managed system name of the agent.
Type String
Timestamp attribute
Description
The local time at the agent when the data was collected.
Type String
Broadcast Packets Received Per Sec attribute
Description
The total number of broadcast packets that the virtual switch
received per second.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Broadcast Packets Sent Per Sec attribute
Description
The total number of broadcast packets that the virtual switch sent
per second.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Directed Packets Received Per Sec attribute
Description
The total number of directed packets that the virtual switch
received per second.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
136 Monitoring Agent for Microsoft Hyper-V Server: Users Guide
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Directed Packets Sent Per Sec attribute
Description
The total number of directed packets that the virtual switch sent
per second.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Learned MAC Addresses attribute
Description
The total number of learned Media Access Control (MAC)
addresses of the virtual switch.
Type Integer (Numeric Property) with enumerated values. The strings
are displayed in the Tivoli Enterprise Portal. The warehouse and
queries return the values shown in parentheses. The following
values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Learned MAC Addresses Per Sec attribute
Description
The total number of MAC addresses that are learned per second by
the virtual switch.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Multicast Packets Received Per Sec attribute
Description
The total number of multicast packets that are received per second
by the virtual switch.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
Chapter 4. Attributes reference 137
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Multicast Packets Sent Per Sec attribute
Description
The total number of multicast packets that are sent per second by
the virtual switch.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Packets Flooded attribute
Description
The total number of packets that are flooded by the virtual switch.
Type Integer (Gauge) with enumerated values. The strings are displayed
in the Tivoli Enterprise Portal. The warehouse and queries return
the values shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Packets Flooded Per Sec attribute
Description
The total number of packets that are flooded per second by the
virtual switch.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Purged MAC Addresses attribute
Description
The total number of MAC addresses of the virtual switch that are
purged.
Type Integer (Numeric Property) with enumerated values. The strings
are displayed in the Tivoli Enterprise Portal. The warehouse and
queries return the values shown in parentheses. The following
values are defined:
v Value_Exceeds_Maximum (2147483647)
138 Monitoring Agent for Microsoft Hyper-V Server: Users Guide
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Purged MAC Addresses Per Sec attribute
Description
The total number of MAC addresses that are purged per second by
the virtual switch.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Name attribute - This attribute is a key attribute.
Description
The name of the instance.
Type String
Hyper-V Virtual Switch Port attribute group
The Hyper-V Virtual Switch Port attribute group represents the statistics for the
virtual switch port. If the warehouse default setting is enabled, data for this
attribute group is not stored in Tivoli Data Warehouse.
Historical group
This attribute group is not part of the default historical group, and is eligible for
use with Tivoli Data Warehouse.
Attribute descriptions
The following list contains information about each attribute in the Hyper-V Virtual
Switch Port attribute group:
Node attribute - This attribute is a key attribute.
Description
The managed system name of the agent.
Type String
Timestamp attribute
Description
The local time at the agent when the data was collected.
Type String
Broadcast Packets Received Per Sec attribute
Description
The total number of broadcast packets that the virtual switch port
received per second.
Chapter 4. Attributes reference 139
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Broadcast Packets Sent Per Sec attribute
Description
The total number of broadcast packets that are sent per second by
the virtual switch port.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Bytes Per Sec attribute
Description
The total number of bytes that traversed the virtual switch port per
second.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Bytes Received Per Sec attribute
Description
The total number of bytes that the virtual switch port received per
second.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Bytes Sent Per Sec attribute
140 Monitoring Agent for Microsoft Hyper-V Server: Users Guide
Description
The total number of bytes that the virtual switch port sent per
second.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Directed Packets Received Per Sec attribute
Description
The total number of directed packets that the virtual switch port
received per second.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Directed Packets Sent Per Sec attribute
Description
The total number of directed packets that are sent per second by
the virtual switch port.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Multicast Packets Received Per Sec attribute
Description
The total number of multicast packets that the virtual switch port
received per second.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Chapter 4. Attributes reference 141
Multicast Packets Sent Per Sec attribute
Description
The total number of multicast packets that the virtual switch port
sent per second.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Packets Per Sec attribute
Description
The total number of packets that traversed the virtual switch port
per second.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Packets Received Per Sec attribute
Description
The total number of packets that the virtual switch port received
per second.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Packets Sent Per Sec attribute
Description
The total number of packets that the virtual switch port sent per
second.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
142 Monitoring Agent for Microsoft Hyper-V Server: Users Guide
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Name attribute - This attribute is a key attribute.
Description
The name of the instance.
Type String
Hyper-V VM IO APIC attribute group
The Hyper-V VM IO APIC attribute group provides information about the number
of interrupt assertions that the I/O APIC device sent to the virtual machine. If the
warehouse default setting is enabled, data for this attribute group is not stored in
Tivoli Data Warehouse.
Historical group
This attribute group is not part of the default historical group, and is eligible for
use with Tivoli Data Warehouse.
Attribute descriptions
The following list contains information about each attribute in the Hyper-V VM IO
APIC attribute group:
Node attribute - This attribute is a key attribute.
Description
The managed system name of the agent.
Type String
Timestamp attribute
Description
The local time at the agent when the data was collected.
Type String
Assertions attribute
Description
The number of interrupts assertions that the I/O APIC device sent
to the virtual machine.
Type Integer (Counter) with enumerated values. The strings are
displayed in the Tivoli Enterprise Portal. The warehouse and
queries return the values shown in parentheses. The following
values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Name attribute - This attribute is a key attribute.
Description
The name of the instance.
Type String
Chapter 4. Attributes reference 143
Hypervisor attribute group
The Hypervisor attribute group provides the version and the statistical information
about the hypervisor. If the warehouse default setting is enabled, data for this
attribute group is not stored in Tivoli Data Warehouse.
Historical group
This attribute group is not part of the default historical group, and is eligible for
use with Tivoli Data Warehouse.
Attribute descriptions
The following list contains information about each attribute in the Hypervisor
attribute group:
Node attribute - This attribute is a key attribute.
Description
The managed system name of the agent.
Type String
Timestamp attribute
Description
The local time at the agent when the data was collected.
Type String
Version attribute
Description
The version of the Hyper-V server.
Type String
Logical Processors attribute
Description
The number of logical processors that are present in the system.
Type Integer (Numeric Property) with enumerated values. The strings
are displayed in the Tivoli Enterprise Portal. The warehouse and
queries return the values shown in parentheses. The following
values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Monitored Notifications attribute
Description
The number of monitored notifications that are registered with the
hypervisor.
Type Integer (Numeric Property) with enumerated values. The strings
are displayed in the Tivoli Enterprise Portal. The warehouse and
queries return the values shown in parentheses. The following
values are defined:
v Value_Exceeds_Maximum (2147483647)
144 Monitoring Agent for Microsoft Hyper-V Server: Users Guide
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Partitions attribute
Description
The number of partitions (virtual machines) that are present in the
system.
Type Integer (Numeric Property) with enumerated values. The strings
are displayed in the Tivoli Enterprise Portal. The warehouse and
queries return the values shown in parentheses. The following
values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Total Pages attribute
Description
The number of bootstrap and deposited pages in the hypervisor.
Type Integer (Numeric Property) with enumerated values. The strings
are displayed in the Tivoli Enterprise Portal. The warehouse and
queries return the values shown in parentheses. The following
values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Virtual Processors attribute
Description
The number of virtual processors that are present in the system.
Type Integer (Numeric Property) with enumerated values. The strings
are displayed in the Tivoli Enterprise Portal. The warehouse and
queries return the values shown in parentheses. The following
values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Memory attribute group
The Memory attribute group represents the memory currently allocated to a virtual
machine. If the warehouse default setting is enabled, data for this attribute group
is stored in Tivoli Data Warehouse.
Historical group
This attribute group is part of the default historical group, and is eligible for use
with Tivoli Data Warehouse.
Chapter 4. Attributes reference 145
Attribute descriptions
The following list contains information about each attribute in the Memory
attribute group:
Node attribute - This attribute is a key attribute.
Description
The managed system name of the agent.
Type String
Timestamp attribute
Description
The local time at the agent when the data was collected.
Type String
Virtual Machine Name attribute
Description
Name of the virtual machine
Type String
HealthState attribute
Description
The current health of the element
Type Integer with enumerated values. The strings are displayed in the
Tivoli Enterprise Portal. The warehouse and queries return the
values shown in parentheses. The following values are defined:
v Healthy (5)
v Non-Functional (30)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
EnabledState attribute
Description
The enabled and disabled states of an element
Type Integer with enumerated values. The strings are displayed in the
Tivoli Enterprise Portal. The warehouse and queries return the
values shown in parentheses. The following values are defined:
v Unknown (0)
v Other (1)
v Enabled (2)
v Disabled (3)
v Shutting_Down (4)
v Not_Applicable (5)
v Enabled_but_Offline (6)
v In_Test (7)
v Deferred (8)
v Quiesce (9)
v Starting (10)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
146 Monitoring Agent for Microsoft Hyper-V Server: Users Guide
BlockSize attribute
Description
The size of the block that forms the storage extent, in bytes
Type Integer (Numeric Property) with enumerated values. The strings
are displayed in the Tivoli Enterprise Portal. The warehouse and
queries return the values shown in parentheses. The following
values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
NumberOfBlocks attribute
Description
The amount of memory allocated to the virtual machine, in MB
Type Integer (Numeric Property) with enumerated values. The strings
are displayed in the Tivoli Enterprise Portal. The warehouse and
queries return the values shown in parentheses. The following
values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
FreePhysicalMemory attribute
Description
The amount of free physical memory, in GB
Type Integer (Gauge) with enumerated values. The strings are displayed
in the Tivoli Enterprise Portal. The warehouse and queries return
the values shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Virtual Machine ID attribute - This attribute is a key attribute.
Description
The unique identifier for the virtual machine
Type String
Device ID attribute - This attribute is a key attribute.
Description
The unique identifier for the memory device
Type String
Chapter 4. Attributes reference 147
Performance Object Status attribute group
The Performance Object Status attribute group contains information that reflects
the status of other attribute groups so you can see the status of all of the
performance objects that make up this application all at once. Each of these other
performance attribute groups is represented by a row in this table (or other type of
view). The status for an attribute group reflects the result of the last attempt to
collect data for that attribute group, which allows you to see whether the agent is
performing correctly. Unlike other attribute groups, the Performance Object Status
attribute group does not reflect the state of the monitored application. This
attribute group is most often used to determine why data is not available for one
of the performance attribute groups. If the warehouse default setting is enabled,
data for this attribute group is stored in Tivoli Data Warehouse.
Historical group
This attribute group is part of the default historical group, and is eligible for use
with Tivoli Data Warehouse.
Attribute descriptions
The following list contains information about each attribute in the Performance
Object Status attribute group:
Node attribute - This attribute is a key attribute.
Description
The managed system name of the agent.
Type String
Timestamp attribute
Description
The local time at the agent when the data was collected.
Type String
Query Name attribute - This attribute is a key attribute.
Description
The name of the attribute group.
Type String
Object Name attribute
Description
The name of the performance object.
Type String
Object Type attribute
Description
The type of the performance object.
Type Integer with enumerated values. The strings are displayed in the
Tivoli Enterprise Portal. The warehouse and queries return the
values shown in parentheses. The following values are defined:
v WMI (0)
v PERFMON (1)
v WMI_ASSOCIATION_GROUP (2)
148 Monitoring Agent for Microsoft Hyper-V Server: Users Guide
v JMX (3)
v SNMP (4)
v SHELL_COMMAND (5)
v JOINED_GROUPS (6)
v CIMOM (7)
v CUSTOM (8)
v ROLLUP_DATA (9)
v WMI_REMOTE_DATA (10)
v LOG_FILE (11)
v JDBC (12)
v CONFIG_DISCOVERY (13)
v NT_EVENT_LOG (14)
v FILTER (15)
v SNMP_EVENT (16)
v PING (17)
v DIRECTOR_DATA (18)
v DIRECTOR_EVENT (19)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Object Status attribute
Description
The status of the performance object.
Type Integer with enumerated values. The strings are displayed in the
Tivoli Enterprise Portal. The warehouse and queries return the
values shown in parentheses. The following values are defined:
v ACTIVE (0)
v INACTIVE (1)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Error Code attribute
Description
The error code associated with the query
Type Integer with enumerated values. The strings are displayed in the
Tivoli Enterprise Portal. The warehouse and queries return the
values shown in parentheses. The following values are defined:
v NO_ERROR (0)
v GENERAL_ERROR (1)
v OBJECT_NOT_FOUND (2)
v COUNTER_NOT_FOUND (3)
v NAMESPACE_ERROR (4)
v OBJECT_CURRENTLY_UNAVAILABLE (5)
v COM_LIBRARY_INIT_FAILURE (6)
v SECURITY_INIT_FAILURE (7)
v PROXY_SECURITY_FAILURE (9)
v NO_INSTANCES_RETURNED (10)
Chapter 4. Attributes reference 149
v ASSOCIATOR_QUERY_FAILED (11)
v REFERENCE_QUERY_FAILED (12)
v NO_RESPONSE_RECEIVED (13)
v CANNOT_FIND_JOINED_QUERY (14)
v CANNOT_FIND_JOIN_ATTRIBUTE_IN_QUERY_1_RESULTS
(15)
v CANNOT_FIND_JOIN_ATTRIBUTE_IN_QUERY_2_RESULTS
(16)
v QUERY_1_NOT_A_SINGLETON (17)
v QUERY_2_NOT_A_SINGLETON (18)
v NO_INSTANCES_RETURNED_IN_QUERY_1 (19)
v NO_INSTANCES_RETURNED_IN_QUERY_2 (20)
v CANNOT_FIND_ROLLUP_QUERY (21)
v CANNOT_FIND_ROLLUP_ATTRIBUTE (22)
v FILE_OFFLINE (23)
v NO_HOSTNAME (24)
v MISSING_LIBRARY (25)
v ATTRIBUTE_COUNT_MISMATCH (26)
v ATTRIBUTE_NAME_MISMATCH (27)
v COMMON_DATA_PROVIDER_NOT_STARTED (28)
v CALLBACK_REGISTRATION_ERROR (29)
v MDL_LOAD_ERROR (30)
v AUTHENTICATION_FAILED (31)
v CANNOT_RESOLVE_HOST_NAME (32)
v SUBNODE_UNAVAILABLE (33)
v SUBNODE_NOT_FOUND_IN_CONFIG (34)
v ATTRIBUTE_ERROR (35)
v CLASSPATH_ERROR (36)
v CONNECTION_FAILURE (37)
v FILTER_SYNTAX_ERROR (38)
v FILE_NAME_MISSING (39)
v SQL_QUERY_ERROR (40)
v SQL_FILTER_QUERY_ERROR (41)
v SQL_DB_QUERY_ERROR (42)
v SQL_DB_FILTER_QUERY_ERROR (43)
v PORT_OPEN_FAILED (44)
v ACCESS_DENIED (45)
v TIMEOUT (46)
v NOT_IMPLEMENTED (47)
v REQUESTED_A_BAD_VALUE (48)
v RESPONSE_TOO_BIG (49)
v GENERAL_RESPONSE_ERROR (50)
v SCRIPT_NONZERO_RETURN (51)
v SCRIPT_NOT_FOUND (52)
v SCRIPT_LAUNCH_ERROR (53)
150 Monitoring Agent for Microsoft Hyper-V Server: Users Guide
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Last Collection Start attribute
Description
The most recent time a data collection of this group started
Type Timestamp with enumerated values. The strings are displayed in
the Tivoli Enterprise Portal. The warehouse and queries return the
values shown in parentheses. The following values are defined:
v NOT COLLECTED (0691231190000000)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Last Collection Finished attribute
Description
The most recent time a data collection of this group finished
Type Timestamp with enumerated values. The strings are displayed in
the Tivoli Enterprise Portal. The warehouse and queries return the
values shown in parentheses. The following values are defined:
v NOT COLLECTED (0691231190000000)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Last Collection Duration attribute
Description
The duration of the most recently completed data collection of this
group in seconds
Type Real number (Counter) with 2 decimal places of precision
Average Collection Duration attribute
Description
The average duration of all data collections of this group in
seconds
Type Real number (Counter) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v NO DATA (-100)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Refresh Interval attribute
Description
The interval at which this group is refreshed in seconds
Type Integer (Counter)
Number of Collections attribute
Description
The number of times this group has been collected since agent start
Type Integer (Counter)
Chapter 4. Attributes reference 151
Cache Hits attribute
Description
The number of times an external data request for this group was
satisfied from the cache
Type Integer (Counter)
Cache Misses attribute
Description
The number of times an external data request for this group was
not available in the cache
Type Integer (Counter)
Cache Hit Percent attribute
Description
The percentage of external data requests for this group that were
satisfied from the cache
Type Real number (Counter) with 2 decimal places of precision
Intervals Skipped attribute
Description
The number of times a background data collection for this group
was skipped because the previous collection was still running
when the next one was due to start
Type Integer (Counter)
Processor attribute group
The processor attribute group represents the virtual processor in a virtual
computer system. If the warehouse default setting is enabled, data for this attribute
group is stored in Tivoli Data Warehouse.
Historical group
This attribute group is part of the default historical group, and is eligible for use
with Tivoli Data Warehouse.
Attribute descriptions
The following list contains information about each attribute in the Processor
attribute group:
Node attribute - This attribute is a key attribute.
Description
The managed system name of the agent.
Type String
Timestamp attribute
Description
The local time at the agent when the data was collected.
Type String
Virtual Machine Name attribute
152 Monitoring Agent for Microsoft Hyper-V Server: Users Guide
Description
Name of the virtual machine
Type String
NumberofProcessors attribute
Description
The total number of virtual processors allocated to the virtual
machine or snapshot
Type Integer (Gauge) with enumerated values. The strings are displayed
in the Tivoli Enterprise Portal. The warehouse and queries return
the values shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
HealthState attribute
Description
The current health of the element
Type Integer with enumerated values. The strings are displayed in the
Tivoli Enterprise Portal. The warehouse and queries return the
values shown in parentheses. The following values are defined:
v Healthy (5)
v Non-Functional (30)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
EnabledState attribute
Description
The enabled and disabled states of an element
Type Integer with enumerated values. The strings are displayed in the
Tivoli Enterprise Portal. The warehouse and queries return the
values shown in parentheses. The following values are defined:
v Unknown (0)
v Other (1)
v Enabled (2)
v Disabled (3)
v Shutting_Down (4)
v Not_Applicable (5)
v Enabled_but_Offline (6)
v In_Test (7)
v Deferred (8)
v Quiesce (9)
v Starting (10)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
LoadPercentage attribute
Chapter 4. Attributes reference 153
Description
The current percentage of the total processing power consumed by
the virtual machine
Type Integer (Gauge) with enumerated values. The strings are displayed
in the Tivoli Enterprise Portal. The warehouse and queries return
the values shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
CPUStatus attribute
Description
The current status of the processor
Type Integer with enumerated values. The strings are displayed in the
Tivoli Enterprise Portal. The warehouse and queries return the
values shown in parentheses. The following values are defined:
v CPU Enabled (1)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Reservation attribute
Description
The amount of processor resources that are reserved for use by the
virtual machine
Type Integer (Gauge) with enumerated values. The strings are displayed
in the Tivoli Enterprise Portal. The warehouse and queries return
the values shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Limit attribute
Description
The maximum amount of processor resources that can be
consumed by the virtual machine
Type Integer (Numeric Property) with enumerated values. The strings
are displayed in the Tivoli Enterprise Portal. The warehouse and
queries return the values shown in parentheses. The following
values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Weight attribute
Description
The weight for each virtual machine processor
Type Integer (Numeric Property) with enumerated values. The strings
154 Monitoring Agent for Microsoft Hyper-V Server: Users Guide
are displayed in the Tivoli Enterprise Portal. The warehouse and
queries return the values shown in parentheses. The following
values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Virtual Machine ID attribute - This attribute is a key attribute.
Description
The unique identifier for the virtual machine
Type String
Thread Pool Status attribute group
The Thread Pool Status attribute group contains information that reflects the status
of the internal thread pool used to collect data asynchronously. If the warehouse
default setting is enabled, data for this attribute group is stored in Tivoli Data
Warehouse.
Historical group
This attribute group is part of the default historical group, and is eligible for use
with Tivoli Data Warehouse.
Attribute descriptions
The following list contains information about each attribute in the Thread Pool
Status attribute group:
Node attribute - This attribute is a key attribute.
Description
The managed system name of the agent.
Type String
Timestamp attribute
Description
The local time at the agent when the data was collected.
Type String
Thread Pool Size attribute
Description
The number of threads currently existing in the thread pool.
Type Integer (Gauge) with enumerated values. The strings are displayed
in the Tivoli Enterprise Portal. The warehouse and queries return
the values shown in parentheses. The following values are defined:
v NO DATA (-1)
v NO DATA (-100)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Thread Pool Max Size attribute
Chapter 4. Attributes reference 155
Description
The maximum number of threads allowed to exist in the thread
pool.
Type Integer (Numeric Property) with enumerated values. The strings
are displayed in the Tivoli Enterprise Portal. The warehouse and
queries return the values shown in parentheses. The following
values are defined:
v NO DATA (-1)
v NO DATA (-100)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Thread Pool Active Threads attribute
Description
The number of threads in the thread pool currently active doing
work.
Type Integer (Gauge) with enumerated values. The strings are displayed
in the Tivoli Enterprise Portal. The warehouse and queries return
the values shown in parentheses. The following values are defined:
v NO DATA (-1)
v NO DATA (-100)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Thread Pool Avg Active Threads attribute
Description
The average number of threads in the thread pool simultaneously
active doing work.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v NO DATA (-1)
v NO DATA (-100)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Thread Pool Min Active Threads attribute
Description
The smallest number of threads in the thread pool that have
simultaneously been active doing work.
Type Integer (Counter) with enumerated values. The strings are
displayed in the Tivoli Enterprise Portal. The warehouse and
queries return the values shown in parentheses. The following
values are defined:
v NO DATA (-1)
v NO DATA (-100)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
156 Monitoring Agent for Microsoft Hyper-V Server: Users Guide
Thread Pool Max Active Threads attribute
Description
The peak number of threads in the thread pool that have
simultaneously been active doing work.
Type Integer (Counter) with enumerated values. The strings are
displayed in the Tivoli Enterprise Portal. The warehouse and
queries return the values shown in parentheses. The following
values are defined:
v NO DATA (-1)
v NO DATA (-100)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Thread Pool Queue Length attribute
Description
The number of jobs currently waiting in the thread pool queue.
Type Integer (Gauge) with enumerated values. The strings are displayed
in the Tivoli Enterprise Portal. The warehouse and queries return
the values shown in parentheses. The following values are defined:
v NO DATA (-1)
v NO DATA (-100)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Thread Pool Avg Queue Length attribute
Description
The average length of the thread pool queue during this run.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v NO DATA (-1)
v NO DATA (-100)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Thread Pool Min Queue Length attribute
Description
The minimum length the thread pool queue has reached.
Type Integer (Counter) with enumerated values. The strings are
displayed in the Tivoli Enterprise Portal. The warehouse and
queries return the values shown in parentheses. The following
values are defined:
v NO DATA (-1)
v NO DATA (-100)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Thread Pool Max Queue Length attribute
Chapter 4. Attributes reference 157
Description
The peak length the thread pool queue has reached.
Type Integer (Counter) with enumerated values. The strings are
displayed in the Tivoli Enterprise Portal. The warehouse and
queries return the values shown in parentheses. The following
values are defined:
v NO DATA (-1)
v NO DATA (-100)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Thread Pool Avg Job Wait attribute
Description
The average time a job spends waiting on the thread pool queue in
seconds.
Type Real number (Gauge) with 2 decimal places of precision with
enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
v NO DATA (-1)
v NO DATA (-100)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Thread Pool Total Jobs attribute
Description
The number of jobs completed by all threads in the pool since
agent start.
Type Integer (Counter) with enumerated values. The strings are
displayed in the Tivoli Enterprise Portal. The warehouse and
queries return the values shown in parentheses. The following
values are defined:
v NO DATA (-1)
v NO DATA (-100)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Virtual Machine attribute group
The Virtual Machines attribute group represents the memory currently allocated to
a virtual machine. If the warehouse default setting is enabled, data for this
attribute group is stored in Tivoli Data Warehouse.
Historical group
This attribute group is part of the default historical group, and is eligible for use
with Tivoli Data Warehouse.
Attribute descriptions
The following list contains information about each attribute in the Virtual Machine
attribute group:
158 Monitoring Agent for Microsoft Hyper-V Server: Users Guide
Node attribute - This attribute is a key attribute.
Description
The managed system name of the agent.
Type String
Timestamp attribute
Description
The local time at the agent when the data was collected.
Type String
Virtual Machine Name attribute
Description
The name of the virtual machine
Type String
EnabledState attribute
Description
The enabled and disabled states of an element
Type Integer with enumerated values. The strings are displayed in the
Tivoli Enterprise Portal. The warehouse and queries return the
values shown in parentheses. The following values are defined:
v Unknown (0)
v Other (1)
v Running (2)
v Off (3)
v Shutting_Down (4)
v Not_Applicable (5)
v Enabled_but_Offline (6)
v In_Test (7)
v Deferred (8)
v Quiesce (9)
v Starting (10)
v Paused (32768)
v Saved (32769)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
HealthState attribute
Description
The current health of the element
Type Integer with enumerated values. The strings are displayed in the
Tivoli Enterprise Portal. The warehouse and queries return the
values shown in parentheses. The following values are defined:
v Healthy (5)
v Non-Functional (30)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
ProcessorLoad attribute
Chapter 4. Attributes reference 159
Description
The current processor usage of the Hyper-V physical processor
across the virtual machines
Type Integer (Gauge) with enumerated values. The strings are displayed
in the Tivoli Enterprise Portal. The warehouse and queries return
the values shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
HeartBeat attribute
Description
The current heartbeat status for the virtual machine
Type Integer with enumerated values. The strings are displayed in the
Tivoli Enterprise Portal. The warehouse and queries return the
values shown in parentheses. The following values are defined:
v Off (0)
v OK (2)
v Error (6)
v No_Contact (12)
v Lost_Communication (13)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
NumberofProcessors attribute
Description
The total number of virtual processors allocated to the virtual
machine or the snapshot
Type Integer (Numeric Property) with enumerated values. The strings
are displayed in the Tivoli Enterprise Portal. The warehouse and
queries return the values shown in parentheses. The following
values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Memory Allocated attribute
Description
The physical memory in MB that is allocated to the virtual
machine.
Type Integer (Gauge) with enumerated values. The strings are displayed
in the Tivoli Enterprise Portal. The warehouse and queries return
the values shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
160 Monitoring Agent for Microsoft Hyper-V Server: Users Guide
UpTime attribute
Description
The amount of time, in hours, since the virtual machine was last
started
Type Integer (Counter) with enumerated values. The strings are
displayed in the Tivoli Enterprise Portal. The warehouse and
queries return the values shown in parentheses. The following
values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
PercentIdleTime attribute
Description
The percentage of the physical processor idle time
Type Integer (Gauge) with enumerated values. The strings are displayed
in the Tivoli Enterprise Portal. The warehouse and queries return
the values shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
GuestOperatingSystem attribute
Description
The name of the guest operating system
Type String
Notes attribute
Description
The notes associated with the virtual machine or the snapshot
Type String
Virtual Machine ID attribute - This attribute is a key attribute.
Description
The unique identifier for the virtual machine
Type String
Virtual Switch attribute group
The Virtual Switch attribute group represents a port on the switch. If the
warehouse default setting is enabled, data for this attribute group is stored in
Tivoli Data Warehouse.
Historical group
This attribute group is part of the default historical group, and is eligible for use
with Tivoli Data Warehouse.
Chapter 4. Attributes reference 161
Attribute descriptions
The following list contains information about each attribute in the Virtual Switch
attribute group:
Node attribute - This attribute is a key attribute.
Description
The managed system name of the agent.
Type String
Timestamp attribute
Description
The local time at the agent when the data was collected.
Type String
SwitchName attribute
Description
A common name of the virtual switch
Type String
PacketsPersec attribute
Description
The rate at which packets were received and sent on the virtual
switch
Type Integer (Gauge) with enumerated values. The strings are displayed
in the Tivoli Enterprise Portal. The warehouse and queries return
the values shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
PacketsReceivedPersec attribute
Description
The rate at which packets were received on the virtual switch
Type Integer (Gauge) with enumerated values. The strings are displayed
in the Tivoli Enterprise Portal. The warehouse and queries return
the values shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
PacketsSentPersec attribute
Description
The rate at which packets were sent on the virtual switch
Type Integer (Gauge) with enumerated values. The strings are displayed
in the Tivoli Enterprise Portal. The warehouse and queries return
the values shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
162 Monitoring Agent for Microsoft Hyper-V Server: Users Guide
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
BytesPersec attribute
Description
The rate at which bytes were received and sent on the virtual
switch.
Type Integer (Gauge) with enumerated values. The strings are displayed
in the Tivoli Enterprise Portal. The warehouse and queries return
the values shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
BytesReceivedPersec attribute
Description
The rate at which bytes were received on the virtual switch
Type Integer (Gauge) with enumerated values. The strings are displayed
in the Tivoli Enterprise Portal. The warehouse and queries return
the values shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
BytesSentPersec attribute
Description
The rate at which bytes were sent on the virtual switch
Type Integer (Gauge) with enumerated values. The strings are displayed
in the Tivoli Enterprise Portal. The warehouse and queries return
the values shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
EnabledState attribute
Description
The enabled and disabled states of an element
Type Integer with enumerated values. The strings are displayed in the
Tivoli Enterprise Portal. The warehouse and queries return the
values shown in parentheses. The following values are defined:
v Unknown (0)
v Other (1)
v Enabled (2)
v Disabled (3)
v Shutting_Down (4)
v Not_Applicable (5)
Chapter 4. Attributes reference 163
v Enabled_but_Offline (6)
v In_Test (7)
v Deferred (8)
v Quiesce (9)
v Starting (10)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
HealthState attribute
Description
The current health of the element
Type Integer with enumerated values. The strings are displayed in the
Tivoli Enterprise Portal. The warehouse and queries return the
values shown in parentheses. The following values are defined:
v Healthy (5)
v Non-Functional (30)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Switch ID attribute - This attribute is a key attribute.
Description
The unique identifier for the virtual switch
Type String
VLAN Endpoint attribute group
The VLAN Endpoint attribute group represents the VLAN endpoint of a switch
port. If the warehouse default setting is enabled, data for this attribute group is not
stored in Tivoli Data Warehouse.
Historical group
This attribute group is not part of the default historical group, and is eligible for
use with Tivoli Data Warehouse.
Attribute descriptions
The following list contains information about each attribute in the VLAN Endpoint
attribute group:
Node attribute - This attribute is a key attribute.
Description
The managed system name of the agent.
Type String
Timestamp attribute
Description
The local time at the agent when the data was collected.
Type String
Switch Name attribute - This attribute is a key attribute.
164 Monitoring Agent for Microsoft Hyper-V Server: Users Guide
Description
A common name of the virtual switch
Type String
EnabledState attribute
Description
The enabled and disabled states of an element
Type Integer with enumerated values. The strings are displayed in the
Tivoli Enterprise Portal. The warehouse and queries return the
values shown in parentheses. The following values are defined:
v Unknown (0)
v Other (1)
v Enabled (2)
v Disabled (3)
v Shutting_Down (4)
v Not_Applicable (5)
v Enabled_but_Offline (6)
v In_Test (7)
v Deferred (8)
v Quiesce (9)
v Starting (10)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
HealthState attribute
Description
The current health of the element
Type Integer with enumerated values. The strings are displayed in the
Tivoli Enterprise Portal. The warehouse and queries return the
values shown in parentheses. The following values are defined:
v Healthy (5)
v Non-Functional (30)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Desired VLAN Trunk Encapsulation attribute
Description
The type of VLAN encapsulation that is requested for use
Type Integer with enumerated values. The strings are displayed in the
Tivoli Enterprise Portal. The warehouse and queries return the
values shown in parentheses. The following values are defined:
v DMTF_Reserved (0)
v Other (1)
v Not_Applicable (2)
v 802.1q (3)
v Cisco_ISL (4)
v Negotiate (5)
Chapter 4. Attributes reference 165
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Operational VLAN Trunk Encapsulation attribute
Description
The type of VLAN encapsulation in use on a trunk endpoint or
port
Type Integer with enumerated values. The strings are displayed in the
Tivoli Enterprise Portal. The warehouse and queries return the
values shown in parentheses. The following values are defined:
v DMTF_Reserved (0)
v Other (1)
v Not_Applicable (2)
v 802.1q (3)
v Cisco_ISL (4)
v Negotiate (5)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Switch Port ID attribute - This attribute is a key attribute.
Description
The unique identifier for the switch port
Type String
Switch ID attribute
Description
The unique identifier for the virtual switch
Type String
Disk capacity planning for historical data
Disk capacity planning for a monitoring agent is a prediction of the amount of disk
space to be consumed for each attribute group whose historical data is being
collected. Required disk storage is an important factor to consider when you are
defining data collection rules and your strategy for historical data collection.
The table in this chapter provides the following information required to calculate
disk space for this monitoring agent:
v Table is the table name as it is displayed in the warehouse database, if the
attribute group is configured to be written to the warehouse. The table name
listed here corresponds to the Table name in Attribute groups and attributes for
the Monitoring Agent for Microsoft Hyper-V Server on page 23
v Attribute group is the name of the attribute group used to create the table in the
warehouse database if it is short enough to fit in the table naming constraints of
the database being used for the warehouse. The attribute group name listed here
corresponds to the Warehouse table name in Attribute groups and attributes for
the Monitoring Agent for Microsoft Hyper-V Server on page 23.
v Bytes per instance (agent) is an estimate of the record length for each row or
instance written to the agent disk for historical data collection. This estimate can
be used for agent disk space planning purposes.
166 Monitoring Agent for Microsoft Hyper-V Server: Users Guide
v Database bytes per instance (warehouse) is an estimate of the record length for
detailed records written to the warehouse database, if the attribute group is
configured to be written to the warehouse. Detailed records are those that have
been uploaded from the agent for long-term historical data collection. This
estimate can be used for warehouse disk space planning purposes.
v Aggregate bytes per instance (warehouse) is an estimate of the record length for
aggregate records written to the warehouse database, if the attribute group is
configured to be written to the warehouse. Aggregate records are created by the
Summarization agent for attribute groups that have been configured for
summarization. This estimate can be used for warehouse disk space planning
purposes.
In addition to the information in the tables, you must know the number of
instances of data that you plan to collect. An attribute group can have single or
multiple instances of data depending on the application environment that is being
monitored. For example, if your attribute group is monitoring each processor in
your computer and you have a dual processor computer, the number of instances
is two.
The following table contains capacity planning information for the data logged by
IBM Tivoli Monitoring for Microsoft Applications: Microsoft Hyper-V Server Agent.
Table 4. Capacity planning for historical data logged by IBM Tivoli Monitoring for Microsoft Applications, V6.2.0
Interim Feature 1: Microsoft Hyper-V Server Agent V6.2.0.1
Table Attribute group
Bytes per
instance
(agent)
Database
bytes per
instance
(warehouse)
Aggregate
bytes per
instance
(warehouse)
KHVAVAIL KHV_AVAILABILITY 3272 3296 3606
KHVGETDIS0 KHV_DISK 300 307 437
KHVEVTLOG KHV_EVENT_LOG 2244 2251 2327
KHVHYPERVI KHV_HYPERVISOR 160 162 199
KHVHYLPROC KHV_HYPER_V_HYPERVISOR_LOGICAL_PROCESSOR 252 496 1502
KHVHYPART KHV_HYPER_V_HYPERVISOR_PARTITION 204 232 527
KHVHYRPART KHV_HYPER_V_HYPERVISOR_ROOT_PARTITION 196 210 415
KHVHYRPROC KHV_HYPER_V_HYPERVISOR_ROOT_VIRTUAL_\
PROCESSOR
256 513 1570
KHVHYRPROM KHV_HYPER_V_HYPERVISOR_ROOT_VIRTUAL_\
PROCESSOR_MORE
432 1261 4562
KHVHYVPROC KHV_HYPER_V_HYPERVISOR_VIRTUAL_PROCESSOR 264 547 1706
KHVHYVPROM KHV_HYPER_V_HYPERVISOR_VIRTUAL_PROCESSOR_\
MORE
424 1227 4426
KHVLEGNWAD KHV_HYPER_V_LEGACY_NETWORK_ADAPTER 200 251 570
KHVHYPERV KHV_HYPER_V_SUMMARY 108 112 461
KHVTASKMD KHV_HYPER_V_TASK_MANAGER_DETAIL 268 312 1621
KHVTASKMDR KHV_HYPER_V_TASK_MANAGER_RECENT_TIME 268 888 3373
KHVVIDECON KHV_HYPER_V_VIRTUAL_IDE_CONTROLLER 192 241 482
KHVVMBUS KHV_HYPER_V_VIRTUAL_MACHINE_BUS 100 102 301
KHVVMHESUM KHV_HYPER_V_VIRTUAL_MACHINE_HEALTH_\
SUMMARY
84 82 197
Chapter 4. Attributes reference 167
Table 4. Capacity planning for historical data logged by IBM Tivoli Monitoring for Microsoft Applications, V6.2.0
Interim Feature 1: Microsoft Hyper-V Server Agent V6.2.0.1 (continued)
Table Attribute group
Bytes per
instance
(agent)
Database
bytes per
instance
(warehouse)
Aggregate
bytes per
instance
(warehouse)
KHVVMSUMMA KHV_HYPER_V_VIRTUAL_MACHINE_SUMMARY 148 162 901
KHVVIRNWAD KHV_HYPER_V_VIRTUAL_NETWORK_ADAPTER 224 377 1026
KHVVIRSWIT KHV_HYPER_V_VIRTUAL_SWITCH 224 341 876
KHVVIRSWPO KHV_HYPER_V_VIRTUAL_SWITCH_PORT 249 402 1051
KHVVMIOAPI KHV_HYPER_V_VM_IO_APIC 180 178 230
KHVGETMEM0 KHV_MEMORY 288 292 368
KHVPOBJST KHV_PERFORMANCE_OBJECT_STATUS 352 399 664
KHVGETPRO0 KHV_PROCESSOR 236 242 396
KHVTHPLST KHV_THREAD_POOL_STATUS 124 168 550
KHVGETVIR0 KHV_VIRTUAL_MACHINE 364 372 541
KHVMSVMVI4 KHV_VIRTUAL_SWITCH 242 248 519
KHVMSVMVI5 KHV_VLAN_ENDPOINT 296 299 336
For more information about historical data collection, see the IBM Tivoli Monitoring
Administrators Guide.
168 Monitoring Agent for Microsoft Hyper-V Server: Users Guide
Chapter 5. Situations reference
This chapter contains an overview of situations, references for detailed information
about situations, and descriptions of the predefined situations included in this
monitoring agent.
About situations
A situation is a logical expression involving one or more system conditions.
Situations are used to monitor the condition of systems in your network. You can
manage situations from Tivoli Enterprise Portal by using the Situation Editor.
The monitoring agents that you use to monitor your system environment are
delivered with a set of predefined situations that you can use as-is or you can
create new situations to meet your requirements. Predefined situations contain
attributes that check for system conditions common to many enterprises.
Using predefined situations can improve the speed with which you can begin
using the Monitoring Agent for Microsoft Hyper-V Server. You can examine and, if
necessary, change the conditions or values being monitored by a predefined
situation to those best suited to your enterprise.
You can display predefined situations and create your own situations using the
Situation Editor. The left frame of the Situation editor initially lists the situations
associated with the Navigator item that you selected. When you click a situation
name or create a new situation, the right frame opens with the following tabs:
Formula
Formula describing condition being tested
Distribution
List of managed systems (operating systems, subsystems, or applications)
to which the situation can be distributed. All of the Monitoring Agent for
Microsoft Hyper-V Server managed systems are assigned by default.
Expert advice
Comments and instructions to be read in the event workspace
Action
Command to be sent to the system
Until Options to close the event after a period of time, or when another situation
becomes true
More information about situations
IBM Tivoli Monitoring Users Guide contains more information about predefined and
custom situations and how to use them to respond to alerts.
For a list of the predefined situations for this monitoring agent and a description
of each situation, see the Predefined situations section in this chapter and the
information in that section for each individual situation.
Copyright IBM Corp. 2008, 2009 169
Predefined situations
This monitoring agent contains the following predefined situations, which are
organized by Navigator item.
v Microsoft Hyper-V Server
Not applicable
v Availability
KHV_Image_Mgmt_Service_Down
KHV_Network_Service_Down
KHV_VM_Mgmt_Service_Down
v Disk
KHV_VM_Disk_HealthState
v Event Log
KHV_HV_PDisk_Usage_Crit
v Hypervisor
KHV_HV_PNW_Utilization_Warn
KHV_HV_PNW_Utilization_Crit
KHV_HV_PCPU_Utilization_Warn
KHV_HV_PCPU_Utilization_Crit
KHV_HV_PMemory_Available_Warn
KHV_HV_PMemory_Available_Crit
KHV_HV_PDisk_Latency_Crit
KHV_HV_PDisk_Latency_Warn
v Memory
KHV_VM_Memory_HealthState
v Network
KHV_VM_Switch_HealthState
KHV_HV_NWAdapter_FramesDropped
KHV_HV_VSwitch_PacketsFlooded
v Processor
KHV_VM_ProcessorLoad_Crit
KHV_VM_Processor_Warn
KHV_HV_LP_Utilization_Warn
KHV_HV_LP_Utilization_Crit
KHV_HV_LP_ContextSwitches
KHV_HV_RVP_Utilization_Warn
KHV_HV_RVP_Utilization_Crit
KHV_HV_VP_Utilization_Crit
KHV_HV_VP_Utilization_Warn
v Virtual Machine
KHV_VM_Heartbeat_Crit
The remaining sections of this chapter contain descriptions of each of these
situations. The situations are organized by Navigator item. The following
information is provided about each situation:
170 Monitoring Agent for Microsoft Hyper-V Server: Users Guide
Description
Information about the conditions that the situation tests
Formula
Syntax that contains one or more logical expressions describing the
conditions for the situation to monitor
Run at startup
Whether the situation is automatically distributed to instances of the agent
or is available for manual distribution
Sampling interval
Number of seconds that elapses between one sample of data that the
monitoring agent collects for the server and the next sample
Situation persistence
Whether the conditions specified in the situation evaluate to true for the
defined number of occurrences in a row before the situation is raised. The
default of 1 means no persistence checking takes place.
Severity
Severity of the predefined events: Warning, Informational, or Critical
Clearing conditions
Controls when a true situation closes: after a period of time, when another
situation is true, or whichever occurs first if both are selected.
Microsoft Hyper-V Server Navigator item
There are no predefined situations for this Navigator item.
Availability Navigator item
KHV_Image_Mgmt_Service_Down situation
Description
Hyper-V Image Management Service is down.
The situation will be evaluated for each distinct value of Name.
Formula
*IF *SCAN KHV_AVAILABILITY.Name *EQ vhdsvc *AND *VALUE
KHV_AVAILABILITY.Status *EQ DOWN
See Attribute groups and attributes for the Monitoring Agent for Microsoft
Hyper-V Server on page 23 for descriptions of the attributes in this formula.
Run at startup
This situation is automatically distributed to instances of this agent.
Sampling interval
10 minutes
Situation persistence
The number of times the conditions of the situation must occur for the situation to
be true is 1.
Chapter 5. Situations reference 171
Severity
Critical
Clearing conditions
The situation clears when the condition becomes false.
KHV_Network_Service_Down situation
Description
Hyper-V Networking Management Service is down.
The situation will be evaluated for each distinct value of Name.
Formula
*IF *SCAN KHV_AVAILABILITY.Name *EQ nvspwmi *AND *VALUE
KHV_AVAILABILITY.Status *EQ DOWN
See Attribute groups and attributes for the Monitoring Agent for Microsoft
Hyper-V Server on page 23 for descriptions of the attributes in this formula.
Run at startup
This situation is automatically distributed to instances of this agent.
Sampling interval
10 minutes
Situation persistence
The number of times the conditions of the situation must occur for the situation to
be true is 1.
Severity
Critical
Clearing conditions
The situation clears when the condition becomes false.
KHV_VM_Mgmt_Service_Down situation
Description
Hyper-V Virtual Machine Management Service is down.
The situation will be evaluated for each distinct value of Name.
Formula
*IF *SCAN KHV_AVAILABILITY.Name *EQ vmms *AND *VALUE
KHV_AVAILABILITY.Status *EQ DOWN
See Attribute groups and attributes for the Monitoring Agent for Microsoft
Hyper-V Server on page 23 for descriptions of the attributes in this formula.
Run at startup
This situation is automatically distributed to instances of this agent.
Sampling interval
5 minutes
172 Monitoring Agent for Microsoft Hyper-V Server: Users Guide
Situation persistence
The number of times the conditions of the situation must occur for the situation to
be true is 1.
Severity
Critical
Clearing conditions
The situation clears when the condition becomes false.
Disk Navigator item
KHV_VM_Disk_HealthState situation
Description
Health of the virtual disks running on virtual machines.
The situation will be evaluated for each distinct value of VirtualMachineName.
Formula
*IF *VALUE KHV_DISK.HealthState *EQ Non-Functional
See Attribute groups and attributes for the Monitoring Agent for Microsoft
Hyper-V Server on page 23 for descriptions of the attributes in this formula.
Run at startup
This situation is available for distribution.
Sampling interval
5 minutes
Situation persistence
The number of times the conditions of the situation must occur for the situation to
be true is 1.
Severity
Critical
Clearing conditions
The situation clears when the condition becomes false.
Event Log Navigator item
KHV_HV_PDisk_Usage_Crit situation
Description
The physical disk utilization is high.
The situation will be evaluated for each distinct value of Name.
Formula
*IF *VALUE KHV_EVENT_LOG.Event_ID *EQ 4096 *AND *VALUE
KHV_EVENT_LOG.Event_Source *EQ 'Microsoft-Windows-Hyper-V-Integration-
KvpExchange'
Chapter 5. Situations reference 173
See Attribute groups and attributes for the Monitoring Agent for Microsoft
Hyper-V Server on page 23 for descriptions of the attributes in this formula.
Run at startup
This situation is available for distribution.
Sampling interval
None. Data is analyzed when it becomes available.
Situation persistence
Not Applicable
Severity
Critical
Clearing conditions
The situation does not clear automatically.
Hypervisor Navigator item
KHV_HV_PNW_Utilization_Warn situation
Description
The physical network interface utilization is 40% - 65%.
The situation will be evaluated for each distinct value of Name.
Formula
*IF *VALUE KHV_HYPER_V_SUMMARY.NetworkUtilization *GT 40 *AND *VALUE
KHV_HYPER_V_SUMMARY.NetworkUtilization *LT 65
See Attribute groups and attributes for the Monitoring Agent for Microsoft
Hyper-V Server on page 23 for descriptions of the attributes in this formula.
Run at startup
This situation is available for distribution.
Sampling interval
30 minutes
Situation persistence
The number of times the conditions of the situation must occur for the situation to
be true is 1.
Severity
Warning
Clearing conditions
The situation clears when the condition becomes false.
KHV_HV_PNW_Utilization_Crit situation
Description
The physical network utilization is more than or equal to 65%.
The situation will be evaluated for each distinct value of Name.
174 Monitoring Agent for Microsoft Hyper-V Server: Users Guide
Formula
*IF *VALUE KHV_HYPER_V_SUMMARY.NetworkUtilization *GE 65
See Attribute groups and attributes for the Monitoring Agent for Microsoft
Hyper-V Server on page 23 for descriptions of the attributes in this formula.
Run at startup
This situation is available for distribution.
Sampling interval
10 minutes
Situation persistence
The number of times the conditions of the situation must occur for the situation to
be true is 1.
Severity
Critical
Clearing conditions
The situation clears when the condition becomes false.
KHV_HV_PCPU_Utilization_Warn situation
Description
The system processor utilization is 59% - 90%.
The situation will be evaluated for each distinct value of Name.
Formula
*IF *VALUE KHV_HYPER_V_SUMMARY.SystemCPUUtilization *GT 59 *AND *VALUE
KHV_HYPER_V_SUMMARY.SystemCPUUtilization *LT 90
See Attribute groups and attributes for the Monitoring Agent for Microsoft
Hyper-V Server on page 23 for descriptions of the attributes in this formula.
Run at startup
This situation is available for distribution.
Sampling interval
5 minutes
Situation persistence
The number of times the conditions of the situation must occur for the situation to
be true is 3.
Severity
Warning
Clearing conditions
The situation clears when the condition becomes false.
Chapter 5. Situations reference 175
KHV_HV_PCPU_Utilization_Crit situation
Description
The system processor utilization is more than or equal to 90%.
The situation will be evaluated for each distinct value of Name.
Formula
*IF *VALUE KHV_HYPER_V_SUMMARY.SystemCPUUtilization *GE 90
See Attribute groups and attributes for the Monitoring Agent for Microsoft
Hyper-V Server on page 23 for descriptions of the attributes in this formula.
Run at startup
This situation is available for distribution.
Sampling interval
5 minutes
Situation persistence
The number of times the conditions of the situation must occur for the situation to
be true is 2.
Severity
Critical
Clearing conditions
The situation clears when the condition becomes false.
KHV_HV_PMemory_Available_Warn situation
Description
The available physical memory is 5% - 10%.
The situation will be evaluated for each distinct value of Name.
Formula
*IF *VALUE KHV_HYPER_V_SUMMARY.MemoryAvailable *LT 10 *AND *VALUE
KHV_HYPER_V_SUMMARY.MemoryAvailable *GT 5
See Attribute groups and attributes for the Monitoring Agent for Microsoft
Hyper-V Server on page 23 for descriptions of the attributes in this formula.
Run at startup
This situation is available for distribution.
Sampling interval
15 minutes
Situation persistence
The number of times the conditions of the situation must occur for the situation to
be true is 2.
Severity
Warning
176 Monitoring Agent for Microsoft Hyper-V Server: Users Guide
Clearing conditions
The situation clears when the condition becomes false.
KHV_HV_PMemory_Available_Crit situation
Description
The available physical memory is less than 6%.
The situation will be evaluated for each distinct value of Name.
Formula
*IF *VALUE KHV_HYPER_V_SUMMARY.MemoryAvailable *LE 5
See Attribute groups and attributes for the Monitoring Agent for Microsoft
Hyper-V Server on page 23 for descriptions of the attributes in this formula.
Run at startup
This situation is automatically distributed to instances of this agent.
Sampling interval
5 minutes
Situation persistence
The number of times the conditions of the situation must occur for the situation to
be true is 2.
Severity
Critical
Clearing conditions
The situation clears when the condition becomes false.
KHV_HV_PDisk_Latency_Crit situation
Description
The physical disk latency is more than or equal to 25 ms.
The situation will be evaluated for each distinct value of Name.
Formula
*IF *VALUE KHV_HYPER_V_SUMMARY.DiskReadLatency *GE 25 *OR *VALUE
KHV_HYPER_V_SUMMARY.DiskWriteLatency *GE 25
See Attribute groups and attributes for the Monitoring Agent for Microsoft
Hyper-V Server on page 23 for descriptions of the attributes in this formula.
Run at startup
This situation is available for distribution.
Sampling interval
15 minutes
Situation persistence
The number of times the conditions of the situation must occur for the situation to
be true is 2.
Chapter 5. Situations reference 177
Severity
Critical
Clearing conditions
The situation clears when the condition becomes false.
KHV_HV_PDisk_Latency_Warn situation
Description
The physical disk latency is 15 ms - 25 ms.
The situation will be evaluated for each distinct value of Name.
Formula
*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
See Attribute groups and attributes for the Monitoring Agent for Microsoft
Hyper-V Server on page 23 for descriptions of the attributes in this formula.
Run at startup
This situation is available for distribution.
Sampling interval
15 minutes
Situation persistence
The number of times the conditions of the situation must occur for the situation to
be true is 2.
Severity
Warning
Clearing conditions
The situation clears when the condition becomes false.
Memory Navigator item
KHV_VM_Memory_HealthState situation
Description
Health of the virtual memory running on the virtual machine.
The situation will be evaluated for each distinct value of VirtualMachineName.
Formula
*IF *VALUE KHV_MEMORY.HealthState *EQ Non-Functional
See Attribute groups and attributes for the Monitoring Agent for Microsoft
Hyper-V Server on page 23 for descriptions of the attributes in this formula.
Run at startup
This situation is available for distribution.
178 Monitoring Agent for Microsoft Hyper-V Server: Users Guide
Sampling interval
5 minutes
Situation persistence
The number of times the conditions of the situation must occur for the situation to
be true is 1.
Severity
Critical
Clearing conditions
The situation clears when the condition becomes false.
Network Navigator item
KHV_VM_Switch_HealthState situation
Description
Health of the virtual switch running on the virtual machine.
The situation will be evaluated for each distinct value of SwitchName.
Formula
*IF *VALUE KHV_VIRTUAL_SWITCH.HealthState *EQ Non-Functional
See Attribute groups and attributes for the Monitoring Agent for Microsoft
Hyper-V Server on page 23 for descriptions of the attributes in this formula.
Run at startup
This situation is available for distribution.
Sampling interval
5 minutes
Situation persistence
The number of times the conditions of the situation must occur for the situation to
be true is 1.
Severity
Critical
Clearing conditions
The situation clears when the condition becomes false.
KHV_HV_NWAdapter_FramesDropped situation
Description
The network frames are dropped.
The situation will be evaluated for each distinct value of Name.
Formula
*IF *VALUE KHV_HYPER_V_LEGACY_NETWORK_ADAPTER.Frames_Dropped *GT 0.0
Chapter 5. Situations reference 179
See Attribute groups and attributes for the Monitoring Agent for Microsoft
Hyper-V Server on page 23 for descriptions of the attributes in this formula.
Run at startup
This situation is available for distribution.
Sampling interval
30 minutes
Situation persistence
The number of times the conditions of the situation must occur for the situation to
be true is 1.
Severity
Warning
Clearing conditions
The situation clears when the condition becomes false.
KHV_HV_VSwitch_PacketsFlooded situation
Description
The network packets are flooded.
The situation will be evaluated for each distinct value of Name.
Formula
*IF *VALUE KHV_HYPER_V_VIRTUAL_SWITCH.Packets_Flooded_Per_Sec *GT 0.0
See Attribute groups and attributes for the Monitoring Agent for Microsoft
Hyper-V Server on page 23 for descriptions of the attributes in this formula.
Run at startup
This situation is available for distribution.
Sampling interval
30 minutes
Situation persistence
The number of times the conditions of the situation must occur for the situation to
be true is 1.
Severity
Warning
Clearing conditions
The situation clears when the condition becomes false.
Processor Navigator item
KHV_VM_ProcessorLoad_Crit situation
Description
Virtual machine processor load is more than or equal to 90%.
The situation will be evaluated for each distinct value of VirtualMachineName.
180 Monitoring Agent for Microsoft Hyper-V Server: Users Guide
Formula
*IF *VALUE KHV_PROCESSOR.LoadPercentage *GE 90
See Attribute groups and attributes for the Monitoring Agent for Microsoft
Hyper-V Server on page 23 for descriptions of the attributes in this formula.
Run at startup
This situation is automatically distributed to instances of this agent.
Sampling interval
5 minutes
Situation persistence
The number of times the conditions of the situation must occur for the situation to
be true is 1.
Severity
Critical
Clearing conditions
The situation clears when the condition becomes false.
KHV_VM_Processor_Warn situation
Description
The virtual machine processor load is between 70% and 90%.
The situation will be evaluated for each distinct value of VirtualMachineName.
Formula
*IF *VALUE KHV_PROCESSOR.LoadPercentage *GT 70 *AND *VALUE
KHV_PROCESSOR.LoadPercentage *LT 90
See Attribute groups and attributes for the Monitoring Agent for Microsoft
Hyper-V Server on page 23 for descriptions of the attributes in this formula.
Run at startup
This situation is available for distribution.
Sampling interval
5 minutes
Situation persistence
The number of times the conditions of the situation must occur for the situation to
be true is 1.
Severity
Warning
Clearing conditions
The situation clears when the condition becomes false.
Chapter 5. Situations reference 181
KHV_HV_LP_Utilization_Warn situation
Description
The hypervisor logical processor load is 59% - 90%.
The situation will be evaluated for each distinct value of Name.
Formula
*IF *VALUE KHV_HYPER_V_HYPERVISOR_LOGICAL_PROCESSOR.Pct_Total_Run_Time *GT
59 *AND *VALUE KHV_HYPER_V_HYPERVISOR_LOGICAL_PROCESSOR.Pct_Total_Run_Time
*LT 90 *AND *VALUE KHV_HYPER_V_HYPERVISOR_LOGICAL_PROCESSOR.Name *NE
'_Total'
See Attribute groups and attributes for the Monitoring Agent for Microsoft
Hyper-V Server on page 23 for descriptions of the attributes in this formula.
Run at startup
This situation is available for distribution.
Sampling interval
5 minutes
Situation persistence
The number of times the conditions of the situation must occur for the situation to
be true is 3.
Severity
Warning
Clearing conditions
The situation clears when the condition becomes false.
KHV_HV_LP_Utilization_Crit situation
Description
The logical processor load is more than or equal to 90%.
The situation will be evaluated for each distinct value of Name.
Formula
*IF *VALUE KHV_HYPER_V_HYPERVISOR_LOGICAL_PROCESSOR.Pct_Total_Run_Time *GE
90 *AND *VALUE KHV_HYPER_V_HYPERVISOR_LOGICAL_PROCESSOR.Name *NE '_Total'
See Attribute groups and attributes for the Monitoring Agent for Microsoft
Hyper-V Server on page 23 for descriptions of the attributes in this formula.
Run at startup
This situation is available for distribution.
Sampling interval
5 minutes
Situation persistence
The number of times the conditions of the situation must occur for the situation to
be true is 2.
182 Monitoring Agent for Microsoft Hyper-V Server: Users Guide
Severity
Critical
Clearing conditions
The situation clears when the condition becomes false.
KHV_HV_LP_ContextSwitches situation
Description
Logical processor context switches are going high.
The situation will be evaluated for each distinct value of Name.
Formula
*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'
See Attribute groups and attributes for the Monitoring Agent for Microsoft
Hyper-V Server on page 23 for descriptions of the attributes in this formula.
Run at startup
This situation is available for distribution.
Sampling interval
15 minutes
Situation persistence
The number of times the conditions of the situation must occur for the situation to
be true is 1.
Severity
Warning
Clearing conditions
The situation clears when the condition becomes false.
KHV_HV_RVP_Utilization_Warn situation
Description
The hypervisor root virtual processor load is 59% - 90%.
The situation will be evaluated for each distinct value of Name.
Formula
*IF *VALUE KHV_HYPER_V_HYPERVISOR_ROOT_VIRTUAL_PROCESSOR.Pct_Total_Run_Time
*GT 59 *AND *VALUE
KHV_HYPER_V_HYPERVISOR_ROOT_VIRTUAL_PROCESSOR.Pct_Total_Run_Time *LT 90
See Attribute groups and attributes for the Monitoring Agent for Microsoft
Hyper-V Server on page 23 for descriptions of the attributes in this formula.
Run at startup
This situation is available for distribution.
Chapter 5. Situations reference 183
Sampling interval
5 minutes
Situation persistence
The number of times the conditions of the situation must occur for the situation to
be true is 3.
Severity
Warning
Clearing conditions
The situation clears when the condition becomes false.
KHV_HV_RVP_Utilization_Crit situation
Description
The root virtual processor load is more than or equal to 90%.
The situation will be evaluated for each distinct value of Name.
Formula
*IF *VALUE KHV_HYPER_V_HYPERVISOR_ROOT_VIRTUAL_PROCESSOR.Pct_Total_Run_Time
*GE 90
See Attribute groups and attributes for the Monitoring Agent for Microsoft
Hyper-V Server on page 23 for descriptions of the attributes in this formula.
Run at startup
This situation is automatically distributed to instances of this agent.
Sampling interval
5 minutes
Situation persistence
The number of times the conditions of the situation must occur for the situation to
be true is 2.
Severity
Critical
Clearing conditions
The situation clears when the condition becomes false.
KHV_HV_VP_Utilization_Crit situation
Description
The virtual machine processor load is more than or equal to 90%.
The situation will be evaluated for each distinct value of Name.
Formula
*IF *VALUE KHV_HYPER_V_HYPERVISOR_VIRTUAL_PROCESSOR.Total_Run_Time *GE 90
*AND *VALUE KHV_HYPER_V_HYPERVISOR_VIRTUAL_PROCESSOR.Name *NE '_Total'
See Attribute groups and attributes for the Monitoring Agent for Microsoft
Hyper-V Server on page 23 for descriptions of the attributes in this formula.
184 Monitoring Agent for Microsoft Hyper-V Server: Users Guide
Run at startup
This situation is available for distribution.
Sampling interval
5 minutes
Situation persistence
The number of times the conditions of the situation must occur for the situation to
be true is 2.
Severity
Critical
Clearing conditions
The situation clears when the condition becomes false.
KHV_HV_VP_Utilization_Warn situation
Description
The virtual machine processor load is 59% - 90%.
The situation will be evaluated for each distinct value of Name.
Formula
*IF *VALUE KHV_HYPER_V_HYPERVISOR_VIRTUAL_PROCESSOR.Total_Run_Time *GT 59
*AND *VALUE KHV_HYPER_V_HYPERVISOR_VIRTUAL_PROCESSOR.Total_Run_Time *LT 90
*AND *VALUE KHV_HYPER_V_HYPERVISOR_VIRTUAL_PROCESSOR.Name *NE '_Total'
See Attribute groups and attributes for the Monitoring Agent for Microsoft
Hyper-V Server on page 23 for descriptions of the attributes in this formula.
Run at startup
This situation is available for distribution.
Sampling interval
5 minutes
Situation persistence
The number of times the conditions of the situation must occur for the situation to
be true is 3.
Severity
Warning
Clearing conditions
The situation clears when the condition becomes false.
Virtual Machine Navigator item
KHV_VM_Heartbeat_Crit situation
Description
Hyper-V Virtual Machine heartbeat failed.
The situation will be evaluated for each distinct value of ElementName.
Chapter 5. Situations reference 185
Formula
*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'
See Attribute groups and attributes for the Monitoring Agent for Microsoft
Hyper-V Server on page 23 for descriptions of the attributes in this formula.
Run at startup
This situation is automatically distributed to instances of this agent.
Sampling interval
3 minutes
Situation persistence
The number of times the conditions of the situation must occur for the situation to
be true is 2.
Severity
Critical
Clearing conditions
The situation clears when the condition becomes false.
186 Monitoring Agent for Microsoft Hyper-V Server: Users Guide
Chapter 6. Take Action commands reference
This chapter contains an overview of Take Action commands, references for
detailed information about Take Action commands, and descriptions of the Take
Action commands included in this monitoring agent, if any.
About Take Action commands
Take Action commands can be run from the portal client or included in a situation
or a policy.
When included in a situation, the command runs when the situation becomes true.
A Take Action command in a situation is also referred to as reflex automation.
When you enable a Take Action command in a situation, you automate a response
to system conditions. For example, you can use a Take Action command to send a
command to restart a process on the managed system or to send a text message to
a cell phone.
Advanced automation uses policies to perform actions, schedule work, and
automate manual tasks. A policy comprises a series of automated steps called
activities that are connected to create a workflow. After an activity is completed,
Tivoli Enterprise Portal receives return code feedback, and advanced automation
logic responds with subsequent activities prescribed by the feedback.
A basic Take Action command displays the return code of the operation in a
message box that is displayed after the action completes or in a log file. After you
close this window, no further information is available for this action.
More information about Take Action commands
For more information about working with Take Action commands, see the IBM
Tivoli Monitoring Users Guide.
For a list of the Take Action commands for this monitoring agent and a description
of each command, see the Predefined Take Action commands section in this
chapter and the information in that section for each individual command.
Predefined Take Action commands
This monitoring agent contains the following Take Action commands:
v Start Hyper-V Image Management Service
v Start Hyper-V Networking Management Service
v Start Hyper-V Virtual Machine
v Start Hyper-V Virtual Machine Management Service
v Stop Hyper-V Image Management Service
v Stop Hyper-V Networking Management Service
v Stop Hyper-V Virtual Machine
v Stop Hyper-V Virtual Machine Management Service
Copyright IBM Corp. 2008, 2009 187
The remaining sections of this chapter contain descriptions of these Take Action
commands, which are listed alphabetically. The following information is provided
about each Take Action command:
Description
Which actions the command performs on the system to which it is sent,
and the permissions required for the Take Action command to function
Return codes
Information that the Take Action command returns
Start Hyper-V Image Management Service action
Description
Starts the Hyper-V Image Management Service.
Return codes
v Return Code: 1
Return Code Type: GENERAL_ERROR
Operating systems: Windows
Message ID: KHV0008E
Message: Error starting the Hyper-V Image Management Service.
v Return Code: 0
Return Code Type: OK
Operating systems: Windows
Message ID: KHV0008I
Message: The Hyper-V Image Management Service was started.
v Return Code: 2
Return Code Type: ALREADY_RUNNING
Operating systems: Windows
Message ID: KHV0009I
Message: The Hyper-V Image Management Service is already started.
v Return Code: 9
Return Code Type: WARNING
Operating systems: Windows
Message ID: KHV0100W
Message: The service does not exist as an installed service.
v Return Code: 8
Return Code Type: DOESNT_EXIST
Operating systems: Windows
Message ID: KHV0101I
Message: The service is disabled and cannot be started.
Start Hyper-V Networking Management Service action
Description
Starts the Hyper-V Networking Management Service.
Return codes
v Return Code: 0
Return Code Type: OK
Operating systems: Windows
188 Monitoring Agent for Microsoft Hyper-V Server: Users Guide
Message ID: KHV0015I
Message: The Hyper-V Networking Management Service was started.
v Return Code: 2
Return Code Type: ALREADY_RUNNING
Operating systems: Windows
Message ID: KHV0016I
Message: The Hyper-V Networking Management Service is already started.
v Return Code: 1
Return Code Type: GENERAL_ERROR
Operating systems: Windows
Message ID: KHV0017E
Message: Error starting the Hyper-V Networking Management Service.
v Return Code: 9
Return Code Type: WARNING
Operating systems: Windows
Message ID: KHV0100W
Message: The service does not exist as an installed service.
v Return Code: 8
Return Code Type: DOESNT_EXIST
Operating systems: Windows
Message ID: KHV0101I
Message: The service is disabled and cannot be started.
Start Hyper-V Virtual Machine action
Description
Starts the Hyper-V Virtual Machine.
System command
To include the Take Action command in a situation or workflow policy, use the
following syntax for the system command:
START_HYPER-V_VIRTUAL_MACHINE \
[HVVMName]
You can use attribute substitution to supply the Take Action command arguments
from the situation, for example:
START_HYPER-V_VIRTUAL_MACHINE \
[&{HVVMName}]
You can also use attribute substitution in a workflow policy though the format is
slightly different:
START_HYPER-V_VIRTUAL_MACHINE \
[&WaitOnSituation:HVVMName]
Arguments
v Name: HVVMName
Description: Virtual Machine Name
Default:
Chapter 6. Take Action commands reference 189
Return codes
v Return Code: 0
Return Code Type: GENERAL_ERROR
Operating systems: Windows
Message ID: KHV0104F
Message: Error starting the virtual machine.
v Return Code: 5
Return Code Type: OK
Operating systems: Windows
Message ID: KHV0104S
Message: The virtual machine is successfully started.
v Return Code: 2
Return Code Type: ALREADY_RUNNING
Operating systems: Windows
Message ID: KHV0105G
Message: The Virtual Machine is already started.
Start Hyper-V Virtual Machine Management Service action
Description
Starts the Hyper-V Virtual Machine Management Service.
Return codes
v Return Code: 0
Return Code Type: OK
Operating systems: Windows
Message ID: KHV0001I
Message: The Hyper-V Virtual Machine Management Service was started.
v Return Code: 2
Return Code Type: ALREADY_RUNNING
Operating systems: Windows
Message ID: KHV0002I
Message: The Hyper-V Virtual Machine Management Service is already
started.
v Return Code: 1
Return Code Type: GENERAL_ERROR
Operating systems: Windows
Message ID: KHV0003E
Message: Error starting the Hyper-V Virtual Machine Management
Service.
v Return Code: 9
Return Code Type: WARNING
Operating systems: Windows
Message ID: KHV0100W
Message: The service does not exist as an installed service.
v Return Code: 8
Return Code Type: DOESNT_EXIST
Operating systems: Windows
Message ID: KHV0101I
Message: The service is disabled and cannot be started.
190 Monitoring Agent for Microsoft Hyper-V Server: Users Guide
Stop Hyper-V Image Management Service action
Description
Stops the Hyper-V Image Management Service.
Return codes
v Return Code: 2
Return Code Type: NOT_RUNNING
Operating systems: Windows
Message ID: KHV0102I
Message: The Hyper-V Image Management Service is already stopped.
v Return Code: 1
Return Code Type: GENERAL_ERROR
Operating systems: Windows
Message ID: KHV0103E
Message: Error stopping the Hyper-V Image Management Service.
v Return Code: 0
Return Code Type: OK
Operating systems: Windows
Message ID: KHV0108I
Message: The Hyper-V Image Management Service was stopped.
Stop Hyper-V Networking Management Service action
Description
Stops the Hyper-V Networking Management Service.
Return codes
v Return Code: 0
Return Code Type: OK
Operating systems: Windows
Message ID: KHV0105I
Message: The Hyper-V Networking Management Service was stopped.
v Return Code: 2
Return Code Type: NOT_RUNNING
Operating systems: Windows
Message ID: KHV0106I
Message: The Hyper-V Networking Management Service is already stopped.
v Return Code: 1
Return Code Type: GENERAL_ERROR
Operating systems: Windows
Message ID: KHV0107E
Message: Error stopping the Hyper-V Networking Management Service.
Stop Hyper-V Virtual Machine action
Description
Stops the Hyper-V Virtual Machine.
Chapter 6. Take Action commands reference 191
System command
To include the Take Action command in a situation or workflow policy, use the
following syntax for the system command:
STOP_HYPER-V_VIRTUAL_MACHINE \
[HVVMName]
You can use attribute substitution to supply the Take Action command arguments
from the situation, for example:
STOP_HYPER-V_VIRTUAL_MACHINE \
[&{HVVMName}]
You can also use attribute substitution in a workflow policy though the format is
slightly different:
STOP_HYPER-V_VIRTUAL_MACHINE \
[&WaitOnSituation:HVVMName]
Arguments
v Name: HVVMName
Description: Virtual Machine Name
Default:
Return codes
v Return Code: 0
Return Code Type: GENERAL_ERROR
Operating systems: Windows
Message ID: KHV0105F
Message: Error stopping the virtual machine.
v Return Code: 3
Return Code Type: NOT_RUNNING
Operating systems: Windows
Message ID: KHV0105H
Message: The Virtual Machine is already stopped.
v Return Code: 5
Return Code Type: OK
Operating systems: Windows
Message ID: KHV0105S
Message: The virtual machine is successfully stopped.
Stop Hyper-V Virtual Machine Management Service action
Description
Stops the Hyper-V Virtual Machine Management Service.
Return codes
v Return Code: 0
Return Code Type: OK
Operating systems: Windows
Message ID: KHV0082I
Message: The Hyper-V Virtual Machine Management Service was stopped.
192 Monitoring Agent for Microsoft Hyper-V Server: Users Guide
v Return Code: 2
Return Code Type: NOT_RUNNING
Operating systems: Windows
Message ID: KHV0083I
Message: The Hyper-V Virtual Machine Management Service is already
stopped.
v Return Code: 1
Return Code Type: GENERAL_ERROR
Operating systems: Windows
Message ID: KHV0084E
Message: Error stopping the Hyper-V Virtual Machine Management
Service.
Chapter 6. Take Action commands reference 193
194 Monitoring Agent for Microsoft Hyper-V Server: Users Guide
Chapter 7. Policies reference
This chapter contains an overview of policies, references for detailed information
about policies, and descriptions of the predefined policies included in this
monitoring agent, if any.
About policies
Policies are an advanced automation technique for implementing more complex
workflow strategies than you can create through simple automation.
A policy is a set of automated system processes that can perform actions, schedule
work for users, or automate manual tasks. You use the Workflow Editor to design
policies. You control the order in which the policy executes a series of automated
steps, which are also called activities. Policies are connected to create a workflow.
After an activity is completed, Tivoli Enterprise Portal receives return code
feedback and advanced automation logic responds with subsequent activities
prescribed by the feedback.
More information about policies
This monitoring agent does not provide predefined policies. For more information
about working with policies, see the IBM Tivoli Monitoring Users Guide.
For information about using the Workflow Editor, see the IBM Tivoli Monitoring
Administrators Guide or the Tivoli Enterprise Portal online help.
Predefined policies
The Monitoring Agent for Microsoft Hyper-V Server does not provide predefined
policies.
Copyright IBM Corp. 2008, 2009 195
196 Monitoring Agent for Microsoft Hyper-V Server: Users Guide
Chapter 8. Troubleshooting
This chapter provides agent-specific troubleshooting information. See the IBM
Tivoli Monitoring Troubleshooting Guide for general troubleshooting information. Also
see Support information on page 213 for other problem-solving options.
Note: You can resolve some problems by ensuring that your system matches the
system requirements listed in Chapter 2, Requirements and agent-specific
installation and configuration information for the monitoring agent, on
page 7.
Gathering product information for IBM Software Support
Before contacting IBM Software Support about a problem you are experiencing
with this product, gather the information in Table 5 that relates to the problem.
Table 5. Information to gather before contacting IBM Software Support
Information type Description
Log files Collect trace log files from failing systems. Most logs are located in a logs subdirectory
on the host computer. See Trace logging on page 198 for lists of all trace log files and
their locations. See the IBM Tivoli Monitoring Users Guide for general information about
the IBM Tivoli Monitoring environment.
Microsoft Hyper-V
Server information
v Version number and patch level
Operating system Operating system version number and patch level
Messages Messages and other information displayed on the screen
Version numbers for
IBM Tivoli Monitoring
Version number of the following members of the monitoring environment:
v IBM Tivoli Monitoring. Also provide the patch level, if available.
v IBM Tivoli Monitoring for Microsoft Applications: Microsoft Hyper-V Server Agent
Screen captures Screen captures of incorrect output, if any.
See http://www.ibm.com/software/support/probsub.html for information about
working with IBM Software Support.
Built-in troubleshooting features
The primary troubleshooting feature in the Monitoring Agent for Microsoft
Hyper-V Server is logging. Logging refers to the text messages and trace data
generated by the Monitoring Agent for Microsoft Hyper-V Server. Messages and
trace data are sent to a file.
Trace data captures transient information about the current operating environment
when a component or application fails to operate as designed. IBM Software
Support personnel use the captured trace information to determine the source of
an error or unexpected condition. See Trace logging on page 198 for more
information.
Copyright IBM Corp. 2008, 2009 197
Problem classification
The following types of problems might occur with the Monitoring Agent for
Microsoft Hyper-V Server:
v Installation and configuration
v General usage and operation
v Display of monitoring data
v Take Action commands
This chapter provides symptom descriptions and detailed workarounds for these
problems, as well as describing the logging capabilities of the monitoring agent.
See the IBM Tivoli Monitoring Troubleshooting Guide for general troubleshooting
information.
Trace logging
Trace logs capture information about the operating environment when component
software fails to operate as intended. The principal log type is the RAS (Reliability,
Availability, and Serviceability) trace log. These logs are in the English language
only. The RAS trace log mechanism is available for all components of IBM Tivoli
Monitoring. Most logs are located in a logs subdirectory on the host computer. See
the following sections to learn how to configure and use trace logging:
v Principal trace log files on page 199
v Examples: using trace logs on page 201
v Setting RAS trace parameters on page 202
Note: The documentation refers to the RAS facility in IBM Tivoli Monitoring as
RAS1.
IBM Software Support uses the information captured by trace logging to trace a
problem to its source or to determine why an error occurred. All components in
the IBM Tivoli Monitoring environment have a default tracing level. The tracing
level can be changed on a per-component level to adjust the type of trace
information collected, the degree of trace detail, the number of trace logs to be
kept, and the amount of disk space used for tracing.
Using KHVEventReader to retrieve events
The Event Log attribute group uses the KHVEventReader application to internally
retrieve events that are specific to Hyper-V. The KHVEventReader application
name and directory path are as follows:
File name
KHVEventReader.exe
Directory path
install_dir\tmaitm6
The KHVEventReader application also generates a log file depending on the values
that you set for the KBB_RAS1 variable in the KHVENV file. The file name and
directory path for the generated log file are as follows:
File name
hostname_hv_KHVEventReader_timestamp.log, where timestamp is the time
stamp representing the time at which the KHVEventReader application
198 Monitoring Agent for Microsoft Hyper-V Server: Users Guide
started. The format for the timestamp is year (y), month (m), day (d), hour
(h), and minute (m), as follows: yyyymmddhhmm
Directory path
installdir\TMAITM6\logs
You can set the following values for the KBB_RAS1 variable in the KHVENV file:
v No error tracing: KBB_RAS1 = -none-
v General error tracing: KBB_RAS1 = ERROR
v Maximum error tracing: KBB_RAS1 = ERROR (COMP:kqz ALL) (UNIT:kra ALL)
Note: If the value of the trace level is other than -none-, ERROR, or ERROR
(COMP:kqz ALL) (UNIT:kra ALL), then the default trace level is set to
ERROR.
Overview of log file management
Table 6 on page 200 provides the names, locations, and descriptions of RAS1 log
files. The log file names adhere to the following naming convention:
Windows systems
hostname_productcode_program_HEXtimestamp-nn.log
Note: The file name for the log generated by the KHVEventReader application
adheres to the following naming convention:
Windows systems
hostname_productcode_program_timestamp.log
where:
v hostname is the host name of the computer where the monitoring component is
running.
v productcode is the two-character product code. For IBM Tivoli Monitoring for
Microsoft Applications: Microsoft Hyper-V Server Agent, the product code is hv.
v program is the name of the program being run.
v HEXtimestamp is a hexadecimal time stamp representing the time at which the
program started.
v nn is a rolling log suffix.
v timestamp is a time stamp representing the time at which the KHVEventReader
application started. The format for the timestamp is year (y), month (m), day (d),
hour (h), and minute (m), as follows: yyyymmddhhmm
Principal trace log files
Table 6 on page 200 contains locations, file names, and descriptions of trace logs
that can help determine the source of problems with agents.
Chapter 8. Troubleshooting 199
Table 6. Trace log files for troubleshooting agents
System where log
is located
File name and path Description
On the Tivoli
Enterprise
Monitoring Server
v Windows: The file in the
install_dir\InstallITM path
v UNIX

: The candle_installation.log file in


the install_dir/logs path
Provides details about products that are
installed.
Note: Trace logging is enabled by default. A
configuration step is not required to enable this
tracing.
The Warehouse_Configuration.log file is in
the following location on Windows systems:
install_dir\InstallITM
Provides details about the configuration of data
warehousing for historical reporting.
The name of the RAS log file is as follows:
v Windows: install_dir\logs\
hostname_ms_timestamp-nn.log
v UNIX: install_dir/logs/
hostname_productcode_timestamp.log
Note: File names for RAS1 logs include a
hexadecimal time stamp.
Also on UNIX, a log with a decimal time
stamp is provided:
hostname_productcode_timestamp.log and
hostname_productcode_ timestamp.pidnnnnn in
the install_dir/logs path, where nnnnn is the
process ID number.
Traces activity on the monitoring server.
On the Tivoli
Enterprise Portal
Server
The name of the RAS log file is as follows:
v Windows: install_dir\logs\
hostname_cq_HEXtimestamp-nn.log
v UNIX: install_dir/logs/
hostname_cq_HEXtimestamp-nn.log
Note: File names for RAS1 logs include a
hexadecimal time stamp.
Also on UNIX, a log with a decimal time
stamp is provided:
hostname_productcode_timestamp.log and
hostname_productcode_ timestamp.pidnnnnn in
the install_dir/logs path, where nnnnn is the
process ID number.
Traces activity on the portal server.
The teps_odbc.log file is located in the
following path
v Windows: install_dir\InstallITM path.
v UNIX: install_dir/logs
When you enable historical reporting, this log
file traces the status of the warehouse proxy
agent.
200 Monitoring Agent for Microsoft Hyper-V Server: Users Guide
Table 6. Trace log files for troubleshooting agents (continued)
System where log
is located
File name and path Description
On the computer
that hosts the
monitoring agent
The RAS1 log files are as follows:
v Windows: hostname_hv_khvagent
_HEXtimestamp-nn.log in the
install_dir\tmaitm6\logs directory
These logs are in the following directories:
v Windows: install_dir\tmaitm6\logs
Traces activity of the monitoring agent.
The agent operations log files are as follows:
instance_hostname_HV.LG0 is the current log
created when the agent was started
instance_hostname_HV.LG1 is the backup of
the previous log
These logs are in the following directory
depending on the operating system that you
are using:
v Windows: install_dir\tmaitm6\logs
Shows whether the agent was able to connect to
the monitoring server. Shows which situations
are started and stopped, and shows other events
while the agent is running. A new version of this
file is generated every time the agent is
restarted.
IBM Tivoli Monitoring generates one backup
copy of the *.LG0 file with the tag .LG1. View
.LG1 to learn the following details regarding the
previous monitoring session:
v Status of connectivity with the monitoring
server.
v Situations that were running.
v The success or failure status of Take Action
commands.
The name of the RAS1 log file created by
the KHVEventReader application is as
follows:
Windows:
hostname_hv_KHVEventReader_timestamp.log
The log is in the following directory:
Windows: install_dir\tmaitm6\logs
Traces the activity of the KHVEventReader
application.
Definitions of variables:
timestamp is time stamp whose format includes year (y), month (m), day (d), hour (h), and minute (m), as
follows: yyyymmddhhmm
HEXtimestamp is a hexadecimal representation of the time at which the process was started.
install_dir represents the directory path where you installed the IBM Tivoli Monitoring component. install_dir can
represent a path on the computer that host the monitoring system, the monitoring agent, or the portal.
instance refers to the name of the database instance that you are monitoring.
hostname refers to the name of the computer on which the IBM Tivoli Monitoring component runs.
nn represents the circular sequence in which logs are rotated. Ranges from 1-5, by default, though the first is
always retained, because it includes configuration parameters.
productcode specifies the product codes, for example, um for Universal Agent or nt for Windows.
See the IBM Tivoli Monitoring Installation and Setup Guide for more information on
the complete set of trace logs that are maintained on the monitoring server.
Examples: using trace logs
Typically, IBM Software Support applies specialized knowledge to analyze trace
logs to determine the source of problems. You can open trace logs in a text editor
to learn some basic facts about your IBM Tivoli Monitoring environment. The
following examples are from the Tivoli Enterprise Monitoring Server log.
Chapter 8. Troubleshooting 201
Example one
This excerpt shows the typical log for a failed connection between a
monitoring agent and a monitoring server with the host name server1a:
(Thursday, August 11, 2005, 08:21:30-{94C}kdcl0cl.c,105,"KDCL0_ClientLookup") status=1c020006,
"location server unavailable", ncs/KDC1_STC_SERVER_UNAVAILABLE
(Thursday, August 11, 2005, 08:21:35-{94C}kraarreg.cpp,1157,"LookupProxy") Unable to connect to
broker at ip.pipe:: status=0, "success", ncs/KDC1_STC_OK
(Thursday, August 11, 2005, 08:21:35-{94C}kraarreg.cpp,1402,"FindProxyUsingLocalLookup") Unable
to find running CMS on CT_CMSLIST <IP.PIPE:#server1a>
Example two
The following excerpts from the trace log for the monitoring server show the
status of an agent, identified here as Remote node. The name of the
computer where the agent is running is SERVER5B:
(42C039F9.0000-6A4:kpxreqhb.cpp,649,"HeartbeatInserter") Remote node SERVER5B:HV is ON-LINE.
. . .
(42C3079B.0000-6A4:kpxreqhb.cpp,644,"HeartbeatInserter") Remote node SERVER5B:HV is OFF-LINE.
Key points regarding the preceding excerpt:
v The monitoring server appends the HV product code to the server name
to form a unique name (SERVER5B:HV) for this instance of the Monitoring
Agent for Microsoft Hyper-V Server. This unique name enables you to
distinguish multiple monitoring products that might be running on
SERVER5B.
v The log shows when the agent started (ON-LINE) and later stopped
(OFF-LINE) in the environment.
v For the sake of brevity an ellipsis (...) represents the series of trace log
entries that were generated while the agent was running.
v Between the ON-LINE and OFF-LINE log entries, the agent was
communicating with the monitoring server.
v The ON-LINE and OFF-LINE log entries are always available in the
trace log. All trace levels that are described in Setting RAS trace
parameters provide these entries.
On Windows, you can use the following alternate method to view trace logs:
1. In the Windows Start menu, choose Program Files > IBM Tivoli Monitoring >
Manage Tivoli Enterprise Monitoring Services. The Manage Tivoli Enterprise
Monitoring Services window is displayed.
2. Right-click a component and select Advanced > View Trace Log in the pop-up
menu. For example, if you want to view the trace log of the Microsoft Hyper-V
Server agent, right-click the name of the that agent in the window. You can also
use the viewer to access remote logs.
Note: The viewer converts time stamps in the logs to a format that is easier to
read.
Setting RAS trace parameters
Objective
Pinpoint a problem by setting detailed tracing of individual components of the
monitoring agent and modules.
202 Monitoring Agent for Microsoft Hyper-V Server: Users Guide
Background Information
The Monitoring Agent for Microsoft Hyper-V Server uses RAS1 tracing and
generates the logs described in Table 6 on page 200. The default RAS1 trace level is
ERROR.
Before you begin
See Overview of log file management on page 199 to ensure that you understand
log rolling and can reference the correct log files when you manage log file
generation.
After you finish
Monitor the size of the logs directory. Default behavior can generate a total of 45 to
60 MB for each agent that is running on a computer. For example, each database
instance that you monitor can generate 45 to 60 MB of log data. See the
Procedure section to learn how to adjust file size and numbers of log files to
prevent logging activity from occupying too much disk space.
Regularly prune log files other than the RAS1 log files in the logs directory. Unlike
the RAS1 log files that are pruned automatically, other log types can grow
indefinitely, for example, the logs in Table 6 on page 200 that include a process ID
number (PID).
Consider using collector trace logs as an additional source of troubleshooting
information.
Note: The KDC_DEBUG setting and the Maximum error tracing setting can
generate a large amount of trace logging. Use them only temporarily, while
you are troubleshooting problems. Otherwise, the logs can occupy excessive
amounts of hard disk space.
Procedure
On Windows systems, you can use the graphical user interface to set trace options:
1. Open the Manage Tivoli Enterprise Monitoring Services window.
2. Right-click the icon of the monitoring agent whose logging you want to modify.
3. Select Advanced > Edit Trace Parms. The Tivoli Enterprise Monitoring Server
Trace Parameters window is displayed.
4. Select a new trace setting in the pull-down menu in the Enter RAS1 Filters
field or type a valid string.
The selections are as follows:
v General error tracing. KBB_RAS1=ERROR
v Intensive error tracing. KBB_RAS1=ERROR (UNIT:kqz ALL)
v Maximum error tracing. KBB_RAS1=ERROR (UNIT:kqz ALL) (UNIT:kra ALL)
Note: As this example shows, you can set multiple RAS tracing options in a
single statement.
5. Modify the value for Maximum Log Size Per File (MB) to change the log file
size (changes LIMIT value).
6. Modify the value for Maximum Number of Log Files Per Session to change
the number of log files per startup of a program (changes COUNT value).
7. Modify the value for Maximum Number of Log Files Total to change the
number of log files for all startups of a program (changes MAXFILES value).
Chapter 8. Troubleshooting 203
8. (Optional) Click Y (Yes) in the KDC_DEBUG Setting menu to log information
that can help you diagnose communications and connectivity problems
between the monitoring agent and the monitoring server.
Note: The KDC_DEBUG setting and the Maximum error tracing setting can
generate a large amount of trace logging. Use them only temporarily,
while you are troubleshooting problems. Otherwise, the logs can occupy
excessive amounts of hard disk space.
9. Click OK. You see a message reporting a restart of the monitoring agent so that
your changes take effect.
You can also manually edit the RAS1 trace logging parameters using this method:
1. Open the trace options file:
Windows: install_dir\tmaitm6\KHVENV
2. Edit the line that begins with KBB_RAS1= to set trace logging preferences. For
example, if you want detailed trace logging, set the Maximum Tracing
option:KBB_RAS1=ERROR (UNIT:kqz ALL) (UNIT:kra ALL)
3. Edit the line that begins with KBB_RAS1_LOG= to manage the generation of
log files:
v MAXFILES: the total number of files that are to be kept for all startups of a
given program. When this value is exceeded, the oldest log files are
discarded. Default value is 9.
v LIMIT: the maximum size, in megabytes (MB) of a RAS1 log file. Default
value is 5.
v IBM Software Support might guide you to modify the following parameters:
COUNT: the number of log files to keep in the rolling cycle of one
program startup. Default is 3.
PRESERVE: the number of files that are not to be reused in the rolling
cycle of one program startup. Default value is 1.
Note: The KBB_RAS1_LOG parameter also provides for the specification of
the log file directory, log file name, and the inventory control file
directory and name. Do not modify these values or log information can
be lost.
4. Restart the monitoring agent so that your changes take effect.
Problems and workarounds
The following sections provide symptoms and workarounds for problems that
might occur with the Monitoring Agent for Microsoft Hyper-V Server:
v Installation and configuration troubleshooting on page 205
v Remote deployment troubleshooting on page 206
v Agent troubleshooting on page 207
v Workspace troubleshooting on page 208
v Situation troubleshooting on page 210
Note: You can resolve some problems by ensuring that your system matches the
system requirements listed in Chapter 2, Requirements and agent-specific
installation and configuration information for the monitoring agent, on
page 7.
This chapter provides agent-specific troubleshooting information. See the IBM
Tivoli Monitoring Troubleshooting Guide for general troubleshooting information.
204 Monitoring Agent for Microsoft Hyper-V Server: Users Guide
Installation and configuration troubleshooting
This section provides tables that show solutions for installation, configuration, and
uninstallation problems.
Table 7. Problems and solutions for installation and configuration
Problem Solution
A problem can arise when you install and configure a
new monitoring agent to a computer where other agents
are running as described in this example:
v Agents are running on computer and communicating
with a Tivoli Enterprise Monitoring Server, called
TEMS1.
v You install a new agent on the same computer and
you want this agent to communicate with a different
monitoring server, called TEMS2.
v When you configure the new agent to communicate
with TEMS2, all the existing agents are re-configured
to communicate with TEMS2.
You must reconfigure the previously existing agents to
restore their communication connection with TEMS1. For
example, you can right-click the row for a specific agent
in the Manage Tivoli Enterprise Monitoring Services, and
select Reconfigure. See the IBM Tivoli Monitoring
Installation and Setup Guide for more information on
reconfiguration.
Diagnosing problems with product browse settings
(Windows systems only).
When you have problems with browse settings, perform
the following steps:
1. Click Start > Programs > IBM Tivoli Monitoring >
Manage Tivoli Enterprise Monitoring Services. The
Manage Tivoli Enterprise Monitoring Services window
is displayed.
2. Right-click the Windows agent and select Browse
Settings. A text window is displayed.
3. Click Save As and save the information in the text file.
If requested, you can forward this file to IBM Software
Support for analysis.
A message similar to Unable to find running CMS on
CT_CMSLIST in the log file is displayed.
If a message similar to Unable to find running CMS on
CT_CMSLIST is displayed in the Log file, the agent is
not able to connect to the monitoring server. Confirm the
following points:
v Do multiple network interface cards (NICs) exist on the
system?
v If multiple NICs exist on the system, find out which
one is configured for the monitoring server. Ensure that
you specify the correct host name and port settings for
communication in the IBM Tivoli Monitoring
environment.
The system is experiencing high CPU usage. Agent process: View the memory usage of the KHVCMA
process. If CPU usage seems to be excessive, recycle the
monitoring agent.
Network Cards: The network card configurations can
decrease the performance of a system. Each of the stream
of packets that a network card receives (assuming it is a
broadcast or destined for the under-performing system)
must generate a CPU interrupt and transfer the data
through the I/O bus. If the network card in question is a
bus-mastering card, work can be off-loaded and a data
transfer between memory and the network card can
continue without using CPU processing power.
Bus-mastering cards are generally 32-bit and are based on
PCI or EISA bus architectures.
Chapter 8. Troubleshooting 205
Table 7. Problems and solutions for installation and configuration (continued)
Problem Solution
When new V6.1 or V6.2 agent support files are added to
IBM Tivoli Monitoring V6.2.1 on Windows 2008, the
portal server configuration portion of the installation
hangs.
See When new agent support files are added to V6.2.1,
the portal server configuration portion of the installation
hangs in the Installation and configuration
troubleshooting chapter of the IBM Tivoli Monitoring
Troubleshooting Guide.
Table 8. General problems and solutions for uninstallation
Problem Solution
On Windows, uninstallation of
IBM Tivoli Monitoring fails to
uninstall the entire environment.
Be sure that you follow the general uninstallation process described in the IBM
Tivoli Monitoring Installation and Setup Guide:
1. Remove Tivoli Enterprise Monitoring Server Application support by
completing the following steps:
a. Use Manage Tivoli Enterprise Monitoring Services.
b. Select Tivoli Enterprise Monitoring Server.
c. Right-click and select Advanced.
d. Select Remove TEMS application support.
e. Select the agent to remove its application support.
2. Uninstall monitoring agents first, as in the following examples:
v Uninstall a single monitoring agent for a specific database.
-OR-
v Uninstall all instances of a monitoring product, such as IBM Tivoli
Monitoring for Databases.
3. Uninstall IBM Tivoli Monitoring.
The way to remove inactive
managed systems (systems whose
status is OFFLINE) from the
Navigator tree in the portal is not
obvious.
Use the following steps to remove, but not uninstall, an offline managed system
from the Navigator tree:
1. Click the Enterprise icon in the Navigator tree.
2. Right-click, then click Workspace > Managed System Status.
3. Right-click the offline managed system, and select Clear offline entry.
If you also want to uninstall the monitoring agent, use the procedure described
in the IBM Tivoli Monitoring Installation and Setup Guide.
Remote deployment troubleshooting
Table 9 on page 207 lists problems that might occur with remote deployment. This
section provides information about troubleshooting remote deployment of the
monitoring agent. See the IBM Tivoli Monitoring Troubleshooting Guide for general
troubleshooting information.
This section describes problems and solutions for remote deployment and removal
of agent software using Agent Remote Deploy.
206 Monitoring Agent for Microsoft Hyper-V Server: Users Guide
Table 9. Remote deployment problems and solutions
Problem Solution
While you are using the remote deployment feature
to install the Monitoring Agent for Microsoft
Hyper-V Server, an empty command window is
displayed on the target computer. This problem
occurs when the target of remote deployment is a
Windows computer. (See the IBM Tivoli Monitoring
Installation and Setup Guide for more information on
the remote deployment feature.)
Do not close or modify this window. It is part of the
installation process and is dismissed automatically.
The removal of a monitoring agent fails when you
use the remote removal process in the Tivoli
Enterprise Portal desktop or browser.
This problem might occur when you attempt the remote
removal process immediately after you have restarted the
Tivoli Enterprise Monitoring Server. You must allow time for
the monitoring agent to refresh its connection with the Tivoli
Enterprise Monitoring Server before you begin the remote
removal process.
Agent troubleshooting
This section lists problems that might occur with agents.
This chapter provides agent-specific troubleshooting information. See the IBM
Tivoli Monitoring Troubleshooting Guide for general troubleshooting information.
Table 10. Agent problems and solutions
Problem Solution
Log data accumulates too
rapidly.
Check the RAS trace option settings, which are described in Setting RAS trace
parameters on page 202. The trace options settings that you can set on the
KBB_RAS1= and KDC_DEBUG= lines potentially generate large amounts of data.
When using the F1 key or
selecting Help --> Contents and
Index, you receive a message in
your Microsoft Internet Explorer
browser which states, It seems
javascript is disabled in your
browser, please enable it and
reload again, or click here to
view without javascript. If you
select here, the Tivoli Enterprise
Portal Help is displayed, but the
agent help is not.
Ensure that the local site is added to the trusted site for the browser, and then
enable the javascript.
If you set the Notes attribute to
have multiline text when setting
the configuration for a virtual
machine, then the data row for
that virtual machine is not
visible in the Virtual Machine
attribute group.
To change the Notes attribute value, start the Hyper-V Manager and perform the
following steps:
1. In the Hyper-V Manager, select the Hyper-V host name to open the Virtual
Machine list for the selected Hyper-V host name.
2. Right-click the required virtual machine, and click Settings.
3. Click Management > Name.
4. Enter only a single line of text in the Notes window.
The Time Generated attribute in
the Event Log attribute group
does not show time according to
the local time zone.
The Time Generated attribute displays the Greenwich Median Time (GMT).
Based on the time difference in GMT and your local time, you can convert the
time displayed by the Time Generated attribute to your local time.
You can also see the value for the Timestamp attribute to see the local time at
which the event is generated.
Chapter 8. Troubleshooting 207
Table 10. Agent problems and solutions (continued)
Problem Solution
A configured and running
instance of the monitoring agent
is not displayed in the Tivoli
Enterprise Portal, but other
instances of the monitoring agent
on the same system do appear in
the portal.
Tivoli Monitoring products use Remote Procedure Call (RPC) to define and
control product behavior. RPC is the mechanism that allows a client process to
make a subroutine call (such as GetTimeOfDay or ShutdownServer) to a server
process somewhere in the network. Tivoli processes can be configured to use
TCP/UDP, TCP/IP, SNA, and SSL as the desired protocol (or delivery
mechanism) for RPCs.
IP.PIPE is the name given to Tivoli TCP/IP protocol for RPCs. The RPCs are
socket-based operations that use TCP/IP ports to form socket addresses. IP.PIPE
implements virtual sockets and multiplexes all virtual socket traffic across a
single physical TCP/IP port (visible from the netstat command).
A Tivoli process derives the physical port for IP.PIPE communications based on
the configured, well-known port for the HUB Tivoli Enterprise Monitoring
Server. (This well-known port or BASE_PORT is configured using the PORT:
keyword on the KDC_FAMILIES / KDE_TRANSPORT environment variable and
defaults to 1918.)
The physical port allocation method is defined as (BASE_PORT + 4096*N) where
N=0 for a Tivoli Enterprise Monitoring Server process and N={1, 2, ..., 15} for a
non-Tivoli Enterprise Monitoring Server. Two architectural limits result as a
consequence of the physical port allocation method:
v No more than one Tivoli Enterprise Monitoring Server reporting to a specific
Tivoli Enterprise Monitoring Server HUB can be active on a system image.
v No more than 15 IP.PIPE processes can be active on a single system image.
A single system image can support any number of Tivoli Enterprise Monitoring
Server processes (address spaces) provided that each Tivoli Enterprise
Monitoring Server on that image reports to a different HUB. By definition, there
is one Tivoli Enterprise Monitoring Server HUB per monitoring Enterprise, so
this architecture limit has been simplified to one Tivoli Enterprise Monitoring
Server per system image.
No more than 15 IP.PIPE processes or address spaces can be active on a single
system image. With the first limit expressed above, this second limitation refers
specifically to Tivoli Enterprise Monitoring Agent processes: no more than 15
agents per system image.
This limitation can be circumvented (at current maintenance levels, IBM Tivoli
Monitoring V6.1 Fix Pack 4 and later) if the Tivoli Enterprise Monitoring Agent
process is configured to use EPHEMERAL IP.PIPE. (This is IP.PIPE configured
with the EPHEMERAL:Y keyword in the KDC_FAMILIES / KDE_TRANSPORT
environment variable). There is no limitation to the number of ephemeral IP.PIPE
connections per system image. If ephemeral endpoints are used, the Warehouse
Proxy Agent is accessible from the Tivoli Enterprise Monitoring Server associated
with the agents using ephemeral connections either by running the Warehouse
Proxy Agent on the same computer or by using the Firewall Gateway feature.
(The Firewall Gateway feature relays the Warehouse Proxy Agent connection
from the Tivoli Enterprise Monitoring Server computer to the Warehouse Proxy
Agent computer if the Warehouse Proxy Agent cannot coexist on the same
computer.)
Workspace troubleshooting
Table 11 on page 209 shows problems that might occur with workspaces. This
chapter provides agent-specific troubleshooting information. See the IBM Tivoli
Monitoring Troubleshooting Guide for general troubleshooting information.
208 Monitoring Agent for Microsoft Hyper-V Server: Users Guide
Table 11. Workspace problems and solutions
Problem Solution
The process application components are
available, but the Availability status shows
PROCESS_DATA_NOT_ AVAILABLE.
This problem occurs because the PerfProc performance object is
disabled. When this condition exists, IBM Tivoli Monitoring
cannot collect performance data for this process. Do the
following to confirm that this problem exists and resolve it:
1. Choose Run in the Windows Start menu.
2. Type perfmon.exe in the Open field of the Run window. The
Performance window is displayed.
3. Click the plus sign (+) in the tool bar located above the right
pane. The Add Counters window is displayed.
4. Look for Process in the Performance object pull-down menu.
5. Perform one of the following actions:
v If you see Process in the pull-down menu, the PerfProc
performance object is enabled and the problem is coming
from a different source. You might need to contact IBM
Software Support.
v If you do not see Process in the pull-down menu, use the
Microsoft utility from the following Web site to enable the
PerfProc performance object:
http://blogs.technet.com/mscom/archive/2008/12/18/
the-mystery-of-the-missing-process-performance-
counter-in-perfmon.aspxThe Process performance object
becomes visible in the Performance object pull-down
menu of the Add Counters windows, and IBM Tivoli
Monitoring is able to detect Availability data.
6. Restart the monitoring agent.
The name of the attribute does not display in a
bar chart or graph view.
When a chart or graph view that includes the attribute is scaled
to a small size, a blank space is displayed instead of a truncated
name. To see the name of the attribute, expand the view of the
chart until there is sufficient space to display all characters of the
attribute name.
You start collection of historical data but the data
cannot be seen.
Managing options for historical data collection:
v Basic historical data collection populates the Warehouse with
raw data. This type of data collection is turned off by default.
See the IBM Tivoli Monitoring Administrators Guide for
information on managing this feature including how to set the
interval at which data is collected. By setting a more frequent
interval for data collection you reduce the load on the system
incurred every time data is uploaded.
v You use the Summarization and Pruning monitoring agent to
collect specific amounts and types of historical data. Be aware
that historical data is not displayed until the Summarization
and Pruning monitoring agent begins collecting the data. By
default, this agent begins collection at 2 AM daily. At that
point, data is visible in the workspace view. See the IBM Tivoli
Monitoring Administrators Guide to learn how to modify the
default collection settings.
Chapter 8. Troubleshooting 209
Table 11. Workspace problems and solutions (continued)
Problem Solution
Historical data collection is unavailable because
of incorrect queries in the Tivoli Enterprise
Portal.
The column, Sort By, Group By, and First/Last functions are not
compatible with the historical data collection feature. Use of
these advanced functions makes a query ineligible for historical
data collection.
Even if data collection has been started, you cannot use the time
span feature if the query for the chart or table includes column
functions or advanced query options (Sort By, Group By, First /
Last).
To ensure support of historical data collection, do not use the
Sort By, Group By, or First/Last functions in your queries.
See the IBM Tivoli Monitoring Administrators Guide or the Tivoli
Enterprise Portal online help for information about the Historical
Data Collection function.
When you use a long process name in the
situation, the process name is truncated.
Truncation of process or service names for situations in the
Availability table in the portal display is the expected behavior.
100 bytes is the maximum name length.
Regular (non-historical) monitoring data fails to
be displayed.
Check the formation of the queries you use to gather data. For
example, look for invalid SQL statements.
Navigator items and workspace titles are labeled
with internal names such as Kr6:KR60000 or
Knt:KNT0000 rather than the correct names (such
as Disk).
Ensure application support has been added on the monitoring
server, portal server, and portal client.
For more information and instruction on installing application
support see Installing and enabling application support in the
IBM Tivoli Monitoring Installation and Setup Guide.
The Event Log workspace events are removed
from the Event Log view after every 100 data
rows.
Environment variables that control the behavior of the Event Log
workspace are stored in the agent ENV file on the Tivoli
Enterprise Monitoring agent, where the agent is running. The
CDP_PURE_EVENT_CACHE_SIZE variable in the agent ENV
file controls the number of data rows that will be cached. By
default the value is set to 100.
You can modify the value for the
CDP_PURE_EVENT_CACHE_SIZE variable to include the
number of data rows that you require.
To view or edit the agent ENV file, on the Tivoli Enterprise
Monitoring agent where the agent is installed, use Manage Tivoli
Enterprise Monitoring Services to select the agent. Right-click the
agent, click Advanced , and click Edit ENV File. Restart the
agent to implement the changes.
Situation troubleshooting
This section provides information about both general situation problems and
problems with the configuration of situations. See the IBM Tivoli Monitoring
Troubleshooting Guide for more information about troubleshooting for situations.
General situation problems
Table 12 on page 211 lists general problems that might occur with situations.
210 Monitoring Agent for Microsoft Hyper-V Server: Users Guide
Table 12. General situation problems and solutions
Problem Solution
Monitoring activity requires too much
disk space.
Check the RAS trace logging settings that are described in Setting RAS
trace parameters on page 202. For example, trace logs grow rapidly
when you apply the ALL logging option.
Monitoring activity requires too many
system resources.
Disk capacity planning for historical data on page 166 describes the
performance impact of specific attribute groups. If possible, decrease your
use of the attribute groups that require greater system resources.
A formula that uses mathematical
operators appears to be incorrect. For
example, if you were monitoring Linux,
a formula that calculates when Free
Memory falls under 10 percent of Total
Memory does not work: LT
#'Linux_VM_Stats.Total_Memory' / 10
This formula is incorrect because situation predicates support only logical
operators. Your formulas cannot have mathematical operators.
Note: The Situation Editor provides alternatives to math operators.
Regarding the example, you can select % Memory Free attribute and
avoid the need for math operators.
You want to change the appearance of
situations when they are displayed in
the Navigation tree.
1. Right-click an item in the Navigation tree.
2. Select Situations in the pop-up menu. The Situation Editor window is
displayed.
3. Select the situation that you want to modify.
4. Use the State pull-down menu in the lower right of the window to set
the status and appearance of the Situation when it triggers.
Note: The State setting is not related to severity settings in IBM Tivoli
Enterprise Console.
When a situation is triggered in the
Event Log attribute group, it remains in
the Situation Event Console as long as
the event ID entry is present in the
Event Log workspace. When this event
ID entry is removed from the Event Log
workspace on the Tivoli Enterprise
Portal, the situation is also cleared even
if the actual problem that caused the
event is not resolved, and the event ID
entry is also present in the Windows
Event Viewer.
There is a timeout on the cache of events for the NT Event Log group.
Increase the cache time of Event Log collection to meet your requirements
by adding the following variable and timeout value to the KXXENV file
for the agent: CDP_NT_EVENT_LOG_CACHE_TIMEOUT=3600
This variable determines how long events from the NT Event Log are
kept.
Problems with configuration of situations
Table 13 lists problems that might occur with configuring situations.
This section provides information for troubleshooting for agents. Be sure to consult
the IBM Tivoli Monitoring Troubleshooting Guide for more general troubleshooting
information.
Table 13. Problems with configuring situations that you solve in the Situation Editor
Problem Solution
Note: To get started with the solutions in this section, perform these steps:
1. Launch the Tivoli Enterprise Portal.
2. Click Edit > Situation Editor.
3. In the tree view, choose the agent whose situation you want to modify.
4. Choose the situation in the list. The Situation Editor view is displayed.
The situation for a specific agent is
not visible in the Tivoli Enterprise
Portal.
Open the Situation Editor. Access the All managed servers view. If the situation
is absent, confirm that the monitoring server has been seeded for the agent. If
not, seed the server, as described in the IBM Tivoli Monitoring Installation and
Setup Guide.
Chapter 8. Troubleshooting 211
Table 13. Problems with configuring situations that you solve in the Situation Editor (continued)
Problem Solution
The monitoring interval is too
long.
Access the Situation Editor view for the situation that you want to modify.
Check the Sampling interval area in the Formula tab. Adjust the time interval
as needed.
The situation did not activate at
startup.
Manually recycle the situation as follows:
1. Right-click the situation and choose Stop Situation.
2. Right-click the situation and choose Start Situation.
Note: You can permanently avoid this problem by placing a check mark in the
Run at Startup option of the Situation Editor view for a specific situation.
The situation is not displayed. Click the Action tab and check whether the situation has an automated
corrective action. This action can occur directly or through a policy. The
situation might be resolving so quickly that you do not see the event or the
update in the graphical user interface.
An Alert event has not occurred
even though the predicate has been
properly specified.
Check the logs, reports, and workspaces.
A situation fires on an unexpected
managed object.
Confirm that you have distributed and started the situation on the correct
managed system.
The product did not distribute the
situation to a managed system.
Click the Distribution tab and check the distribution settings for the situation.
The situation does not fire. This problem can be caused when incorrect predicates are present in the
formula that defines the situation. For example, the managed object shows a
state that normally triggers a monitoring event, but the situation is not true
because the wrong attribute is specified in the formula.
In the Formula tab, analyze predicates as follows:
1. Click the fx icon in the upper-right corner of the Formula area. The Show
formula window is displayed.
a. Confirm the following details in the Formula area at the top of the
window:
v The attributes that you intend to monitor are specified in the formula.
v The situations that you intend to monitor are specified in the formula.
v The logical operators in the formula match your monitoring goal.
v The numerical values in the formula match your monitoring goal.
b. (Optional) Click the Show detailed formula check box in the lower left
of the window to see the original names of attributes in the application
or operating system that you are monitoring.
c. Click OK to dismiss the Show formula window.
2. (Optional) In the Formula area of the Formula tab, temporarily assign
numerical values that immediately trigger a monitoring event. The
triggering of the event confirms that other predicates in the formula are
valid.
Note: After you complete this test, you must restore the numerical values
to valid levels so that you do not generate excessive monitoring data based
on your temporary settings.
See the IBM Tivoli Monitoring Troubleshooting Guide for additional information
about situations that do not fire.
212 Monitoring Agent for Microsoft Hyper-V Server: Users Guide
Table 14. Problems with configuration of situations that you solve in the Workspace area
Problem Solution
Situation events are not displayed
in the Events Console view of the
workspace.
Associate the situation with a Navigator item.
Note: The situation does not need to be displayed in the workspace. It is
sufficient that the situation be associated with any Navigator item.
You do not have access to a
situation.
Note: You must have administrator privileges to perform these steps.
1. Select Edit > Administer Users to access the Administer Users window.
2. In the Users area, select the user whose privileges you want to modify.
3. In the Permissions tab, Applications tab, and Navigator Views tab, select
the permissions or privileges that correspond to the user role.
4. Click OK.
A managed system seems to be
offline.
1. Select Physical View and highlight the Enterprise Level of the navigator
tree.
2. Select View > Workspace > Managed System Status to see a list of
managed systems and their status.
3. If a system is offline, check network connectivity and the status of the
specific system or application.
Take Action commands troubleshooting
Table 15 lists general problems that might occur with Take Action commands.
When each Take Action command runs it generates the log file listed in Table 6 on
page 200. This chapter provides agent-specific troubleshooting information.
See the IBM Tivoli Monitoring Troubleshooting Guide for general troubleshooting
information.
Table 15. Take Action commands problems and solutions
Problem Solution
Take Action commands often require several
minutes to complete.
Allow several minutes. If you do not see a pop-up message
advising you of completion, try to run the command manually.
Situations fail to trigger Take Action commands. Attempt to manually run the Take Action command in the Tivoli
Enterprise Portal. If the Take Action command works, look for
configuration problems in the situation. See Situation
troubleshooting on page 210. If the Take Action command fails,
see IBM Tivoli Monitoring Troubleshooting Guide for general
information on troubleshooting Take Action commands.
Support information
If you have a problem with your IBM software, you want to resolve it quickly. IBM
provides the following ways for you to obtain the support you need:
Online
Go to the IBM Software Support site at http://www.ibm.com/software/
support/probsub.html and follow the instructions.
IBM Support Assistant
The IBM Support Assistant (ISA) is a free local software serviceability
workbench that helps you resolve questions and problems with IBM
software products. The ISA provides quick access to support-related
information and serviceability tools for problem determination. To install
the ISA software, go to http://www.ibm.com/software/support/isa.
Chapter 8. Troubleshooting 213
Informational, warning, and error messages
This chapter introduces message logging and explains how to gather information
from those logs.
Message logging refers to the text and numeric messages created by the software.
These messages relay information about how the system or application is
performing and can alert you to exceptional conditions when they occur. Messages
are sent to an output destination, such as a file, database, or console screen.
If you receive a warning or error message, you can do one of the following:
v Follow the instructions listed in the Detail window of the message if this
information is included there.
v Consult the message details listed in this chapter to see what action you can take
to correct the problem.
v Consult the message log for message ID and text, time and date of the message,
as well as other data you can use to diagnose the problem.
Message format
Monitoring Agent for Microsoft Hyper-V Server messages have the following
format:
Message ID and text
Explanation
Operator Response
The message ID has the following format:
CCC####severity
where:
CCC Prefix that indicates the component to which the message applies. The
component is one of the following:
KHV General Monitoring Agent for Microsoft Hyper-V Server messages
#### Number of the message
severity
Severity of the message. There are three levels of severity:
I Informational messages provide feedback about something that
happened in the product or system that might be important. These
messages can provide guidance when you are requesting a specific
action from the product.
W Warning messages call your attention to an exception condition.
The condition might not be an error but can cause problems if not
resolved.
E Error messages indicate that an action cannot be completed
because of a user or system error. These messages require user
response.
The Text of the message provides a general statement regarding the problem or
condition that occurred. The Explanation provides additional information about the
214 Monitoring Agent for Microsoft Hyper-V Server: Users Guide
message and what might have caused the condition. The Operator Response
provides actions to take in response to the condition, particularly for error
messages (messages with the E suffix).
Note: Many message texts and explanations contain variables, such as the specific
name of a server or application. Those variables are represented in this
chapter as symbols, such as &1. Actual messages contain values for these
variables.
This chapter includes the messages for the following software:
v Monitoring Agent for Microsoft Hyper-V Server
Monitoring Agent for Microsoft Hyper-V Server messages
KHV0001I The Hyper-V Virtual Machine Management Service was started.
Explanation: The Hyper-V Virtual Machine Management Service was started.
Operator response: None.
KHV0002I The Hyper-V Virtual Machine Management Service is already started.
Explanation: The Hyper-V Virtual Machine Management Service is already started.
Operator response: None.
KHV0003E Error starting the Hyper-V Virtual Machine Management Service.
Explanation: Error starting the Hyper-V Virtual Machine Management Service.
Operator response: Check the event log for more information.
KHV0008I The Hyper-V Image Management Service was started.
Explanation: The Hyper-V Image Management Service was started.
Operator response: None.
KHV0009I The Hyper-V Image Management Service is already started.
Explanation: The Hyper-V Image Management Service is already started.
Operator response: None.
KHV0008E Error starting the Hyper-V Image Management Service.
Explanation: Error starting the Hyper-V Image Management Service.
Operator response: Check the event log for more information.
KHV0015I The Hyper-V Networking Management Service was started.
Explanation: The Hyper-V Networking Management Service was started.
Operator response: None.
KHV0016I The Hyper-V Networking Management Service is already started.
Explanation: The Hyper-V Networking Management Service is already started.
Operator response: None.
KHV0001I KHV0016I
Chapter 8. Troubleshooting 215
KHV0017E Error starting the Hyper-V Networking Management Service.
Explanation: Error starting the Hyper-V Networking Management Service.
Operator response: Check the event log for more information.
KHV0082I The Hyper-V Virtual Machine Management Service was stopped.
Explanation: The Hyper-V Virtual Machine Management Service was stopped.
Operator response: None.
KHV0083I The Hyper-V Virtual Machine Management Service is already stopped.
Explanation: The Hyper-V Virtual Machine Management Service is already stopped.
Operator response: None.
KHV0084E Error stopping the Hyper-V Virtual Machine Management Service.
Explanation: Error stopping the Hyper-V Virtual Machine Management Service.
Operator response: Check the event log for more information.
KHV0108I The Hyper-V Image Management Service was stopped.
Explanation: The Hyper-V Image Management Service was stopped.
Operator response: None.
KHV0102I The Hyper-V Image Management Service is already stopped.
Explanation: The Hyper-V Image Management Service is already stopped.
Operator response: None.
KHV0103E Error stopping the Hyper-V Image Management Service.
Explanation: Error stopping the Hyper-V Image Management Service.
Operator response: Check the event log for more information.
KHV0105I The Hyper-V Networking Management Service was stopped.
Explanation: The Hyper-V Networking Management Service was stopped.
Operator response: None.
KHV0106I The Hyper-V Networking Management Service is already stopped.
Explanation: The Hyper-V Networking Management Service is already stopped.
Operator response: None.
KHV0107E Error stopping the Hyper-V Networking Management Service.
Explanation: Error stopping the Hyper-V Networking Management Service.
Operator response: Check the event log for more information.
KHV0017E KHV0107E
216 Monitoring Agent for Microsoft Hyper-V Server: Users Guide
KHV0100W The service does not exist as an installed service.
Explanation: The service does not exist as an installed service.
Operator response: None.
KHV0101I The service is disabled and cannot be started.
Explanation: The service is disabled and cannot be started.
Operator response: None.
KHV0104S The virtual machine is successfully started.
Explanation: The virtual machine is successfully started.
Operator response: None.
KHV0104F Error starting the virtual machine.
Explanation: Error starting the virtual machine.
Operator response: None.
KHV0105S The virtual machine is successfully stopped.
Explanation: The virtual machine is successfully stopped.
Operator response: None.
KHV0105F Error stopping the virtual machine.
Explanation: Error stopping the virtual machine.
Operator response: None.
KHV0105G The Virtual Machine is already started.
Explanation: The Virtual Machine is already started.
Operator response: None.
KHV0105H The Virtual Machine is already stopped.
Explanation: The Virtual Machine is already stopped.
Operator response: None.
KHV0100W KHV0105H
Chapter 8. Troubleshooting 217
218 Monitoring Agent for Microsoft Hyper-V Server: Users Guide
Appendix A. IBM Tivoli Enterprise Console event mapping
Each event class corresponds to an attribute group in the IBM Tivoli Enterprise
Console. For a description of the event slots for each event class, see the lists in
this appendix. For more information about mapping attribute groups to event
classes, see the IBM Tivoli Monitoring Administrators Guide.
Generic event mapping provides useful event class and attribute information for
situations that do not have specific event mapping defined. BAROC files are found
on the Tivoli Enterprise Monitoring Server in the installation directory in TECLIB
(that is, install_dir/cms/TECLIB for Windows systems and install_dir/tables/
TEMS_hostname/TECLIB for UNIX systems). IBM Tivoli Enterprise Console event
synchronization provides a collection of ready-to-use rule sets that you can deploy
with minimal configuration. Be sure to install IBM Tivoli Enterprise Console event
synchronization to access the correct Sentry.baroc, which is automatically included
during base configuration of IBM Tivoli Enterprise Console rules if you indicate
that you want to use an existing rulebase. See the IBM Tivoli Monitoring Installation
and Setup Guide for details.
Each of the event classes is a child of KHV_Base and is defined in the khv.baroc
file. The KHV_Base event class can be used for generic rules processing for any
event from the IBM Tivoli Monitoring for Microsoft Applications: Microsoft
Hyper-V Server Agent.
For events generated by situations in the Availability attribute group, Tivoli
Enterprise Console

events are sent using the ITM_KHV_AVAILABILITY class.


This class contains the following slots:
v node: STRING
v timestamp: STRING
v application_component: STRING
v name: STRING
v name_enum: STRING
v khv_status: INTEGER
v khv_status_enum: STRING
v full_name: STRING
v full_name_enum: STRING
v type: INTEGER
v type_enum: STRING
v virtual_size: INTEGER
v page_faults_per_sec: INTEGER
v working_set_size: INTEGER
v thread_count: INTEGER
v pid: INTEGER
v percent_privileged_time: INTEGER
v percent_user_mode_time: INTEGER
v percent_processor_time: INTEGER
v command_line: STRING
v command_line_enum: STRING
Copyright IBM Corp. 2008, 2009 219
v functionality_test_status: INTEGER
v functionality_test_status_enum: STRING
v functionality_test_message: STRING
For events generated by situations in the Disk attribute group, Tivoli Enterprise
Console events are sent using the ITM_KHV_DISK class. This class contains the
following slots:
v node: STRING
v timestamp: STRING
v virtualmachinename: STRING
v availability: INTEGER
v availability_enum: STRING
v healthstate: INTEGER
v healthstate_enum: STRING
v enabledstate: INTEGER
v enabledstate_enum: STRING
v maxdiskallocated: INTEGER
v defaultblocksize: INTEGER
v loadtime: INTEGER
v totalmounttime: INTEGER
v freephysicaldisk: INTEGER
v systemname: STRING
v deviceid: STRING
For events generated by situations in the Enterprise Hyper-V Summary attribute
group, Tivoli Enterprise Console events are sent using the
ITM_KHV_ENTERPRISE_HYPER-V_SUMMARY class. This class contains the
following slots:
v node: STRING
v timestamp: STRING
v systemcpuutilization: INTEGER
v memoryavailable: INTEGER
v memoryutilized: INTEGER
v diskreadlatency: INTEGER
v diskwritelatency: INTEGER
v networkutilization: INTEGER
v maxlogicalprocessor: INTEGER
v maxvirtualprocessor: INTEGER
For events generated by situations in the Event Log attribute group, Tivoli
Enterprise Console events are sent using the ITM_KHV_EVENT_LOG class. This
class contains the following slots:
v node: STRING
v timestamp: STRING
v log_name: STRING
v event_source: STRING
v event_id: INTEGER
220 Monitoring Agent for Microsoft Hyper-V Server: Users Guide
v event_type: INTEGER
v event_type_enum: STRING
v event_category: INTEGER
v event_category_enum: STRING
v time_generated: STRING
v message: STRING
For events generated by situations in the Hyper-V Hypervisor Logical Processor
attribute group, Tivoli Enterprise Console events are sent using the
ITM_KHV_HYPER-V_HYPERVISOR_LOGICAL_PROCESSOR class. This class
contains the following slots:
v node: STRING
v timestamp: STRING
v pct_c1_time: REAL
v pct_c2_time: REAL
v pct_c3_time: REAL
v pct_guest_run_time: REAL
v pct_hypervisor_run_time: REAL
v pct_idle_time: REAL
v pct_total_run_time: REAL
v c1_transitions_per_sec: REAL
v c2_transitions_per_sec: REAL
v c3_transitions_per_sec: REAL
v context_switches_per_sec: REAL
v hardware_interrupts_per_sec: REAL
v inter_processor_interrupts_per_sec: REAL
v inter_processor_interrupts_sent_per_sec: REAL
v monitor_transition_cost_ns: REAL
v monitor_transition_cost: REAL
v scheduler_interrupts_per_sec: REAL
v timer_interrupts_per_sec: REAL
v total_interrupts_per_sec: REAL
v name: STRING
For events generated by situations in the Hyper-V Hypervisor Partition attribute
group, Tivoli Enterprise Console events are sent using the ITM_KHV_HYPER-
V_HYPERVISOR_PARTITION class. This class contains the following slots:
v node: STRING
v timestamp: STRING
v address_spaces: INTEGER
v deposited_pages: INTEGER
v gpa_pages: INTEGER
v gpa_space_modifications_per_sec: REAL
v virtual_processors: INTEGER
v virtual_tlb_flush_entires_per_sec: REAL
v virtual_tlb_pages: INTEGER
v name: STRING
Appendix A. IBM Tivoli Enterprise Console event mapping 221
For events generated by situations in the Hyper-V Hypervisor Root Partition
attribute group, Tivoli Enterprise Console events are sent using the
ITM_KHV_HYPER-V_HYPERVISOR_ROOT_PARTITION class. This class contains
the following slots:
v node: STRING
v timestamp: STRING
v address_spaces: INTEGER
v deposited_pages: INTEGER
v virtual_processors: INTEGER
v virtual_tlb_flush_entires_per_sec: REAL
v virtual_tlb_pages: INTEGER
v name: STRING
For events generated by situations in the Hyper-V Hypervisor Root Virtual
Processor attribute group, Tivoli Enterprise Console events are sent using the
ITM_KHV_HYPER-V_HYPERVISOR_ROOT_VIRTUAL_PROCESSOR class. This
class contains the following slots:
v node: STRING
v timestamp: STRING
v pct_guest_run_time: REAL
v pct_hypervisor_run_time: REAL
v pct_total_run_time: REAL
v cpuid_instructions_per_sec: REAL
v cpuid_instructions_cost_ns: REAL
v cpuid_instructions_cost: REAL
v gpa_space_hypercalls_per_sec: REAL
v guest_page_table_maps_per_sec: REAL
v page_fault_intercepts_per_sec: REAL
v page_invalidations_per_sec: REAL
v page_invalidations_cost_ns: REAL
v page_invalidations_cost: REAL
v total_intercepts_per_sec: REAL
v total_intercepts_cost_ns: REAL
v total_intercepts_cost: REAL
v total_messages_per_sec: REAL
v virtual_interrupt_hypercalls_per_sec: REAL
v virtual_interrupts_per_sec: REAL
v virtual_mmu_hypercalls_per_sec: REAL
v virtual_processor_hypercalls_per_sec: REAL
v name: STRING
For events generated by situations in the Hyper-V Hypervisor Root Virtual
Processor More attribute group, Tivoli Enterprise Console events are sent using the
ITM_KHV_HYPER-V_HYPERVISOR_ROOT_VIRTUAL_PROCESSOR_MORE class.
This class contains the following slots:
v node: STRING
v timestamp: STRING
222 Monitoring Agent for Microsoft Hyper-V Server: Users Guide
v address_domain_flushes_per_sec: REAL
v address_space_evictions_per_sec: REAL
v address_space_flushes_per_sec: REAL
v address_space_switches_per_sec: REAL
v apic_eoi_accesses_per_sec: REAL
v apic_ipis_sent_per_sec: REAL
v apic_mmio_accesses_per_sec: REAL
v apic_self_ipis_sent_per_sec: REAL
v apic_tpr_accesses_per_sec: REAL
v control_register_accesses_per_sec: REAL
v control_register_accesses_cost_ns: REAL
v control_register_accesses_cost: REAL
v debug_register_accesses_per_sec: REAL
v debug_register_accesses_cost_ns: REAL
v debug_register_accesses_cost: REAL
v emulated_instructions_per_sec: REAL
v emulated_instructions_cost_ns: REAL
v emulated_instructions_cost: REAL
v external_interrupts_per_sec: REAL
v external_interrupts_cost_ns: REAL
v external_interrupts_cost: REAL
v global_gva_range_flushes_per_sec: REAL
v hlt_instructions_per_sec: REAL
v hlt_instructions_cost_ns: REAL
v hlt_instructions_cost: REAL
v hypercalls_per_sec: REAL
v hypercalls_cost_ns: REAL
v hypercalls_cost: REAL
v io_instructions_per_sec: REAL
v io_instructions_cost_ns: REAL
v io_instructions_cost: REAL
v io_intercept_messages_per_sec: REAL
v large_page_tlb_fills_per_sec: REAL
v local_flushed_gva_ranges_per_sec: REAL
v logical_processor_hypercalls_per_sec: REAL
v logical_processor_migrations_per_sec: REAL
v long_spin_wait_hypercalls_per_sec: REAL
v memory_intercept_messages_per_sec: REAL
v msr_accesses_per_sec: REAL
v msr_accesses_cost_ns: REAL
v msr_accesses_cost: REAL
v mwait_instructions_per_sec: REAL
v mwait_instructions_cost_ns: REAL
v mwait_instructions_cost: REAL
v other_hypercalls_per_sec: REAL
Appendix A. IBM Tivoli Enterprise Console event mapping 223
v other_intercepts_per_sec: REAL
v other_intercepts_cost_ns: REAL
v other_intercepts_cost: REAL
v other_messages_per_sec: REAL
v page_fault_intercepts_cost_ns: REAL
v page_fault_intercepts_cost: REAL
v page_table_allocations_per_sec: REAL
v page_table_eviction_per_sec: REAL
v page_table_reclamations_per_sec: REAL
v page_table_resets_per_sec: REAL
v page_table_validations_per_sec: REAL
v page_table_write_intercepts_per_sec: REAL
v pending_interrupts_per_sec: REAL
v pending_interrupts_cost_ns: REAL
v pending_interrupts_cost: REAL
v reflected_guest_page_faults_per_sec: REAL
v small_page_tlb_fills_per_sec: REAL
v synthetic_interrupt_hypercalls_per_sec: REAL
v synthetic_interrupts_per_sec: REAL
v name: STRING
For events generated by situations in the Hyper-V Hypervisor Virtual Processor
attribute group, Tivoli Enterprise Console events are sent using the
ITM_KHV_HYPER-V_HYPERVISOR_VIRTUAL_PROCESSOR class. This class
contains the following slots:
v node: STRING
v timestamp: STRING
v pct_guest_run_time: REAL
v pct_hypervisor_run_time: REAL
v total_run_time: REAL
v cpuid_instructions_per_sec: REAL
v cpuid_instructions_cost_ns: REAL
v cpuid_instructions_cost: REAL
v gpa_space_hypercalls_per_sec: REAL
v guest_page_table_maps_per_sec: REAL
v page_fault_intercepts_per_sec: REAL
v page_fault_intercepts_cost_ns: REAL
v page_fault_intercepts_cost: REAL
v page_invalidations_per_sec: REAL
v page_invalidations_cost_ns: REAL
v page_invalidations_cost: REAL
v total_intercepts_per_sec: REAL
v total_intercepts_cost_ns: REAL
v total_intercepts_cost: REAL
v total_messages_per_sec: REAL
v virtual_interrupt_hypercalls_per_sec: REAL
224 Monitoring Agent for Microsoft Hyper-V Server: Users Guide
v virtual_interrupts_per_sec: REAL
v virtual_mmu_hypercalls_per_sec: REAL
v virtual_processor_hypercalls_per_sec: REAL
v name: STRING
For events generated by situations in the Hyper-V Hypervisor Virtual Processor
More attribute group, Tivoli Enterprise Console events are sent using the
ITM_KHV_HYPER-V_HYPERVISOR_VIRTUAL_PROCESSOR_MORE class. This
class contains the following slots:
v node: STRING
v timestamp: STRING
v address_domain_flushes_per_sec: REAL
v address_space_evictions_per_sec: REAL
v address_space_flushes_per_sec: REAL
v address_space_switches_per_sec: REAL
v apic_eoi_accesses_per_sec: REAL
v apic_ipis_sent_per_sec: REAL
v apic_mmio_accesses_per_sec: REAL
v apic_self_ipis_sent_per_sec: REAL
v apic_tpr_accesses_per_sec: REAL
v control_register_accesses_per_sec: REAL
v control_register_accesses_cost_ns: REAL
v control_register_accesses_cost: REAL
v debug_register_accesses_per_sec: REAL
v debug_register_accesses_cost_ns: REAL
v debug_register_accesses_cost: REAL
v emulated_instructions_per_sec: REAL
v emulated_instructions_cost_ns: REAL
v emulated_instructions_cost: REAL
v external_interrupts_per_sec: REAL
v external_interrupts_cost_ns: REAL
v external_interrupts_cost: REAL
v global_gva_range_flushes_per_sec: REAL
v hlt_instructions_per_sec: REAL
v hlt_instructions_cost_ns: REAL
v hlt_instructions_cost: REAL
v hypercalls_per_sec: REAL
v hypercalls_cost_ns: REAL
v hypercalls_cost: REAL
v io_instructions_per_sec: REAL
v io_instructions_cost_ns: REAL
v io_instructions_cost: REAL
v io_intercept_messages_per_sec: REAL
v large_page_tlb_fills_per_sec: REAL
v local_flushed_gva_ranges_per_sec: REAL
v logical_processor_hypercalls_per_sec: REAL
Appendix A. IBM Tivoli Enterprise Console event mapping 225
v logical_processor_migrations_per_sec: REAL
v long_spin_wait_hypercalls_per_sec: REAL
v memory_intercept_messages_per_sec: REAL
v msr_accesses_per_sec: REAL
v msr_accesses_cost_ns: REAL
v msr_accesses_cost: REAL
v mwait_instructions_per_sec: REAL
v mwait_instructions_cost_ns: REAL
v mwait_instructions_cost: REAL
v other_hypercalls_per_sec: REAL
v other_intercepts_per_sec: REAL
v other_intercepts_cost_ns: REAL
v other_intercepts_cost: REAL
v other_messages_per_sec: REAL
v page_table_allocations_per_sec: REAL
v page_table_eviction_per_sec: REAL
v page_table_reclamations_per_sec: REAL
v page_table_resets_per_sec: REAL
v page_table_validations_per_sec: REAL
v page_table_write_intercepts_per_sec: REAL
v pending_interrupts_per_sec: REAL
v pending_interrupts_cost_ns: REAL
v pending_interrupts_cost: REAL
v reflected_guest_page_faults_per_sec: REAL
v small_page_tlb_fills_per_sec: REAL
v synthetic_interrupt_hypercalls_per_sec: REAL
v synthetic_interrupts_per_sec: REAL
v name: STRING
For events generated by situations in the Hyper-V Legacy Network Adapter
attribute group, Tivoli Enterprise Console events are sent using the
ITM_KHV_HYPER-V_LEGACY_NETWORK_ADAPTER class. This class contains
the following slots:
v node: STRING
v timestamp: STRING
v bytes_dropped: INTEGER
v bytes_received_per_sec: REAL
v bytes_sent_per_sec: REAL
v frames_dropped: INTEGER
v frames_received_per_sec: REAL
v frames_sent_per_sec: REAL
v name: STRING
For events generated by situations in the Hyper-V Summary attribute group, Tivoli
Enterprise Console events are sent using the ITM_KHV_HYPER-V_SUMMARY
class. This class contains the following slots:
v node: STRING
226 Monitoring Agent for Microsoft Hyper-V Server: Users Guide
v timestamp: STRING
v systemcpuutilization: INTEGER
v memoryavailable: INTEGER
v memoryutilized: INTEGER
v diskreadlatency: INTEGER
v diskwritelatency: INTEGER
v networkutilization: INTEGER
v maxlogicalprocessor: INTEGER
v maxvirtualprocessor: INTEGER
For events generated by situations in the Hyper-V Task Manager Detail attribute
group, Tivoli Enterprise Console events are sent using the ITM_KHV_HYPER-
V_TASK_MANAGER_DETAIL class. This class contains the following slots:
v node: STRING
v timestamp: STRING
v add_resources_virtual_machine_tasks_completed: INTEGER
v add_resources_virtual_machine_tasks_in_progress: INTEGER
v apply_snapshot_virtual_machine_tasks_completed: INTEGER
v apply_snapshot_virtual_machine_tasks_in_progress: INTEGER
v clone_virtual_machine_tasks_completed: INTEGER
v clone_virtual_machine_tasks_in_progress: INTEGER
v create_vss_snapshot_set_tasks_completed: INTEGER
v create_vss_snapshot_set_tasks_in_progress: INTEGER
v define_virtual_machine_tasks_completed: INTEGER
v define_virtual_machine_tasks_in_progress: INTEGER
v destroy_snapshot_virtual_machine_tasks_completed: INTEGER
v destroy_snapshot_virtual_machine_tasks_in_progress: INTEGER
v destroy_virtual_machine_tasks_completed: INTEGER
v destroy_virtual_machine_tasks_in_progress: INTEGER
v export_virtual_machine_tasks_completed: INTEGER
v export_virtual_machine_tasks_in_progress: INTEGER
v import_virtual_machine_tasks_completed: INTEGER
v import_virtual_machine_tasks_in_progress: INTEGER
v merge_disk_tasks_completed: INTEGER
v merge_disk_tasks_in_progress: INTEGER
v migrate_virtual_machine_tasks_completed: INTEGER
v migrate_virtual_machine_tasks_in_progress: INTEGER
v modify_resources_virtual_machine_tasks_completed: INTEGER
v modify_resources_virtual_machine_tasks_in_progress: INTEGER
v modify_service_settings_tasks_completed: INTEGER
v modify_service_settings_tasks_in_progress: INTEGER
v modify_virtual_machine_tasks_completed: INTEGER
v modify_virtual_machine_tasks_in_progress: INTEGER
v pause_virtual_machine_tasks_completed: INTEGER
v pause_virtual_machine_tasks_in_progress: INTEGER
v remove_resources_virtual_machine_tasks_completed: INTEGER
Appendix A. IBM Tivoli Enterprise Console event mapping 227
v remove_resources_virtual_machine_tasks_in_progress: INTEGER
v reset_virtual_machine_tasks_completed: INTEGER
v reset_virtual_machine_tasks_in_progress: INTEGER
v restore_virtual_machine_tasks_completed: INTEGER
v restore_virtual_machine_tasks_in_progress: INTEGER
v resume_virtual_machine_tasks_completed: INTEGER
v resume_virtual_machine_tasks_in_progress: INTEGER
v save_virtual_machine_tasks_completed: INTEGER
v save_virtual_machine_tasks_in_progress: INTEGER
v shutdown_virtual_machine_tasks_completed: INTEGER
v shutdown_virtual_machine_tasks_in_progress: INTEGER
v snapshot_virtual_machine_tasks_completed: INTEGER
v snapshot_virtual_machine_tasks_in_progress: INTEGER
v start_virtual_machine_tasks_completed: INTEGER
v start_virtual_machine_tasks_in_progress: INTEGER
v waiting_to_start_virtual_machine_tasks_completed: INTEGER
v waiting_to_start_virtual_machine_tasks_in_progress: INTEGER
For events generated by situations in the Hyper-V Task Manager Recent Time
attribute group, Tivoli Enterprise Console events are sent using the
ITM_KHV_HYPER-V_TASK_MANAGER_RECENT_TIME class. This class contains
the following slots:
v node: STRING
v timestamp: STRING
v waiting_to_start_virtual_machine_tasks_recent_time: REAL
v waiting_to_start_virtual_machine_tasks_recent_time_ms: REAL
v add_resources_virtual_machine_tasks_recent_time: REAL
v apply_snapshot_virtual_machine_tasks_recent_time: REAL
v clone_virtual_machine_tasks_recent_time: REAL
v create_vss_snapshot_set_tasks_recent_time: REAL
v define_virtual_machine_tasks_recent_time: REAL
v destroy_snapshot_virtual_machine_tasks_recent_time: REAL
v destroy_virtual_machine_tasks_recent_time: REAL
v export_virtual_machine_tasks_recent_time: REAL
v import_virtual_machine_tasks_recent_time: REAL
v merge_disk_tasks_recent_time: REAL
v migrate_virtual_machine_tasks_recent_time: REAL
v modify_resources_virtual_machine_tasks_recent_time: REAL
v modify_service_settings_tasks_recent_time: REAL
v modify_virtual_machine_tasks_recent_time: REAL
v pause_virtual_machine_tasks_recent_time: REAL
v remove_resources_virtual_machine_tasks_recent_time: REAL
v reset_virtual_machine_tasks_recent_time: REAL
v restore_virtual_machine_tasks_recent_time: REAL
v resume_virtual_machine_tasks_recent_time: REAL
v save_virtual_machine_tasks_recent_time: REAL
228 Monitoring Agent for Microsoft Hyper-V Server: Users Guide
v shutdown_virtual_machine_tasks_recent_time: REAL
v snapshot_virtual_machine_tasks_recent_time: REAL
v start_virtual_machine_tasks_recent_time: REAL
v add_resources_virtual_machine_tasks_recent_time_ms: REAL
v apply_snapshot_virtual_machine_tasks_recent_time_ms: REAL
v clone_virtual_machine_tasks_recent_time_ms: REAL
v create_vss_snapshot_set_tasks_recent_time_ms: REAL
v define_virtual_machine_tasks_recent_time_ms: REAL
v destroy_snapshot_virtual_machine_tasks_recent_time_ms: REAL
v destroy_virtual_machine_tasks_recent_time_ms: REAL
v export_virtual_machine_tasks_recent_time_ms: REAL
v import_virtual_machine_tasks_recent_time_ms: REAL
v merge_disk_tasks_recent_time_ms: REAL
v migrate_virtual_machine_tasks_recent_time_ms: REAL
v modify_resources_virtual_machine_tasks_recent_time_ms: REAL
v modify_service_settings_tasks_recent_time_ms: REAL
v modify_virtual_machine_tasks_recent_time_ms: REAL
v pause_virtual_machine_tasks_recent_time_ms: REAL
v remove_resources_virtual_machine_tasks_recent_time_ms: REAL
v reset_virtual_machine_tasks_recent_time_ms: REAL
v restore_virtual_machine_tasks_recent_time_ms: REAL
v resume_virtual_machine_tasks_recent_time_ms: REAL
v save_virtual_machine_tasks_recent_time_ms: REAL
v shutdown_virtual_machine_tasks_recent_time_ms: REAL
v snapshot_virtual_machine_tasks_recent_time_ms: REAL
v start_virtual_machine_tasks_recent_time_ms: REAL
For events generated by situations in the Hyper-V Virtual IDE Controller attribute
group, Tivoli Enterprise Console events are sent using the ITM_KHV_HYPER-
V_VIRTUAL_IDE_CONTROLLER class. This class contains the following slots:
v node: STRING
v timestamp: STRING
v read_bytes_per_sec: REAL
v read_sectors_per_sec: REAL
v write_bytes_per_sec: REAL
v written_sectors_per_sec: REAL
v name: STRING
For events generated by situations in the Hyper-V Virtual Machine Bus attribute
group, Tivoli Enterprise Console events are sent using the ITM_KHV_HYPER-
V_VIRTUAL_MACHINE_BUS class. This class contains the following slots:
v node: STRING
v timestamp: STRING
v interrupts_received: INTEGER
v change_in_interrupts_received: INTEGER
v interrupts_sent: INTEGER
Appendix A. IBM Tivoli Enterprise Console event mapping 229
v change_in_interrupts_sent: INTEGER
v throttle_events: INTEGER
v change_in_throttle_events: INTEGER
For events generated by situations in the Hyper-V Virtual Machine Health
Summary attribute group, Tivoli Enterprise Console events are sent using the
ITM_KHV_HYPER-V_VIRTUAL_MACHINE_HEALTH_SUMMARY class. This
class contains the following slots:
v node: STRING
v timestamp: STRING
v health_critical: INTEGER
v health_ok: INTEGER
For events generated by situations in the Hyper-V Virtual Machine Summary
attribute group, Tivoli Enterprise Console events are sent using the
ITM_KHV_HYPER-V_VIRTUAL_MACHINE_SUMMARY class. This class contains
the following slots:
v node: STRING
v timestamp: STRING
v applying_snapshot: INTEGER
v deleting: INTEGER
v deleting_saved_state: INTEGER
v deleting_snapshot: INTEGER
v exporting: INTEGER
v merging_disks: INTEGER
v paused: INTEGER
v pausing: INTEGER
v resetting: INTEGER
v resuming: INTEGER
v running: INTEGER
v saved: INTEGER
v saving: INTEGER
v starting: INTEGER
v stopping: INTEGER
v taking_snapshot: INTEGER
v turned_off: INTEGER
v waiting_to_start: INTEGER
For events generated by situations in the Hyper-V Virtual Network Adapter
attribute group, Tivoli Enterprise Console events are sent using the
ITM_KHV_HYPER-V_VIRTUAL_NETWORK_ADAPTER class. This class contains
the following slots:
v node: STRING
v timestamp: STRING
v broadcast_packets_received_per_sec: REAL
v broadcast_packets_sent_per_sec: REAL
v bytes_per_sec: REAL
v bytes_received_per_sec: REAL
230 Monitoring Agent for Microsoft Hyper-V Server: Users Guide
v bytes_sent_per_sec: REAL
v directed_packets_received_per_sec: REAL
v directed_packets_sent_per_sec: REAL
v multicast_packets_received_per_sec: REAL
v multicast_packets_sent_per_sec: REAL
v packets_per_sec: REAL
v packets_received_per_sec: REAL
v packets_sent_per_sec: REAL
v name: STRING
For events generated by situations in the Hyper-V Virtual Switch attribute group,
Tivoli Enterprise Console events are sent using the ITM_KHV_HYPER-
V_VIRTUAL_SWITCH class. This class contains the following slots:
v node: STRING
v timestamp: STRING
v broadcast_packets_received_per_sec: REAL
v broadcast_packets_sent_per_sec: REAL
v directed_packets_received_per_sec: REAL
v directed_packets_sent_per_sec: REAL
v learned_mac_addresses: INTEGER
v learned_mac_addresses_per_sec: REAL
v multicast_packets_received_per_sec: REAL
v multicast_packets_sent_per_sec: REAL
v packets_flooded: INTEGER
v packets_flooded_per_sec: REAL
v purged_mac_addresses: INTEGER
v purged_mac_addresses_per_sec: REAL
v name: STRING
For events generated by situations in the Hyper-V Virtual Switch Port attribute
group, Tivoli Enterprise Console events are sent using the ITM_KHV_HYPER-
V_VIRTUAL_SWITCH_PORT class. This class contains the following slots:
v node: STRING
v timestamp: STRING
v broadcast_packets_received_per_sec: REAL
v broadcast_packets_sent_per_sec: REAL
v bytes_per_sec: REAL
v bytes_received_per_sec: REAL
v bytes_sent_per_sec: REAL
v directed_packets_received_per_sec: REAL
v directed_packets_sent_per_sec: REAL
v multicast_packets_received_per_sec: REAL
v multicast_packets_sent_per_sec: REAL
v packets_per_sec: REAL
v packets_received_per_sec: REAL
v packets_sent_per_sec: REAL
Appendix A. IBM Tivoli Enterprise Console event mapping 231
v name: STRING
For events generated by situations in the Hyper-V VM IO APIC attribute group,
Tivoli Enterprise Console events are sent using the ITM_KHV_HYPER-
V_VM_IO_APIC class. This class contains the following slots:
v node: STRING
v timestamp: STRING
v assertions: INTEGER
v name: STRING
For events generated by situations in the Hypervisor attribute group, Tivoli
Enterprise Console events are sent using the ITM_KHV_HYPERVISOR class. This
class contains the following slots:
v node: STRING
v timestamp: STRING
v version: STRING
v logical_processors: INTEGER
v monitored_notifications: INTEGER
v partitions: INTEGER
v total_pages: INTEGER
v virtual_processors: INTEGER
For events generated by situations in the Memory attribute group, Tivoli Enterprise
Console events are sent using the ITM_KHV_MEMORY class. This class contains
the following slots:
v node: STRING
v timestamp: STRING
v virtualmachinename: STRING
v healthstate: INTEGER
v healthstate_enum: STRING
v enabledstate: INTEGER
v enabledstate_enum: STRING
v blocksize: INTEGER
v numberofblocks: INTEGER
v freephysicalmemory: INTEGER
v systemname: STRING
v deviceid: STRING
For events generated by situations in the Performance Object Status attribute
group, Tivoli Enterprise Console events are sent using the
ITM_KHV_PERFORMANCE_OBJECT_STATUS class. This class contains the
following slots:
v node: STRING
v timestamp: STRING
v query_name: STRING
v object_name: STRING
v object_type: INTEGER
v object_type_enum: STRING
232 Monitoring Agent for Microsoft Hyper-V Server: Users Guide
v object_status: INTEGER
v object_status_enum: STRING
v error_code: INTEGER
v error_code_enum: STRING
v last_collection_start: STRING
v last_collection_start_enum: STRING
v last_collection_finished: STRING
v last_collection_finished_enum: STRING
v last_collection_duration: REAL
v average_collection_duration: REAL
v average_collection_duration_enum: STRING
v refresh_interval: INTEGER
v number_of_collections: INTEGER
v cache_hits: INTEGER
v cache_misses: INTEGER
v cache_hit_percent: REAL
v intervals_skipped: INTEGER
For events generated by situations in the Processor attribute group, Tivoli
Enterprise Console events are sent using the ITM_KHV_PROCESSOR class. This
class contains the following slots:
v node: STRING
v timestamp: STRING
v virtualmachinename: STRING
v numberofprocessors: INTEGER
v healthstate: INTEGER
v healthstate_enum: STRING
v enabledstate: INTEGER
v enabledstate_enum: STRING
v loadpercentage: INTEGER
v cpustatus: INTEGER
v cpustatus_enum: STRING
v reservation: INTEGER
v limit: INTEGER
v weight: INTEGER
v systemname: STRING
For events generated by situations in the Thread Pool Status attribute group, Tivoli
Enterprise Console events are sent using the ITM_KHV_THREAD_POOL_STATUS
class. This class contains the following slots:
v node: STRING
v timestamp: STRING
v thread_pool_size: INTEGER
v thread_pool_size_enum: STRING
v thread_pool_max_size: INTEGER
v thread_pool_max_size_enum: STRING
Appendix A. IBM Tivoli Enterprise Console event mapping 233
v thread_pool_active_threads: INTEGER
v thread_pool_active_threads_enum: STRING
v thread_pool_avg_active_threads: REAL
v thread_pool_avg_active_threads_enum: STRING
v thread_pool_min_active_threads: INTEGER
v thread_pool_min_active_threads_enum: STRING
v thread_pool_max_active_threads: INTEGER
v thread_pool_max_active_threads_enum: STRING
v thread_pool_queue_length: INTEGER
v thread_pool_queue_length_enum: STRING
v thread_pool_avg_queue_length: REAL
v thread_pool_avg_queue_length_enum: STRING
v thread_pool_min_queue_length: INTEGER
v thread_pool_min_queue_length_enum: STRING
v thread_pool_max_queue_length: INTEGER
v thread_pool_max_queue_length_enum: STRING
v thread_pool_avg_job_wait: REAL
v thread_pool_avg_job_wait_enum: STRING
v thread_pool_total_jobs: INTEGER
v thread_pool_total_jobs_enum: STRING
For events generated by situations in the Virtual Machine attribute group, Tivoli
Enterprise Console events are sent using the ITM_KHV_VIRTUAL_MACHINE
class. This class contains the following slots:
v node: STRING
v timestamp: STRING
v elementname: STRING
v enabledstate: INTEGER
v enabledstate_enum: STRING
v healthstate: INTEGER
v healthstate_enum: STRING
v processorload: INTEGER
v heartbeat: INTEGER
v heartbeat_enum: STRING
v numberofprocessors: INTEGER
v memoryusage: INTEGER
v uptime: INTEGER
v percentidletime: INTEGER
v guestoperatingsystem: STRING
v notes: STRING
v name: STRING
For events generated by situations in the Virtual Switch attribute group, Tivoli
Enterprise Console events are sent using the ITM_KHV_VIRTUAL_SWITCH class.
This class contains the following slots:
v node: STRING
234 Monitoring Agent for Microsoft Hyper-V Server: Users Guide
v timestamp: STRING
v elementname: STRING
v packetspersec: INTEGER
v packetsreceivedpersec: INTEGER
v packetssentpersec: INTEGER
v bytespersec: INTEGER
v bytesreceivedpersec: INTEGER
v bytessentpersec: INTEGER
v enabledstate: INTEGER
v enabledstate_enum: STRING
v healthstate: INTEGER
v healthstate_enum: STRING
v name: STRING
For events generated by situations in the VLAN Endpoint attribute group, Tivoli
Enterprise Console events are sent using the ITM_KHV_VLAN_ENDPOINT class.
This class contains the following slots:
v node: STRING
v timestamp: STRING
v switchname: STRING
v enabledstate: INTEGER
v enabledstate_enum: STRING
v healthstate: INTEGER
v healthstate_enum: STRING
v desiredvlantrunkencapsulation: INTEGER
v desiredvlantrunkencapsulation_enum: STRING
v operationalvlantrunkencapsulation: INTEGER
v operationalvlantrunkencapsulation_enum: STRING
v elementname: STRING
v systemname: STRING
Appendix A. IBM Tivoli Enterprise Console event mapping 235
236 Monitoring Agent for Microsoft Hyper-V Server: Users Guide
Appendix B. Documentation library
This appendix contains information about the publications related to the
Monitoring Agent for Microsoft Hyper-V Server. These publications are listed in
the following categories:
v Monitoring Agent for Microsoft Hyper-V Server library
v Prerequisite publications
v Related publications
See the IBM Tivoli Monitoring and OMEGAMON XE products: Documentation Guide,
SC23-8816, for information about accessing and using publications. You can find
the Documentation Guide in the IBM Tivoli Monitoring and OMEGAMON

XE
Information Center at http://publib.boulder.ibm.com/infocenter/tivihelp/v15r1/
topic/com.ibm.docguide.doc/DocGuide.htm. To open the Documentation Guide in
the information center, select Using the publications in the Contents pane.
To find a list of new and changed publications, click Whats new on the Welcome
page of the IBM Tivoli Monitoring and OMEGAMON XE Information Center. To
find publications from the previous version of a product, click Previous versions
under the name of the product in the Contents pane.
Monitoring Agent for Microsoft Hyper-V Server library
There is one document specific to the Monitoring Agent for Microsoft Hyper-V
Server: IBM Tivoli Monitoring for Microsoft Applications: Microsoft Hyper-V Server
Agent Users Guide. This publication provides agent-specific information for
configuring, using, and troubleshooting the Monitoring Agent for Microsoft
Hyper-V Server
Use the configuration chapter in this guide with the IBM Tivoli Monitoring
Installation and Setup Guide to set up the software.
Use the information in this guide with the IBM Tivoli Monitoring Users Guide to
monitor Microsoft Hyper-V Server resources.
Prerequisite publications
To use the information in this publication effectively, you must have some
prerequisite knowledge, which you can obtain from the following IBM Tivoli
Monitoring publications:
v Exploring IBM Tivoli Monitoring
v IBM Tivoli Monitoring Administrators Guide
v IBM Tivoli Monitoring Agent Builder Users Guide
v IBM Tivoli Monitoring Command Reference
v IBM Tivoli Monitoring: Configuring Tivoli Enterprise Monitoring Server on z/OS
v IBM Tivoli Monitoring Installation and Setup Guide
v IBM Tivoli Monitoring: Messages
v IBM Tivoli Monitoring Troubleshooting Guide
v IBM Tivoli Monitoring: Upgrading from Tivoli Distributed Monitoring
Copyright IBM Corp. 2008, 2009 237
v IBM Tivoli Monitoring: Upgrading from V5.1.2
v IBM Tivoli Monitoring Users Guide
v IBM Tivoli Monitoring: i5/OS

Agent Users Guide


v IBM Tivoli Monitoring: Linux OS Agent Users Guide
v IBM Tivoli Monitoring: UNIX Log OS Agent Users Guide
v IBM Tivoli Monitoring: UNIX OS Agent Users Guide
v IBM Tivoli Monitoring: Windows OS Agent Users Guide
v IBM Tivoli Monitoring Universal Agent Users Guide
v IBM Tivoli Monitoring Universal Agent API and Command Programming Reference
Guide
Related publications
The following documents also provide useful information:
v IBM Tivoli Enterprise Console Adapters Guide
v IBM Tivoli Enterprise Console Event Integration Facility Users Guide
v IBM Tivoli Enterprise Console Reference Manual
v IBM Tivoli Enterprise Console Rule Builders Guide
Other sources of documentation
You can also obtain technical documentation about Tivoli Monitoring and
OMEGAMON XE products from the following sources:
v IBM Tivoli Open Process Automation Library (OPAL)
http://www.ibm.com/software/tivoli/opal
OPAL is an online catalog that contains integration documentation as well as
other downloadable product extensions.
v Redbooks
http://www.redbooks.ibm.com/
IBM Redbooks

, Redpapers, and Redbooks Technotes provide information about


products from platform and solution perspectives.
v Technotes
Technotes provide the latest information about known product limitations and
workarounds. You can find Technotes through the IBM Software Support Web
site at http://www.ibm.com/software/support.
v Tivoli wikis on the IBM developerWorks

Web site
Tivoli Wiki Central at http://www.ibm.com/developerworks/wikis/display/
tivoli/Home is the home for interactive wikis that offer best practices and
scenarios for using Tivoli products. The wikis contain white papers contributed
by IBM employees, and content created by customers and business partners.
238 Monitoring Agent for Microsoft Hyper-V Server: Users Guide
Two of these wikis are of particular relevance to IBM Tivoli Monitoring:
Tivoli Distributed Monitoring and Application Management Wiki at
http://www.ibm.com/developerworks/wikis/display/tivolimonitoring/
Home provides information about IBM Tivoli Monitoring and related
distributed products, including IBM Tivoli Composite Application
Management products.
Tivoli System z

Monitoring and Application Management Wiki at


http://www.ibm.com/developerworks/wikis/display/tivoliomegamon/
Home provides information about the OMEGAMON XE products, NetView

for z/OS

, Tivoli Monitoring Agent for z/TPF, and other System z monitoring


and application management products.
Appendix B. Documentation library 239
240 Monitoring Agent for Microsoft Hyper-V Server: Users Guide
Appendix C. Accessibility
Accessibility features help users with physical disabilities, such as restricted
mobility or limited vision, to use software products successfully. The major
accessibility features in this product enable users to do the following:
v Use assistive technologies, such as screen-reader software and digital speech
synthesizer, to hear what is displayed on the screen. Consult the product
documentation of the assistive technology for details on using those technologies
with this product.
v Operate specific or equivalent features using only the keyboard.
v Magnify what is displayed on the screen.
In addition, the product documentation was modified to include the following
features to aid accessibility:
v All documentation is available in both HTML and convertible PDF formats to
give the maximum opportunity for users to apply screen-reader software.
v All images in the documentation are provided with alternative text so that users
with vision impairments can understand the contents of the images.
Navigating the interface using the keyboard
Standard shortcut and accelerator keys are used by the product and are
documented by the operating system. See the documentation provided by your
operating system for more information.
Magnifying what is displayed on the screen
You can enlarge information on the product windows using facilities provided by
the operating systems on which the product is run. For example, in a Microsoft
Windows environment, you can lower the resolution of the screen to enlarge the
font sizes of the text on the screen. See the documentation provided by your
operating system for more information.
Copyright IBM Corp. 2008, 2009 241
242 Monitoring Agent for Microsoft Hyper-V Server: Users Guide
Appendix D. Notices
This information was developed for products and services offered in the U.S.A.
IBM may not offer the products, services, or features discussed in this document in
other countries. Consult your local IBM representative for information on the
products and services currently available in your area. Any reference to an IBM
product, program, or service is not intended to state or imply that only that IBM
product, program, or service may be used. Any functionally equivalent product,
program, or service that does not infringe any IBM intellectual property right may
be used instead. However, it is the users responsibility to evaluate and verify the
operation of any non-IBM product, program, or service.
IBM may have patents or pending patent applications covering subject matter
described in this document. The furnishing of this document does not give you
any license to these patents. You can send license inquiries, in writing, to:
IBM Director of Licensing
IBM Corporation
North Castle Drive
Armonk, NY 10504-1785 U.S.A.
For license inquiries regarding double-byte (DBCS) information, contact the IBM
Intellectual Property Department in your country or send inquiries, in writing, to:
Intellectual Property Licensing
Legal and Intellectual Property Law
IBM Japan, Ltd.
3-2-12, Roppongi, Minato-ku, Tokyo 106-8711 Japan
The following paragraph does not apply to the United Kingdom or any other
country where such provisions are inconsistent with local law:
INTERNATIONAL BUSINESS MACHINES CORPORATION PROVIDES THIS
PUBLICATION AS IS WITHOUT WARRANTY OF ANY KIND, EITHER
EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
WARRANTIES OF NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS
FOR A PARTICULAR PURPOSE.
Some states do not allow disclaimer of express or implied warranties in certain
transactions, therefore, this statement might not apply to you.
This information could include technical inaccuracies or typographical errors.
Changes are periodically made to the information herein; these changes will be
incorporated in new editions of the publication. IBM may make improvements
and/or changes in the product(s) and/or the program(s) described in this
publication at any time without notice.
Any references in this information to non-IBM Web sites are provided for
convenience only and do not in any manner serve as an endorsement of those Web
sites. The materials at those Web sites are not part of the materials for this IBM
product and use of those Web sites is at your own risk.
Copyright IBM Corp. 2008, 2009 243
IBM may use or distribute any of the information you supply in any way it
believes appropriate without incurring any obligation to you.
Licensees of this program who wish to have information about it for the purpose
of enabling: (i) the exchange of information between independently created
programs and other programs (including this one) and (ii) the mutual use of the
information which has been exchanged, should contact:
IBM Corporation
2Z4A/101
11400 Burnet Road
Austin, TX 78758 U.S.A.
Such information may be available, subject to appropriate terms and conditions,
including in some cases payment of a fee.
The licensed program described in this document and all licensed material
available for it are provided by IBM under terms of the IBM Customer Agreement,
IBM International Program License Agreement or any equivalent agreement
between us.
Any performance data contained herein was determined in a controlled
environment. Therefore, the results obtained in other operating environments may
vary significantly. Some measurements may have been made on development-level
systems and there is no guarantee that these measurements will be the same on
generally available systems. Furthermore, some measurement may have been
estimated through extrapolation. Actual results may vary. Users of this document
should verify the applicable data for their specific environment.
Information concerning non-IBM products was obtained from the suppliers of
those products, their published announcements or other publicly available sources.
IBM has not tested those products and cannot confirm the accuracy of
performance, compatibility or any other claims related to non-IBM products.
Questions on the capabilities of non-IBM products should be addressed to the
suppliers of those products.
All statements regarding IBMs future direction or intent are subject to change or
withdrawal without notice, and represent goals and objectives only.
All IBM prices shown are IBMs suggested retail prices, are current and are subject
to change without notice. Dealer prices may vary.
This information is for planning purposes only. The information herein is subject to
change before the products described become available.
This information contains examples of data and reports used in daily business
operations. To illustrate them as completely as possible, the examples include the
names of individuals, companies, brands, and products. All of these names are
fictitious and any similarity to the names and addresses used by an actual business
enterprise is entirely coincidental.
COPYRIGHT LICENSE:
This information contains sample application programs in source language, which
illustrate programming techniques on various operating platforms. You may copy,
modify, and distribute these sample programs in any form without payment to
244 Monitoring Agent for Microsoft Hyper-V Server: Users Guide
IBM, for the purposes of developing, using, marketing or distributing application
programs conforming to the application programming interface for the operating
platform for which the sample programs are written. These examples have not
been thoroughly tested under all conditions. IBM, therefore, cannot guarantee or
imply reliability, serviceability, or function of these programs. You may copy,
modify, and distribute these sample programs in any form without payment to
IBM for the purposes of developing, using, marketing, or distributing application
programs conforming to IBMs application programming interfaces.
Each copy or any portion of these sample programs or any derivative work, must
include a copyright notice as follows:
(your company name) (year). Portions of this code are derived from IBM Corp.
Sample Programs. Copyright IBM Corp. _enter the year or years_. All rights
reserved.
If you are viewing this information in softcopy form, the photographs and color
illustrations might not be displayed.
Trademarks
IBM, the IBM logo, and ibm.com

are trademarks or registered trademarks of


International Business Machines Corp., registered in many jurisdictions worldwide.
Other product and service names might be trademarks of IBM or other companies.
A current list of IBM trademarks is available on the Web at Copyright and
trademark information at www.ibm.com/legal/copytrade.shtml.
Adobe

, Acrobat, PostScript

and all Adobe-based trademarks are either registered


trademarks or trademarks of Adobe Systems Incorporated in the United States,
other countries, or both.
Cell Broadband Engine

and Cell/B.E. are trademarks of Sony Computer


Entertainment, Inc., in the United States, other countries, or both and is used under
license therefrom.
Intel

, Intel logo, Intel Inside

, Intel Inside logo, Intel Centrino

, Intel Centrino
logo, Celeron

, Intel Xeon

, Intel SpeedStep

, Itanium

, and Pentium

are
trademarks or registered trademarks of Intel Corporation or its subsidiaries in the
United States and other countries.
IT Infrastructure Library

is a registered trademark of the Central Computer and


Telecommunications Agency which is now part of the Office of Government
Commerce.
ITIL

is a registered trademark, and a registered community trademark of the


Office of Government Commerce, and is registered in the U.S. Patent and
Trademark Office.
Java and all Java-based trademarks and logos are trademarks or
registered trademarks of Sun Microsystems, Inc. in the United States,
other countries, or both.
Linux is a trademark of Linus Torvalds in the United States, other countries, or
both.
Appendix D. Notices 245
Microsoft, Windows, Windows NT

, and the Windows logo are trademarks of


Microsoft Corporation in the United States, other countries, or both.
UNIX is a registered trademark of The Open Group in the United States and other
countries.
Other company, product, and service names may be trademarks or service marks
of others.
246 Monitoring Agent for Microsoft Hyper-V Server: Users Guide
Index
A
accessibility 241
Add Resources Tasks Completed attribute 97
Add Resources Tasks In Progress attribute 98
Add Resources Virtual Machine Tasks Recent Time In MS
attribute 116
Add Resources Virtual Machine Tasks Recent Time In NS
attribute 110
Address Domain Flushes Per Sec attribute 53, 76
Address Space Evictions Per Sec attribute 53, 77
Address Space Flushes Per Sec attribute 54, 77
Address Space Switches Per Sec attribute 54, 77
Address Spaces attribute 43, 45
agent
trace logs 199
agents
troubleshooting 207
APIC EOI Accesses Per Sec attribute 54, 77
APIC IPIs Sent Per Sec attribute 54, 78
APIC MMIO Accesses Per Sec attribute 55, 78
APIC Self IPIs Sent Per Sec attribute 55, 78
APIC TPR Accesses Per Sec attribute 55, 79
Application Component attribute 26
Apply Snapshot Tasks Completed attribute 98
Apply Snapshot Tasks In Progress attribute 98
Apply Snapshot Virtual Machine Tasks Recent Time In MS
attribute 117
Apply Snapshot Virtual Machine Tasks Recent Time In NS
attribute 111
Applying SnapShot attribute 127
Assertions attribute 143
attribute groups
Availability 26
Disk 30
Enterprise Hyper-V Summary 33
Event Log 35
Hyper-V Hypervisor Logical Processor 37
Hyper-V Hypervisor Partition 43
Hyper-V Hypervisor Root Partition 45
Hyper-V Hypervisor Root Virtual Processor 47
Hyper-V Hypervisor Root Virtual Processor More 53
Hyper-V Hypervisor Virtual Processor 70
Hyper-V Hypervisor Virtual Processor More 76
Hyper-V Legacy Network Adapter 93
Hyper-V Summary 95
Hyper-V Task Manager Detail 97
Hyper-V Task Manager Recent Time 109
Hyper-V Virtual IDE Controller 122
Hyper-V Virtual Machine Bus 124
Hyper-V Virtual Machine Health Summary 126
Hyper-V Virtual Machine Summary 127
Hyper-V Virtual Network Adapter 132
Hyper-V Virtual Switch 135
Hyper-V Virtual Switch Port 139
Hyper-V VM IO APIC 143
Hypervisor 144
list of all 23
Memory 145
more information 23
new 3
overview 23
attribute groups (continued)
Performance Object Status 148
Processor 152
Thread Pool Status 155
Virtual Machine 158
Virtual Switch 161
VLAN Endpoint 164
attributes
Add Resources Tasks Completed 97
Add Resources Tasks In Progress 98
Add Resources Virtual Machine Tasks Recent Time In
MS 116
Add Resources Virtual Machine Tasks Recent Time In
NS 110
Address Domain Flushes Per Sec 53, 76
Address Space Evictions Per Sec 53, 77
Address Space Flushes Per Sec 54, 77
Address Space Switches Per Sec 54, 77
Address Spaces 43, 45
APIC EOI Accesses Per Sec 54, 77
APIC IPIs Sent Per Sec 54, 78
APIC MMIO Accesses Per Sec 55, 78
APIC Self IPIs Sent Per Sec 55, 78
APIC TPR Accesses Per Sec 55, 79
Application Component 26
Apply Snapshot Tasks Completed 98
Apply Snapshot Tasks In Progress 98
Apply Snapshot Virtual Machine Tasks Recent Time In
MS 117
Apply Snapshot Virtual Machine Tasks Recent Time In
NS 111
Applying SnapShot 127
Assertions 143
Availability 26, 30
Average Collection Duration 151
BlockSize 147
Broadcast Packets Received Per Sec 132, 136, 139
Broadcast Packets Sent Per Sec 132, 136, 140
Bytes Dropped 93
Bytes Per Sec 133, 140
Bytes Received Per Sec 93, 133, 140
Bytes Sent Per Sec 93, 133, 140
BytesPersec 163
BytesReceivedPersec 163
BytesSentPersec 163
C1 Transitions Per Sec 39
C2 Transitions Per Sec 40
C3 Transitions Per Sec 40
Cache Hit Percent 152
Cache Hits 152
Cache Misses 152
Change In Interrupts Received 125
Change In Interrupts Sent 125
Change In Throttle Events 126
Clone Tasks Completed 98
Clone Tasks In Progress 99
Clone Virtual Machine Tasks Recent Time In MS 117
Clone Virtual Machine Tasks Recent Time In NS 111
Command Line 29
Context Switches Per Sec 40
Control Register Accesses Cost In MS 56, 79
Copyright IBM Corp. 2008, 2009 247
attributes (continued)
Control Register Accesses Cost In NS 56, 79
Control Register Accesses Per Sec 55, 79
CPUID Instructions Cost In MS 48, 71
CPUID Instructions Cost In NS 48, 71
CPUID Instructions Per Sec 48, 71
CPUStatus 154
Create VSS Snapshot Set Tasks Completed 99
Create VSS Snapshot Set Tasks In Progress 99
Create VSS Snapshot Set Tasks Recent Time In MS 117
Create VSS Snapshot Set Tasks Recent Time In NS 111
Debug Register Accesses Cost In MS 57, 80
Debug Register Accesses Cost In NS 56, 80
Debug Register Accesses Per Sec 56, 80
DefaultBlockSize 32
Define Tasks Completed 99
Define Tasks In Progress 100
Define Virtual Machine Tasks Recent Time In MS 117
Define Virtual Machine Tasks Recent Time In NS 111
Deleting 128
Deleting Saved State 128
Deleting Snapshot 128
Deposited Pages 43, 46
Desired VLAN Trunk Encapsulation 165
Destroy Snapshot Tasks Completed 100
Destroy Snapshot Tasks In Progress 100
Destroy Snapshot Virtual Machine Tasks Recent Time In
MS 118
Destroy Snapshot Virtual Machine Tasks Recent Time In
NS 112
Destroy Tasks Completed 100
Destroy Tasks In Progress 101
Destroy Virtual Machine Tasks Recent Time In MS 118
Destroy Virtual Machine Tasks Recent Time In NS 112
Device ID 33, 147
Directed Packets Received Per Sec 133, 136, 141
Directed Packets Sent Per Sec 134, 137, 141
Disk 30
DiskReadLatency 34, 96
DiskWriteLatency 34, 96
Emulated Instructions Cost In MS 57, 81
Emulated Instructions Cost In NS 57, 81
Emulated Instructions Per Sec 57, 80
EnabledState 31, 146, 153, 159, 163, 165
Enterprise Hyper-V Summary 33
Error Code 149
Event Category 37
Event ID 36
Event Log 36
Event Source 36
Event Type 36
Export Tasks Completed 101
Export Tasks In Progress 101
Export Virtual Machine Tasks Recent Time In MS 118
Export Virtual Machine Tasks Recent Time In NS 112
Exporting 128
External Interrupts Cost In MS 58, 82
External Interrupts Cost In NS 58, 81
External Interrupts Per Sec 58, 81
Frames Dropped 94
Frames Received Per Sec 94
Frames Sent Per Sec 94
FreePhysicalDisk 33
FreePhysicalMemory 147
Full Name 27
Functionality Test Message 29
Functionality Test Status 29
attributes (continued)
Global GVA Range Flushes Per Sec 58, 82
GPA Pages 43
GPA Space Hypercalls Per Sec 49, 72
GPA Space Modifications Per Sec 44
Guest Page Table Maps Per Sec 49, 72
GuestOperatingSystem 161
Hardware Interrupts Per Sec 40
Health Critical 127
Health Ok 127
HealthState 31, 146, 153, 159, 164, 165
HeartBeat 160
HLT Instructions Cost In MS 59, 83
HLT Instructions Cost In NS 59, 82
HLT Instructions Per Sec 59, 82
Hyper-V Hypervisor Logical Processor 37
Hyper-V Hypervisor Partition 43
Hyper-V Hypervisor Root Partition 45
Hyper-V Hypervisor Root Virtual Processor 47
Hyper-V Hypervisor Root Virtual Processor More 53
Hyper-V Hypervisor Virtual Processor 70
Hyper-V Hypervisor Virtual Processor More 76
Hyper-V Legacy Network Adapter 93
Hyper-V Summary 95
Hyper-V Task Manager Detail 97
Hyper-V Task Manager Recent Time 110
Hyper-V Virtual IDE Controller 123
Hyper-V Virtual Machine Bus 124
Hyper-V Virtual Machine Health Summary 126
Hyper-V Virtual Machine Summary 127
Hyper-V Virtual Network Adapter 132
Hyper-V Virtual Switch 136
Hyper-V Virtual Switch Port 139
Hyper-V VM IO APIC 143
Hypercalls Cost In Ms 60
Hypercalls Cost In MS 83
Hypercalls Cost In NS 60, 83
Hypercalls Per Sec 59, 83
Hypervisor 144
Import Tasks Completed 101
Import Tasks In Progress 102
Import Virtual Machine Tasks Recent Time In MS 118
Import Virtual Machine Tasks Recent Time In NS 112
Inter Processor Interrupts Per Sec 41
Inter Processor Interrupts Sent Per Sec 41
Interrupts Received 124
Interrupts Sent 125
Intervals Skipped 152
IO Instructions Cost In MS 61, 84
IO Instructions Cost In NS 60, 84
IO Instructions Per Sec 60, 84
IO Intercept Messages Per Sec 61, 84
Large Page TLB Fills Per Sec 61, 85
Last Collection Duration 151
Last Collection Finished 151
Last Collection Start 151
Learned MAC Addresses 137
Learned MAC Addresses Per Sec 137
Limit 154
LoadPercentage 153
LoadTime 32
Local Flushed GVA Ranges Per Sec 62, 85
Log Name 36
Logical Processor Hypercalls Per Sec 62, 85
Logical Processor Migrations Per Sec 62, 85
Logical Processors 144
Long Spin Wait Hypercalls Per Sec 62, 86
248 Monitoring Agent for Microsoft Hyper-V Server: Users Guide
attributes (continued)
MaxDiskAllocated 31
MaxLogicalProcessor 35, 96
MaxVirtualProcessor 35, 97
Memory 146
Memory Allocated 160
Memory Intercept Messages Per Sec 63, 86
MemoryAvailable 34, 95
MemoryUtilized 34, 96
Merge Disk Tasks Completed 102
Merge Disk Tasks In Progress 102
Merge Disk Tasks Recent Time In MS 119
Merge Disk Tasks Recent Time In NS 113
Merging Disks 129
Message 37
Migrate Tasks Completed 102
Migrate Tasks In Progress 103
Migrate Virtual Machine Tasks Recent Time In MS 119
Migrate Virtual Machine Tasks Recent Time In NS 113
Modify Resources Tasks Completed 103
Modify Resources Tasks In Progress 103
Modify Resources Virtual Machine Tasks Recent Time In
MS 119
Modify Resources Virtual Machine Tasks Recent Time In
NS 113
Modify Service Settings Tasks Complete 103
Modify Service Settings Tasks In Progress 104
Modify Service Settings Tasks Recent Time In MS 120
Modify Service Settings Tasks Recent Time In NS 114
Modify Tasks Completed 104
Modify Tasks In Progress 104
Modify Virtual Machine Tasks Recent Time In MS 120
Modify Virtual Machine Tasks Recent Time In NS 114
Monitor Transition Cost In MS 41
Monitor Transition Cost In NS 41
Monitored Notifications 144
more information 23
MSR Accesses Cost In MS 63, 87
MSR Accesses Cost In NS 63, 86
MSR Accesses Per Sec 63, 86
Multicast Packets Received Per Sec 134, 137, 141
Multicast Packets Sent Per Sec 134, 138, 142
MWAIT Instructions Cost In MS 64, 88
MWAIT Instructions Cost In NS 64, 87
MWAIT Instructions Per Sec 64, 87
Name 27, 42, 45, 47, 52, 70, 76, 92, 94, 124, 135, 139, 143
NetworkUtilization 35, 96
Node 26, 30, 33, 36, 37, 43, 45, 47, 53, 70, 76, 93, 95, 97,
110, 123, 124, 126, 127, 132, 136, 139, 143, 144, 146, 148,
152, 155, 159, 162, 164
Notes 161
Number of Collections 151
NumberOfBlocks 147
NumberofProcessors 153, 160
Object Name 148
Object Status 149
Object Type 148
Operational VLAN Trunk Encapsulation 166
Other Hypercalls Per Sec 64, 88
Other Intercepts Cost In MS 65, 89
Other Intercepts Cost In NS 65, 88
Other Intercepts Per Sec 65, 88
Other Messages Per Sec 65, 89
overview 23
Packets Flooded 138
Packets Flooded Per Sec 138
Packets Per Sec 134, 142
attributes (continued)
Packets Received Per Sec 135, 142
Packets Sent Per Sec 135, 142
PacketsPersec 162
PacketsReceivedPersec 162
PacketsSentPersec 162
Page Fault Intercepts Cost In MS 66, 73
Page Fault Intercepts Cost In NS 66, 73
Page Fault Intercepts Per Sec 49, 72
Page Faults per Sec 28
Page Invalidations Cost In MS 50, 74
Page Invalidations Cost In NS 50, 73
Page Invalidations Per Sec 50, 73
Page Table Allocations Per Sec 66, 89
Page Table Eviction Per Sec 66, 89
Page Table Reclamations Per Sec 67, 90
Page Table Resets Per Sec 67, 90
Page Table Validations Per Sec 67, 90
Page Table Write Intercepts Per Sec 67, 90
Partitions 145
Pause Tasks Completed 104
Pause Tasks In Progress 105
Pause Virtual Machine Tasks Recent Time In MS 120
Pause Virtual Machine Tasks Recent Time In NS 114
Paused 129
Pausing 129
Pending Interrupts Cost In MS 68, 91
Pending Interrupts Cost In NS 68, 91
Pending Interrupts Per Sec 68, 91
Percent C1 Time 37
Percent C2 Time 38
Percent C3 Time 38
Percent Guest Run Time 38, 47, 70
Percent Hypervisor Run Time 38, 47, 70
Percent Idle Time 39
Percent Privileged Time 28
Percent Processor Time 29
Percent Total Run Time 39, 48, 71
Percent User Mode Time 28
PercentIdleTime 161
Performance Object Status 148
PID 28
Processor 152
ProcessorLoad 159
Purged MAC Addresses 138
Purged MAC Addresses Per Sec 139
Query Name 148
Read Bytes Per Sec 123
Read Sectors Per Sec 123
Reflected Guest Page Faults Per Sec 68, 91
Refresh Interval 151
Remove Resources Tasks Completed 105
Remove Resources Tasks In Progress 105
Remove Resources Virtual Machine Tasks Recent Time In
MS 120
Remove Resources Virtual Machine Tasks Recent Time In
NS 114
Reservation 154
Reset Tasks Completed 105
Reset Tasks In Progress 106
Reset Virtual Machine Tasks Recent Time In MS 121
Reset Virtual Machine Tasks Recent Time In NS 115
Resetting 129
Restore Tasks Completed 106
Restore Tasks In Progress 106
Restore Virtual Machine Tasks Recent Time In MS 121
Restore Virtual Machine Tasks Recent Time In NS 115
Index 249
attributes (continued)
Resume Tasks Completed 106
Resume Tasks In Progress 107
Resume Virtual Machine Tasks Recent Time In MS 121
Resume Virtual Machine Tasks Recent Time In NS 115
Resuming 130
Running 130
Save Tasks Completed 107
Save Tasks In Progress 107
Save Virtual Machine Tasks Recent Time In MS 121
Save Virtual Machine Tasks Recent Time In NS 115
Saved 130
Saving 130
Scheduler Interrupts Per Sec 42
Shutdown Tasks Completed 107
Shutdown Tasks In Progress 108
Shutdown Virtual Machine Tasks Recent Time In MS 122
Shutdown Virtual Machine Tasks Recent Time In NS 116
Small Page TLB Fills Per Sec 69, 92
Snapshot Tasks Completed 108
Snapshot Tasks In Progress 108
Snapshot Virtual Machine Tasks Recent Time In MS 122
Snapshot Virtual Machine Tasks Recent Time In NS 116
Start Tasks Completed 108
Start Tasks In Progress 109
Start Virtual Machine Tasks Recent Time In MS 122
Start Virtual Machine Tasks Recent Time In NS 116
Starting 130
Status 27
Stopping 131
Switch ID 164, 166
Switch Name 164
Switch Port ID 166
SwitchName 162
Synthetic Interrupt Hypercalls Per Sec 69, 92
Synthetic Interrupts Per Sec 69, 92
SystemProcessorUtilization 33, 95
Taking Snapshot 131
Thread Count 28
Thread Pool Active Threads 156
Thread Pool Avg Active Threads 156
Thread Pool Avg Job Wait 158
Thread Pool Avg Queue Length 157
Thread Pool Max Active Threads 157
Thread Pool Max Queue Length 157
Thread Pool Max Size 155
Thread Pool Min Active Threads 156
Thread Pool Min Queue Length 157
Thread Pool Queue Length 157
Thread Pool Size 155
Thread Pool Status 155
Thread Pool Total Jobs 158
Throttle Events 126
Time Generated 37
Timer Interrupts Per Sec 42
Timestamp 26, 30, 33, 36, 37, 43, 45, 47, 53, 70, 76, 93, 95,
97, 110, 123, 124, 126, 127, 132, 136, 139, 143, 144, 146, 148,
152, 155, 159, 162, 164
Total Intercepts Cost In MS 51, 74
Total Intercepts Cost In NS 51, 74
Total Intercepts Per Sec 50, 74
Total Interrupts Per Sec 42
Total Messages Per Sec 51, 75
Total Pages 145
TotalMountTime 32
Turned Off 131
Type 28
attributes (continued)
UpTime 161
Version 144
Virtual Interrupt Hypercalls Per Sec 51, 75
Virtual Interrupts Per Sec 52, 75
Virtual Machine 158
Virtual Machine ID 33, 147, 155, 161
Virtual Machine Name 30, 146, 152, 159
Virtual MMU Hypercalls Per Sec 52, 75
Virtual Processor Hypercalls Per Sec 52, 76
Virtual Processors 44, 46, 145
Virtual Size 28
Virtual Switch 162
Virtual TLB Flush Entires Per Sec 44, 46
Virtual TLB Pages 44, 46
VLAN Endpoint 164
Waiting To Start 131
Waiting to Start Tasks Completed 109
Waiting to Start Tasks In Progress 109
Waiting To Start Virtual Machine Tasks Recent Time In
MS 110
Waiting To Start Virtual Machine Tasks Recent Time In
NS 110
Weight 154
Working Set Size 28
Write Bytes Per Sec 123
Written Sectors Per Sec 124
Availability
situations 170, 171
workspaces
descriptions 17
list 14
Availability attribute 30
Availability attribute group 26
Availability workspace 17
Average Collection Duration attribute 151
B
BlockSize attribute 147
Broadcast Packets Received Per Sec attribute 132, 136, 139
Broadcast Packets Sent Per Sec attribute 132, 136, 140
built-in troubleshooting features 197
Bytes Dropped attribute 93
Bytes Per Sec attribute 133, 140
Bytes Received Per Sec attribute 93, 133, 140
Bytes Sent Per Sec attribute 93, 133, 140
BytesPersec attribute 163
BytesReceivedPersec attribute 163
BytesSentPersec attribute 163
C
C1 Transitions Per Sec attribute 39
C2 Transitions Per Sec attribute 40
C3 Transitions Per Sec attribute 40
Cache Hit Percent attribute 152
Cache Hits attribute 152
Cache Misses attribute 152
calculate historical data disk space 166
capacity planning
Monitoring Agent for Microsoft Hyper-V Server 167
capacity planning for historical data 166
Change In Interrupts Received attribute 125
Change In Interrupts Sent attribute 125
Change In Throttle Events attribute 126
250 Monitoring Agent for Microsoft Hyper-V Server: Users Guide
changes
attribute groups, new 3
baroc file updated 5
situations 5
views 3
workspaces 3
Clone Tasks Completed attribute 98
Clone Tasks In Progress attribute 99
Clone Virtual Machine Tasks Recent Time In MS attribute 117
Clone Virtual Machine Tasks Recent Time In NS attribute 111
Command Line attribute 29
commands
tacmd addSystem 10
commands, Take Action 187
components 5
configuration 7
after installation 10
fields 10
remote 10
values 10
configuring the monitoring agent 10
Context Switches Per Sec attribute 40
Control Register Accesses Cost In MS attribute 56, 79
Control Register Accesses Cost In NS attribute 56, 79
Control Register Accesses Per Sec attribute 55, 79
CPUID Instructions Cost In MS attribute 48, 71
CPUID Instructions Cost In NS attribute 48, 71
CPUID Instructions Per Sec attribute 48, 71
CPUStatus attribute 154
Create VSS Snapshot Set Tasks Completed attribute 99
Create VSS Snapshot Set Tasks In Progress attribute 99
Create VSS Snapshot Set Tasks Recent Time In MS
attribute 117
Create VSS Snapshot Set Tasks Recent Time In NS
attribute 111
D
data
trace logs 198
data logged
Monitoring Agent for Microsoft Hyper-V Server 167
data provider logs
See agent
Debug Register Accesses Cost In MS attribute 57, 80
Debug Register Accesses Cost In NS attribute 56, 80
Debug Register Accesses Per Sec attribute 56, 80
DefaultBlockSize attribute 32
Define Tasks Completed attribute 99
Define Tasks In Progress attribute 100
Define Virtual Machine Tasks Recent Time In MS
attribute 117
Define Virtual Machine Tasks Recent Time In NS
attribute 111
Deleting attribute 128
Deleting Saved State attribute 128
Deleting Snapshot attribute 128
Deposited Pages attribute 43, 46
Desired VLAN Trunk Encapsulation attribute 165
Destroy Snapshot Tasks Completed attribute 100
Destroy Snapshot Tasks In Progress attribute 100
Destroy Snapshot Virtual Machine Tasks Recent Time In MS
attribute 118
Destroy Snapshot Virtual Machine Tasks Recent Time In NS
attribute 112
Destroy Tasks Completed attribute 100
Destroy Tasks In Progress attribute 101
Destroy Virtual Machine Tasks Recent Time In MS
attribute 118
Destroy Virtual Machine Tasks Recent Time In NS
attribute 112
developerWorks Web site 238
Device ID attribute 33, 147
Directed Packets Received Per Sec attribute 133, 136, 141
Directed Packets Sent Per Sec attribute 134, 137, 141
Disk
situations 170, 173
workspaces
descriptions 18
list 14
Disk attribute group 30
disk capacity planning
See capacity planning
disk capacity planning for historical data 166
Disk workspace 18
DiskReadLatency attribute 34, 96
DiskWriteLatency attribute 34, 96
documentation
See publications
E
Emulated Instructions Cost In MS attribute 57, 81
Emulated Instructions Cost In NS attribute 57, 81
Emulated Instructions Per Sec attribute 57, 80
EnabledState attribute 31, 146, 153, 159, 163, 165
Enterprise Dashboard workspace 15
Enterprise Disk Dashboard workspace 16
Enterprise Hyper-V Summary attribute group 33
Enterprise Memory Dashboard workspace 16
Enterprise Network Utilization Dashboard workspace 16
Enterprise Processor Dashboard workspace 16
environment
features 1
functions 1
Error Code attribute 149
event
mapping 219
Event Category attribute 37
Event ID attribute 36
Event Log
situations 170, 173
workspaces
descriptions 18
list 14
Event Log attribute group 35
Event Log workspace 18
Event Source attribute 36
Event Type attribute 36
Export Tasks Completed attribute 101
Export Tasks In Progress attribute 101
Export Virtual Machine Tasks Recent Time In MS
attribute 118
Export Virtual Machine Tasks Recent Time In NS
attribute 112
Exporting attribute 128
External Interrupts Cost In MS attribute 58, 82
External Interrupts Cost In NS attribute 58, 81
External Interrupts Per Sec attribute 58, 81
F
features, Monitoring Agent for Microsoft Hyper-V Server 1
Index 251
files
agent trace 199
installation trace 199
other trace log 200
trace logs 198
Frames Dropped attribute 94
Frames Received Per Sec attribute 94
Frames Sent Per Sec attribute 94
FreePhysicalDisk attribute 33
FreePhysicalMemory attribute 147
Full Name attribute 27
Functionality Test Message attribute 29
Functionality Test Status attribute 29
functions, Monitoring Agent for Microsoft Hyper-V Server 1
G
gathering support information 197
Global GVA Range Flushes Per Sec attribute 58, 82
GPA Pages attribute 43
GPA Space Hypercalls Per Sec attribute 49, 72
GPA Space Modifications Per Sec attribute 44
Guest Page Table Maps Per Sec attribute 49, 72
GuestOperatingSystem attribute 161
H
Hardware Interrupts Per Sec attribute 40
Health Critical attribute 127
Health Ok attribute 127
HealthState attribute 31, 146, 153, 159, 164, 165
HeartBeat attribute 160
historical data
calculate disk space 166
capacity planning
Monitoring Agent for Microsoft Hyper-V Server 167
disk capacity planning 166
HLT Instructions Cost In MS attribute 59, 83
HLT Instructions Cost In NS attribute 59, 82
HLT Instructions Per Sec attribute 59, 82
Hyper V Logical Processor Load workspace 20
Hyper-V Hypervisor Logical Processor attribute group 37
Hyper-V Hypervisor Partition attribute group 43
Hyper-V Hypervisor Root Partition attribute group 45
Hyper-V Hypervisor Root Virtual Processor attribute
group 47
Hyper-V Hypervisor Root Virtual Processor More attribute
group 53
Hyper-V Hypervisor Virtual Processor attribute group 70
Hyper-V Hypervisor Virtual Processor More attribute
group 76
Hyper-V Legacy Network Adapter attribute group 93
Hyper-V Summary attribute group 95
Hyper-V Task Manager Detail attribute group 97
Hyper-V Task Manager Recent Time attribute group 109
Hyper-V Virtual IDE Controller attribute group 122
Hyper-V Virtual Machine Bus attribute group 124
Hyper-V Virtual Machine Health Summary attribute
group 126
Hyper-V Virtual Machine Summary attribute group 127
Hyper-V Virtual Network Adapter attribute group 132
Hyper-V Virtual Switch attribute group 135
Hyper-V Virtual Switch Port attribute group 139
Hyper-V VM IO APIC attribute group 143
Hypercalls Cost In Ms attribute 60
Hypercalls Cost In MS attribute 83
Hypercalls Cost In NS attribute 60, 83
Hypercalls Per Sec attribute 59, 83
Hypervisor
situations 170, 174
workspaces
descriptions 19
list 14
Hypervisor attribute group 144
Hypervisor workspace 19
I
IBM Software Support
See support
IBM Support Assistant 213
IBM Tivoli Enterprise Console
event mapping 219
IDE Controller workspace 18
Import Tasks Completed attribute 101
Import Tasks In Progress attribute 102
Import Virtual Machine Tasks Recent Time In MS
attribute 118
Import Virtual Machine Tasks Recent Time In NS
attribute 112
information
troubleshooting 197
information, additional
attributes 23
policies 195
situations 169
Take Action commands 187
workspaces 11
installation
log file 199
problems 205
remote 10
silent 7
Inter Processor Interrupts Per Sec attribute 41
Inter Processor Interrupts Sent Per Sec attribute 41
interface, user 6
Interrupts Received attribute 124
Interrupts Sent attribute 125
Intervals Skipped attribute 152
IO Instructions Cost In MS attribute 61, 84
IO Instructions Cost In NS attribute 60, 84
IO Instructions Per Sec attribute 60, 84
IO Intercept Messages Per Sec attribute 61, 84
ISA 213
K
KHV_HV_LP_ContextSwitches situation 183
KHV_HV_LP_Utilization_Crit situation 182
KHV_HV_LP_Utilization_Warn situation 182
KHV_HV_NWAdapter_FramesDropped situation 179
KHV_HV_PCPU_Utilization_Crit situation 176
KHV_HV_PCPU_Utilization_Warn situation 175
KHV_HV_PDisk_Latency_Crit situation 177
KHV_HV_PDisk_Latency_Warn situation 178
KHV_HV_PDisk_Usage_Crit situation 173
KHV_HV_PMemory_Available_Crit situation 177
KHV_HV_PMemory_Available_Warn situation 176
KHV_HV_PNW_Utilization_Crit situation 174
KHV_HV_PNW_Utilization_Warn situation 174
KHV_HV_RVP_Utilization_Crit situation 184
KHV_HV_RVP_Utilization_Warn situation 183
252 Monitoring Agent for Microsoft Hyper-V Server: Users Guide
KHV_HV_VP_Utilization_Crit situation 184
KHV_HV_VP_Utilization_Warn situation 185
KHV_HV_VSwitch_PacketsFlooded situation 180
KHV_Image_Mgmt_Service_Down situation 171
KHV_Network_Service_Down situation 172
KHV_VM_Disk_HealthState situation 173
KHV_VM_Heartbeat_Crit situation 185
KHV_VM_Memory_HealthState situation 178
KHV_VM_Mgmt_Service_Down situation 172
KHV_VM_Processor_Warn situation 181
KHV_VM_ProcessorLoad_Crit situation 180
KHV_VM_Switch_HealthState situation 179
L
Large Page TLB Fills Per Sec attribute 61, 85
Last Collection Duration attribute 151
Last Collection Finished attribute 151
Last Collection Start attribute 151
Learned MAC Addresses attribute 137
Learned MAC Addresses Per Sec attribute 137
Legacy Network Adapter workspace 19
library, Monitoring Agent for Microsoft Hyper-V Server 237
Limit attribute 154
list of messages 215
LoadPercentage attribute 153
LoadTime attribute 32
Local Flushed GVA Ranges Per Sec attribute 62, 85
Local Hyper-V Dashboard workspace 17
Log Name attribute 36
logged data
Monitoring Agent for Microsoft Hyper-V Server 167
logging
agent trace logs 199, 200
built-in features 197
installation log files 199
trace log files 198
Logical Processor Hypercalls Per Sec attribute 62, 85
Logical Processor Migrations Per Sec attribute 62, 85
Logical Processors attribute 144
Long Spin Wait Hypercalls Per Sec attribute 62, 86
M
MaxDiskAllocated attribute 31
MaxLogicalProcessor attribute 35, 96
MaxVirtualProcessor attribute 35, 97
Memory
situations 170, 178
workspaces
descriptions 19
list 14
Memory Allocated attribute 160
Memory attribute group 145
Memory Intercept Messages Per Sec attribute 63, 86
Memory workspace 19
MemoryAvailable attribute 34, 95
MemoryUtilized attribute 34, 96
Merge Disk Tasks Completed attribute 102
Merge Disk Tasks In Progress attribute 102
Merge Disk Tasks Recent Time In MS attribute 119
Merge Disk Tasks Recent Time In NS attribute 113
Merging Disks attribute 129
Message attribute 37
messages
built-in features 197
messages (continued)
for Monitoring Agent for Microsoft Hyper-V Server 215
format 214
overview 214
syntax 214
Microsoft Hyper-V Server
situations 170, 171
workspaces
descriptions 15
list 14
Microsoft Hyper-V Server workspace 15
Migrate Tasks Completed attribute 102
Migrate Tasks In Progress attribute 103
Migrate Virtual Machine Tasks Recent Time In MS
attribute 119
Migrate Virtual Machine Tasks Recent Time In NS
attribute 113
Modify Resources Tasks Completed attribute 103
Modify Resources Tasks In Progress attribute 103
Modify Resources Virtual Machine Tasks Recent Time In MS
attribute 119
Modify Resources Virtual Machine Tasks Recent Time In NS
attribute 113
Modify Service Settings Tasks Complete attribute 103
Modify Service Settings Tasks In Progress attribute 104
Modify Service Settings Tasks Recent Time In MS
attribute 120
Modify Service Settings Tasks Recent Time In NS
attribute 114
Modify Tasks Completed attribute 104
Modify Tasks In Progress attribute 104
Modify Virtual Machine Tasks Recent Time In MS
attribute 120
Modify Virtual Machine Tasks Recent Time In NS
attribute 114
Monitor Transition Cost In MS attribute 41
Monitor Transition Cost In NS attribute 41
Monitored Notifications attribute 144
Monitoring Agent for Microsoft Hyper-V Server
components 5
features 1
functions 1
performance considerations 210
MSR Accesses Cost In MS attribute 63, 87
MSR Accesses Cost In NS attribute 63, 86
MSR Accesses Per Sec attribute 63, 86
Multicast Packets Received Per Sec attribute 134, 137, 141
Multicast Packets Sent Per Sec attribute 134, 138, 142
MWAIT Instructions Cost In MS attribute 64, 88
MWAIT Instructions Cost In NS attribute 64, 87
MWAIT Instructions Per Sec attribute 64, 87
N
Name attribute 27, 42, 45, 47, 52, 70, 76, 92, 94, 124, 135, 139,
143
Network
situations 170, 179
workspaces
descriptions 19
list 14
Network workspace 19
NetworkUtilization attribute 35, 96
new attribute groups 3
new or changed situations 5
new or changed views 3
new or changed workspaces 3
Index 253
Node attribute 26, 30, 33, 36, 37, 43, 45, 47, 53, 70, 76, 93, 95,
97, 110, 123, 124, 126, 127, 132, 136, 139, 143, 144, 146, 148,
152, 155, 159, 162, 164
Notes attribute 161
Number of Collections attribute 151
NumberOfBlocks attribute 147
NumberofProcessors attribute 153, 160
O
Object Name attribute 148
Object Status attribute 149
Object Type attribute 148
OPAL documentation 238
Operational VLAN Trunk Encapsulation attribute 166
Other Hypercalls Per Sec attribute 64, 88
Other Intercepts Cost In MS attribute 65, 89
Other Intercepts Cost In NS attribute 65, 88
Other Intercepts Per Sec attribute 65, 88
Other Messages Per Sec attribute 65, 89
other new function 5
P
Packets Flooded attribute 138
Packets Flooded Per Sec attribute 138
Packets Per Sec attribute 134, 142
Packets Received Per Sec attribute 135, 142
Packets Sent Per Sec attribute 135, 142
PacketsPersec attribute 162
PacketsReceivedPersec attribute 162
PacketsSentPersec attribute 162
Page Fault Intercepts Cost In MS attribute 66, 73
Page Fault Intercepts Cost In NS attribute 66, 73
Page Fault Intercepts Per Sec attribute 49, 72
Page Faults per Sec attribute 28
Page Invalidations Cost In MS attribute 50, 74
Page Invalidations Cost In NS attribute 50, 73
Page Invalidations Per Sec attribute 50, 73
Page Table Allocations Per Sec attribute 66, 89
Page Table Eviction Per Sec attribute 66, 89
Page Table Reclamations Per Sec attribute 67, 90
Page Table Resets Per Sec attribute 67, 90
Page Table Validations Per Sec attribute 67, 90
Page Table Write Intercepts Per Sec attribute 67, 90
Partition workspace 22
Partitions attribute 145
Pause Tasks Completed attribute 104
Pause Tasks In Progress attribute 105
Pause Virtual Machine Tasks Recent Time In MS attribute 120
Pause Virtual Machine Tasks Recent Time In NS attribute 114
Paused attribute 129
Pausing attribute 129
Pending Interrupts Cost In MS attribute 68, 91
Pending Interrupts Cost In NS attribute 68, 91
Pending Interrupts Per Sec attribute 68, 91
Percent C1 Time attribute 37
Percent C2 Time attribute 38
Percent C3 Time attribute 38
Percent Guest Run Time attribute 38, 47, 70
Percent Hypervisor Run Time attribute 38, 47, 70
Percent Idle Time attribute 39
Percent Privileged Time attribute 28
Percent Processor Time attribute 29
Percent Total Run Time attribute 39, 48, 71
Percent User Mode Time attribute 28
PercentIdleTime attribute 161
performance considerations 210
Performance Object Status attribute group 148
Performance Object Status workspace 18
PID attribute 28
policies
more information 195
overview 195
problems and workarounds 204
Processor
situations 170, 180
workspaces
descriptions 20
list 14
Processor attribute group 152
Processor workspace 21
ProcessorLoad attribute 159
publications
developerWorks Web site 238
Monitoring Agent for Microsoft Hyper-V Server 237
OPAL 238
prerequisite 237
Redbooks 238
related 238
Technotes 238
types 237
wikis 238
Purged MAC Addresses attribute 138
Purged MAC Addresses Per Sec attribute 139
purposes
troubleshooting 197
Q
queries, using attributes 23
Query Name attribute 148
R
Read Bytes Per Sec attribute 123
Read Sectors Per Sec attribute 123
Redbooks 238
Reflected Guest Page Faults Per Sec attribute 68, 91
Refresh Interval attribute 151
remote
installation and configuration 10
remote deployment
troubleshooting 206
Remove Resources Tasks Completed attribute 105
Remove Resources Tasks In Progress attribute 105
Remove Resources Virtual Machine Tasks Recent Time In MS
attribute 120
Remove Resources Virtual Machine Tasks Recent Time In NS
attribute 114
requirements 7
Reservation attribute 154
Reset Tasks Completed attribute 105
Reset Tasks In Progress attribute 106
Reset Virtual Machine Tasks Recent Time In MS attribute 121
Reset Virtual Machine Tasks Recent Time In NS attribute 115
Resetting attribute 129
Restore Tasks Completed attribute 106
Restore Tasks In Progress attribute 106
Restore Virtual Machine Tasks Recent Time In MS
attribute 121
254 Monitoring Agent for Microsoft Hyper-V Server: Users Guide
Restore Virtual Machine Tasks Recent Time In NS
attribute 115
Resume Tasks Completed attribute 106
Resume Tasks In Progress attribute 107
Resume Virtual Machine Tasks Recent Time In MS
attribute 121
Resume Virtual Machine Tasks Recent Time In NS
attribute 115
Resuming attribute 130
Root Virtual Processor Load workspace 21
Running attribute 130
S
Save Tasks Completed attribute 107
Save Tasks In Progress attribute 107
Save Virtual Machine Tasks Recent Time In MS attribute 121
Save Virtual Machine Tasks Recent Time In NS attribute 115
Saved attribute 130
Saving attribute 130
Scheduler Interrupts Per Sec attribute 42
Shutdown Tasks Completed attribute 107
Shutdown Tasks In Progress attribute 108
Shutdown Virtual Machine Tasks Recent Time In MS
attribute 122
Shutdown Virtual Machine Tasks Recent Time In NS
attribute 116
silent installation 7
situations
general troubleshooting 210, 211
KHV_HV_LP_ContextSwitches 183
KHV_HV_LP_Utilization_Crit 182
KHV_HV_LP_Utilization_Warn 182
KHV_HV_NWAdapter_FramesDropped 179
KHV_HV_PCPU_Utilization_Crit 176
KHV_HV_PCPU_Utilization_Warn 175
KHV_HV_PDisk_Latency_Crit 177
KHV_HV_PDisk_Latency_Warn 178
KHV_HV_PDisk_Usage_Crit 173
KHV_HV_PMemory_Available_Crit 177
KHV_HV_PMemory_Available_Warn 176
KHV_HV_PNW_Utilization_Crit 174
KHV_HV_PNW_Utilization_Warn 174
KHV_HV_RVP_Utilization_Crit 184
KHV_HV_RVP_Utilization_Warn 183
KHV_HV_VP_Utilization_Crit 184
KHV_HV_VP_Utilization_Warn 185
KHV_HV_VSwitch_PacketsFlooded 180
KHV_Image_Mgmt_Service_Down 171
KHV_Network_Service_Down 172
KHV_VM_Disk_HealthState 173
KHV_VM_Heartbeat_Crit 185
KHV_VM_Memory_HealthState 178
KHV_VM_Mgmt_Service_Down 172
KHV_VM_Processor_Warn 181
KHV_VM_ProcessorLoad_Crit 180
KHV_VM_Switch_HealthState 179
list of all 170
more information 169
new or changed 5
overview 169
predefined 170
situations, using attributes 23
Small Page TLB Fills Per Sec attribute 69, 92
Snapshot Tasks Completed attribute 108
Snapshot Tasks In Progress attribute 108
Snapshot Virtual Machine Tasks Recent Time In MS
attribute 122
Snapshot Virtual Machine Tasks Recent Time In NS
attribute 116
Software Support 213
Start Hyper-V Image Management Service action 188
Start Hyper-V Networking Management Service action 188
Start Hyper-V Virtual Machine action 189
Start Hyper-V Virtual Machine Management Service
action 190
Start Tasks Completed attribute 108
Start Tasks In Progress attribute 109
Start Virtual Machine Tasks Recent Time In MS attribute 122
Start Virtual Machine Tasks Recent Time In NS attribute 116
Starting attribute 130
Status attribute 27
Stop Hyper-V Image Management Service action 191
Stop Hyper-V Networking Management Service action 191
Stop Hyper-V Virtual Machine action 191
Stop Hyper-V Virtual Machine Management Service
action 192
Stopping attribute 131
support
gathering information for 197
list of messages 215
messages 214
support assistant 213
Switch ID attribute 164, 166
Switch Name attribute 164
Switch Port ID attribute 166
SwitchName attribute 162
syntax
messages 214
Synthetic Interrupt Hypercalls Per Sec attribute 69, 92
Synthetic Interrupts Per Sec attribute 69, 92
SystemProcessorUtilization attribute 33, 95
T
tacmd addSystem command 10
Take Action commands
list of all 187
more information 187
overview 187
predefined 187
Start Hyper-V Image Management Service 188
Start Hyper-V Networking Management Service 188
Start Hyper-V Virtual Machine 189
Start Hyper-V Virtual Machine Management Service 190
Stop Hyper-V Image Management Service 191
Stop Hyper-V Networking Management Service 191
Stop Hyper-V Virtual Machine 191
Stop Hyper-V Virtual Machine Management Service 192
troubleshooting 213
Taking Snapshot attribute 131
Task Manager Details workspace 22
Technotes 238
Thread Count attribute 28
Thread Pool Active Threads attribute 156
Thread Pool Avg Active Threads attribute 156
Thread Pool Avg Job Wait attribute 158
Thread Pool Avg Queue Length attribute 157
Thread Pool Max Active Threads attribute 157
Thread Pool Max Queue Length attribute 157
Thread Pool Max Size attribute 155
Thread Pool Min Active Threads attribute 156
Thread Pool Min Queue Length attribute 157
Index 255
Thread Pool Queue Length attribute 157
Thread Pool Size attribute 155
Thread Pool Status attribute group 155
Thread Pool Total Jobs attribute 158
Throttle Events attribute 126
Time Generated attribute 37
Timer Interrupts Per Sec attribute 42
Timestamp attribute 26, 30, 33, 36, 37, 43, 45, 47, 53, 70, 76,
93, 95, 97, 110, 123, 124, 126, 127, 132, 136, 139, 143, 144, 146,
148, 152, 155, 159, 162, 164
Total Intercepts Cost In MS attribute 51, 74
Total Intercepts Cost In NS attribute 51, 74
Total Intercepts Per Sec attribute 50, 74
Total Interrupts Per Sec attribute 42
Total Messages Per Sec attribute 51, 75
Total Pages attribute 145
TotalMountTime attribute 32
trace logs 198
troubleshooting 197, 204
agents 207
built-in features 197
installation 205
installation logs 199
messages 214
remote deployment 206
situations 210, 211
Take Action commands 213
uninstallation 205
uninstallation logs 199
workspaces 208
Turned Off attribute 131
Type attribute 28
U
uninstallation
log file 199
problems 205
UpTime attribute 161
user interfaces options 6
V
Version attribute 144
views
Availability workspace 17
Disk workspace 18
Enterprise Dashboard workspace 15
Enterprise Disk Dashboard workspace 16
Enterprise Memory Dashboard workspace 16
Enterprise Network Utilization Dashboard workspace 16
Enterprise Processor Dashboard workspace 16
Event Log workspace 18
Hyper V Logical Processor Load workspace 20
Hypervisor workspace 19
IDE Controller workspace 18
Legacy Network Adapter workspace 19
Local Hyper-V Dashboard workspace 17
Memory workspace 19
Microsoft Hyper-V Server workspace 15
Network workspace 19
new or changed 3
Partition workspace 22
Performance Object Status workspace 18
Processor workspace 21
Root Virtual Processor Load workspace 21
views (continued)
Task Manager Details workspace 22
Virtual Machine Summary workspace 22
Virtual Machine workspace 22
Virtual Network Adapter workspace 20
Virtual Switch Port workspace 20
VLAN EndPoint workspace 20
VM Virtual Processor Details workspace 21
VM Virtual Processor Load workspace 21
Virtual Interrupt Hypercalls Per Sec attribute 51, 75
Virtual Interrupts Per Sec attribute 52, 75
Virtual Machine
situations 170, 185
workspaces
descriptions 22
list 14
Virtual Machine attribute group 158
Virtual Machine ID attribute 33, 147, 155, 161
Virtual Machine Name attribute 30, 146, 152, 159
Virtual Machine Summary workspace 22
Virtual Machine workspace 22
Virtual MMU Hypercalls Per Sec attribute 52, 75
Virtual Network Adapter workspace 20
Virtual Processor Hypercalls Per Sec attribute 52, 76
Virtual Processors attribute 44, 46, 145
Virtual Size attribute 28
Virtual Switch attribute group 161
Virtual Switch Port workspace 20
Virtual TLB Flush Entires Per Sec attribute 44, 46
Virtual TLB Pages attribute 44, 46
VLAN Endpoint attribute group 164
VLAN EndPoint workspace 20
VM Virtual Processor Details workspace 21
VM Virtual Processor Load workspace 21
W
Waiting To Start attribute 131
Waiting to Start Tasks Completed attribute 109
Waiting to Start Tasks In Progress attribute 109
Waiting To Start Virtual Machine Tasks Recent Time In MS
attribute 110
Waiting To Start Virtual Machine Tasks Recent Time In NS
attribute 110
Weight attribute 154
wikis 238
workarounds 204
agents 207
remote deployment 206
situations 210
Take Action commands 213
workspaces 208
Working Set Size attribute 28
workspaces
Availability 17
Disk 18
Enterprise Dashboard 15
Enterprise Disk Dashboard 16
Enterprise Memory Dashboard 16
Enterprise Network Utilization Dashboard 16
Enterprise Processor Dashboard 16
Event Log 18
Hyper V Logical Processor Load 20
Hypervisor 19
IDE Controller 18
Legacy Network Adapter 19
list of all 14
256 Monitoring Agent for Microsoft Hyper-V Server: Users Guide
workspaces (continued)
Local Hyper-V Dashboard 17
Memory 19
Microsoft Hyper-V Server 15
more information 11
Network 19
new or changed 3
overview 11
Partition 22
Performance Object Status 18
predefined 14
Processor 20, 21
Root Virtual Processor Load 21
Task Manager Details 22
troubleshooting 208
Virtual Machine 22
Virtual Machine Summary 22
Virtual Network Adapter 20
Virtual Switch Port 20
VLAN EndPoint 20
VM Virtual Processor Details 21
VM Virtual Processor Load 21
Write Bytes Per Sec attribute 123
Written Sectors Per Sec attribute 124
Index 257
258 Monitoring Agent for Microsoft Hyper-V Server: Users Guide

Printed in USA
SC27-2319-01

Das könnte Ihnen auch gefallen