Administrator Guide

Receiving telemetry reports

Document 418

performing a GET on SSE URI. The streaming URI contains the event format type as metric report, which

directs the iDRAC event service to stream enabled metric reports alone. The client-triggered SSE URI can

also be provisioned to query specific metric reports that are streamed with the use of $filter. Upon receipt of a

GET request from the client, the Event service makes an entry of the SSE request in the subscription

collection and starts streaming the reports that are enabled and configured for triggers. The message

received on the client contains the fields defined by the SSE protocol, namely Event, Id, Data and Retry. The

metric report content is bundled in the Datasection and the Id contains the report sequence for the streamed

content. The Timestamp behavior of metric reports documented in the subscription method holds good for

SSE as well.

The connection can be terminated by either the client or iDRAC event service. Where there is no telemetry

data sent to client for more than an hour, the connection is closed from the event service endpoint. Where

connections drop off due to a network glitch or for unknown reasons, then the last event id is provided by the

client to the event service to resume streaming. When the connection closes, the subscription entry is

removed from the list. A maximum of 2 SSE connections are allowed at one time, and any request beyond

this is not honored.

HTTP request to stream all reports:

HTTP GET /redfish/v1/SSE?$filter=EventFormatType%20eq%20MetricReport

e.g.

curl -s -k -u user:pw -X GET https://<IDRAC-

IP>/redfish/v1/SSE?$filter=EventFormatType%20eq%20MetricReport

HTTP request to stream a single report:

HTTP GET

/redfish/v1/SSE?$filter=MetricReportDefinition%20eq%20'/redfish/v1/TelemetryService/Metri

cReportDefinitions/<report>'

e.g.

curl -s -k -u user:pw -X GET

https://<IDRAC-

IP>/redfish/v1/SSE?$filter=MetricReportDefinition%20eq%20'/redfish/v1/TelemetryService/Me

tricReportDefinitions/PowerMetrics'

Redfish client receiving reports SSE method