Export (0) Print
Expand All

Get-HpcMetricValue

Gets the current value of the specified metrics that HPC Cluster Manager uses in the heat maps for the nodes and the monitoring charts.

Syntax

Get-HpcMetricValue [-Counter <string[]>] [-MetricTarget <MetricTarget[]>] [-Node <HPCNode[]>] [-Scheduler <string>] [-Type <string[]>] [[-Name] <string[]>] [<CommonParameters>]

Get-HpcMetricValue [-Counter <string[]>] [-MetricTarget <MetricTarget[]>] [-NodeName <string[]>] [-Scheduler <string>] [-Type <string[]>] [[-Name] <string[]>] [<CommonParameters>]

Detailed Description

Gets the current value of the specified set of metrics for the specified nodes that HPC Cluster Manager uses in the heat maps for the nodes and the monitoring charts.

You can specify the metric values that you want to get by any combination of the names of the metrics, the locations where the metrics are generated, and the categories for the metrics. You can specify the nodes for which you want to get the metric values by specifying the node name or an HpcNode object for the NodeName or Node parameters, respectively.

If you do not specify any names, locations, or categories, the Get-HpcMetricValue cmdlet gets the values of all of the metrics for the specified nodes, or for all of nodes in the HPC cluster if no nodes are specified.

Parameters

-Counter <string[]>

Specifies a list of one or more counters for which you want to get the current value. A single metric can contain multiple counters. For example, the HPCSchedulerJobs metric contains multiple job-related counters such as Total number of jobs and Number of canceled jobs.

 

Required?

false

Position?

named

Default Value

no default

Accept Pipeline Input?

false

Accept Wildcard Characters?

true

-MetricTarget <MetricTarget[]>

Specifies a list of one or more locations where the metrics that you want to get values for are generated. The valid locations are HeadNode, ComputeNode, and Cluster.

 

Required?

false

Position?

named

Default Value

HeadNode,ComputeNode,Cluster

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-Name <string[]>

Specifies a list of one or more names for the metrics for which you want to get the current values.

 

Required?

false

Position?

1

Default Value

no default

Accept Pipeline Input?

true (ByPropertyName)

Accept Wildcard Characters?

true

-Node <HPCNode[]>

Specifies a list of one or more HpcNode objects that correspond to the nodes for which you want to get the values of the metrics. Use the Get-HpcNode cmdlet to get the HpcNode objects for the nodes. You cannot specify both the Node and NodeName parameters.

 

Required?

false

Position?

named

Default Value

no default

Accept Pipeline Input?

true (ByValue)

Accept Wildcard Characters?

false

-NodeName <string[]>

Specifies a list of the names of one or more nodes for which you want to get the values of the metrics. You cannot specify both the NodeName and Node parameters.

 

Required?

false

Position?

named

Default Value

no default

Accept Pipeline Input?

false

Accept Wildcard Characters?

true

-Scheduler <string>

Specifies the host name or IP address of the head node for the cluster that includes the metrics for which you want to get the current values. The value must be a valid computer name or IP address. If you do not specify the Scheduler parameter, this cmdlet uses the scheduler on the head node that the CCP_SCHEDULER environment variable specifies. To set this environment variable, run the following cmdlet:

Set-Content Env:CCP_SCHEDULER <head_node_name>

 

Required?

false

Position?

named

Default Value

%CCP_SCHEDULER%

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-Type <string[]>

Specifies one or more categories that include the metrics that you want to get. The valid categories are Performance, Hardware, and Calculated.

 

Required?

false

Position?

named

Default Value

Performance,Hardware,Calculated

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

<CommonParameters>

This cmdlet supports the common parameters: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, and -OutVariable. For more information, see about_CommonParameters.

Input and Return Types

The input type is the type of the objects that you can pipe to the cmdlet. The return type is the type of the objects that the cmdlet emits.

 

Input Type

One or more HpcNode objects, or one or more HpcMetric objects.

Return Type

One or more HpcMetricValue objects.

Example 1

C:\PS>Get-HpcMetricValue

Gets the current values of all the counters for all of the metrics on all of the nodes in the HPC cluster.

Example 2

C:\PS>Get-HpcMetricValue -Name HPCCpuUsage,HPCDiskSpace -NodeName ComputeNode1

Gets the current values of all of the counters for the HPCCpuUsage and HPCDiskSpace metrics for the node named ComputeNode1.

Example 3

C:\PS>Get-HpcMetricValue -Name HpcSchedulerJobs -Counters "Total number of jobs","Number of canceled jobs"

Gets the current values of the counters named Total number of jobs and Number of canceled jobs for the metric named HpcSchedulerJobs.

Example 4

C:\PS>Get-HpcNode -Name ComputeNode1 | Get-HpcMetricValue -MetricTarget ComputeNode

Gets the current values on the compute node named ComputeNode1 for all of the counters for all of the metrics that are generated on compute nodes.

See Also

Was this page helpful?
(1500 characters remaining)
Thank you for your feedback

Community Additions

ADD
Show:
© 2014 Microsoft