9 Information model definitions for MDA
28.1043GPPManagement and orchestrationManagement Data Analytics (MDA)Release 17TS
9.1 Imported and associated information entities
9.1.1 Imported information entities and local labels
Table 9.1.1-1
|
Label reference |
Local label |
|
TS 28.622 [19], IOC, Top |
Top |
|
TS 28.622 [19], IOC, SubNetwork |
SubNetwork |
|
TS 28.622 [19], IOC, ManagedElement |
ManagedElement |
|
TS 28.622 [19], IOC, ManagedFunction |
ManagedFunction |
9.2 Class diagram
9.2.1 Relationships
This clause provides the relationships of relevant classes in UML.
NOTE: When the MDAEntity represents the ManagedElement or ManagedFunction, it means the MDAF is located in the NE/NF that the ManagedElement or ManagedFunction represents, but it does not mean the MDA is the feature of the NE/NF.
Figure 9.2.1-1: NRM fragment for MDA request and MDA report
9.2.2 Inheritance
Figure 9.2.2-1: Inheritance Hierarchy
9.3 Class definitions
9.3.1 MDAFunction
9.3.1.1 Definition
The IOC MDAFunction represents the MDA function which supports one or more MDA capabilities.
9.3.1.2 Attributes
Table 9.3.1.2-1
|
Attribute name |
S |
isReadable |
isWritable |
isInvariant |
isNotifyable |
|
supportedMDACapabilities |
M |
T |
F |
F |
T |
9.3.1.3 Attribute constraints
None.
9.3.1.4 Notifications
The common notifications defined in clause 9.6 are valid for this IOC, without exceptions or additions.
9.3.2 MDARequest
9.3.2.1 Definition
The IOC MDARequest represents the MDA output request created by an MnS consumer.
The attribute requestedMDAOutputs contains one or multiple MDAOutputPerMDAType elements, and each MDAOutputPerMDAType element supports filtering of MDA output for a certain MDA type.
9.3.2.2 Attributes
Table 9.3.2.2-1
|
Attribute name |
S |
isReadable |
isWritable |
isInvariant |
isNotifyable |
|
requestedMDAOutputs |
M |
T |
T |
F |
T |
|
reportingMethod |
M |
T |
T |
F |
T |
|
reportingTarget |
M |
T |
T |
F |
T |
|
analyticsScope |
M |
T |
T |
F |
T |
|
startTime |
M |
T |
T |
F |
T |
|
stopTime |
M |
T |
T |
F |
T |
9.3.2.3 Attribute constraints
Table 9.3.2.3-1
|
Name |
Definition |
|
startTime |
Condition: at least one MDA output IE in requestedMDAOutputs attribute is requested based on the choice of granularityPeriod. |
|
stopTime |
Condition: at least one MDA output in requestedMDAOutputs attribute is requested based on the choice of granularityPeriod. |
9.3.2.4 Notifications
The common notifications defined in clause 9.6 are valid for this IOC, without exceptions or additions.
9.3.3 MDAReport
9.3.3.1 Definition
The IOC MDAReport represents the report containing the outputs for one or more MDA types delivered to the MDA consumer.
9.3.3.2 Attributes
Table 9.3.3.2-1
|
Attribute name |
S |
isReadable |
isWritable |
isInvariant |
isNotifyable |
|
mDAReportID |
M |
T |
F |
T |
T |
|
mDAOutputs |
M |
T |
F |
F |
T |
|
NOTE: The content represented by this IOC can be reported by notification, file and streaming. |
|||||
9.3.3.3 Attribute constraints
None.
9.3.3.4 Notifications
The common notifications defined in clause 9.6 are valid for this IOC, without exceptions or additions.
9.4 Data type definitions
9.4.1 MDAOutputPerMDAType <<dataType>>
9.4.1.1 Definition
This <<dataType>> represents the analytics output filters for each MDA type for an MDA request.
If only mDAType element is present (i.e. mDAOutputIEFilters element is not present), then all of the MDA output information elements for this mDAType (see analytics output definitions per MDA capability in clause 8) are requested.
if mDAOutputIEFilters element is present, then only the listed analytics output information elements are requested and shall be reported according to the corresponding threshold.
9.4.1.2 Attributes
Table 9.4.1.2-1
|
Attribute name |
S |
isReadable |
isWritable |
isInvariant |
isNotifyable |
|
mDAType |
M |
T |
T |
F |
T |
|
mDAOutputIEFilters |
O |
T |
T |
F |
T |
9.4.1.3 Attribute constraints
None.
9.4.1.4 Notifications
The <<IOC>> using this <<dataType>> for one of its attributes, shall be applicable.
9.4.2 MDAOutputIEFilter <<dataType>>
9.4.2.1 Definition
This <<dataType>> represents the filter for an MDA output information element for an MDA request.
If only mDAOutputIEName element is present (i.e. filterValue and threshold elements are not present), then the MDA output information element indicated by the mDAOutputIEName is requested and reported without filter or threshold.
If filterValue element is present (only applicable when the MDA output information element indicated by mDAOutputIEName is non-numeric type (e.g. enum, string)), then the MDA output information element indicated by the mDAOutputIEName is only requested and reported when its value equals to the value of filterValue.
If threshold element is present (only applicable when the MDA output information element indicated by mDAOutputIEName is numeric type (e.g. integer, real)), then the MDA output information element indicated by the mDAOutputIEName is only requested and reported when its value reaches or crosses the threshold.
If analyticsPeriod element is present (only applicable when filterValue and threshold elements are not present), then the MDA output information element indicated by the mDAOutputIEName is only requested and reported, at specified time or periodically, i.e. when time reaches the indicated time schedule.
timeOut element is present optionally when an MDA MnS consumer needs an mDAOutputIEName element before a specified time only.
9.4.2.2 Attributes
Table 9.4.2.2-1
|
Attribute name |
Support Qualifier |
isReadable |
isWritable |
isInvariant |
isNotifyable |
|
mDAOutputIEName |
M |
T |
T |
F |
T |
|
filterValue |
CO |
T |
T |
F |
T |
|
threshold |
CO |
T |
T |
F |
T |
|
analyticsPeriod |
O |
T |
T |
F |
T |
|
timeOut |
O |
T |
T |
F |
T |
9.4.2.3 Attribute constraints
Table 9.4.2.3-1
|
Name |
Definition |
|
filterValue |
Condition: the MDA output information element indicated by the mDAOutputIEName element is non‑numeric type (e.g. enum, string). |
|
threshold |
Condition: the MDA output information element indicated by the mDAOutputIEName element is numeric type (e.g. integer, real). |
9.4.2.4 Notifications
The <<IOC>> using this <<dataType>> for one of its attributes, shall be applicable.
9.4.3 AnalyticsScopeType <<choice>>
9.4.3.1 Definition
This <<choice>> represents the scope of analytics.
When the managedEntitiesScope attribute is present, the MnS producer identify the analytics scope by the DNs of the managed entities.
When the areaScope attribute is present, the MnS producer identify the analytics scope by the geographical area information.
The managedEntitiesScope attribute and areaScope attribute shall not be present at the same time.
9.4.3.2 Attributes
Table 9.4.3.2-1
|
Attribute name |
S |
isReadable |
isWritable |
isInvariant |
isNotifyable |
|
Choice_1 managedEntitiesScope |
CM |
T |
T |
F |
T |
|
Choice_2 areaScope |
CM |
T |
T |
F |
T |
9.4.3.3 Attribute constraints
Table 9.4.3.3-1
|
Name |
Definition |
|
Choice_1 managedEntitiesScope |
Condition: the MDA MnS producer supports to identify the scope by managed entities. |
|
Choice_2 areaScope |
Condition: MDA MnS producer supports to identify the scope by geographical area information. |
9.4.3.4 Notifications
The <<IOC>> using this <<dataType>> for one of its attributes, shall be applicable.
9.4.4 TimeWindow <<dataType>>
9.4.4.1 Definition
This <<dataType>> represents the time duration related to the MDA output sent to the MDA MnS consumer.
9.4.4.2 Attributes
Table 9.4.4.2-1
|
Attribute name |
S |
isReadable |
isWritable |
isInvariant |
isNotifyable |
|
mDAOutputStartTime |
M |
T |
T |
F |
T |
|
mDAOutputEndTime |
M |
T |
T |
F |
T |
9.4.4.3 Attribute constraints
None.
9.4.4.4 Notifications
The <<IOC>> using this <<dataType>> for one of its attributes, shall be applicable.
9.4.5 MDAOutputs <<dataType>>
9.4.5.1 Definition
The IOC MDAOutputs represents the MDA outputs created by an MDA MnS producer for a specific MDA type.
9.4.5.2 Attributes
Table 9.4.5.2-1
|
Attribute name |
S |
isReadable |
isWritable |
isInvariant |
isNotifyable |
|
mDAType |
M |
T |
T |
F |
T |
|
mdaOutputList |
M |
T |
T |
F |
T |
|
mDARequestRef |
M |
T |
F |
F |
T |
9.4.5.3 Attribute constraints
None.
9.4.5.4 Notifications
The <<IOC>> using this <<dataType>> for one of its attributes, shall be applicable.
9.4.6 MDAOutputEntry <<dataType>>
9.4.6.1 Definition
This data type specifies an MDA output.
9.4.6.2 Attributes
Table 9.4.6.2-1
|
Attribute name |
S |
isReadable |
isWritable |
isInvariant |
isNotifyable |
|
mdaOutputIEName |
M |
T |
T |
F |
T |
|
mdaOutputIEValue |
M |
T |
T |
F |
T |
|
analyticsWindow |
M |
T |
T |
F |
T |
|
confidenceDegree |
M |
T |
T |
F |
T |
9.4.6.3 Attribute constraints
None.
9.4.6.4 Notifications
The <<IOC>> using this <<dataType>> for one of its attributes, shall be applicable.
9.4.7 AnalyticsSchedule <<choice>>
9.4.7.1 Definition
The <<choice>> represents the time schedule for MDA.
9.4.7.2 Attributes
Table 9.4.7.2-1
|
Attribute name |
S |
isReadable |
isWritable |
isInvariant |
isNotifyable |
|
Choice_1 timeDurations |
M |
T |
T |
F |
T |
|
Choice_2 granularityPeriod |
M |
T |
T |
F |
T |
9.4.7.3 Attribute constraints
None.
9.4.7.4 Notifications
The <<IOC>> using this <<dataType>> for one of its attributes, shall be applicable.
9.4.8 ThresholdInfo <<dataType>>
9.4.8.1 Definition
This data type defines a single threshold level.
9.4.8.2 Attributes
|
Attribute name |
S |
isReadable |
isWritable |
isInvariant |
isNotifyable |
|
monitoredMDAOutputIE |
M |
T |
T |
F |
T |
|
thresholdDirection |
M |
T |
T |
F |
T |
|
thresholdValue |
M |
T |
T |
F |
T |
|
hysteresis |
O |
T |
T |
F |
T |
9.4.8.3 Attribute constraints
None
9.4.8.4 Notifications
The <<IOC>> using this <<dataType>> for one of its attributes, shall be applicable.
9.5 Attribute definitions
9.5.1 Attribute properties
Table 9.5.1-1
|
Attribute Name |
Documentation and Allowed Values |
Properties |
|---|---|---|
|
mDAType |
It indicates the type of MDA type (corresponding to the MDA capability). AllowedValues: the value of MDA type defined for each MDA capability in clause 8. |
type: String multiplicity: 1 isOrdered: N/A isUnique: N/A defaultValue: None isNullable: True |
|
requestedMDAOutputs |
It indicates the requested analytics outputs for an MDA request. |
type: MDAOutputPerMDAType multiplicity: * isOrdered: False isUnique: True defaultValue: None isNullable: False |
|
mDAOutputIEFilters |
It provides the filters for the analytics output information elements of an MDA type for an MDA request. |
type: MDAOutputIEFilter multiplicity: * isOrdered: False isUnique: True defaultValue: None isNullable: True |
|
mDAOutputIEName |
It indicates the analytics output information element name. AllowedValues: the analytics output information element names for each MDA type as specified in clause 8. |
type: string multiplicity: * isOrdered: False isUnique: True defaultValue: None isNullable: True |
|
filterValue |
It indicates the filter value for analytics output information element for an MDA request. The MDA output information element is only requested and reported when its value equals to the value of this attribute. allowedValues: depends on the definitions of the analytics output information element (see clause 8) indicated by mDAOutputIEName attribute. |
The type for the corresponding mdaOutputIEName as defined in clause 8 |
|
threshold |
It indicates the threshold for analytics output information element for an MDA request. |
type: ThresholdInfo multiplicity: * isOrdered: False isUnique: True defaultValue: None isNullable: True |
|
analyticsPeriod |
It indicates a list of time duration, or a time-period related to a time schedule for analytics. |
type: AnalyticsSchedule multiplicity: 1..* isOrdered: False isUnique: True defaultValue: None isNullable: True |
|
timeOut |
It indicates a time until which an MDA MnS consumer needs to obtain an MDA output. Beyond this time the MDA output is no longer needed by the MDA MnS consumer. |
type: DateTime (see TS 32.156 [18]) multiplicity: 1 isOrdered: N/A isUnique: N/A defaultValue: None isNullable: True |
|
reportingMethod |
It indicates the reporting method of the analytics output selected by the MnS consumer. allowedValues: File, Streaming, Notification. |
type: Enum multiplicity: 1 isOrdered: N/A isUnique: N/A defaultValue: None isNullable: True |
|
reportingTarget |
It indicates the reporting target of the MDA outputs. Allowed values: URI. |
type: String multiplicity: 1 isOrdered: N/A isUnique: N/A defaultValue: None isNullable: True |
|
analyticsScope |
It indicates the scope of the analytics requested by the MnS consumer. |
type: AnalyticsScopeType multiplicity: 1 isOrdered: N/A isUnique: True defaultValue: None isNullable: True |
|
managedEntitiesScope |
It indicates the scope of the analytics by the DNs of the managed entities. It carries the DN(s) of SubNetwork MOI(s), ManagedElement MOI(s), and/or the MOI(s) of the derivative IOCs of ManagedFunction (see TS 28.622 [19]). For each MOI provided by this attribute, the MOI itself and all of its subordinated MOIs are in the scope of analytics. |
type: DN multiplicity: * isOrdered: False isUnique: True defaultValue: None isNullable: True |
|
areaScope |
It indicates the scope of the analytics by the geographical area information. |
type: GeoArea (see TS 28.622 [19]) multiplicity: * isOrdered: False isUnique: True defaultValue: None isNullable: True |
|
startTime |
It indicates the start time of the periodical analytics requested by the MnS consumer. |
type: DateTime (see TS 32.156 [18]) multiplicity: 1 isOrdered: N/A isUnique: N/A defaultValue: None isNullable: True |
|
stopTime |
It indicates the stop time of the periodical analytics requested by the MnS consumer. |
type: DateTime (see TS 32.156 [18]) multiplicity: 1 isOrdered: N/A isUnique: N/A defaultValue: None isNullable: True |
|
mDAReportID |
It indicates the identifier for the MDAReport. |
type: string multiplicity: 1 isOrdered: N/A isUnique: N/A defaultValue: None isNullable: True |
|
mdaOutputList |
It indicates a list of output results related to particular MDA type. |
type: MDAOutputEntry multiplicity: * isOrdered: False isUnique: True defaultValue: None isNullable: True |
|
analyticsWindow |
It indicates the time duration related to an MDA output. It can be in the past, when the analytics is statistics, or in the future for a prediction. |
type: TimeWindow multiplicity: 1 isOrdered: N/A isUnique: N/A defaultValue: None isNullable: True |
|
mdaOutputIEValue |
It indicates the MDA output result that can be numeric or non-numeric. |
The type for the corresponding mdaOutputIEName as defined in clause 8 |
|
confidenceDegree |
A probability range that contains the degree of accuracy of the analytics output statistics or prediction. |
type: Real multiplicity: 1 isOrdered: N/A isUnique: N/A defaultValue: None isNullable: False |
|
supportedMDACapabilities |
It indicates the MDA capabilities supported by the MDA function. AllowedValues: the value of MDA types defined for the MDA capabilities in clause 8. |
type: String multiplicity: * isOrdered: False isUnique: True defaultValue: None isNullable: True |
|
mDAOutputs |
It indicates the analytics output results of one or more MDA types delivered to MDA consumer. |
type: MDAOutputs multiplicity: 1..* isOrdered: False isUnique: True defaultValue: None isNullable: True |
|
mDARequestRef |
It indicates the DN of the MDARequest MOI for which the results are generated by the MDA producer. |
type: DN multiplicity: 1 isOrdered: N/A isUnique: N/A defaultValue: None isNullable: True |
|
monitoredMDAOutputIE |
It indicates the analytics output information element name monitored by a threshold. AllowedValues: the analytics output information element names for each MDA type as specified in clause 8. |
type: string multiplicity: 1 isOrdered: N/A isUnique: N/A defaultValue: None isNullable: False |
|
thresholdValue |
It specifies the value against which the monitored MDA output information element is compared at a threshold level in case the hysteresis is zero. allowedValues: float or integer |
type: Union multiplicity: 1 isOrdered: NA isUnique: NA defaultValue: None isNullable: False |
|
hysteresis |
It specifies the hysteresis of a threshold. If this attribute is present the monitored MDA output information element value is not compared against the threshold value as specified by the thresholdValue attribute but against a high and low threshold value given by highThresholdValue- = thresholdValue + hysteresis lowThresholdValue = thresholdValue – hysteresis When going up, the threshold is triggered when the MDA output information element value reaches or crosses the high threshold value. When going down, the threshold is triggered when the MDA output information element value reaches or crosses the low threshold value. allowedValues: non-negative float or integer |
type: Union multiplicity: 0..1 isOrdered: NA isUnique: NA defaultValue: None isNullable: False |
|
thresholdDirection |
It indicates the direction of a threshold indicating the direction for which a threshold crossing triggers a threshold. When the threshold direction is configured to "UP", the associated treshold is triggered only when the subject MDA output information element value is going up upon reaching or crossing the threshold value. The treshold is not triggered, when the MDA output information element value is going down upon reaching or crossing the threshold value. Vice versa, when the threshold direction is configured to "DOWN", the associated treshold is triggered only when the MDA output information element value is going down upon reaching or crossing the threshold value. The treshold is not triggered, when the MDA output information element value is going up upon reaching or crossing the threshold value. When the threshold direction is set to "UP_AND_DOWN" the treshold is active in both direcions. In case a threshold with hysteresis is configured, the threshold direction attribute shall be set to "UP_AND_DOWN". allowedValues: – UP – DOWN – UP_AND_DOWN |
type: ENUM multiplicity: 1 isOrdered: N/A isUnique: N/A defaultValue: None isNullable: False |
|
mDAOutputStartTime |
It indicates the analytics start time for an MDA output. |
type: DateTime (see TS 32.156 [18]) multiplicity: 1 isOrdered: N/A isUnique: N/A defaultValue: None isNullable: False |
|
mDAOutputEndTime |
It indicates the analytics end time for an MDA output. |
type: DateTime (see TS 32.156 [18]) multiplicity: 1 isOrdered: N/A isUnique: N/A defaultValue: None isNullable: False |
|
timeDurations |
It indicates a list of time duration. |
type: TimeWindow multiplicity: * isOrdered: N/A isUnique: True defaultValue: None isNullable: False |
|
granularityPeriod |
It indicates the granularity period (in unit of second) of the analytics for an MDA output. |
type: integer multiplicity: 1 isOrdered: N/A isUnique: N/A defaultValue: None isNullable: False |
9.6 Common notifications
9.6.1 Configuration notifications
This clause presents a list of notifications, defined in TS 28.532 [11], that an MnS consumer may receive. The notification header attribute objectClass/objectInstance shall capture the DN of an instance of a class defined in the present document.
Table 9.6.1-1
|
Name |
Qualifier |
Notes |
|---|---|---|
|
notifyMOICreation |
O |
— |
|
notifyMOIDeletion |
O |
— |
|
notifyMOIAttributeValueChanges |
O |
— |
|
notifyEvent |
O |
— |