17 Media Streaming data reporting at R4
26.5123GPP5G Media Streaming (5GMS)ProtocolsRelease 17TS
17.1 General
The following record types shall be used with the Ndcaf_DataReporting_Report service operation specified in clause 7.3.2.2.3.1 of TS 26.532 [47]. In each case, one or more records are included in a DataReport, as specified in clause 7.3.3.2.1 of [47].
The OpenAPI definitions of the record types are found in clause C.5.1 of the present document.
17.2 MediaStreamingAccessRecord type
As specified in clause 4.11.3, the MediaStreamingAccessRecord type shall be used by the 5GMS AS to report media streaming access.
Table 17.2-1: Definition of MediaStreamingAccessRecord type
Property name |
Data Type |
Cardinality |
Description |
---|---|---|---|
timestamp |
DateTime |
1..1 |
The date and time of the media access. (See table 6.4.2-1.) |
mediaStreamHandlerEndpointAddress |
EndpointAddress |
1..1 |
The endpoint address of the Media Stream Handler accessing the 5GMS AS. (See clause 6.4.3.8.) |
applicationServerEndpointAddress |
EndpointAddress |
1..1 |
The service endpoint on the 5GMS AS to which the Media Stream Handler is connected. (See clause 6.4.3.8.) |
sessionIdentifier |
string |
0..1 |
An identifier for the HTTP session on which the Media Stream Handler request was made. This should not contain any user-identifiable data. It may, for example, be a one-way hash of the transport connection identifier, if available from the underlying transport protocol. Alternatively, it could be a one-way hash of the 5-tuple formed from the Media Stream Handler and 5GMSd AS endpoint addresses and a transport protocol identifier. |
requestMessage |
Object |
1..1 |
Details of the HTTP request message submitted to the 5GMS AS by the Media Stream Handler for this media access. |
method |
string |
1..1 |
The request method. |
url |
Url |
1..1 |
The request URL. (See table 6.4.2‑1.) |
protocolVersion |
string |
1..1 |
The HTTP protocol version, e.g. "HTTP/1.1". |
range |
string |
0..1 |
The value of the Range request header, if present. |
size |
Uinteger |
1..1 |
The total number of bytes in the request message. |
bodySize |
Uinteger |
1..1 |
The number of bytes supplied by the Media Stream Handler in the HTTP request message body. Zero if there is no request body. |
contentType |
string |
0..1 |
The MIME content type of the request message, if any. |
userAgent |
string |
0..1 |
A string describing the requesting Media Stream Handler, if it supplies a User-Agent request header. |
userIdentity |
String |
0..1 |
A string identifying the user that made the access, if supplied. |
referer |
Url |
0..1 |
The URL that the Media Player reports being referred from, if the Referer request header is supplied. (See table 6.4.2‑1.) |
cacheStatus |
CacheStatus |
0..1 |
An indication of whether the 5GMS AS is able to serve an object corresponding to requestMessage,url from cache (HIT) or whether there is a stale object cached (EXPIRED) or the requested object is not present in cache (MISS). (See table 6.4.4.4.) For non-caching implementations of the 5GMS AS, the property shall be omitted. |
responseMessage |
Object |
1..1 |
Details of the HTTP response message returned by the 5GMS AS to the Media Stream Handler for this media access. |
responseCode |
Uinteger |
1..1 |
The HTTP response code. |
size |
Uinteger |
1..1 |
The total number of bytes in the response message. |
bodySize |
Uinteger |
1..1 |
The number of bytes in the HTTP response message body. |
contentType |
string |
0..1 |
The MIME content type of response message, if any. |
processingLatency |
Float |
1..1 |
The time, expressed in milliseconds, taken by the 5GMS AS to respond to the Media Stream Handler request, measured from the first byte of the HTTP request being processed by the 5GMS AS to the last byte of the response being sent. |
connectionMetrics |
Object |
0..1 |
Metrics about the performance of the transport connection underlying the HTTP session serving this media access. |
meanNetworkRoundTripTime |
Float |
1..1 |
A rolling mean average, expressed in milliseconds, of the network round-trip time for the HTTP session. |
networkRoundTripTimeVariation |
Float |
1..1 |
The variation in meanNetworkRoundTripTime, expressed in milliseconds, during the averaging period. |
CongestionWindowSize |
Uinteger |
1..1 |
The current size (in bytes) of the congestion window for the transport connection underlying the HTTP session. |