Concept Guide

Document 365/385
2.4.3 Pull Method
The Redfish client can pull a report or report collection URIs on demand by performing an HTTP GET
operation on the metric report URI as specified below.
Pull report collection (URI list only) to know available reports:
curl -s -k -u <user>:<password> -X GET https://<IDRAC-
IP>/redfish/v1/TelemetryService/MetricReports
Pull one report:
curl -s -k -u <user>:<password> -X GET https://<IDRAC-
IP>/redfish/v1/TelemetryService/MetricReports/<report>
e.g. <report> = PowerMetrics
2.5 Configuring Custom Telemetry Reports
Telemetry streaming solution includes a large list of metrics with metric report definition that contains a list of
properties. Not all users might be interested in all the metric and properties. There comes the need to
configure the MRD with a custom set of metrics and properties . Each client/user can control the properties of
its named report, specifying recurrence interval, report type, aggregation, etc. independently. And the metric
reports can be customized by selecting the needed arbitrary metrics in the metric report definition. The
existing pre-canned reports can be also modified or configured with desired metrics and properties, but that
would impact all clients that use the pre-canned report. For the detailed explanation of the all available MRD
properties please refer to the white paper “Metric Report Definition Explained”
2.5.1 Create New Custom Report
Below is an example to post a custom MRD with specific properties using Redfish interface. Typically, one
can GET any existing pre-canned report definition (MRD) and update the metrics and properties (at the
minimum different “Id” value should be specified) and POST the updated json as shown in the example below
where a custom report for NIC Tx and Rx bytes metrics for a desired NIC port (FQDD) - NIC.Slot.1-1-1 is
requested.
curl -s -k -u <user>:<password> -X POST https://<IDRAC-
IP>/redfish/v1/TelemetryService/MetricReportDefinitions
-H 'Content-Type: application/json'
-d {
"Id": "TxRxBytesNicSlot1",
"Name": "Tx and Rx Bytes from Nic Slot 1 Metric Report",
"Description": "Tx and Rx Bytes of Nic Slot1 record",
"MetricReportDefinitionEnabled": true,