GET /nodes/metrics/`{uuid}`

Use this method to return a set of sample metrics for a specific server or Flex System storage device. Each sample is represented in terms of when the sample was taken (timeStamp) and the value of the sample (metricValue).

Note

Depending on your environment and the number of managed hardware resources, it might take several minutes to retrieve the requested metrics data.
System usage data (including processor, memory, and I/O) and memory power usage data is not collected for ThinkSystem SR635, SR645, SR655, and SR665 servers.

Authentication

Authentication with username and password is required.

Request URL

GET https://{management_server_IP}/nodes/metrics/{uuid}

where {uuid} is the UUID of the node to be retrieved. To obtain the node UUID, use the GET /nodes method.

Query parameters

Parameters	Required / Optional	Description
excludeAttributes=`{attributes}`	Optional	Returns a response that excludes the specified attributes for each resource. You can specify one or more attributes that are listed in the response body, separated by a comma. Note When the includeAttributes query parameter is specified, the excludeAttributes query parameter is ignored. The response is filtered based on attribute name, not the attribute value. Base attributes cannot be excluded.
includeAttributes=`<attributes}`	Optional	Returns a response that includes the base attributes and the specified attributes for each resource. You can specify one or more attributes that are listed in the response body, separated by a comma. Note The response is filtered based on attribute name, not the attribute value. If this attribute is not specified, all attributes are returned by default.

Response codes

Code	Description	Comments
200	OK	The request completed successfully.
400	Bad Request	A query parameter or request attribute is missing or not valid, or the operation is not supported. A descriptive error message is returned in the response body.
403	Forbidden	The orchestrator server was prevented from fulfilling the request. A descriptive error message is returned in the response body. Ensure that you have privileges to perform the request.
409	Conflict	There is a conflict with the current state of the resource. A descriptive error message is returned in the response body.
500	Internal Server Error	An internal error occurred. A descriptive error message is returned in the response body.

Response body

Each energy metric contains one or more arrays that include when the sample was taken (timeStamp) and the value of the sample (metricValue).

Attributes			Type	Description
energyMetrics			Object	Energy metrics for the server
	averageSystemInputPower		Array of objects	Average system input power samples
	minimumSystemInputPower		Array of objects	Minimum system input power samples
	maximumSystemInputPower		Array of objects	Maximum system input power samples
	averageSystemOutputPower		Array of objects	Average system output power samples
	minimumSystemOutputPower		Array of objects	Minimum system output power samples
	maximumSystemOutputPower		Array of objects	Maximum system output power samples
	averageEffectiveCPUSpeed		Array of objects	Average effective processor speed samples
	minimumEffectiveCPUSpeed		Array of objects	Minimum effective processor speed samples
	maximumEffectiveCPUSpeed		Array of objects	Maximum effective processor speed samples
	averageCPUSubsystemPower		Array of objects	Average processor subsystem speed samples
	minimumCPUSubsystemPower		Array of objects	Minimum processor subsystem speed samples
	maximumCPUSubsystemPower		Array of objects	Maximum processor subsystem speed samples
	averageMemorySubsystemPower		Array of objects	Average memory subsystem power samples
	minimumMemorySubsystemPower		Array of objects	Minimum memory subsystem power samples
	maximumMemorySubsystemPower		Array of objects	Maximum memory subsystem power samples
	coolingSubSystemAirFlow		Array of objects	Cooling subsystem air flow samples
	inletAirTemperature		Array of objects	Inlet air temperature samples
	inletAirTemperature2		Array of objects	Inlet air temperature samples
	outletAirTemperature		Array of objects	Outlet air temperature samples
	powerSupplyList		Array of objects	List of power supplies in the server
		See GET /powerSupplies/metrics/{uuid}	Object	Sample metrics for each power supply
name			String	Server name
parent			Array
	uuid		String
	uri		String
uuid			String	Server UUID
uri			String	Server URI

The following example is returned if the request is successful.

{
   "energyMetrics": {
      "minimumMemorySubsystemPerformance": [{
         "timeStamp": "2015-09-11T18:50:00Z",
         "metricValue": 0.0
      },
      ...,
      {
         "timeStamp": "2015-09-11T19:49:30Z",
         "metricValue": 0.0
      }],
      "maximumCPUSubsystemPerformance": [{
         "timeStamp": "2015-09-11T18:50:00Z",
         "metricValue": 0.0
      },
      ...,
      {
         "timeStamp": "2015-09-11T19:49:30Z",
         "metricValue": 0.0
      }],
      "averageIOSubsystemPerformance": [],
      "minimumCPUSubsystemPower": [{
         "timeStamp": "2015-09-11T18:50:00Z",
         "metricValue": 0.0
      },
      ...,
      {
         "timeStamp": "2015-09-11T19:49:30Z",
            "metricValue": 0.0
      }],
      "averageSystemPerformance": [{
         "timeStamp": "2015-09-11T18:50:00Z",
         "metricValue": 0.0
      },
      ...,
      {
         "timeStamp": "2015-09-11T19:49:30Z",
         "metricValue": 0.0
         }],
      "minimumSystemInputPower": [{
         "timeStamp": "2015-09-11T18:50:00Z",
         "metricValue": 0.0
         },
      ...,
         {
            "timeStamp": "2015-09-11T19:49:30Z",
            "metricValue": 0.0
         }],
      "minimumSystemOutputPower": [],
      "maximumSystemOutputPower": [],
      "minimumCPUSubsystemPerformance": [{
         "timeStamp": "2015-09-11T18:50:00Z",
         "metricValue": 0.0
      },
      ...,
      {
      "timeStamp": "2015-09-11T19:49:30Z",
         "metricValue": 0.0
      }],
      "minimumIOSubsystemPerformance": [],
      "maximumMemorySubsystemPower": [{
         "timeStamp": "2015-09-11T18:50:00Z",
         "metricValue": 0.0
      },
      ...,
      {
         "timeStamp": "2015-09-11T19:49:30Z",
         "metricValue": 0.0
      }],
      "averageCPUSubsystemPower": [{
         "timeStamp": "2015-09-11T18:50:00Z",
         "metricValue": 0.0
      },
      ...,
      {
            "timeStamp": "2015-09-11T19:49:30Z",
         "metricValue": 0.0
      }],
      "averageMemorySubsystemPerformance": [{
         "timeStamp": "2015-09-11T18:50:00Z",
         "metricValue": 0.0
      },
      ...,
      {
         "timeStamp": "2015-09-11T19:49:30Z",
         "metricValue": 0.0
      }],
      "minimumSystemPerformance": [{
         "timeStamp": "2015-09-11T18:50:00Z",
         "metricValue": 0.0
      },
         ...,
      {
         "timeStamp": "2015-09-11T19:49:30Z",
         "metricValue": 0.0
      }],
         "minimumEffectiveCPUSpeed": [{
         "timeStamp": "2015-09-11T18:50:00Z",
         "metricValue": 0.0
      },
      ...,
      {
         "timeStamp": "2015-09-11T19:49:30Z",
         "metricValue": 0.0
      }],
      "averageMemorySubsystemPower": [{
         "timeStamp": "2015-09-11T18:50:00Z",
         "metricValue": 0.0
      },
      ...,
      {
      "timeStamp": "2015-09-11T19:49:30Z",
         "metricValue": 0.0
      }],
      "powerSupplyList": [],
      "inletAirTemperature": [{
         "timeStamp": "2015-09-11T18:50:30Z",
         "metricValue": 18.0
      },
      ...,
      {
         "timeStamp": "2015-09-11T19:50:00Z",
         "metricValue": 17.5
      }],
      "maximumSystemPerformance": [{
         "timeStamp": "2015-09-11T18:50:00Z",
         "metricValue": 0.0
      },
      ...,
      {
         "timeStamp": "2015-09-11T19:49:30Z",
         "metricValue": 0.0
      }],
      "maximumMemorySubsystemPerformance": [{
         "timeStamp": "2015-09-11T18:50:00Z",
         "metricValue": 0.0
      },
      ...,
      {
         "timeStamp": "2015-09-11T19:49:30Z",
         "metricValue": 0.0
      }],
      "averageSystemInputPower": [{
         "timeStamp": "2015-09-11T18:50:00Z",
         "metricValue": 8.0
      },
      ...,
      {
         "timeStamp": "2015-09-11T19:49:30Z",
         "metricValue": 8.0
      }],
      "maximumEffectiveCPUSpeed": [{
         "timeStamp": "2015-09-11T18:50:00Z",
         "metricValue": 0.0
      },
      ...,
      {
         "timeStamp": "2015-09-11T19:49:30Z",
         "metricValue": 0.0
         }],
      "minimumMemorySubsystemPower": [{
         "timeStamp": "2015-09-11T18:50:00Z",
         "metricValue": 0.0
      },
      ...,
      {
         "timeStamp": "2015-09-11T19:49:30Z",
         "metricValue": 0.0
      }],
      "maximumIOSubsystemPerformance": [],
      "maximumCPUSubsystemPower": [{
         "timeStamp": "2015-09-11T18:50:00Z",
         "metricValue": 0.0
      },
      ...,
      {
         "timeStamp": "2015-09-11T19:49:30Z",
         "metricValue": 0.0
      }],
      "maximumSystemInputPower": [{
         "timeStamp": "2015-09-11T18:50:00Z",
         "metricValue": 25.0
      },
      ...,
      {
         "timeStamp": "2015-09-11T19:49:30Z",
         "metricValue": 25.0
      }],
      "averageCPUSubsystemPerformance": [{
         "timeStamp": "2015-09-11T18:50:00Z",
         "metricValue": 0.0
      },
      ...,
      {
         "timeStamp": "2015-09-11T19:49:30Z",
         "metricValue": 0.0
      }],
      "inletAirTemperature2": [],
      "averageSystemOutputPower": [],
      "averageEffectiveCPUSpeed": [{
         "timeStamp": "2015-09-11T18:50:00Z",
         "metricValue": 0.0
      },
      ...,
      {
         "timeStamp": "2015-09-11T19:49:30Z",
         "metricValue": 0.0
      }],
      "outletAirTemperature": []
   },
   "name": "node12",
   "parent": {
      "uri": "chassis/FBEF740B178F4EFAA846E7225EE256DC",
      "uuid": "FBEF740B178F4EFAA846E7225EE256DC"
   },
   "uri": "node/69BDF8912E5211E4998B40F2E99033F0",
   "uuid": "69BDF8912E5211E4998B40F2E99033F0"
}

Give documentation feedback

GET /nodes/metrics/{uuid}

Authentication​

Request URL​

Query parameters​

Response codes​

Response body​