Beruflich Dokumente
Kultur Dokumente
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
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
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
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
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
for z/OS
, Acrobat, PostScript
, 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
Printed in USA
SC27-2319-01