<?xml version="1.0" encoding="utf-8"?>
  <?xml-stylesheet type="text/xsl" href="rfc2629.xslt" ?>
  <!-- generated by https://github.com/cabo/kramdown-rfc version 1.6.17 (Ruby 2.7.0) -->


<!DOCTYPE rfc  [
  <!ENTITY nbsp    "&#160;">
  <!ENTITY zwsp   "&#8203;">
  <!ENTITY nbhy   "&#8209;">
  <!ENTITY wj     "&#8288;">

]>

<?rfc comments="yes"?>

<rfc ipr="trust200902" docName="draft-yu-ccamp-optical-resource-pm-yang-00" category="std" consensus="true" tocInclude="true" sortRefs="true" symRefs="true">
  <front>
    <title abbrev="Optical Resource Performance Monitoring YANG">A YANG Data Model for Optical Resource Performance Monitoring</title>

    <author initials="C." surname="Yu" fullname="Chaode Yu">
      <organization>Huawei Technologies</organization>
      <address>
        <email>yuchaode@huawei.com</email>
      </address>
    </author>
    <author initials="F." surname="Peruzzini" fullname="Fabio Peruzzini">
      <organization>TIM</organization>
      <address>
        <email>fabio.peruzzini@telecomitalia.it</email>
      </address>
    </author>
    <author initials="Y." surname="Zheng" fullname="Yanlei Zheng">
      <organization>China Unicom</organization>
      <address>
        <email>zhengyanlei@chinaunicom.cn</email>
      </address>
    </author>
    <author initials="I." surname="Busi" fullname="Italo Busi">
      <organization>Huawei Technologies</organization>
      <address>
        <email>italo.busi@huawei.com</email>
      </address>
    </author>
    <author initials="A." surname="Guo" fullname="Aihua Guo">
      <organization>Futurewei Technologies</organization>
      <address>
        <email>aihuaguo.ietf@gmail.com</email>
      </address>
    </author>

    <date year="2023" month="March" day="13"/>

    
    <workgroup>CCAMP Working Group</workgroup>
    

    <abstract>


<t>This document defines a YANG data model for performance Monitoring in optical networks which provides the functionalities of performance monitoring task management, TCA (Threshold Crossing Alert) configuration and current or historic performance data retrieval. This data model should be used in the northbound of PNC.</t>



    </abstract>



  </front>

  <middle>


<section anchor="introduction"><name>Introduction</name>

<t>Performance monitoring is a basic function of optical networks management. With it, operators can proactively detect the running state of devices, identify major risks in advanced and avoid users' complaints.</t>

<t>As before, TMF has defined interfaces for performance management through traditional protocols, such as CORBA and MTOSI. With the development of SDN technologies and the using of RESTCONF interfaces, it becomes a widespread requirement to use RESTCONF protocol to support performance monitoring.</t>

<t>Using RESTCONF does not mean changing existing performance monitoring requirements or scenarios. On the contrary, since O&amp;M is very important, many operators' O&amp;M departments tend to be conservative. Mostly, they are fear of introducing issues into their network due to the protocol changes and O&amp;M habits changes. Therefore, our document prefers to use the new protocol to support legacy functionality.</t>

<t>Traditional performance management involves control of performance monitoring, setting collectors on monitored objects, and obtaining performance data in different periods. The data can be current data on devices or processed by PNC, and historical performance data. TCA can be also configured by performance monitoring tasks.</t>

<t>The explanation of performance monitoring indicator would also be an important part of this document, especially some typical optical-specific indicators.</t>

<t>Currently, there are some existing documents related to performance monitoring in IETF, but there is no overlap with our current work. For example:</t>

<t><xref target="I-D.ietf-teas-actn-pm-telemetry-autonomics"/> provides a YANG data model that describes performance monitoring and scaling intent mechanisms for TE-Tunnels and Virtual Networks(VNs). VN is determinated to be used in CMI (CNC-MDSC Interface) level and TE tunnel is more service or connection related. Our data model is proposed to be used in MPI (MDSC-PNC Interface) level and this performance monitoring is performed on network resources, such as network element, board, fiber, port or TTP (Tunnel Termination Point), which are not included in <xref target="I-D.ietf-teas-actn-pm-telemetry-autonomics"/>.</t>

<t><xref target="I-D.ietf-opsawg-yang-vpn-service-pm"/> defines a YANG data model for performance monitoring of both network topology layer and overlay VPN service topology layer. VPN service is more IP-specific and not adopted in Optical domain. And the data model in this document is augmenting network model. If the client wants to retrieve performance data of a link by RESTCONF, the URL would be probably same with the URL of topology retrieval. This may need some special mechanisms to make the client and server differentiate the using scenarios. This is not quite compliance with current O&amp;M habits of Optical technology.</t>

<t><xref target="I-D.zheng-ccamp-client-pm-yang"/> provides a performance monitoring YANG data model on client signal level. It is also not operated on resource level which is not compliance with the existing O&amp;M habits. This performance monitoring solution is more user-oriented and can be used for more automatic O&amp;M scenarios in the future. However, there is not a complete closed-loop O&amp;M solution at the service layer and it has not been accepted by all operators' O&amp;M departments, resource-based performance monitoring is still required.</t>

<t>The YANG data model defined in this document conforms to the Network Management Datastore Architecture (NMDA) defined in <xref target="RFC8342"/>.</t>

<section anchor="terminology-and-notations"><name>Terminology and Notations</name>
<t>Refer to <xref target="RFC7446"/> and <xref target="RFC7581"/> for the key terms used in this document.  The following terms are defined in <xref target="RFC7950"/> and are not redefined here:
*  client
*  server
*  augment
*  data model
*  data node</t>

<t>The following terms are defined in <xref target="RFC6241"/> and are not redefined here:
*  configuration data
*  state data</t>

<t>The following terms are defined in <xref target="RFC8454"/> and are not redefined here:
*  CMI
*  MPI
*  MDSC
*  CNC
*  PNC</t>

<t>//To Be Added: some explanation of performance indicator</t>

</section>
<section anchor="tree-diagram"><name>Tree Diagram</name>
<t>A simplified graphical representation of the data model is used in Section 3 of this document.  The meaning of the symbols in these diagrams are defined in <xref target="RFC8340"/>.</t>

</section>
<section anchor="prefix-in-data-node-names"><name>Prefix in Data Node Names</name>
<t>In this document, names of data nodes and other data model objects are prefixed using the standard prefix associated with the corresponding YANG imported modules, as shown in the following table.</t>

<texttable title="Prefixes and corresponding YANG modules" anchor="tab-prefixes">
      <ttcol align='left'>Prefix</ttcol>
      <ttcol align='left'>Yang Module</ttcol>
      <ttcol align='left'>Reference</ttcol>
      <c>optrpm</c>
      <c>ietf-optical-resource-pm</c>
      <c>RFC XXXX</c>
      <c>optrpm-types</c>
      <c>ietf-optical-resource-pm-types</c>
      <c>RFC XXXX</c>
      <c>yang</c>
      <c>ietf-yang-types</c>
      <c><xref target="RFC6991"/></c>
</texttable>

<t>RFC Editor Note:
Please replace XXXX with the RFC number assigned to this document.</t>

</section>
</section>
<section anchor="yang-data-model-for-optical-performance-monitoring"><name>YANG Data Model for Optical Performance Monitoring</name>
<t>According to the business requirements stated in <xref target="TMF-518"/>, resource performance management requirements include:
* The Interface shall support the control of performance monitoring in the network. This includes PM control, e.g., the enabling and disabling of PM collection and Threshold Crossing Alerts (TCA) control, e.g., the enabling and disabling of TCA generation.
* The Interface shall support the retrieval of current and historical performance measurements for network resources.
* The Interface shall support the distribution of TCAs to subscribed OSs.</t>

<t>For these requirements of PM, there are three group of interfaces are defined in TMF, including PerformanceManagementControl, PerformanceManagementRetrieval and ThresholdCrossingAlertControlm.</t>

<section anchor="performance-management-control"><name>Performance Management Control</name>

<t>There are three interfaces defined in TMF for this group, including:
* clearPerformanceMonitoringData: This interface shall allow MDSC to clear or reset the performance register on TPs or NEs. This clearing operation means to reset the data value to the current value. The monitoring job is still running on.
* disablePerformanceMonitoringData: This interface shall allow MDSC disable PM data collection on a list of TPs or NEs.
* enablePerformanceMonitoringData: This interface shall allow MDSC enable PM data collection on a list of TPs or NEs.</t>

<t>This aspect of interface we introduce a monitor task to do this control. In the monitoring task, MDSC should be able to configure what period and what kind of performance data it want to collect. The disabling, enabling operation can be satisfy by changing the admin status which includes disabled, enabled. The change's result will affect the task status accordingly.</t>

<t>//NOTES: To be added. to support the clearPerformanceMonitoringData</t>

<figure><artwork type="ascii-art"><![CDATA[
module: ietf-optical-resource-pm
   +--rw performance-monitoring
      +--rw monitor-tasks
      |  +--rw monitor-task* [task-id]
      |     +--rw task-id          yang:uuid
      |     +--rw resource-id?     leafref
      |     +--ro resource-type?   identityref
      |     +--rw task-name?       string
      |     +--rw admin-status?    enumeration
      |     +--ro task-status?     enumeration
      |     +--rw task-cfg
      |        +--rw period?       identityref
      |        +--rw indicators
      |           +--rw indicator* [indicator-name]
      |              +--rw indicator-name          string
      |              +--rw indicator-value-unit?   string
]]></artwork></figure>

</section>
<section anchor="performancemanagementretrieval"><name>PerformanceManagementRetrieval</name>

<t>There are six interfaces are defined in TMF for this group, including:
* getAllCurrentPerformanceMonitoringData: This interface should allow MDSC to retrieve performance data on a series of termination point.
* getHistoryPerformanceMonitoringData: This interface should allow MDSC to retrieve some historic performance data on a series of termination point in a time period through FTP.
* getAllPerformanceMonitoringPoints: This interface should allow MDSC to retrieve all the performance monitoring points in a specified termination point or NE.
* getHoldingTime: This interface should allow MDSC to retrieve how many hours PM data records are held in PNC.
* getMePerformanceMonitoringCapabilities: This interface should allow MDSC to retrieve what parameters are supported by a specified NE or termination point.</t>

<t>For the retrieval of current/historic performance data, there is one option that we define the value in the data model. But considered that performance data is frequently changed and if we follow that approach, according to the requirement of on-change notification in YANG-push <xref target="RFC8641"/>, once the performance data changes, the PNC should trigger a notifcation to the MDSC, for the sake of data consistency. But these two retrieval interfaces is more like on-demand invoking. The interaction through notification would bring great pressure to both PNC and MDSC.</t>

<t>And it is also hard to support retrieving performance data of multiple resources by data model. And for historic performance data retrieval, there could be a requirement to specify the start time and end time. It is not quite flexible to support this requirement by data model neither.</t>

<t>So we suggest to define two RPCs to accomplish these two interfaces' function.</t>

<figure><artwork type="ascii-art"><![CDATA[
rpcs:
   +---x get-all-current-pm-data
   |  +--ro input
   |  |  +--ro resources*   leafref
   |  +--ro output
   |     +--ro pm-data
   |        +--ro pm-data-list* [resource]
   |           +--ro resource          leafref
   |           +--ro collect-time?     yang:date-and-time
   |           +--ro resource-type?    identityref
   |           +--ro indicator-data
   |              +--ro indicator-data-list* [indicator-name]
   |                 +--ro indicator-name          string
   |                 +--ro indicator-value?        string
   |                 +--ro indicator-value-unit?   string
   +---x get-historic-pm-data
      +--ro input
      |  +--ro resources*    leafref
      |  +--ro start-time?   yang:date-and-time
      |  +--ro end-time?     yang:date-and-time
      +--ro output
         +--ro pm-data
            +--ro pm-data-list* [resource]
               +--ro resource          leafref
               +--ro collect-time?     yang:date-and-time
               +--ro resource-type?    identityref
               +--ro indicator-data
                  +--ro indicator-data-list* [indicator-name]
                     +--ro indicator-name          string
                     +--ro indicator-value?        string
                     +--ro indicator-value-unit?   string
]]></artwork></figure>

<t>//NOTE: To be futhur analyze: getAllPerformanceMonitoringPoints, getHoldingTime, getMePerformanceMonitoringCapabilities</t>

</section>
<section anchor="threshold-crossing-alert-control"><name>Threshold Crossing Alert Control</name>

<t>There are nine interfaces are defined in TMF for this group, including:
* createTcaParameterProfile: This interface should allow MDSC to create a new TCA parameter profile. This profile can be applied to the resources.
* deleteTcaParameterProfile: This interface should allow MDSC to delete an existing TCA parameter profile which should not have been used by any resources.
* enableThresholdCrossingAlert: This interface should allow MDSC to turn on TCA reporting on a list of TPs and NEs if the reporting was turned off before.
* disableThresholdCrossingAlert: This interface should allow MDSC to turn off TCA reporting on a list of TPs and NEs.
* getAllTcaParameterProfiles: This interfaces should allow MDSC to retrieve all TCA parameter profile that are being managed by a specified NE.
* getTcaParameterProfile: This interface should allow MDSC to retrieve all the parameters of a specified TCA parameter profile.
* getTcaTpParameter: This interface should allow MDSC to retrieve the PM threshold values on a TP.
* setTcaParameterProfile: This interface should allow MDSC to configure all threshold values of a TCA parameter profile.
* setTcaTpParameter: This interface should allow MDSC to modify the values of TCA Parameters on a TP</t>

<t>To be summarized, there are four main requirements for Threshold Crossing Alert Control:
* Creation/retrieval/deletion/updating of TCA profile;
* Enabling/disabling TCA reporting on the resource;
* Configuring TCA on the resource by associating an existing profile;
* Configuring TCA on the resource by detailed parameters.</t>

<t>And for the TCA parameters, no matter it is configured directly on the resource or by a preset profile, there should not be any differences. The TCA parameter (indicator) should include:
* indicator-name: Name of indicator. This indicator should also include some data processing information, such if it is a maximum, or minimum, or average data .etc.
* threshold-type: This threshold type is used to indicate when the alert will be triggered. By exceeding the upper bound value, or by below the lower bound value.
* period: This period is used to indicate the frequency of the data collection.
* severity: This severity is used to indicate what level of alert would be triggered if cross the threshold.
* indicator-value: The value of threshold.
* indicator-value-unit: The unit of threshold value.</t>

<t>The tree structure for TCA profile:</t>

<figure><artwork type="ascii-art"><![CDATA[
module: ietf-optical-resource-pm
   +--rw performance-monitoring
      +--rw monitor-tasks
      |  +--rw monitor-task* [task-id]
      |     +--rw task-id          yang:uuid
      |     +--......................
      +--rw tca-management
      |  +--rw profiles
      |  |  +--rw profile* [profile-id]
      |  |     +--rw profile-id      yang:uuid
      |  |     +--rw profile-name?   string
      |  |     +--rw tca-cfg
      |  |        +--rw tca-indicator* [indicator-name threshold-type period severity]
      |  |           +--rw indicator-name          string
      |  |           +--rw indicator-value         string
      |  |           +--rw indicator-value-unit    string
      |  |           +--rw threshold-type          enumeration
      |  |           +--rw period                  identityref
      |  |           +--rw severity                identityref
]]></artwork></figure>

<t>The function  of enabling/disabling TCA on the resource can be controlled by an admin-status attributes in "tca" node:</t>

<figure><artwork type="ascii-art"><![CDATA[
module: ietf-optical-resource-pm
   +--rw performance-monitoring
      +--rw monitor-tasks
      |  +--rw monitor-task* [task-id]
      |     +--rw task-id          yang:uuid
      |     +--......................
      +--rw tca-management
      |     +--rw tca* [resource-id]
      |        +--rw resource-id         leafref
      |        +--ro resource-type?      identityref
      |        +--rw admin-status?       enumeration
      |        +--......................
]]></artwork></figure>

<t>If MDSC wants to configure TCA by an existing profile, it can use this applied-profiles structure:</t>

<figure><artwork type="ascii-art"><![CDATA[
module: ietf-optical-resource-pm
   +--rw performance-monitoring
      +--rw monitor-tasks
      |  +--rw monitor-task* [task-id]
      |     +--rw task-id          yang:uuid
      |     +--......................
      +--rw tca-management
      |     +--rw tca* [resource-id]
      |        +--rw resource-id         leafref
      |        +--ro resource-type?      identityref
      |        +--rw applied-profiles
      |        |  +--rw profile* [profile-id]
      |        |     +--rw profile-id    leafref
      |        +--......................
]]></artwork></figure>

<t>MDSC can also configure TCA value directly by the "tca-cfg" structure:</t>

<figure><artwork type="ascii-art"><![CDATA[
module: ietf-optical-resource-pm
   +--rw performance-monitoring
      +--rw monitor-tasks
      |  +--rw monitor-task* [task-id]
      |     +--rw task-id          yang:uuid
      |     +--......................
      +--rw tca-management
      |     +--rw tca* [resource-id]
      |        +--rw resource-id         leafref
      |        +--ro resource-type?      identityref
      |        +--......................
      |        +--rw tca-cfg
      |           +--rw tca-indicator* [indicator-name threshold-type period severity]
      |              +--rw indicator-name          string
      |              +--rw indicator-value         string
      |              +--rw indicator-value-unit    string
      |              +--rw threshold-type          enumeration
      |              +--rw period                  identityref
      |              +--rw severity                identityref
]]></artwork></figure>

</section>
<section anchor="generic-resource"><name>Generic Resource</name>
<t>The definition of most performance monitoring interfaces in TMF is quite generic. And it is also similar that the functionalities of both alarm and performance monitoring can be defined with a generic structure, regardless of what kind of object is operated on. Therefore, our data model prefer to follow this approach. And when defining our data model, we get refer to <xref target="RFC8632"/>, in which a generic alarm data model is provided. In <xref target="RFC8632"/>, a union type of resource attributes is defined as the source of alarm. So we also reference this structure in our data model.</t>

<t>Additionally, we extend a resource-type attribute to indicate what exact kind of resource is. Firstly, this attribute can help to improve interaction efficiency between PNC and MDSC. The MDSC may quickly identify the resource type from this attribute, without parsing the resource identifier or searching the resource id in the whole resource. On the other hand, it will be unified with the existing IETF topology and inventory objects and form a complete interface system.</t>

<figure><artwork type="ascii-art"><![CDATA[
module: ietf-optical-resource-pm
   +--rw performance-monitoring
      +--rw resources
         +--rw resource* [resource-id]
            +--rw resource-id      union
            +--ro resource-type?   identityref
]]></artwork></figure>

</section>
</section>
<section anchor="performance-indicator-introduction"><name>Performance Indicator Introduction</name>
<t>//To Be Added</t>

</section>
<section anchor="optical-performance-monitoring-tree-diagram"><name>Optical Performance Monitoring Tree Diagram</name>

<figure title="Optical Resource Performance Monitoring tree diagram" anchor="fig-rpm-tree"><artwork type="ascii-art" name="ietf-optical-resource-pm.tree"><![CDATA[
module: ietf-optical-resource-pm
   +--rw performance-monitoring
      +--rw monitor-tasks
      |  +--rw monitor-task* [task-id]
      |     +--rw task-id          yang:uuid
      |     +--rw resource-id?     leafref
      |     +--ro resource-type?   identityref
      |     +--rw task-name?       string
      |     +--rw admin-status?    enumeration
      |     +--ro task-status?     enumeration
      |     +--rw task-cfg
      |        +--rw period?       identityref
      |        +--rw indicators
      |           +--rw indicator* [indicator-name]
      |              +--rw indicator-name          string
      |              +--rw indicator-value-unit?   string
      +--rw tca-management
      |  +--rw profiles
      |  |  +--rw profile* [profile-id]
      |  |     +--rw profile-id      yang:uuid
      |  |     +--rw profile-name?   string
      |  |     +--rw tca-cfg
      |  |        +--rw tca-indicator* [indicator-name threshold-type period severity]
      |  |           +--rw indicator-name          string
      |  |           +--rw indicator-value         string
      |  |           +--rw indicator-value-unit    string
      |  |           +--rw threshold-type          enumeration
      |  |           +--rw period                  identityref
      |  |           +--rw severity                identityref
      |  +--rw tcas
      |     +--rw tca* [resource-id]
      |        +--rw resource-id         leafref
      |        +--ro resource-type?      identityref
      |        +--rw admin-status?       enumeration
      |        +--rw applied-profiles
      |        |  +--rw profile* [profile-id]
      |        |     +--rw profile-id    leafref
      |        +--rw tca-cfg
      |           +--rw tca-indicator* [indicator-name threshold-type period severity]
      |              +--rw indicator-name          string
      |              +--rw indicator-value         string
      |              +--rw indicator-value-unit    string
      |              +--rw threshold-type          enumeration
      |              +--rw period                  identityref
      |              +--rw severity                identityref
      +--rw resources
         +--rw resource* [resource-id]
            +--rw resource-id      union
            +--ro resource-type?   identityref
rpcs:
   +---x get-all-current-pm-data    
   |  +--ro input     
   |  |  +--ro resources*   leafref
   |  +--ro output    
   |     +--ro pm-data
   |        +--ro pm-data-list* [resource]
   |           +--ro resource          leafref
   |           +--ro collect-time?     yang:date-and-time
   |           +--ro resource-type?    identityref
   |           +--ro indicator-data
   |              +--ro indicator-data-list* [indicator-name]
   |                 +--ro indicator-name          string
   |                 +--ro indicator-value?        string
   |                 +--ro indicator-value-unit?   string
   +---x get-historic-pm-data       
      +--ro input     
      |  +--ro resources*    leafref
      |  +--ro start-time?   yang:date-and-time
      |  +--ro end-time?     yang:date-and-time
      +--ro output    
         +--ro pm-data
            +--ro pm-data-list* [resource]
               +--ro resource          leafref
               +--ro collect-time?     yang:date-and-time
               +--ro resource-type?    identityref
               +--ro indicator-data
                  +--ro indicator-data-list* [indicator-name]
                     +--ro indicator-name          string
                     +--ro indicator-value?        string
                     +--ro indicator-value-unit?   string
]]></artwork></figure>

</section>
<section anchor="yang-model-for-optical-performance-monitoring"><name>YANG Model for Optical Performance Monitoring</name>

<figure title="Optical Resource Performance Monitoring YANG module" anchor="fig-rpm-yang"><sourcecode type="yang" markers="true" name="ietf-optical-resource-pm@2023-03-01.yang"><![CDATA[
module ietf-optical-resource-pm {
  yang-version 1.1;
  namespace "urn:ietf:params:xml:ns:yang:ietf-optical-resource-pm";
  prefix optrpm;
  
  import ietf-yang-types {
    prefix "yang";
  }
  
  import ietf-optical-resource-pm-types {
    prefix "optrpm-types";
  }

    
  organization
    "IETF CCAMP Working Group";
    
  contact
    "WG Web:   <https://datatracker.ietf.org/wg/ccamp/>
     WG List:  <mailto:ccamp@ietf.org>

     Editor:   Chaode Yu
               <yuchaode@huawei.com>";
    
  description 
    "This module defines a model for optical performance 
    monitoring.

    The model fully conforms to the Network Management 
    Datastore Architecture (NMDA).
    
    Copyright (c) 2022 IETF Trust and the persons
    identified as authors of the code.  All rights reserved.

    Redistribution and use in source and binary forms, with or
    without modification, is permitted pursuant to, and subject
    to the license terms contained in, the Revised BSD License
    set forth in Section 4.c of the IETF Trust's Legal Provisions
    Relating to IETF Documents
    (https://trustee.ietf.org/license-info).

    This version of this YANG module is part of RFC XXXX; see
    the RFC itself for full legal notices.

    The key words 'MUST', 'MUST NOT', 'REQUIRED', 'SHALL', 'SHALL
    NOT', 'SHOULD', 'SHOULD NOT', 'RECOMMENDED', 'NOT RECOMMENDED',
    'MAY', and 'OPTIONAL' in this document are to be interpreted as
    described in BCP 14 (RFC 2119) (RFC 8174) when, and only when,
    they appear in all capitals, as shown here.";
 
    
  revision 2023-03-01 {
    description  "Initial revision.";
  }
  
  container performance-monitoring {
    description 
      "the root node.";
      
    uses monitoring-tasks-grouping;
    uses tca-management-grouping;
    uses resource-info-grouping;
  }
  
  grouping resource-info-grouping {
    description 
      "grouping of resources' PM capabilities related information";
    
    container resources {
      description
        "resources' PM capabilities related information";
        
      list resource {
        description
          "list of resource instances";
        key resource-id;
        
        leaf resource-id {
          type union {
            type instance-identifier {
              require-instance false;
            }
            type yang:object-identifier;
            type string;
           type yang:uuid;
          }
        }
        
        leaf resource-type {
          description 
            "the type of resource, such as NE, board or port";
        
          config false;
          type identityref {
            base optrpm-types:resource-type;
          }          
        }
        
        //TO BE ADDED: holding-time, capabilities etc.
      }
    }
  }

  grouping monitoring-tasks-grouping {
    description 
      "grouping of performance monitoring task";
      
    container monitor-tasks {
      description
        "Information of PM tasks";
        
      list monitor-task {
        description 
          "monitoring task list";
          
        key task-id;
        uses task-instance-grouping;
      }
    }  
  }

  
  grouping task-instance-grouping {
    description 
      "grouping of performance monitoring task. In this monitoring
      task, the client can specify a resource to run a monitor task
      and what kind of performance data need to be monitored.";
    
    leaf task-id {
      description
        "identifier of the performance task";
      type yang:uuid;
    }
    
    leaf resource-id {
      description 
        "the identifier of network resource on which the performance
        monitoring task is running";
      
      type leafref {
        path "/optrpm:performance-monitoring/optrpm:resources" + 
        "/optrpm:resource/optrpm:resource-id";
      }
    }
    
    leaf resource-type {
      description 
        "the type of resource, such as NE, board or port";
        
      config false;
      type identityref {
        base optrpm-types:resource-type;
      }
    }
    
    leaf task-name {
      description 
        "the name of monitoring task";
        
      type string;
    }
    
    leaf admin-status {
      description
        "it is used to control enbling/disabling PM task";
    
      type enumeration {
        enum enabled {
          description
            "it is used to enable the pm task, if the task is enabled,
            the task-staus should be running";
        }
        
        enum disabled {
          description
            "it is used to disenable the pm task, if the task is 
            disabled, the task-staus should be suspended";
        }
      }
    }
    
    leaf task-status {
      config false;
      description 
        "the status of monitoring task.";
        
      type enumeration {
        enum running;
      
        enum suspended;
        
        enum abnormal;
      }
    }

    uses task-configuration-grouping;
  }
  
  grouping task-configuration-grouping {
    description
      "grouping of pm task configuration";
      
    container task-cfg {
      description 
        "Configuration of the monitoring task";
    
      leaf period {
        description 
          "it is used to indicate the interval as per monitoring
          task";
        type identityref {
          base optrpm-types:period;
        }
      }
      
      container indicators {
        description 
          "performance indicators";
          
        list indicator {
          description 
            "list of PM indicators to be monitored";
            
          key indicator-name;
          uses indicator-grouping;
        }
      }
    }  
  }
  
  grouping indicator-grouping {
    description 
      "grouping of a monitoring indicator instance";
      
    leaf indicator-name {
      description 
        "performance indicator's name";
        
      type string;
    }
    
    leaf indicator-value-unit {
      description 
        "unit of indicator value";
        
      type string;
    }
  }
  
  grouping tca-management-grouping {
    description 
      "grouping of configuration and management for Threshol Crossing
      Alert";
      
    container tca-management {
      description
        "configuration and management for Threshol Crossing Alert";
      
      container profiles {
        description
          "the TCA profile in the whole network";
      
        list profile {
          description
            "List of TCA profile instances";
            
          key "profile-id";          
          uses tca-profile-grouping;
        }
      }
    
      container tcas {
        description
          "TCA configuration on the network resources.";
          
        list tca {
          description
            "List of TCA configuration instances";
        
          key "resource-id";
        
          leaf resource-id {
            description 
              "the identifier of network resource on which threshold 
              is configured for TCA purpose";
          
            type leafref {
              path "/optrpm:performance-monitoring/optrpm:resources" + 
              "/optrpm:resource/optrpm:resource-id";
            }
          }
          
          leaf resource-type {
            description 
              "the type of resource, such as NE, board or termination
              point";
              
            config false;
            
            type identityref {
              base optrpm-types:resource-type;
            }
          }
          
          leaf admin-status {
            description
              "it is used to control the validity of threshold";
            type enumeration {
              enum enabled {
              description
                "if the admin-status of TCA configuration is enabled,
                the threshold is effective";
              }
        
              enum disabled {
                description
                  "if the admin-status of TCA configuration is 
                  disabled, the threshold is not effective";
              }
            }
          }
          
          uses tca-grouping;
        }
      }
    }
  }
  
  grouping tca-profile-grouping {
    description
      "grouping of TCA profile instance";
      
    leaf profile-id {
      description 
        "identifier of threshold crossing alerrt profile";
        
      type yang:uuid;    
    }
    
    leaf profile-name {
      description 
        "Name of the threshold crossing alerrt profile";
        
      type string;
    }
    
    container tca-cfg {
      description
        "detailed TCA configuration in a profile";
        
      list tca-indicator {
        description
          "list of TCA configuration.";
          
        key "indicator-name threshold-type period severity";
        uses tca-indicator-grouping;
      }    
    }
  }
  
  grouping tca-indicator-grouping {
    description
      "grouping for detail TCA configuration";
    leaf indicator-name {
      type string;
      description 
        "name of the indicator";
    }
    
    leaf indicator-value {
      mandatory true;
      type string;
      description 
        "treshold value of the indicator";
    }
    
    leaf indicator-value-unit {
      mandatory true;
      type string;
      description 
        "unit of indicator's value";
    }
    
    leaf threshold-type {
      description
        "it is used to indicate the trigger/clearing condition of 
        alert upon the threshold";
        
      type enumeration {
        enum upperbound-trigger {
          description
            "If the performace data exceeds this threshold value,
            a TCA will be triggered";
        }
        enum lowerbound-trigger {
          description
            "if the performace data is lower than this threshold
            value, a TCA will be triggered";
        }
        enum upperbound-clear {
          description
            "If the performance data is not longer bigger than this
            threshold value, the TCA triggered before will be cleared
            by system automatically";
        }
        enum lowerbound-clear {
          description
            "If the performance data is not longer lower than this
            threshold value, the TCA triggered before will be cleared
            by system automatically";
        }
      }
    }

    leaf period {
      description 
        "it is used to indicate the interval as per monitoring task";
        
      type identityref {
        base optrpm-types:period;
      }
    }
    
    leaf severity {
      description
        "it is used to indicate what severity level of alert would be
        triggered if not confirms to the threashold";
        
      type identityref {
        base optrpm-types:severity;
      }
    }
  }
  
  grouping tca-grouping {
    description
      "grouping of TCA configuration";
      
    container applied-profiles {
        description
          "Information of applied TCA profiles on this resource";
          
      list profile {
          description
            "list of applied TCA profile";
            
        key "profile-id";
        
        leaf profile-id {
          description
            "identifier of the applied TCA profile";
              
          type leafref {
            path "../../../../../optrpm:profiles/optrpm:profile" +
            "/optrpm:profile-id";
          }
        }
      }
    }
    container tca-cfg {
      description 
        "detailed configuration of TCA";
      list tca-indicator {
         description
           "list of tca indicator configuration";
        key "indicator-name threshold-type period severity";
        uses tca-indicator-grouping;
      }    
    }
  }
  

  rpc get-all-current-pm-data {
    description 
      "this RPC is used to retrieve current performance data.";
    
    input {
      leaf-list resources {
        description 
          "the identifier of resources from which current performace 
          data is collected";
          
        type leafref {
          path "/optrpm:performance-monitoring/optrpm:resources" + 
          "/optrpm:resource/optrpm:resource-id";
        }
      }
    }
    output {
      container pm-data {
        description 
          "result of current performance data";
          
        list pm-data-list {
          description 
            "list of curent performance data";
            
          key resource;
          uses pm-data-instance-grouping;
        }
      }      
    }
  }
  
  rpc get-historic-pm-data {
    input {
      description 
      "this RPC is used to retrieve historic performance data.";
      
      leaf-list resources {
        description
          "the identifier of resources from which historic performace 
          data is collected";
          
        type leafref {
          path "/optrpm:performance-monitoring/optrpm:resources" + 
          "/optrpm:resource/optrpm:resource-id";
        }
      }
      
      leaf start-time {
        description 
        "the starttime of performance data needed to be retrieved";
        
        type yang:date-and-time;
      }
      
      leaf end-time {
        description 
        "the endtime of performance data needed to be retrieved";
        
        type yang:date-and-time;
      }
    }
    output {
      container pm-data {
        description 
          "result of historic performance data";
          
        list pm-data-list {
          description 
            "list of historic performance data";
            
          key resource;
          uses pm-data-instance-grouping;
        }
      }      
    }
  }
  
  grouping pm-data-instance-grouping {
    description 
      "grouping for common attributes of performance data";
      
    leaf resource {
    description 
      "the identifier of network resource which is monitored.";
    
      type leafref {
        path "/optrpm:performance-monitoring/optrpm:resources" + 
        "/optrpm:resource/optrpm:resource-id";
      }      
    }
    
    leaf collect-time {
      description 
        "the time of this data is collected";
        
      type yang:date-and-time;
    }
    
    leaf resource-type {
      description 
        "the type of resource, such as NE, board or port";
        
      type identityref {
        base optrpm-types:resource-type; 
      }      
    }
    
    container indicator-data {
      description 
        "grouping for historic performance data";
        
      list indicator-data-list {
        description 
          "list of historic performance data";
        key indicator-name;
        
        uses indicator-data-instance-grouping;
      }
    }
  }
  
  grouping indicator-data-instance-grouping {
    description 
      "grouping for a performance data";
      
    leaf indicator-name {
      description 
        "name of performance data indicator";
        
      type string;     
    }

    leaf indicator-value {
      description 
        "value of performance data";
        
      type string;
    }

    leaf indicator-value-unit {
      description 
        "unit of performance data value";
        
      type string;
    }
  }
  
}    
]]></sourcecode></figure>

</section>
<section anchor="yang-model-for-optical-performance-monitoring-types"><name>YANG Model for Optical Performance Monitoring Types</name>

<figure title="Optical Resource Performance Monitoring Types YANG module" anchor="fig-rpm-type-yang"><sourcecode type="yang" markers="true" name="ietf-optical-resource-pm-types@2023-03-01.yang"><![CDATA[
module ietf-optical-resource-pm-types {
  yang-version 1.1;
  namespace 
  "urn:ietf:params:xml:ns:yang:ietf-optical-resource-pm-types";
  
  prefix optrpm-types;
  
  organization
    "IETF CCAMP Working Group";
  contact
    "WG Web:   <https://datatracker.ietf.org/wg/ccamp/>
     WG List:  <mailto:ccamp@ietf.org>

     Editor:   Chaode Yu
               <yuchaode@huawei.com>";
    
  description 
    "This module defines types model for optical performance 
    monitoring which will be imported by ietf-performance-monitoring
    data model.

    The model fully conforms to the Network Management 
    Datastore Architecture (NMDA).
    
    Copyright (c) 2022 IETF Trust and the persons
    identified as authors of the code.  All rights reserved.

    Redistribution and use in source and binary forms, with or
    without modification, is permitted pursuant to, and subject
    to the license terms contained in, the Revised BSD License
    set forth in Section 4.c of the IETF Trust's Legal Provisions
    Relating to IETF Documents
    (https://trustee.ietf.org/license-info).

    This version of this YANG module is part of RFC XXXX; see
    the RFC itself for full legal notices.

    The key words 'MUST', 'MUST NOT', 'REQUIRED', 'SHALL', 'SHALL
    NOT', 'SHOULD', 'SHOULD NOT', 'RECOMMENDED', 'NOT RECOMMENDED',
    'MAY', and 'OPTIONAL' in this document are to be interpreted as
    described in BCP 14 (RFC 2119) (RFC 8174) when, and only when,
    they appear in all capitals, as shown here.";
               
  
  revision 2023-03-01 {
    description  "Initial revision.";
    
  }

  identity resource-type {
    description "this is the base type of all the rerource type";
  }
  
  identity network-element {
    base resource-type;
        description "NE resource type";
  }
  
  identity board {
    base resource-type;
        description "board resource type";
  }
  
  identity termination-point {
    base resource-type;
        description "Termination point resource";
  }
  
  identity tunnel-termination-point {
    base resource-type;
        description "Tunnel termination point resource";
  }  
  
  identity period {
    description 
          "this is the base type of all the performace monitoring priod 
          type.";
  }
  
  identity period-15-minutes {
    base period;
        description 
      "the during of monitoring task will be repeated at every 15 
          minutes";
  }
  
  identity period-24-hours {
    base period;
        description 
      "the during of monitoring task will be repeated at every 24 
          hours";
  }
  
  identity severity {
    description 
          "it is used to indicate what severity alarm will be caused if 
          exceeds the threshold";
  }
  
  identity critical {
    description 
          "critical alarm will be caused if exceeds the threshold";
        base severity;
  }
  
  identity mayjor {
    description 
          "mayjor alarm will be caused if exceeds the threshold";
        base severity;
  }

  identity minor {
    description 
          "minor alarm will be caused if exceeds the threshold";
        base severity;
  }

  identity warning {
    description 
          "only a warning will be caused if exceeds the threshold";
        base severity;
  }

}
]]></sourcecode></figure>

</section>
<section anchor="manageability-considerations"><name>Manageability Considerations</name>

<t>&lt;Add any manageability considerations&gt;</t>

</section>
<section anchor="security-considerations"><name>Security Considerations</name>

<t>The YANG module specified in this document defines a schema for data that is designed to be accessed via network management protocols such as NETCONF <xref target="RFC6241"/> or RESTCONF <xref target="RFC8040"/>. The lowest NETCONF layer is the secure transport layer, and the mandatory-to-implement secure transport is Secure Shell (SSH) <xref target="RFC6242"/>. The lowest RESTCONF layer is HTTPS, and the mandatory-to-implement secure transport is TLS <xref target="RFC8446"/>.</t>

<t>The NETCONF access control model <xref target="RFC8341"/> provides the means to restrict access for particular NETCONF or RESTCONF users to a preconfigured subset of all available NETCONF or RESTCONF protocol operations and content.</t>

<t>There are a number of data nodes defined in this YANG module that are writable/creatable/deletable (i.e., config true, which is the default). These data nodes may be considered sensitive or vulnerable in some network environments. Write operations (e.g., edit-config) to these data nodes without proper protection can have a negative effect on network operations. Considerations in Section 8 of <xref target="RFC8795"/>are also applicable to their subtrees in the module defined in this document.</t>

<t>Some of the readable data nodes in this YANG module may be considered sensitive or vulnerable in some network environments. It is thus important to control read access (e.g., via get, get-config, or notification) to these data nodes. Considerations in Section 8 of <xref target="RFC8795"/> are also applicable to their subtrees in the module defined in this document.</t>

</section>
<section anchor="iana-considerations"><name>IANA Considerations</name>

<t>This document registers following YANG modules in the YANG Module Names registry <xref target="RFC6020"/>.</t>

<t>name:         ietf-optical-resource-pm
   namespace:    urn:ietf:params:xml:ns:yang:ietf-optical-resource-pm
   prefix:       optrpm
   reference:    RFC XXXX: A YANG Data Model for Optical Performance Monitoring</t>

<t>name:         ietf-optical-resource-pm-types
   namespace:    urn:ietf:params:xml:ns:yang:ietf-optical-resource-pm-types
   prefix:       optrpm-types
   reference:    RFC XXXX: A YANG Data Model for Optical Performance Monitoring</t>

</section>


  </middle>

  <back>


    <references title='Normative References'>

<reference anchor="TMF-518" target="https://www.tmforum.org/resources/collection/mtosi-4-0">
  <front>
    <title>Resource Performance Management</title>
    <author >
      <organization>TM Forum (TMF)</organization>
    </author>
    <date year="2011"/>
  </front>
  <seriesInfo name="TMF518_RPM" value=""/>
</reference>




<reference anchor='RFC8342' target='https://www.rfc-editor.org/info/rfc8342'>
<front>
<title>Network Management Datastore Architecture (NMDA)</title>
<author fullname='M. Bjorklund' initials='M.' surname='Bjorklund'><organization/></author>
<author fullname='J. Schoenwaelder' initials='J.' surname='Schoenwaelder'><organization/></author>
<author fullname='P. Shafer' initials='P.' surname='Shafer'><organization/></author>
<author fullname='K. Watsen' initials='K.' surname='Watsen'><organization/></author>
<author fullname='R. Wilton' initials='R.' surname='Wilton'><organization/></author>
<date month='March' year='2018'/>
<abstract><t>Datastores are a fundamental concept binding the data models written in the YANG data modeling language to network management protocols such as the Network Configuration Protocol (NETCONF) and RESTCONF. This document defines an architectural framework for datastores based on the experience gained with the initial simpler model, addressing requirements that were not well supported in the initial model.  This document updates RFC 7950.</t></abstract>
</front>
<seriesInfo name='RFC' value='8342'/>
<seriesInfo name='DOI' value='10.17487/RFC8342'/>
</reference>



<reference anchor='RFC7446' target='https://www.rfc-editor.org/info/rfc7446'>
<front>
<title>Routing and Wavelength Assignment Information Model for Wavelength Switched Optical Networks</title>
<author fullname='Y. Lee' initials='Y.' role='editor' surname='Lee'><organization/></author>
<author fullname='G. Bernstein' initials='G.' role='editor' surname='Bernstein'><organization/></author>
<author fullname='D. Li' initials='D.' surname='Li'><organization/></author>
<author fullname='W. Imajuku' initials='W.' surname='Imajuku'><organization/></author>
<date month='February' year='2015'/>
<abstract><t>This document provides a model of information needed by the Routing and Wavelength Assignment (RWA) process in Wavelength Switched Optical Networks (WSONs).  The purpose of the information described in this model is to facilitate constrained optical path computation in WSONs.  This model takes into account compatibility constraints between WSON signal attributes and network elements but does not include constraints due to optical impairments.  Aspects of this information that may be of use to other technologies utilizing a GMPLS control plane are discussed.</t></abstract>
</front>
<seriesInfo name='RFC' value='7446'/>
<seriesInfo name='DOI' value='10.17487/RFC7446'/>
</reference>



<reference anchor='RFC7581' target='https://www.rfc-editor.org/info/rfc7581'>
<front>
<title>Routing and Wavelength Assignment Information Encoding for Wavelength Switched Optical Networks</title>
<author fullname='G. Bernstein' initials='G.' role='editor' surname='Bernstein'><organization/></author>
<author fullname='Y. Lee' initials='Y.' role='editor' surname='Lee'><organization/></author>
<author fullname='D. Li' initials='D.' surname='Li'><organization/></author>
<author fullname='W. Imajuku' initials='W.' surname='Imajuku'><organization/></author>
<author fullname='J. Han' initials='J.' surname='Han'><organization/></author>
<date month='June' year='2015'/>
<abstract><t>A Wavelength Switched Optical Network (WSON) requires certain key information fields be made available to facilitate path computation and the establishment of Label Switched Paths (LSPs). The information model described in &quot;Routing and Wavelength                           Assignment Information Model for Wavelength Switched Optical Networks&quot; (RFC 7446) shows what information is required at specific points in the WSON. Part of the WSON information model contains aspects that may be of general applicability to other technologies, while other parts are specific to WSONs.</t><t>This document provides efficient, protocol-agnostic encodings for the WSON-specific information fields.  It is intended that protocol- specific documents will reference this memo to describe how information is carried for specific uses.  Such encodings can be used to extend GMPLS signaling and routing protocols.  In addition, these encodings could be used by other mechanisms to convey this same information to a Path Computation Element (PCE).</t></abstract>
</front>
<seriesInfo name='RFC' value='7581'/>
<seriesInfo name='DOI' value='10.17487/RFC7581'/>
</reference>



<reference anchor='RFC7950' target='https://www.rfc-editor.org/info/rfc7950'>
<front>
<title>The YANG 1.1 Data Modeling Language</title>
<author fullname='M. Bjorklund' initials='M.' role='editor' surname='Bjorklund'><organization/></author>
<date month='August' year='2016'/>
<abstract><t>YANG is a data modeling language used to model configuration data, state data, Remote Procedure Calls, and notifications for network management protocols.  This document describes the syntax and semantics of version 1.1 of the YANG language.  YANG version 1.1 is a maintenance release of the YANG language, addressing ambiguities and defects in the original specification.  There are a small number of backward incompatibilities from YANG version 1.  This document also specifies the YANG mappings to the Network Configuration Protocol (NETCONF).</t></abstract>
</front>
<seriesInfo name='RFC' value='7950'/>
<seriesInfo name='DOI' value='10.17487/RFC7950'/>
</reference>



<reference anchor='RFC6241' target='https://www.rfc-editor.org/info/rfc6241'>
<front>
<title>Network Configuration Protocol (NETCONF)</title>
<author fullname='R. Enns' initials='R.' role='editor' surname='Enns'><organization/></author>
<author fullname='M. Bjorklund' initials='M.' role='editor' surname='Bjorklund'><organization/></author>
<author fullname='J. Schoenwaelder' initials='J.' role='editor' surname='Schoenwaelder'><organization/></author>
<author fullname='A. Bierman' initials='A.' role='editor' surname='Bierman'><organization/></author>
<date month='June' year='2011'/>
<abstract><t>The Network Configuration Protocol (NETCONF) defined in this document provides mechanisms to install, manipulate, and delete the configuration of network devices.  It uses an Extensible Markup Language (XML)-based data encoding for the configuration data as well as the protocol messages.  The NETCONF protocol operations are realized as remote procedure calls (RPCs).  This document obsoletes RFC 4741.  [STANDARDS-TRACK]</t></abstract>
</front>
<seriesInfo name='RFC' value='6241'/>
<seriesInfo name='DOI' value='10.17487/RFC6241'/>
</reference>



<reference anchor='RFC8340' target='https://www.rfc-editor.org/info/rfc8340'>
<front>
<title>YANG Tree Diagrams</title>
<author fullname='M. Bjorklund' initials='M.' surname='Bjorklund'><organization/></author>
<author fullname='L. Berger' initials='L.' role='editor' surname='Berger'><organization/></author>
<date month='March' year='2018'/>
<abstract><t>This document captures the current syntax used in YANG module tree diagrams.  The purpose of this document is to provide a single location for this definition.  This syntax may be updated from time to time based on the evolution of the YANG language.</t></abstract>
</front>
<seriesInfo name='BCP' value='215'/>
<seriesInfo name='RFC' value='8340'/>
<seriesInfo name='DOI' value='10.17487/RFC8340'/>
</reference>



<reference anchor='RFC6991' target='https://www.rfc-editor.org/info/rfc6991'>
<front>
<title>Common YANG Data Types</title>
<author fullname='J. Schoenwaelder' initials='J.' role='editor' surname='Schoenwaelder'><organization/></author>
<date month='July' year='2013'/>
<abstract><t>This document introduces a collection of common data types to be used with the YANG data modeling language.  This document obsoletes RFC 6021.</t></abstract>
</front>
<seriesInfo name='RFC' value='6991'/>
<seriesInfo name='DOI' value='10.17487/RFC6991'/>
</reference>



<reference anchor='RFC8040' target='https://www.rfc-editor.org/info/rfc8040'>
<front>
<title>RESTCONF Protocol</title>
<author fullname='A. Bierman' initials='A.' surname='Bierman'><organization/></author>
<author fullname='M. Bjorklund' initials='M.' surname='Bjorklund'><organization/></author>
<author fullname='K. Watsen' initials='K.' surname='Watsen'><organization/></author>
<date month='January' year='2017'/>
<abstract><t>This document describes an HTTP-based protocol that provides a programmatic interface for accessing data defined in YANG, using the datastore concepts defined in the Network Configuration Protocol (NETCONF).</t></abstract>
</front>
<seriesInfo name='RFC' value='8040'/>
<seriesInfo name='DOI' value='10.17487/RFC8040'/>
</reference>



<reference anchor='RFC6242' target='https://www.rfc-editor.org/info/rfc6242'>
<front>
<title>Using the NETCONF Protocol over Secure Shell (SSH)</title>
<author fullname='M. Wasserman' initials='M.' surname='Wasserman'><organization/></author>
<date month='June' year='2011'/>
<abstract><t>This document describes a method for invoking and running the Network Configuration Protocol (NETCONF) within a Secure Shell (SSH) session as an SSH subsystem.  This document obsoletes RFC 4742.  [STANDARDS-TRACK]</t></abstract>
</front>
<seriesInfo name='RFC' value='6242'/>
<seriesInfo name='DOI' value='10.17487/RFC6242'/>
</reference>



<reference anchor='RFC8446' target='https://www.rfc-editor.org/info/rfc8446'>
<front>
<title>The Transport Layer Security (TLS) Protocol Version 1.3</title>
<author fullname='E. Rescorla' initials='E.' surname='Rescorla'><organization/></author>
<date month='August' year='2018'/>
<abstract><t>This document specifies version 1.3 of the Transport Layer Security (TLS) protocol.  TLS allows client/server applications to communicate over the Internet in a way that is designed to prevent eavesdropping, tampering, and message forgery.</t><t>This document updates RFCs 5705 and 6066, and obsoletes RFCs 5077, 5246, and 6961.  This document also specifies new requirements for TLS 1.2 implementations.</t></abstract>
</front>
<seriesInfo name='RFC' value='8446'/>
<seriesInfo name='DOI' value='10.17487/RFC8446'/>
</reference>



<reference anchor='RFC8341' target='https://www.rfc-editor.org/info/rfc8341'>
<front>
<title>Network Configuration Access Control Model</title>
<author fullname='A. Bierman' initials='A.' surname='Bierman'><organization/></author>
<author fullname='M. Bjorklund' initials='M.' surname='Bjorklund'><organization/></author>
<date month='March' year='2018'/>
<abstract><t>The standardization of network configuration interfaces for use with the Network Configuration Protocol (NETCONF) or the RESTCONF protocol requires a structured and secure operating environment that promotes human usability and multi-vendor interoperability.  There is a need for standard mechanisms to restrict NETCONF or RESTCONF protocol access for particular users to a preconfigured subset of all available NETCONF or RESTCONF protocol operations and content.  This document defines such an access control model.</t><t>This document obsoletes RFC 6536.</t></abstract>
</front>
<seriesInfo name='STD' value='91'/>
<seriesInfo name='RFC' value='8341'/>
<seriesInfo name='DOI' value='10.17487/RFC8341'/>
</reference>



<reference anchor='RFC8795' target='https://www.rfc-editor.org/info/rfc8795'>
<front>
<title>YANG Data Model for Traffic Engineering (TE) Topologies</title>
<author fullname='X. Liu' initials='X.' surname='Liu'><organization/></author>
<author fullname='I. Bryskin' initials='I.' surname='Bryskin'><organization/></author>
<author fullname='V. Beeram' initials='V.' surname='Beeram'><organization/></author>
<author fullname='T. Saad' initials='T.' surname='Saad'><organization/></author>
<author fullname='H. Shah' initials='H.' surname='Shah'><organization/></author>
<author fullname='O. Gonzalez de Dios' initials='O.' surname='Gonzalez de Dios'><organization/></author>
<date month='August' year='2020'/>
<abstract><t>This document defines a YANG data model for representing, retrieving, and manipulating Traffic Engineering (TE) Topologies. The model serves as a base model that other technology-specific TE topology models can augment.</t></abstract>
</front>
<seriesInfo name='RFC' value='8795'/>
<seriesInfo name='DOI' value='10.17487/RFC8795'/>
</reference>



<reference anchor='RFC6020' target='https://www.rfc-editor.org/info/rfc6020'>
<front>
<title>YANG - A Data Modeling Language for the Network Configuration Protocol (NETCONF)</title>
<author fullname='M. Bjorklund' initials='M.' role='editor' surname='Bjorklund'><organization/></author>
<date month='October' year='2010'/>
<abstract><t>YANG is a data modeling language used to model configuration and state data manipulated by the Network Configuration Protocol (NETCONF), NETCONF remote procedure calls, and NETCONF notifications. [STANDARDS-TRACK]</t></abstract>
</front>
<seriesInfo name='RFC' value='6020'/>
<seriesInfo name='DOI' value='10.17487/RFC6020'/>
</reference>




    </references>

    <references title='Informative References'>




<reference anchor='I-D.ietf-teas-actn-pm-telemetry-autonomics' target='https://datatracker.ietf.org/doc/html/draft-ietf-teas-actn-pm-telemetry-autonomics-09'>
   <front>
      <title>YANG models for Virtual Network (VN)/TE Performance Monitoring Telemetry and Scaling Intent Autonomics</title>
      <author fullname='Young Lee' initials='Y.' surname='Lee'>
         <organization>Samsung Electronics</organization>
      </author>
      <author fullname='Dhruv Dhody' initials='D.' surname='Dhody'>
         <organization>Huawei Technologies</organization>
      </author>
      <author fullname='Ricard Vilalta' initials='R.' surname='Vilalta'>
         <organization>CTTC</organization>
      </author>
      <author fullname='Daniel King' initials='D.' surname='King'>
         <organization>Lancaster University</organization>
      </author>
      <author fullname='Daniele Ceccarelli' initials='D.' surname='Ceccarelli'>
         <organization>Ericsson</organization>
      </author>
      <date day='11' month='July' year='2022'/>
      <abstract>
	 <t>   This document provides YANG data models that describe performance
   monitoring parameters and scaling intent mechanisms for TE-tunnels
   and Virtual Networks (VNs).  There performance monitoring parameters
   are exposed as the key telemetry data for tunnels and VN.

   The models presented in this document allow customers to subscribe to
   and monitor the key performance data of the TE-tunnel or the VN.  The
   models also provide customers with the ability to program autonomic
   scaling intent mechanisms on the level of TE-tunnel as well as VN.

	 </t>
      </abstract>
   </front>
   <seriesInfo name='Internet-Draft' value='draft-ietf-teas-actn-pm-telemetry-autonomics-09'/>
   
</reference>


<reference anchor='I-D.ietf-opsawg-yang-vpn-service-pm' target='https://datatracker.ietf.org/doc/html/draft-ietf-opsawg-yang-vpn-service-pm-15'>
   <front>
      <title>A YANG Model for Network and VPN Service Performance Monitoring</title>
      <author fullname='Bo Wu' initials='B.' surname='Wu'>
         <organization>Huawei</organization>
      </author>
      <author fullname='Qin Wu' initials='Q.' surname='Wu'>
         <organization>Huawei</organization>
      </author>
      <author fullname='Mohamed Boucadair' initials='M.' surname='Boucadair'>
         <organization>Orange</organization>
      </author>
      <author fullname='Oscar Gonzalez de Dios' initials='O. G.' surname='de Dios'>
         <organization>Telefonica</organization>
      </author>
      <author fullname='Bin Wen' initials='B.' surname='Wen'>
         <organization>Comcast</organization>
      </author>
      <date day='11' month='November' year='2022'/>
      <abstract>
	 <t>   The data model for network topologies defined in RFC 8345 introduces
   vertical layering relationships between networks that can be
   augmented to cover network and service topologies.  This document
   defines a YANG module for performance monitoring (PM) of both
   underlay networks and overlay VPN services that can be used to
   monitor and manage network performance on the topology of both
   layers.

	 </t>
      </abstract>
   </front>
   <seriesInfo name='Internet-Draft' value='draft-ietf-opsawg-yang-vpn-service-pm-15'/>
   
</reference>


<reference anchor='I-D.zheng-ccamp-client-pm-yang' target='https://datatracker.ietf.org/doc/html/draft-zheng-ccamp-client-pm-yang-07'>
   <front>
      <title>A YANG Data Model for Client Signal Performance Monitoring</title>
      <author fullname='Haomian Zheng' initials='H.' surname='Zheng'>
         <organization>Huawei Technologies</organization>
      </author>
      <author fullname='Italo Busi' initials='I.' surname='Busi'>
         <organization>Huawei Technologies</organization>
      </author>
      <author fullname='Zheng Yanlei' initials='Z.' surname='Yanlei'>
         <organization>China Unicom</organization>
      </author>
      <author fullname='Victor Lopez' initials='V.' surname='Lopez'>
         <organization>Nokia</organization>
      </author>
      <author fullname='Oscar Gonzalez de Dios' initials='O. G.' surname='de Dios'>
         <organization>Telefonica</organization>
      </author>
      <date day='9' month='January' year='2023'/>
      <abstract>
	 <t>   A transport network is a server-layer network to provide connectivity
   services to its client.  Given the client signal is configured, the
   followup function for performance monitoring, such as latency and bit
   error rate, would be needed for network operation.

   This document describes the data model to support the performance
   monitoring functionalities.

	 </t>
      </abstract>
   </front>
   <seriesInfo name='Internet-Draft' value='draft-zheng-ccamp-client-pm-yang-07'/>
   
</reference>



<reference anchor='RFC8454' target='https://www.rfc-editor.org/info/rfc8454'>
<front>
<title>Information Model for Abstraction and Control of TE Networks (ACTN)</title>
<author fullname='Y. Lee' initials='Y.' surname='Lee'><organization/></author>
<author fullname='S. Belotti' initials='S.' surname='Belotti'><organization/></author>
<author fullname='D. Dhody' initials='D.' surname='Dhody'><organization/></author>
<author fullname='D. Ceccarelli' initials='D.' surname='Ceccarelli'><organization/></author>
<author fullname='B. Yoon' initials='B.' surname='Yoon'><organization/></author>
<date month='September' year='2018'/>
<abstract><t>This document provides an information model for Abstraction and Control of TE Networks (ACTN).</t></abstract>
</front>
<seriesInfo name='RFC' value='8454'/>
<seriesInfo name='DOI' value='10.17487/RFC8454'/>
</reference>



<reference anchor='RFC8641' target='https://www.rfc-editor.org/info/rfc8641'>
<front>
<title>Subscription to YANG Notifications for Datastore Updates</title>
<author fullname='A. Clemm' initials='A.' surname='Clemm'><organization/></author>
<author fullname='E. Voit' initials='E.' surname='Voit'><organization/></author>
<date month='September' year='2019'/>
<abstract><t>This document describes a mechanism that allows subscriber applications to request a continuous and customized stream of updates from a YANG datastore.  Providing such visibility into updates enables new capabilities based on the remote mirroring and monitoring of configuration and operational state.</t></abstract>
</front>
<seriesInfo name='RFC' value='8641'/>
<seriesInfo name='DOI' value='10.17487/RFC8641'/>
</reference>



<reference anchor='RFC8632' target='https://www.rfc-editor.org/info/rfc8632'>
<front>
<title>A YANG Data Model for Alarm Management</title>
<author fullname='S. Vallin' initials='S.' surname='Vallin'><organization/></author>
<author fullname='M. Bjorklund' initials='M.' surname='Bjorklund'><organization/></author>
<date month='September' year='2019'/>
<abstract><t>This document defines a YANG module for alarm management.  It includes functions for alarm-list management, alarm shelving, and notifications to inform management systems.  There are also operations to manage the operator state of an alarm and administrative alarm procedures.  The module carefully maps to relevant alarm standards.</t></abstract>
</front>
<seriesInfo name='RFC' value='8632'/>
<seriesInfo name='DOI' value='10.17487/RFC8632'/>
</reference>




    </references>


<section numbered="false" anchor="acknowledgments"><name>Acknowledgments</name>

<t>This document was prepared using kramdown.</t>

</section>


  </back>

<!-- ##markdown-source:
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
3sZqN9KZJrcgQOwDU5GAb6AsAXAyBXUYB7acosPt63l4v9rellSZFQBJXmzt
7RWO2q3d63JOaHVbVnLdPsJ/UD1uzjpGDXGmH4QVZqil0ZbEB4HD0t4EShaN
Iz+5/MxE/LwSJN5dKuzTf1XDvz61Lzo/2oXPj7oNo48GWkYf7WUahVp35bG2
2/bvQyck7UzWUNO+VNYQKH25rJ2ggC30UdhS6sxm7Whv01lbDdpt2ufcoU7t
fkHbaWDX0Hm1T2++0dsiOO3iOA/6vRu/oWi0bYfxdrT343gdjZWB23rqNbi/
hRsad/9t2jeWt0/XhpHb23WAldvbf4CZ29t/gJ3bokLYvzLIzi2HrINRezyy
YI+dLlnHPDtiTV29GvGEVrPBLNdGUTCi0AFHm49Eu8GD8JFoDf1w4u4Dunbz
UbvrfnzU7r8fH7X778FHDVNN/9x60sFLoaa+sdZuuctKoDxSbRp1J5LicNTK
pONR4p9wfw+n/7mUblpwep7b2YCrJnR+bz5qJen5bVsLt783YGm0H5Kmt2Oq
YJ5eRx8/A6/VqKNdR6ZeqHtghE6W3t01lKu3T9eQ8fObzhxTNZLLOC2SE10k
F5Cu3GpXymmrw66cUx++BlW7j1yqDj8KU3W7eT9Vt9sPpuruqbqpum/X2+vt
btdH1btH6FNUO7p2UvXArsEUVCyPME8XEVVnQJdVlUfQ3m24Lqtz7xX7qMoc
ByMgWbzHTqv8/UGXdzvGTlhYQdVAGF7WmNxopAnlQXcXoniPmOEqXrIoMSz0
bPzsS/yR6n1sMNhxUBfZBEeYUNZQOflxvZpk5YSIrmvkAxpE1fjgshb0C/7L
tTxaNSre8y6pPgf4hEe5C3XsrovRGMetqWHG4yb437xYxFn6k2NUHFB8KFC0
mXtzNzzRjhPl1B388K34QU4n8PF3ukgu8gBWvH0nCyqZRpVybxdHVNDq6A+K
IqHja+AT6Pk7rAJc5RN6/rXu8QcNqqqsgVOYWs4tqv5doGjzH1youYwf3+tS
oHOFMCYTW7jNlmvTRWLdiDN3dcqPaij5Qj11rbGM4oBaTNyxtyLT2C4AVp9v
tkW6WFbicfJEPH/6/DnH866xerYpxgrQlnmmzDETZqTQLpdHLnVyVQLgjoU4
xiv/OCzd3sYCSTOzqrfSqyGBc+BZM14PV2Fk+GWaZnGxpZhheaiKNBbcX8dA
KfdS3c46VMUA12mFEfZNXZQ132HnWpplTYFIHkBhb5UmMsNDbiqJRBSoUsv5
ptpbeZNi8tc3Vy+Bqqgt98c8wTmWEnYLDL0YJxoHFoGPSvFaLlC0YDQdBUKp
cbDi9EiAhZq/1DUt+fljTfdUxVxKS/MK6gjz/Z44lMJFY0tTEAm+OxVlCD2q
TKeucfMlLEStSFeQSatSruZEqEhxVId1RdfgMN3RJUust3VLdzkfnX9/df3o
kP8vLt7Q57en//792dvTl/j56rvj16/NBx5CNbv67s33r1/aT7b7yZvz89OL
lzwC/Cq8n3iQR+fHf3rE+/vozeX12ZuL49eP2hXMYnVDT0WcQZBRNTiFaV2K
k8Li35xcimcvxGPExfNnz754wh8/f/bbF0/o0EXVgs2AGemrQd8WXWOswIEX
bAFzSbzBeuduYSU88RmT+LAMWEgmC+S8T6Kn8M8zLXBd4QJCFI/LqPYVdxg3
ZLkm36IjdBsaVQu8AzogyPOK0oTGWsJpEQHMWTrSieO9EV24gK9fOo38CF2w
ifXKgH79FmYt+teOxr1LMY2cc53yERXvca6imMKxTtasK9hdfNrrl+/1LM7M
Vmkc3G86O6XgewjGfH1vGwQnhCn1xQV7upNhQbBEq2b+Q151vOHAxGwiey7z
e3ciihvwoZ/3u3qiZ42cE6hGO6Hz2iPdWMyBPeSXfrO7wOhkGPFBkjPBl4GW
bGL6T+wQGMP1njmT3e3GCQ3krSpEgPxHHNU8HrXVaC9OVQFaKv4MmiREDPjH
GTEBTDHara/RRDfWhBSuqTbx1uGjwX7cgZCjo+s34ptTcfwSpPBELPkOGDlI
hz7BYyq57qeGunNsRcOlnWJlMJP3lLpuCjLL097R1S6+PrNMq+qAUbdOBnYH
72Bib5MPmm9OwFEOvC3yeVmdlzktWPrSz5oVG8LXbgOPpjbC24zwAA+xE6p2
UerqET0G1zByauXiSbu+jW7P9OkmUZ016iTpQXZXNaKKvWwGmArvY1/mE7/r
w8gdROGetc9bZQ986guKoLvWzEHpGyYaki8+CM1ibpg7zHkeDeDsKE26w3v7
XKaryTlqDSqO4hL1JgYz+OCIRc0kbHvop0ZBHojfuItpPm9+B4QctMi4G32+
oO5B4AcK6KBw7hPMQ4Vy5xLN8fSg5WXqclGnVGzsrqc925N7Oea7uKNyr87o
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

-->

</rfc>

