Reference Guide › Command-Line Scripting › Collection Engine Commands › dpmce ceconfig -updatemetric Command--Update a Metric

dpmce ceconfig -updatemetric Command--Update a Metric

The dpmce ceconfig -updatemetric command lets you update currently collected host metrics, thresholds, and overall calculation attributes.

This command has the following format:

dpmce ceconfig -updatemetric [-sc sc_url] -host_name hostname -metricname metricname [-lower_threshold lowerthreshold][-upper_threshold upperthreshold] include_for_overall Yes|No [-ws_user username -ws_password password][-locale iso629value]

-sc sc_url

(Optional) Defines the URL for the service controller host.

Example: https://hostname:port/...

hostname

Defines the fully qualified host where the service controller is installed.

Example: localhost.ca.com

port

Defines the listening port for the service controller server.

Example: 80

-host_name hostname

Defines the name of the host computer.

-metricname metricname

Defines a name for the metric.

-lower_threshold lowerthreshold

Defines the lower overall usage threshold for the Data Center. The lower threshold must always be less than the upper threshold.

Limits: 0-100%

-upper_threshold upperthreshold

Defines the upper overall usage threshold for the Data Center. The upper threshold must always be greater than the lower threshold.

Limits: 1-100%

-include_for_overall Yes|No

Defines whether the metric is included in the overall calculation.

Yes

Includes the metric in the overall calculation.

No

Excludes the metric from the overall calculation.

-ws_user username -ws_password password

(Optional) Specifies the credentials to use for the web service security check. If you do not include credentials, you are prompted to enter them. Avoid the prompt for credentials by setting up your own session using caaipsecurity.

-locale iso639value

(Optional) Specifies an IS0 639_3166 combination to override the default English output, for example, fr_FR for French. To use the locale of the command prompt, specify "native".

Example: Update a Memory Metric for the Host ServerZ

This example updates the upper and lower thresholds for the metric Memory: AvailableMbytes and includes it in the overall calculation for the host ServerZ.

dpmce ceconfig -updatemetric -host_name ServerZ -metricname Memory: AvailableMbytes -lower_threshold 10 -upper_threshold 90 -include_for_overall Yes