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. Processed metrics give utilization data per time interval. These metrics are retained for maximum of 2 hours. After 2 hours, they are rolled up by the aggregation logic.

Processed metrics works on the Raw metrics and performs 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 time stamp is an optional parameter. If specified, the API returns available Shared Storage Pool (SSP) Processed metrics from the specified time. yyyy-MM-dd'T'HH:mm:ssZ
EndTS The end time stamp 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 is a web link to the actual JSON file. The content can be retrieved by using the Atom Link. application/atom+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.

Parent topic: Shared Storage Pool Monitoring


Last updated: Fri, June 23, 2017