SOL005NSPerformanceManagementNotification_def.yaml 8.53 KB
Newer Older
1 2
# Copyright (c) ETSI 2017.
# https://forge.etsi.org/etsi-forge-copyright-notice.txt
3

4 5 6 7
definitions:
  PerformanceInformationAvailableNotification:
    description: >
      This notification informs the receiver that performance information is available.
8
      The notification shall be triggered by the NFVO when new performance information 
9 10 11
      collected by a PM job is available.
      The periodicity of triggering this notification is influenced by the "reportingPeriod"
      attribute in the "PmJobCriteria" data structure as defined in clause 7.5.3.3.
12 13 14 15 16
    type: object
    required:
      - id
      - notificationType
      - timeStamp
17
      - pmJobId
18
      - objectType
19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39
      - objectInstanceId
      - _links
    properties:
      id:
        description: >
          Identifier of this notification. If a notification is
          sent multiple times due to multiple
          subscriptions, the "id" attribute of all these
          notifications shall have the same value.
        $ref: "../../definitions/SOL005_def.yaml#/definitions/Identifier"
      notificationType:
        description: >
          Discriminator for the different notification types.
          Shall be set to
          "PerformanceInformationAvailableNotification"
          for this notification type.
        type: string
      timeStamp:
        description: >
          Date and time of the generation of the notification.
        $ref: "../../definitions/SOL005_def.yaml#/definitions/DateTime"
40 41 42 43
      pmJobId:
        description: >
          Identifier of the PM job for which performance information is available.
        $ref: "../../definitions/SOL005_def.yaml#/definitions/Identifier"
44 45 46 47 48 49
      objectType:
        description: >
          Type of the measured object.
          The applicable measured object type for a measurement is
          defined in clause 7.3 of ETSI GS NFV-IFA 027.
        $ref: "../../definitions/SOL005_def.yaml#/definitions/String"
50 51 52 53
      objectInstanceId:
        description: >
          Identifier that identifies a NS instance.
        $ref: "../../definitions/SOL005_def.yaml#/definitions/Identifier"
54 55 56 57 58 59 60 61 62 63 64 65
      subObjectInstanceIds:
        description: >
          Identifiers of the sub-object instances of the measured object
          instance for which the measurements have been taken.
          Shall be present if the related PM job has been set up to measure
          only a subset of all sub-object instances of the measured object
          instance and a sub-object is defined in clause 6.2 of ETSI GS
          NFV-IFA 027 for the related measured object type.
          Shall be absent otherwise.
        type: array
        items:
          $ref: "../../definitions/SOL005_def.yaml#/definitions/IdentifierInNs"
66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98
      _links:
        description: >
          Links to resources related to this notification.
        type: object
        required:
          - pmJob
          - performanceReport
        properties:
          objectInstance:
            description: >
              Link to the resource representing the NS
              instance to which the notified change applies.
              Shall be present if the NS instance information
              is accessible as a resource.
            $ref: "../../definitions/SOL005_def.yaml#/definitions/NotificationLink"
          pmJob:
            description: >
              Link to the resource that represents the PM job
              for which performance information is available.
            $ref: "../../definitions/SOL005_def.yaml#/definitions/NotificationLink"
          performanceReport:
            description: >
              Link from which the available performance
              information of data type "PerformanceReport"
              (see clause 7.5.2.10) can be obtained.
              This link should point to an "Individual
              performance report" resource as defined in
              clause 6.4.3a.
            $ref: "../../definitions/SOL005_def.yaml#/definitions/NotificationLink"

  ThresholdCrossedNotification:
    description: >
      This type represents a notification that is sent when a threshold has been crossed.
99 100 101
      NOTE:	The timing of sending this notification is determined by the capability of 
      the producing entity to evaluate the threshold crossing condition.
      The notification shall be triggered by the NFVO when a threshold has been crossed.
102 103 104 105 106 107 108
    type: object
    required:
      - id
      - notificationType
      - timeStamp
      - thresholdId
      - crossingDirection
109
      - objectType
110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139
      - objectInstanceId
      - performanceMetric
      - performanceValue
      - _links
    properties:
      id:
        description: >
          Identifier of this notification. If a notification is
          sent multiple times due to multiple
          subscriptions, the "id" attribute of all these
          notifications shall have the same value..
        $ref: "../../definitions/SOL005_def.yaml#/definitions/Identifier"
      notificationType:
        description: >
          Discriminator for the different notification types.
          Shall be set to "ThresholdCrossedNotification "
          for this notification type.
        type: string
      timeStamp:
        description: >
          Date and time of the generation of the notification.
        $ref: "../../definitions/SOL005_def.yaml#/definitions/DateTime"
      thresholdId:
        description: >
          Identifier of the threshold which has been crossed.
        $ref: "../../definitions/SOL005_def.yaml#/definitions/Identifier"
      crossingDirection:
        description: >
          An indication of whether the threshold was crossed in upward or downward direction.
        $ref: "#/definitions/CrossingDirectionType"
140 141 142 143 144 145
      objectType:
        description: >
          Type of the measured object.
          The applicable measured object type for a measurement
          is defined in clause 7.3 of ETSI GS NFV-IFA 027.
        $ref: "../../definitions/SOL005_def.yaml#/definitions/String"
146 147 148 149
      objectInstanceId:
        description: >
          Identifier that identifies a NS instance.
        $ref: "../../definitions/SOL005_def.yaml#/definitions/Identifier"
150 151 152 153 154 155 156 157 158 159
      subObjectInstanceId:
        description: >
          Identifier of the sub-object of the measured object to which
          the measurement applies. Shall be present if this is required
          in clause 6.2 of ETSI GS NFV IFA 027 for the related measured
          object type.
          The sub-object allows to structure the measured object but is
          not to be confused with sub-counters which allow to structure
          the measurement.
        $ref: "../../definitions/SOL005_def.yaml#/definitions/IdentifierInNs"
160 161 162 163 164 165 166 167 168 169 170 171
      performanceMetric:
        description: >
          Performance metric associated with the threshold.
          This attribute shall contain the related "Measurement Name" value
          as defined in clause 7.2 of ETSI GS NFV-IFA 027.
        type: string
      performanceValue:
        description: >
          Value of the metric that resulted in threshold crossing.
          The type of this attribute shall correspond to the related
          "Measurement Unit" as defined in clause 7.2 of ETSI GS NFV-IFA 027.
        type: object
172 173 174 175 176 177
      context:
        description: >
          Measurement context information related to the measured value.
          The set of applicable keys is defined per measurement in the
          related "Measurement Context" in clause 7.3 of ETSI GS NFV-IFA 027.
        $ref: "../../definitions/SOL005_def.yaml#/definitions/KeyValuePairs"
178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208
      _links:
        description: >
          Links to resources related to this notification.
        type: object
        required:
          - objectInstance
          - threshold
        properties:
          objectInstance:
            description: >
              Link to the resource representing the NS
              instance to which the notified change applies.
              Shall be present if the NS instance information
              is accessible as a resource..
            $ref: "../../definitions/SOL005_def.yaml#/definitions/NotificationLink"
          threshold:
            description: >
              Link to the resource that represents the
              threshold that was crossed.
            $ref: "../../definitions/SOL005_def.yaml#/definitions/NotificationLink"

  CrossingDirectionType:
    description: >
      The enumeration CrossingDirectionType shall comply with the provisions.
      Acceptable Values are:
      UP - The threshold was crossed in upward direction.
      DOWN - The threshold was crossed in downward direction.
    type: string
    enum:
      - UP
      - DOWN