Content for  TS 23.288  Word version:  19.0.0

The consumers of the Nnwdaf_AnalyticsSubscription_Subscribe or Nnwdaf_AnalyticsInfo_Request service operations described in clause 7 provide the input parameters listed below.

• A list of Analytics IDs: identifies the requested analytics.
  • Analytics Filter Information: indicates the conditions to be fulfilled for reporting Analytics Information. This set of optional parameter types and values enables to select which type of analytics information is requested. Analytics Filter Information is defined in the analytics related clauses.
• Target of Analytics Reporting: indicates the object(s) for which Analytics information is requested, entities such as specific list of UEs, i.e. a list of SUPIs, group of UEs, i.e. a list of Internal-Group-Ids, or any UE (i.e. all UEs).
• (Only for Nnwdaf_AnalyticsSubscription_Subscribe) A Notification Target Address (+ Notification Correlation ID) as defined in clause 4.15.1 of TS 23.502, allowing to correlate notifications received from NWDAF with this subscription.
• (Only for Nnwdaf_AnalyticsSubscription_Subscribe) Subscription Correlation ID: identifies an existing analytics subscription that is to be modified.
• Related to analytic consumers that aggregate analytics from multiple NWDAF subscriptions:
  • [OPTIONAL] (Set of) NWDAF identifiers of NWDAF instances used by the NWDAF service consumer when aggregating multiple analytics subscriptions. See clause 6.1A.
• Analytics Reporting Information with the following parameters:
  • (Only for Nnwdaf_AnalyticsSubscription_Subscribe) Analytics Reporting Parameters as per Event Reporting parameters defined in Table 4.15.1-1 of TS 23.502.
  • (Only for Nnwdaf_AnalyticsSubscription_Subscribe) Reporting Thresholds, which indicate conditions on the level of each requested analytics that when reached shall be notified by the NWDAF.
    • [OPTIONAL] Matching direction: A matching direction may be provided such as below, above, or crossed. If no matching direction is provided, the default direction is crossed.
    • [OPTIONAL] Acceptable deviation: An acceptable deviation from the threshold level in the non-critical direction (i.e. in which the QoS is improving) may be set to limit the amount of signalling.
  • Analytics target period: time interval [start..end], either in the past (both start time and end time in the past) or in the future (both start time and end time in the future). An Analytics target period in the past is a request or subscription for statistics. An Analytics target period in the future is a request or subscription for predictions. The time interval is expressed with actual start time and actual end time (e.g. via UTC time). When the Analytics Reporting Parameters indicate a periodic reporting mode, the time interval can also be expressed as positive or negative offsets to the reporting time, which indicates a subscription for predictions or statistics respectively. By setting start time and end time to the same value, the consumer of the analytics can request analytics or subscribe to analytics for a specific time rather than for a time interval.
  • Time window for historical analytics: time interval [start..end]. The time window for historical analytics indicates the time interval during which the historical analytics was generated. If the time window for historical analytics is included, the NWDAF only needs to provide the existing analytics, and does not need to generate new analytics.
  • [OPTIONAL] Data time window: if specified, only events that have been created in the specified time interval are considered for the analytics generation.
  • [OPTIONAL] Preferred level of accuracy of the analytics ("Low", "Medium", "High" or "Highest").
  • [OPTIONAL] Preferred level of accuracy per analytics subset ("Low", "Medium", "High" or "Highest"). When a preferred level of accuracy is expressed for a given analytics subset, it takes precedence for this subset over the above preferred level of accuracy of the analytics. Analytics subsets are defined in the "Output Analytics" clause of applicable analytics.
  • [OPTIONAL] Dataset Statistical Properties: information in order to influence the data selection mechanisms to be used for the generation of an Analytics ID, assuring that the generated Analytics ID reflects the statistical characteristics of the data that are relevant for the NWDAF consumer. The following dataset statistical properties are allowed:
    • Uniformly distributed datasets, which indicates the use of data samples that are uniformly distributed according to the different aspects of the requested analytics (e.g. equivalent data samples for each UE listed as a Target of Analytics Reporting or for S-NSSAIs included in the Analytics Filter Information).
    • Datasets with or without outliers, which indicates that the data samples shall consider or disregard data samples that are at the extreme boundaries of the value range.
  • Time when analytics information is needed (if applicable): indicates to the NWDAF the latest time the analytics consumer expects to receive analytics data provided by the NWDAF. It should not be set to a value less than the Supported Analytics Delay of the selected NWDAF if applicable. If the time is reached the consumer does not need to wait for the analytics information any longer, yet the NWDAF may send an error response or error notification to the consumer. "Time when analytics information is needed" is a relative time interval as the gap with respect to analytics request /subscription (e.g. "in 10 minutes").
  • [OPTIONAL] Maximum number of objects requested by the consumer (max) to limit the number of objects in a list of analytics per Nnwdaf_AnalyticsSubscription_Notify or Nnwdaf_AnalyticsInfo_Request response.
  • [OPTIONAL] Preferred granularity of location information: "TA level", "cell level" or "longitude and latitude level".
  • [OPTIONAL] Spatial granularity size: maximum number of TA or cells used to define an area for which analytics are provided. When this parameter is provided, the NWDAF should provide analytics per group of TA of cells accordingly.
  • [OPTIONAL] Temporal granularity size: minimum duration of each time slot for which analytics are provide. When this parameter is provided, the NWDAF should provide analytics per elementary time slot accordingly.
  • [OPTIONAL] Preferred orientation of location information: ("horizontal", "vertical", "both").
  • [OPTIONAL] Preferred order of results when a list of analytics is returned, possibly with a criterion for identifying the property of the results to which the preferred ordering is applied.
  • [OPTIONAL] Maximum number of SUPIs (SUPImax) requested by the consumer to limit the number of SUPIs in an object. When SUPImax is not provided, the NWDAF shall return all SUPIs concerned by the analytics object. When SUPImax is set to 0, the NWDAF shall not provide any SUPI.
  • [OPTIONAL] Output strategy: indicates the relevant factors for determining when the analytics reported. The following values are allowed:
    • Binary output strategy: indicates that the analytics shall only be reported when the preferred level of accuracy is reached within a cycle of periodic notification as defined in the Analytics Reporting Parameters.
    • Gradient output strategy: indicates that the analytics shall be reported according to the periodicity defined in the Analytics Reporting Parameters irrespective if the preferred level of accuracy has been reached.
  • [OPTIONAL] Analytics metadata request: indicates a request from one NWDAF to another NWDAF to provide the "analytics metadata information" related to the produced output analytics. This input parameter indicates which parameters in "analytics metadata information" are required to aggregate the output analytics for the requested Analytics ID(s).
• (Only for Nnwdaf_AnalyticsSubscription_Subscribe) Consumer NF's serving area or NF ID. During a pending analytics subscription transfer, this information can be used by the NWDAF to find out if the analytics consumers may change as described in clause 6.1B.2.
• (Only for Nnwdaf_AnalyticsSubscription_Subscribe) Information of previous analytics subscription. When setting up the analytics generation, this information may be used to retrieve analytics context from the previous NWDAF in order to build upon the context that is already related to this subscription as described in clause 6.1B.2.1.
• [OPTIONAL] Use case context: indicates the context of use of the analytics to select the most relevant ML Model.
• (Only for Nnwdaf_AnalyticsSubscription_Subscribe) [OPTIONAL] Analytics Feedback Information: indicates that the consumer NF has taken an action(s) influenced by the previously provided analytics, which may or may not affect the ground truth data corresponding to analytic ID requested at the time which the prediction refers to, and consequently affect the ML Model Accuracy Monitoring by the subscription with following parameter(s):
  • Corresponding Analytics ID(s) which has been used for taking an action(s);
  • Indication whether the action will affect ground truth data (if available);
  • Time stamp(s) of the action(s) taken.
• [OPTIONAL] Analytics Accuracy Request information with the following parameters:
  • Analytics accuracy request: indicates NWDAF to provide accuracy information to the analytics consumer.
  • [OPTIONAL] Analytics Accuracy Information time window: time interval [start. end], which indicates that analytics consumers only consider the accuracy information which is generated within this time interval.
  • [OPTIONAL] Analytics Accuracy Information periodicity: time period, which indicates periodic reporting of accuracy information for the corresponding Analytics ID(s).
  • [OPTIONAL] Analytics Accuracy threshold: a reporting threshold accuracy value, which indicates that:
    • The NWDAF can provide analytics output and optionally analytics accuracy value to the analytics consumer(s) when the accuracy value is above this Analytics Accuracy threshold (i.e. the accuracy is sufficient according to the threshold);
    • The NWDAF can provide "Stop Analytics Output Consumption indication", "Updated Analytics" or the Analytics Accuracy Information to the analytics consumer(s) when the accuracy value is under this threshold (This indicates the deviation of the predictions from the actual network data does not meet analytics accuracy requirement, i.e. the accuracy is not sufficient according to the threshold).
  • [OPTIONAL] Minimal number of analytics output occurrences: determines the minimal number of analytics outputs provided by NWDAF that have to be considered in the determination of the accuracy information.
    • [OPTIONAL] Updated Analytics flag: indicates that the NWDAF can provide updated analytics for provided Analytics ID(s), if updated analytics can be generated within Analytics Accuracy Information time window.
    • [OPTIONAL] Correction time period: a relative time interval as the gap with respect to analytics is provided, which is indicated the time interval during which the updated analytics can be accepted by the analytics consumer.
    • [OPTIONAL] Pause analytics consumption flag: is a flag indicating to NWDAF to stop sending the notifications of analytics outputs for a subscribed analytics ID, without unsubscribing to such analytics ID.
    • [OPTIONAL] Resume Analytics Subscription request: is a flag indicating to NWDAF to resume the notification of analytics outputs for an existing analytics ID(s) subscription(s) that have been previously paused.

The NWDAF provides to the consumer of the Nnwdaf_AnalyticsSubscription_Subscribe or Nnwdaf_AnalyticsInfo_Request service operations described in clause 7, the output information listed below, using a Nnwdaf_AnalyticsSubscription_Notify service operation or the Nnwdaf_AnalyticsInfo_Request response, respectively:

• (Only for Nnwdaf_AnalyticsSubscription_Notify) The Notification Correlation Information.
• For each Analytics ID, the analytics information in the requested Analytics target period. If the analytics subset is subscribed or requested, then the corresponding analytics information shall be provided.
• Timestamp of analytics generation: allows consumers to decide until when the received information shall be used. For instance, an NF can deem a received notification from NWDAF for a given feedback as invalid based on this timestamp;
• Validity period: defines the time period for which the analytics information is valid.
• Confidence: probability assertion, i.e. confidence in the prediction.
• [OPTIONAL] For each Analytics ID the Termination Request, which notifies the consumer that the subscription is requested to be cancelled as the NWDAF can no longer serve this subscription, e.g. due to user consent revoked, NWDAF overload, UE moved out of NWDAF serving area, etc.
• [OPTIONAL] Analytics metadata information: additional information required to aggregate the output analytics for the requested Analytics ID(s). This parameter shall be provided if the "Analytics metadata request" parameter was provided in the corresponding Nnwdaf_AnalyticsSubscription_Subscribe or Nnwdaf_AnalyticsInfo_Request service operation.
  • Number of data samples used for the generation of the output analytics;
  • Data time window of the data samples;
  • Dataset Statistical Properties of the analytics output used for the generation of the analytics;
  • [OPTIONAL] Data source(s) of the data used for the generation of the output analytics;
  • [OPTIONAL] Data Formatting and Processing applied on the data;
  • Output strategy (i.e. gradient output strategy or binary output strategy) used for the reporting of the analytics.
• (Only for error response or error notification) Revised waiting time: indicates to the consumer a revised waiting value for "Time when analytics information is needed". Each NWDAF may include this as part of error response or error notification to "Time when analytics information is needed" as described in clause 6.2.5. Revised waiting time is the minimum time interval recommended by NWDAF to use as "Time when analytics information is needed" for similar future analytics requests/subscriptions.
• [OPTIONAL] Analytics Accuracy Information generated for each analytics ID, including:
  • Analytics accuracy value for requested Analytics ID(s): a value shall be provided if "Analytics accuracy request" parameter was provided in the corresponding Nnwdaf_AnalyticsSubscription_Subscribe service operation. This parameter may be provided if the value crosses the analytics accuracy threshold(s) which is indicated in the subscribe request or locally configured, or the Analytics Accuracy Information periodicity indicated in the subscribe request is reached.
  • [OPTIONAL] An indication that the determined accuracy value for the analytics ID does not meet the analytics accuracy threshold requested for the analytics ID.
• [OPTIONAL] Updated Analytics: NWDAF provides updated Analytics, which is generated within Analytics Accuracy Information time window, for provided Analytics ID(s), if "Updated Analytics flag" parameter was indicated in the corresponding Nnwdaf_AnalyticsSubscription_Subscribe service operation.
• [OPTIONAL] Stop Analytics Output Consumption indication: NWDAF provides to the consumer an indication to stop the consumption of the Analytics ID(s) related to the subscription ID based on NWDAF internal logic or specified analytics accuracy threshold.
• [OPTIONAL] Stop Analytics Output Consumption time window: NWDAF provides to the consumer a time window to stop the consumption of the Analytics ID(s) related to the subscription ID based on NWDAF internal logic or specified analytics accuracy threshold.
• [OPTIONAL] Resume Analytics Output Consumption indication: NWDAF provides to consumer an indication to resume the consumption of analytics output for existing subscription to the analytics ID(s) that was previously paused.
• [OPTIONAL] Accuracy Information Termination: NWDAF notifies the consumer that the subscription to the accuracy information for an analytics ID has been cancelled as the NWDAF does not support the accuracy checking capability, e.g. as an indication that a new target serving NWDAF supporting accuracy checking capability could not have been selected during the analytics transfer procedures.