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.)

mediaStreamHandler‌EndpointAddress

Endpoint‌Address

1..1

The endpoint address of the Media Stream Handler accessing the 5GMS AS. (See clause 6.4.3.8.)

applicationServer‌EndpointAddress

Endpoint‌Address

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

Cache‌Status

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.

meanNetwork‌RoundTripTime

Float

1..1

A rolling mean average, expressed in milliseconds, of the network round-trip time for the HTTP session.

networkRoundTrip‌Time‌Variation

Float

1..1

The variation in meanNetwork‌RoundTripTime, expressed in milliseconds, during the averaging period.

Congestion‌Window‌Size

Uinteger

1..1

The current size (in bytes) of the congestion window for the transport connection underlying the HTTP session.