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.
Service operation name:
Nnwdaf_MLModelMonitor_Subscribe
Description:
Subscribes to NWDAF for the monitored 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), desired Accuracy metrics to indicate the metrics to calculate the accuracy information, reporting period to indicate the reporting periodicity in which the monitored ML Model Accuracy Information shall be reported, Accuracy reporting threshold to indicate the reporting condition across which the accuracy information shall be reported, Analytics ID, Target of Analytics Reporting and Analytics filter.
Analytics ID, Target of Analytics Reporting and Analytics filter for each ML Model identifier should reflect the corresponding information received in the
Nnwdaf_MLModelMonitor_Register request from the NWDAF containing AnLF to which the current NWDAF containing MTLF subscribes.
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.
Service operation name:
Nnwdaf_MLModelMonitor_Unsubscribe
Description:
The NF consumer unsubscribes to the NWDAF for the monitored 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.
Service operation name:
Nnwdaf_MLModelMonitor_Notify
Description:
NWDAF notifies the monitored 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 monitored ML Model Accuracy Information which includes:
-
Unique ML Model identifier;
-
Monitoring interval: time interval during which the ML Model Accuracy Monitoring was conducted;
-
Monitored Analytics metrics value of the ML Model and a deviation value which indicates the deviation of the predictions generated using the ML Model(s) from the ground truth data;
-
Number of inferences that were performed during the monitoring interval;
-
Used Accuracy metrics (as requested in Subscribe service operation).
-
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:
-
Input data used for inferencing indicated by DataSetTag with ADRF ID when the prediction generated from the ML Model is not correct (which can be used by the NWDAF containing MTLF for possible ML Model retraining);
-
An indication that the analytics metrics value of the ML Model does not meet the requirement of accuracy for the ML Model.
-
Analytics ID;
-
Target of Analytics Reporting;
-
Analytics filter for which the model is used for.
Outputs, Required:
Operation execution result indication.
Outputs, Optional:
None.
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, ML Model accuracy transfer indication as defined in
clause 6.2E.3.2, Analytics ID, Target of Analytics Reporting and the Analytics filter for which the model is used for.
Outputs, Required:
ML Model monitoring registration ID.
Outputs, Optional:
None.
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:
A termination indication, a termination cause, the NWDAF containing AnLF NF ID of the target NWDAF (in the case that the termination cause is due to analytics transfer).
Outputs, Required:
None.
Outputs, Optional:
None.