Management Console PCM Preferences

Management console PCM preferences are configuration options provided to the REST API consumers to manage the PCM data collection for managed systems that are connected to a hardware management console (HMC).

The API provides a list of managed systems along with their PCM data collection configuration. It provides details of the following status values:
  1. EnergyMonitoringCapable: This is a read-only attribute and provides information on whether the managed system supports Energy data collection or not. For non-supported managed systems, this value is false. This attribute is available from HMC 860 SP1 release onwards.
  2. LongTermMonitorEnabled: Long term monitoring configuration value
  3. AggregationEnabled: Utilization data aggregation configuration value
  4. ShortTermMonitorEnabled: Short term monitoring configuration value
  5. ComputeLTMEnabled: Processor and memory metrics monitoring configuration value
  6. EnergyMonitorEnabled: Energy monitoring status
For aggregation of the PCM data it is essential to have Long Term Monitoring (LTM) enabled. In case the user enables only aggregation and does not enable LTM, the application implicitly enables LTM and Energy Monitoring, if the managed system supports Energy monitoring.

The Energy Monitoring flag gets enabled when user enables aggregation. The Energy Monitoring flag can also be enabled explicitly without enabling aggregation. In such a case, only raw metrics is available.

The API user can enable or disable the PCM data collection and aggregation for one or more managed systems. The HMC stores aggregated metrics for configured duration. The preferences APIs allows users to specify the storage duration for the aggregated data with AggregatedMetricsStorageDuration property. The configured storage duration is applicable across all the managed systems.

There is restriction on number of managed system for which PCM functionality can be enabled. The preferences APIs also provides information for how many managed systems the PCM functionality can be enabled. These values are computed based on HMC configuration and they are read only.
  1. MaximumManagedSystemsForLongTermMonitor: Indicates maximum number of managed systems for which Long Term Monitoring (LTM) collection is possible.
  2. MaximumManagedSystemsForComputeLTM: Indicates maximum number of managed systems for which processor and memory metrics collection is possible.
  3. MaximumManagedSystemsForAggregation: Indicates maximum number of managed systems for with Aggregation is possible.
  4. MaximumManagedSystemsForShortTermMonitor: Indicates maximum number of managed systems for which Short Term Monitoring (STM) collection is possible.
  5. MaximumManagedSystemsForEnergyMonitor: Indicates the maximum number of managed systems for which Energy Monitoring collection is possible. The Energy Monitoring flag is available from HMC Version 8 onwards.
Resource 
/rest/api/pcm/preferences

Since: Version 1_1_0

Table 1. Supported methods
Method Description Internet media type
GET This API is used to retrieve the preferences set for all the managed systems connected to the HMC. application/xml, application/vnd.ibm.powervm.pcm.dita
POST This API is used to set/update the preferences set for one or more managed systems connected to the HMC. It also allows user to change aggregated metrics storage duration. application/xml, application/vnd.ibm.powervm.pcm.dita
Parent topic: Performance and Capacity Monitoring
Related reference:
Managed System PCM Preferences
Long Term Monitor Metrics (LTM)
Short Term Monitor Metrics
Processed Metrics for Managed System
Processed Metrics for Logical Partition
Aggregated Metrics for Managed System
Aggregated Metrics for Logical Partition


Last updated: Fri, June 23, 2017