Processed metrics for SSP

If aggregation flag is enabled in SSP preferences, the processed metrics for Shared Storage Pool (SSP) are generated for the specific processing duration of 5 minutes. The processed metrics give utilization data per time interval. These metrics are retained for maximum of 2 hours. After 2 hours, the metrics are rolled up by the aggregation logic.

Processed metrics work on the raw metrics and perform a series of computations on the raw data to generate the processed data. The processing of raw metrics job runs every 5 minutes. It starts at xx:00 hours, continues to xx:05 hours, and so on. Processed metrics give utilization data per time interval (5 minutes).

Resource

/rest/api/pcm/SharedStoragePool/<SSPUuId>/ProcessedMetrics

/rest/api/pcm/SharedStoragePool/${SSPUuid}/ProcessedMetrics?
StartTS={StartTS}&EndTS={EndTS}&NoOfSamples={n}

An example for date is 2017-05-22T18:43:29+0000

Table 1. Quick properties
Quick property	Description	Format
StartTS	The start timestamp is an optional parameter. If specified, the API returns available SSP processed metrics from the specified time.	yyyy-MM-dd'T'HH:mm:ssZ
EndTS	The end timestamp is an optional parameter. If specified, the API returns available SSP Processed metrics on or before the specified time.	yyyy-MM-dd'T'HH:mm:ssZ
NoOfSamples	Number of samples is an optional parameter. If specified, the API returns the specified number of processed metrics.	integer > 0

Table 2. Supported methods
Method	Description	Internet media type
GET	This API is used to retrieve the Atom link that is a web link to the actual JSON file. The content can be retrieved by using the Atom Link.	`application/xml`

Response

<feed xmlns="http://www.w3.org/2005/Atom" xmlns:ns2="http://a9.com/-/spec/opensearch/1.1/"
             xmlns:ns3="http://www.w3.org/1999/xhtml">
	<id>FEED_UNIQUE_ID</id>
	<updated>YYYY-MM-DDThh:mm:ss.sssZ</updated>
	<title type="text">ProcessedMetrics</title>
	<subtitle type="text">SharedStoragePool SSPUuid</subtitle>
	<link rel="self" href="https://HMC_IP_OR_HOST_NAME/rest/api/pcm/
       SharedStoragePool/SSPUuid/ProcessedMetrics"/>
	<generator uri="IBM Power Systems Management Console" version="1"/>
	<entry>
		<id>ENTRY_UNIQUE_ID</id>
		<updated>YYYY-MM-DDThh:mm:ss.sssZ</updated>
		<title type="text">JSON file name</title>
		<published>YYYY-MM-DDThh:mm:ss.sssZ</published>
		<link type="application/json" href="https://HMC_IP_OR_HOST_NAME/rest/
               api/pcm/ProcessedMetrics/
      file name.json"/>
		<author>
			<name>IBM Power Systems Management Console</name>
		</author>
		<category term="SharedStoragePool" frequency="300"/>
	</entry>
</feed>

Successful execution of the request is returned with response code 200. In response the application returns Feed and Entry.

The Entry includes the link of the processed data file that is in the JSON format. The following link provides the JSON specification for SSP processed metrics: JSON Specification for SSP Processed and Aggregated Metrics.