Management Console Performance and Capacity Monitoring Preferences

Management console PCM preferences are the configuration options that are 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, and later.
  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 allow 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 the number of managed systems for which a PCM functionality can be enabled. The preferences APIs also provide the information about the number of managed systems for which the PCM functionality can be enabled. These values are computed based on HMC configuration and they are read only.
  1. MaximumManagedSystemsForLongTermMonitor: Indicates the maximum number of managed systems for which a Long Term Monitoring (LTM) collection is possible.
  2. MaximumManagedSystemsForComputeLTM: Indicates the maximum number of managed systems for which processor and memory metrics collection is possible.
  3. MaximumManagedSystemsForAggregation: Indicates the maximum number of managed systems for which aggregation is possible.
  4. MaximumManagedSystemsForShortTermMonitor: Indicates the 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, and later.
Resource 
/rest/api/pcm/preferences

Since: Version 1_1_0

Table 1. Supported methods
Method Description Internet media type
GET This API retrieves the preferences set for all the managed systems that are connected to the HMC. application/xml
POST This API is used to set or update the preferences that are set for a managed system that is connected to the HMC. This API also allows the user to change the storage duration of the aggregated metrics. application/xml