Tech-invite  3GPPspace  IETF RFCs  SIP
index  N  21  22  23  24  25  26  27  28  29  31  32  33  34  35  36  37  38  4‑5x

Content for  TS 23.288  Word version:  18.2.0

Top   Top   Up   Prev   Next
1…   4…   5…   5A…   6…   6.1.3   6.1.4…   6.1.4.4…   6.1.5…   6.1A…   6.1B…   6.1B.2.3…   6.1C   6.2…   6.2.3…   6.2.6…   6.2.6.2   6.2.6.3…   6.2.6.3.3   6.2.6.3.4   6.2.6.3.5   6.2.6.3.6…   6.2.7…   6.2.8…   6.2.9…   6.2.13…   6.2A…   6.2B…   6.2B.3   6.2B.4…   6.2C…   6.2D…   6.2E…   6.2F…   6.3…   6.4…   6.5…   6.6…   6.7…   6.7.3…   6.7.4…   6.7.5…   6.8…   6.9…   6.10…   6.11…   6.12…   6.13…   6.14…   6.16…   6.17…   6.18…   6.19…   6.20…   6.21…   7…   7.4…   7.7…   7.9…   8…   9…   10… 
7.9 Nnwdaf_MLModelMonitor Service  7.9.1 General  7.9.2 Nnwdaf_MLModelMonitor_Subscribe service operation  7.9.3 Nnwdaf_MLModelMonitor_Unsubscribe service operation  7.9.4 Nnwdaf_MLModelMonitor_Notify service operation  7.9.5 Nnwdaf_MLModelMonitor_Register  7.9.6 Nnwdaf_MLModelMonitor_Deregister  7.10 Nnwdaf_MLModelTraining Service  7.10.1 General  7.10.2 Nnwdaf_MLModelTraining_Subscribe service operation  7.10.3 Nnwdaf_MLModelTraining_Unsubscribe service operation  7.10.4 Nnwdaf_MLModelTraining_Notify service operation  7.11 Nnwdaf_MLModelTrainingInfo Service  7.11.1 General  7.11.2 Nnwdaf_MLModelTrainingInfo_Request service operation 
...

 

7.9  Nnwdaf_MLModelMonitor Service |R18|  p. 289

7.9.1  General  p. 289

Service Description:
This service enables the consumer to subscribe/unsubscribe for ML model accuracy (i.e. Analytics accuracy for an ML model as described in clause 6.2E.3.3) information monitored. The service can additionally provide Analytics feedback information for the analytics generated by an NWDAF (i.e. NWDAF containing AnLF). The service also enables the NWDAF containing AnLF registers the use and monitoring capability for an ML model into the model provider NWDAF, i.e. NWDAF containing MTLF.

7.9.2  Nnwdaf_MLModelMonitor_Subscribe service operation  p. 289

Service operation name:
Nnwdaf_MLModelMonitor_Subscribe
Description:
Subscribes to NWDAF for ML model accuracy (i.e. Analytics accuracy for an ML model as described in clause 6.2E.3.3) information and Analytics feedback information for the analytics generated by the NWDAF with specific parameters.
Inputs, Required:
(set of) Unique ML Model identifier(s), Notification Target Address (+ Notification Correlation ID).
Inputs, Optional:
Subscription Correlation ID (in the case of modification of the ML model monitor subscription), Accuracy metrics to indicate the metrics to calculate the accuracy information, ML model accuracy information period to indicate the reporting periodicity in which the information can be reported, Accuracy reporting threshold to indicate the reporting condition above which the accuracy information needs to be reported.
Outputs Required:
When the subscription is accepted: Subscription Correlation ID (required for management of this subscription), Expiry time (required if the subscription can be expired based on the operator's policy).
Outputs, Optional:
None.
Up

7.9.3  Nnwdaf_MLModelMonitor_Unsubscribe service operation  p. 290

Service operation name:
Nnwdaf_MLModelMonitor_Unsubscribe
Description:
The NF consumer unsubscribes to the NWDAF for ML model accuracy (i.e. Analytics accuracy for an ML model as described in clause 6.2E.3.3) information and Analytics feedback information for the analytics generated by the NWDAF.
Inputs, Required:
Subscription Correlation ID.
Outputs, Required:
Operation execution result indication.
Outputs, Optional:
None.

7.9.4  Nnwdaf_MLModelMonitor_Notify service operation  p. 290

Service operation name:
Nnwdaf_MLModelMonitor_Notify.
Description:
NWDAF notifies the ML model accuracy (i.e. Analytics accuracy for an ML model as described in clause 6.2E.3.3) information and Analytics feedback information for the analytics generated by the NWDAF to the consumer instance which has subscribed to the specific NWDAF service.
Inputs, Required:
Notification Correlation Information, at least one of the following:
  • the tuple (Unique ML model identifier, ML model accuracy information): the ML model accuracy information may include a deviation value which indicates the deviation of the predictions generated using the ML model(s) from the ground truth data, Network data indicated by DataSetTag with ADRF ID when the deviation occurs (which can be used by the NWDAF containing MTLF for possible ML model retraining), Accuracy metrics as requested in Subscribe service operation; and
  • Analytics feedback information: indicates that the consumer NF of the analytics generated by the provisioned ML model has taken an action(s) influenced by the analytics, and includes the following parameter(s):
    • Corresponding Analytics ID(s) which has been used for taking an action(s);
    • Corresponding ML Model identifier(s) which has been used for generating Analytics;
    • Indication whether the action will affect on ground truth data (if available);
    • Time stamp(s) when the action(s) are taken.
Inputs, Optional:
Validity period.
Outputs, Required:
Operation execution result indication.
Outputs, Optional:
None.
Up

7.9.5  Nnwdaf_MLModelMonitor_Register  p. 290

Service operation name:
Nnwdaf_MLModelMonitor_Register
Description:
The consumer registers the use and monitoring capability for an ML model at an NWDAF containing MTLF.
Inputs, Required:
Consumer NF ID, Unique ML Model identifier.
Inputs, Optional:
Endpoint address of the Nnwdaf_MLModelMonitor_Subscribe service operation.
Outputs, Required:
ML model monitoring registration ID.
Outputs, Optional:
None.

7.9.6  Nnwdaf_MLModelMonitor_Deregister  p. 291

Service operation name:
Nnwdaf_MLModelMonitor_Deregister
Description:
The consumer deregisters, from an NWDAF containing MTLF, a previous MLModelMonitor registration, e.g. when the consumer is no longer using or monitoring the accuracy of the analytics generated using the ML model.
Inputs, Required:
ML model monitoring registration ID.
Inputs, Optional:
None.
Outputs, Required:
None.
Outputs, Optional:
None.

7.10  Nnwdaf_MLModelTraining Service |R18|  p. 291

7.10.1  General  p. 291

Service Description:
This service enables the consumer to subscribe/unsubscribe/notify/modify for ML model training.
When used for Federated Learning, this service enables FL server NWDAF to enable Federated Learning while providing global ML model information to FL Client NWDAF and getting local ML model information and status report of FL training as defined in clause 6.2C.2.3 from the FL Client NWDAF.
Up

7.10.2  Nnwdaf_MLModelTraining_Subscribe service operation  p. 291

Service operation name:
Nnwdaf_MLModelTraining_Subscribe
Description:
Subscribes to NWDAF ML model training with specific parameters.
Inputs, Required:
  • Analytics ID as defined in Table 7.1-2;
  • Interoperability information;
  • Notification Target Address (+ Notification Correlation ID);
Inputs, Optional:
  • ML Model ID: identifies the provided ML model.
  • ML Model Information (i.e. file address (e.g. URL or FQDN) of ML Model that needs to update);
  • Subscription Correlation ID (in the case of modification of the ML Model Training subscription);
  • ML Training Information, i.e. data availability requirement, time availability requirement.
  • ML Preparation Flag;
  • ML Model Accuracy Check Flag;
  • ML Correlation ID;
  • Training Filter Information;
  • Target of Training Reporting;
  • Training Reporting Information as defined in clause 6.2F.2;
  • Use case context;
  • Iteration round ID;
  • Expiry time.
Outputs Required:
When the request is accepted: Subscription Correlation ID (required for management of this subscription). When the request is not accepted, an error response with cause code (e.g. NWDAF does not meet the ML training requirements).
Outputs, Optional:
ML Correlation ID (e.g. confirm of the subscription for this FL process).
Up

7.10.3  Nnwdaf_MLModelTraining_Unsubscribe service operation  p. 292

Service operation name:
Nnwdaf_MLModelTraining_Unsubscribe
Description:
Terminate NWDAF ML model training.
Inputs, Required:
Subscription Correlation ID.
Inputs, Optional:
None.
Outputs, Required:
Operation execution result indication.
Outputs, Optional:
Cause code (e.g. FL Client NWDAF is unselected by the FL Server NWDAF for the FL process, or the FL process is suspended or finished, etc.). Final aggregated ML model information (if FL has finished) or updated aggregated ML model information (if FL is suspended).

7.10.4  Nnwdaf_MLModelTraining_Notify service operation  p. 292

Service operation name:
Nnwdaf_MLModelTraining_Notify
Description:
NWDAF notifies the consumer instance of the trained ML model that has subscribed to the specific NWDAF service. The NWDAF can also use this service to indicate to consumer it will terminate the ML model training.
Inputs, Required:
  • Notification Correlation Information: this parameter indicates the Notification Correlation ID that has been assigned by the consumer during ML model training.
Inputs, Optional:
  • Set of the tuple (Analytics ID, ML model Information as defined in clause 6.2F.2;
  • ML Correlation ID, when for Federated Learning;
  • Corresponding Use case context;
  • Termination Request: this parameter indicates that NWDAF requests to terminate the ML model training, i.e. NWDAF will not provide further notifications related to this request, with cause code (e.g. NWDAF overload, not available for the FL process anymore, etc.);
  • ML Model ID: this parameter identifies the provisioned ML model;
  • ML Model Accuracy: The model accuracy of the global ML model, which is calculate by the FL Client NWDAF using the local training data as the testing dataset;
  • Status report of FL training: Accuracy of local model and Training Input Data Information (e.g. areas covered by the data set, sampling ratio, maximum/minimum of value of each dimension, etc.), which are generated by the FL Client NWDAF during FL procedure;
  • Delay Event Notification: as defined in clause 6.2F.2;
  • Iteration round ID.
Outputs, Required:
Operation execution result indication.
Outputs, Optional:
None.
Up

7.11  Nnwdaf_MLModelTrainingInfo Service |R18|  p. 293

7.11.1  General  p. 293

Service Description:
This service enables the consumer to request for the information about ML model training based on the ML Model provided by the consumer.
When used for Federated Learning, this service enables FL server NWDAF to enable Federated Learning while providing global ML model information to FL Client NWDAF and getting local ML model information from the FL Client NWDAF.

7.11.2  Nnwdaf_MLModelTrainingInfo_Request service operation  p. 293

Service operation name:
Nnwdaf_MLModelTrainingInfo_Request
Description:
Request information about NWDAF ML model training with specific parameters.
Inputs, Required:
  • Analytics ID as defined in Table 7.1-2.
  • Interoperability information.
  • ML Model ID: identifies the provided ML model.
Inputs, Optional:
  • ML Model Information (i.e. file address (e.g. URL or FQDN) of ML Model that needs to update).
  • ML Training Information (i.e. data availability requirement, time availability requirement).
  • ML Preparation Flag.
  • ML Model Accuracy Check Flag.
  • ML Correlation ID.
  • Termination Request, when terminating the Federated Learning identified by the ML Correlation ID, and optionally indicating the reason, e.g. FL Client NWDAF is unselected by the FL Server NWDAF for the FL process, or the FL process is suspended, etc.
  • Training Filter Information.
  • Use case context.
Outputs Required:
When the request is accepted: Operation execution result indication. When the request is not accepted, an error response with cause code (e.g. NWDAF does not meet the ML training requirements, ML training is not complete, NWDAF overload, not available for the FL process anymore, etc.).
Outputs, Optional:
  • ML Model ID.
  • Set of the tuple (Analytics ID, ML model Information (i.e., file address (e.g. URL or FQDN) of updated ML Model).
  • ML Correlation ID, when for Federated Learning.
  • Corresponding Use case context.
  • Status report of FL training: local ML model metric and Training Input Data Information (e.g. areas covered by the data set, sampling ratio, maximum/minimum of value of each dimension of data, etc.), which are generated by the FL Client NWDAF during FL procedure.
  • Delay Event Notification with the following parameters:
    • delay event indication: this parameter indicates that the FL Client NWDAF is not able to complete the training of the interim local ML model within the maximum response time provided by the FL Server NWDAF.
    • [OPTIONAL] cause code (e.g. local ML model training failure, more time necessary for local ML model training, etc.).
    • [OPTIONAL] the expected time to complete the training.
  • global ML model metric.
Up

Up   Top   ToC