Customize Metrics Collection in Windows HPC Server 2008

Updated: May 9, 2012

Applies To: Windows HPC Server 2008

In Windows® HPC Server 2008, you can modify or remove existing performance metrics or add new metrics to the metric collection that is available for monitoring the nodes in your cluster. The metrics in the collection are available in HPC Cluster Manager in the node List and Heat Map views, and in the node Performance Charts. You can also view node metrics by using the HPC PowerShell cmdlet Get-HpcMetricValue.

You can change or add a new metric in two steps:

  1. Create an XML file that describes the metric to add or overwrite

  2. Import the XML file by using the HPC PowerShell cmdlet Import-HpcMetric

As an example, this topic describes how to add a new metric that displays CPU idle time. The topic includes an additional step for displaying the new metric in the node Heat Map view.

To see more examples of XML metrics descriptions, you can export an XML file that contains the current heat map metrics. In HPC PowerShell, run the cmdlet Export-HpcMetric.

  1. Log on to your head node as a user with Administrator privileges.

  2. Open Notepad:

    Click Start, point to All Programs, click Accessories, click Notepad.

  3. Copy and paste the following XML code into the new document:

    <?xml version="1.0" encoding="utf-8"?>
    <Metrics xmlns:xsi="" 
              DisplayName="CPU Idle Time (%)"
              Description="Percentage CPU Idle Time"
              Counter="% Idle Time"
  4. Save the document as C:\Users\user_name\Documents\MyNewMetric.xml, where user_name is your user name.

  1. Run HPC PowerShell as an administrator:

    Click Start, point to All Programs, click Microsoft HPC Pack, right-click HPC PowerShell, and click Run as administrator.

  2. Import the new metric by typing the following command:

    Import-HPCMetric –path C:\Users\user_name\Documents\MyNewMetric.xml

  3. Verify that the new metric, CPUIdleTime, appears in the metric collection. Type the following command to see the list of metrics:


  4. View the current CPUIdleTime values for the nodes on you cluster by typing the following command:

    Get-HPCMetricValue –name CPUIdleTime

  1. Open HPC Cluster Manager:

    Click Start, point to All Programs, click Microsoft HPC Pack, and click HPC Cluster Manager.

  2. Go to the node Heat Map view:

    In Node Management, in the view pane, click Heat Map.

  3. The Heat Map displays a maximum of three metrics at a time. If you already have three metrics displayed, remove one of them before continuing to the next step.

  4. In the Metric drop-down list, select CPU Idle Time (%), then click Add to heat map. The Heat Map now displays the new metric.

Community Additions