<?xml version='1.0' encoding='utf-8'?>
<!DOCTYPE rfc [
  <!ENTITY nbsp    "&#160;">
  <!ENTITY zwsp   "&#8203;">
  <!ENTITY nbhy   "&#8209;">
  <!ENTITY wj     "&#8288;">
]>
<?xml-stylesheet type="text/xsl" href="rfc2629.xslt" ?>
<!-- generated by https://github.com/cabo/kramdown-rfc version 1.7.30 (Ruby 3.4.7) -->
<rfc xmlns:xi="http://www.w3.org/2001/XInclude" ipr="trust200902" docName="draft-yu-ccamp-resource-pm-yang-05" category="std" consensus="true" submissionType="IETF" tocInclude="true" sortRefs="true" symRefs="true" version="3">
  <!-- xml2rfc v2v3 conversion 3.31.0 -->
  <front>
    <title abbrev="Resource PM YANG">A YANG Data Model for Resource Performance Monitoring</title>
    <seriesInfo name="Internet-Draft" value="draft-yu-ccamp-resource-pm-yang-05"/>
    <author fullname="Chaode Yu">
      <organization>Huawei Technologies</organization>
      <address>
        <email>yuchaode@huawei.com</email>
      </address>
    </author>
    <author initials="F." surname="Peruzzini" fullname="Fabio Peruzzini">
      <organization>FiberCop</organization>
      <address>
        <email>fabio.peruzzini@fibercop.com</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>
    <author initials="V." surname="Lopez" fullname="Victor Lopez">
      <organization>Nokia</organization>
      <address>
        <email>victor.lopez@nokia.com</email>
      </address>
    </author>
    <author initials="X." surname="Zhao" fullname="Xing Zhao">
      <organization>CAICT</organization>
      <address>
        <email>zhaoxing@caict.ac.cn</email>
      </address>
    </author>
    <author initials="M." surname="Jin" fullname="Mingshuang Jin">
      <organization>Huawei Technologies</organization>
      <address>
        <email>jinmingshuang@huawei.com</email>
      </address>
    </author>
    <date year="2026" month="January" day="07"/>
    <area>Routing</area>
    <workgroup>Common Control and Measurement Plane</workgroup>
    <keyword>next generation</keyword>
    <keyword>unicorn</keyword>
    <keyword>sparkling distributed ledger</keyword>
    <abstract>
      <?line 76?>

<t>This document defines a YANG data model for resource Performance Monitoring, applicable to network controllers,  which provides the functionalities of retrieval of performance monitoring capabilities, TCA (Threshold Crossing Alert) configuration, current or history performance data retrieval, and performance monitoring task management.</t>
    </abstract>
    <note removeInRFC="true">
      <name>About This Document</name>
      <t>
        The latest revision of this draft can be found at <eref target="https://YuChaode.github.io/draft-yu-ccamp-resource-pm-yang/draft-yu-ccamp-resource-pm-yang.html"/>.
        Status information for this document may be found at <eref target="https://datatracker.ietf.org/doc/draft-yu-ccamp-resource-pm-yang/"/>.
      </t>
      <t>
        Discussion of this document takes place on the
        Common Control and Measurement Plane Working Group mailing list (<eref target="mailto:ccamp@ietf.org"/>),
        which is archived at <eref target="https://mailarchive.ietf.org/arch/browse/ccamp/"/>.
        Subscribe at <eref target="https://www.ietf.org/mailman/listinfo/ccamp/"/>.
      </t>
      <t>Source for this draft and an issue tracker can be found at
        <eref target="https://github.com/YuChaode/draft-yu-ccamp-resource-pm-yang"/>.</t>
    </note>
  </front>
  <middle>
    <?line 80?>

<section anchor="introduction">
      <name>Introduction</name>
      <t>Resource performance monitoring is a basic function of network management. By viewing and analyzing the performance data of different resources (such as network element, interface, board, termination point, tunnel termination point) operators can detect the running state of the network in time, quickly resolve real-time problems or identify major risks in advanced , avoiding users' complaints.</t>
      <t>According to the business requirements stated in <xref target="TMF-518"/>, resource performance monitoring requirements include:</t>
      <ul spacing="normal">
        <li>
          <t>Retrieval of current and historical performance measurements for network resources</t>
        </li>
        <li>
          <t>Distribution of Threshold Crossing Alerts (TCAs) to the collectors of PM data</t>
        </li>
        <li>
          <t>Control of performance monitoring in the network: enable/disable of PM collection and TCA generation</t>
        </li>
      </ul>
      <t>Currently, there are some existing documents related to performance monitoring in IETF, but there is no overlap with our current work. The relative monitored objects are summarized in Table 1.</t>
      <table>
        <thead>
          <tr>
            <th align="left">YANG Module</th>
            <th align="left">Performance-Monitored Object</th>
            <th align="left">Reference</th>
          </tr>
        </thead>
        <tbody>
          <tr>
            <td align="left">ietf-te-telemetry, ietf-vn-telemetry</td>
            <td align="left">TE tunnel, virtual network</td>
            <td align="left">
              <xref target="I-D.ietf-teas-actn-pm-telemetry-autonomics"/></td>
          </tr>
          <tr>
            <td align="left">ietf-network-vpn-pm</td>
            <td align="left">VPN service topology</td>
            <td align="left">
              <xref target="RFC9375"/></td>
          </tr>
          <tr>
            <td align="left">ietf-service-pm</td>
            <td align="left">Transport network service</td>
            <td align="left">
              <xref target="I-D.zheng-ccamp-client-pm-yang"/></td>
          </tr>
          <tr>
            <td align="left">ietf-lmap-control, ietf-lmap-report</td>
            <td align="left">massive measurement agents in broadband service</td>
            <td align="left">
              <xref target="RFC8194"/></td>
          </tr>
        </tbody>
      </table>
      <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). <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. <xref target="I-D.zheng-ccamp-client-pm-yang"/> provides a performance monitoring YANG data model on client signal level. <xref target="RFC8194"/> defines a data model for Large-Scale Measurement Platforms(LMAP), focusing on  task capability and configuration of massive measurement agents.</t>
      <t>This document defines a YANG module for resource performance monitoring, which defines the capabilities of resource performance monitoring, the tca configuration model of a specific resource. In addition, the sub-module of monitoring task and a few RPCs are defined to support the operations of performance monitoring, such as data retrieval and controlling the monitoring tasks.</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>
        <ul empty="true">
          <li>
            <t>To Be Added: some explanation of performance indicator</t>
          </li>
        </ul>
      </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>
        <table anchor="tab-prefixes">
          <name>Prefixes and corresponding YANG modules</name>
          <thead>
            <tr>
              <th align="left">Prefix</th>
              <th align="left">Yang Module</th>
              <th align="left">Reference</th>
            </tr>
          </thead>
          <tbody>
            <tr>
              <td align="left">rpm</td>
              <td align="left">ietf-resource-pm</td>
              <td align="left">RFC XXXX</td>
            </tr>
            <tr>
              <td align="left">rpm-types</td>
              <td align="left">ietf-resource-pm-types</td>
              <td align="left">RFC XXXX</td>
            </tr>
            <tr>
              <td align="left">yang</td>
              <td align="left">ietf-yang-types</td>
              <td align="left">
                <xref target="RFC6991"/></td>
            </tr>
          </tbody>
        </table>
        <t>RFC Editor Note:
Please replace XXXX with the RFC number assigned to this document.</t>
      </section>
    </section>
    <section anchor="yang-data-model-for-resource-performance-monitoring">
      <name>YANG Data Model for Resource Performance Monitoring</name>
      <section anchor="capabilities-of-resource-performance-monitoring">
        <name>Capabilities of Resource Performance Monitoring</name>
        <t>### Supported Resources and Corresponding PM Capabilities
A generic "resources" structure is defined to describe the objects that could be monitored:</t>
        <ul spacing="normal">
          <li>
            <t>"resource":  the identifier of a monitored object</t>
          </li>
          <li>
            <t>"resource-type": indicate what exact kind of resource is</t>
          </li>
          <li>
            <t>"holding time": the longest time period that performance data could be monitored</t>
          </li>
          <li>
            <t>"indicator name": the indicators that could be monitored for the resource</t>
          </li>
          <li>
            <t>"sub-resources": the identifier of the performace monitoring point of this resource (e.g., if the resource is a network element, the sub resources may be a list of termination points)</t>
          </li>
        </ul>
        <artwork type="ascii-art"><![CDATA[
module: ietf-resource-pm
   +--rw performance-monitoring
      +--rw resources
         +--rw resource-list* [resource]
            +--rw resource             union
            +--ro resource-type?       identityref
            +--ro holding-time?     uint8
            +--ro indicator-name*   string
            +--ro sub-resources*    -> ../resource
]]></artwork>
        <section anchor="introduction-of-performance-indicators">
          <name>Introduction of Performance Indicators</name>
          <t>It is impossible to list all the PM indicator exhaustively, even if ITU-T and IETF has done a lot of work.  Some new performance indicators would be raised once there are some new requirements and technologies. So in this document we would like to provide String type rather than an explicit type for performance indicator, to have a better compatibility for future extension. Then if there are some new indicators, there is no need to revise this document or create a branch of documents to standardize the PM indicators.</t>
          <t>For optical network, a performance management information table in the session10.2 of <xref target="ITU-T_G.874"/> lists all the PM current data and history data collected on the EMF(Equipment Management Function). A few indicators of different resources are listed below as an example.</t>
          <t>// To be added: performance indicators of different resources in optical network.</t>
          <t>For IP network, a few indicators of different resources are listed below as an example.
For a network element, following are possible indicators:
* CPU usage.
* Memory usage.
* Total active routes.
* Total active mac entries.</t>
          <t>For an interface, following are possible indicators:
* Ingress unicast packets.
* Ingress multicast packets.
* Ingress discard packets.
* Ingress error packets.
* Ingress unknown protocol packets.
* Egress unicast packets.
* Egress multicast packets.
* Egress discard packets.
* Egress error packets.</t>
          <t>For a board, following are possible indicators:
* CPU usage.
* Memory usage.</t>
        </section>
      </section>
      <section anchor="threshold-crossing-alert-control">
        <name>Threshold Crossing Alert Control</name>
        <t>Threshold crossing alert control parameters could be set directly for a resource, or set through applying an existing profile to the resource. Therefore, there are four main requirements for Threshold Crossing Alert Control:</t>
        <ul spacing="normal">
          <li>
            <t>Creation/retrieval/deletion/updating of TCA profile;</t>
          </li>
          <li>
            <t>Enabling/disabling TCA reporting on the resource;</t>
          </li>
          <li>
            <t>Configuring TCA on the resource by associating an existing profile;</t>
          </li>
          <li>
            <t>Configuring TCA on the resource by detailed parameters.</t>
          </li>
        </ul>
        <t>To satisfy the above requirements, the module defines "tca-management", including the "profile" structure to enable the preset of tca parameters, "tca" structure to describe the tca parameters (directly set or preset by applying profiles) and tca status of a specific resource.</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 parameters (tca-indicator) should include:</t>
        <ul spacing="normal">
          <li>
            <t>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.</t>
          </li>
          <li>
            <t>Period: This period is used to indicate the frequency of the data collection.</t>
          </li>
          <li>
            <t>Severity: This severity is used to indicate what level of alert would be triggered if cross the threshold.</t>
          </li>
          <li>
            <t>Indicator-value: The value of threshold.</t>
          </li>
          <li>
            <t>Indicator-value-unit: The unit of threshold value.</t>
          </li>
        </ul>
        <t>In addition, the function of enabling/disabling TCA on the resource can be controlled by the "admin-status" attribute in "tca" node. The pre-defined profiles with unique profile id could be applied to "tca" node, shown as "applied-profiles" in "tca" node.</t>
        <artwork type="ascii-art"><![CDATA[
module: ietf-resource-pm
  +--rw performance-monitoring
     +--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]
     |        +--rw resource            -> /performance-monitoring/resources/resource-list/resource
     |        +--ro resource-type?      identityref
     |        +--rw admin-status?       enumeration
     |        +--rw applied-profiles
     |        |  +--rw profile* [profile-id]
     |        |     +--rw profile-id    -> ../../../../../profiles/profile/profile-id
     |        +--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>
      </section>
      <section anchor="data-retrieval-of-resource-performance-monitoring">
        <name>Data Retrieval of Resource Performance Monitoring</name>
        <section anchor="get-currenthistory-performance-monitoring-data">
          <name>Get Current/History Performance Monitoring Data</name>
          <t>For the retrieval of current/history performance data, we consider these data are not suitable to define in a data model.  Because performance data can be changed frequently 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 controller should trigger a notification to the northbound system, there would be great number of notifications reported in the big network.</t>
          <t>These two retrieval interfaces are usually invoked on-demand. It is also hard to support retrieving performance data of multiple resources by data model in one request. And for history 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. So we suggest to define an RPC to accomplish these two functions.</t>
          <artwork type="ascii-art"><![CDATA[
  rpcs:
    +---x get-pm-data
    |  +---w input
    |  |  +---w resources*                     -> /performance-monitoring/resources/resource-list/resource
    |  |  +---w is-requesting-history-data?   boolean
    |  |  +---w start-time?                    yang:date-and-time
    |  |  +---w end-time?                      yang:date-and-time
    |  +--ro output
    |     +--ro pm-data
    |        +--ro pm-data-list* [resource]
    |           +--ro resource          -> /performance-monitoring/resources/resource-list/resource
    |           +--ro task-id*          yang:uuid
    |           +--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>
        </section>
        <section anchor="get-profile-associated-resources">
          <name>Get Profile Associated Resources</name>
          <t>For the TCA related definition, it can be found in the previous Section (Section2.2). A TCA profile can be associated with a lot of resources, so we don't defined a resource list under the profile instance to avoid reporting some unnecessary notifications while the resource instances in this list have been changed. We define an RPC operation to support this flexible retrieval request.</t>
          <artwork type="ascii-art"><![CDATA[
  rpcs:
    +---x get-profile-associated-resources
       +---w input
       |  +---w profile-id?   -> /performance-monitoring/tca-management/profiles/profile/profile-id
       +--ro output
          +--ro resource-list*   -> /performance-monitoring/resources/resource-list/resource
]]></artwork>
        </section>
      </section>
      <section anchor="controlling-of-resource-performance-monitoring">
        <name>Controlling of Resource Performance Monitoring</name>
        <section anchor="clear-performance-monitoring-data-of-specific-resources">
          <name>Clear Performance Monitoring Data of Specific Resources</name>
          <t>We define an RPC to enable clearing the performance monitoring data of specified resources. If there are any resources failed to clear performance monitoring data, their identifier should be returned by the failed-resources leaf list. An empty list indicates that this operation was performed successfully.</t>
          <artwork type="ascii-art"><![CDATA[
  rpcs:
    +---x clear-performance-monitoring-data
    |  +---w input
    |  |  +---w resources*   -> /performance-monitoring/resources/resource-list/resource
    |  +--ro output
    |     +--ro failed-resources*   -> /performance-monitoring/resources/resource-list/resource
]]></artwork>
        </section>
        <section anchor="enabledisable-performance-monitoring">
          <name>Enable/Disable Performance Monitoring</name>
          <t>To enable/disable performance monitoring data, we introduce a monitor task to do this control. In the monitoring task, the resource, the monitored period, the monitored indicators could be set. The disabling, enabling operation can be satisfied by changing the admin status which includes disabled, enabled. The change's result will affect the task status accordingly.</t>
          <artwork type="ascii-art"><![CDATA[
   module: ietf-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>
        </section>
      </section>
    </section>
    <section anchor="resource-performance-monitoring-tree-diagram">
      <name>Resource Performance Monitoring Tree Diagram</name>
      <figure anchor="fig-rpm-tree">
        <name>Resource Performance Monitoring tree diagram</name>
        <artwork type="ascii-art" name="ietf-resource-pm.tree"><![CDATA[
=============== NOTE: '\' line wrapping per RFC 8792 ================

module: ietf-resource-pm
  +--rw performance-monitoring
     +--rw resources
     |  +--rw resource-list* [resource]
     |     +--rw resource          union
     |     +--ro resource-type?    identityref
     |     +--ro holding-time?     uint8
     |     +--ro indicator-name*   string
     |     +--ro sub-resources*    -> ../resource
     +--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]
     |        +--rw resource            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 monitor-tasks
        +--rw monitor-task* [task-id]
           +--rw task-id          yang:uuid
           +--rw resource?        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

  rpcs:
    +---x get-pm-data
    |  +---w input
    |  |  +---w resources*                    leafref
    |  |  +---w is-requesting-history-data?   boolean
    |  |  +---w start-time?                   yang:date-and-time
    |  |  +---w end-time?                     yang:date-and-time
    |  +--ro output
    |     +--ro pm-data
    |        +--ro pm-data-list* [resource]
    |           +--ro resource          leafref
    |           +--ro task-id*          yang:uuid
    |           +--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 clear-performance-monitoring-data
    |  +---w input
    |  |  +---w resources*   leafref
    |  +--ro output
    |     +--ro failed-resources*   leafref
    +---x get-profile-associated-resources
       +---w input
       |  +---w profile-id?   leafref
       +--ro output
          +--ro resource-list*   leafref
]]></artwork>
      </figure>
    </section>
    <section anchor="yang-model-for-resource-performance-monitoring">
      <name>YANG Model for Resource Performance Monitoring</name>
      <figure anchor="fig-rpm-yang">
        <name>Resource Performance Monitoring YANG module</name>
        <sourcecode type="yang" markers="true" name="ietf-resource-pm@2025-07-04.yang"><![CDATA[
module ietf-resource-pm {
  yang-version 1.1;
  namespace "urn:ietf:params:xml:ns:yang:ietf-resource-pm";
  prefix rpm;

  import ietf-yang-types {
    prefix "yang";
  }

  import ietf-resource-pm-types {
    prefix "rpm-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>

     Editor:   Fabio Peruzzini
               <fabio.peruzzini@fibercop.com>

     Editor:   Yanlei Zheng
               <zhengyanlei@chinaunicom.cn>

     Editor:   Victor Lopez
               <victor.lopez@nokia.com>

     Editor:   Italo Busi
               <italo.busi@huawei.com>

     Editor:   Aihua Guo
               <aihuaguo.ietf@gmail.com>

     Editor:   Xing Zhao
               <zhaoxing@caict.ac.cn>

     Editor:   Mingshuang Jin
               <jinmingshuang@huawei.com>";

  description
    "This module defines a model for resource performance
    monitoring.

    The model fully conforms to the Network Management
    Datastore Architecture (NMDA).

    Copyright (c) 2025 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 2025-07-04 {
    description  "Initial revision.";
  }

  container performance-monitoring {
    description
      "the root node.";

    uses resource-info-grouping;
    uses tca-management-grouping;
    uses monitoring-tasks-grouping;
  }

  grouping resource-info-grouping {
    description
      "grouping of resources' PM capabilities related information";

    container resources {
      description
        "resources' PM capabilities related information";

      list resource-list {
        description
          "list of resource instances";
        key resource;

        leaf resource {
          type union {
            type instance-identifier {
              require-instance false;
            }
            type yang:object-identifier;
            type string;
            type yang:uuid;
          }
        }

        leaf resource-type {
          type identityref {
            base rpm-types:resource-type;
        }
        config false;
          description
          "the type of resource, such as NE, board or port";
     }

      leaf holding-time {
         description
           "Contains the time period in hours within which 24h PM
            data records and 15min PM data records may be retrieved.
            If the domain controller does not store PM data it is the
            time supported in the NE";
        config false;
        type uint8;
        units "hour";
      }

     leaf-list indicator-name {
        type string;
        config false;
     }

     leaf-list sub-resources {
       description
          "the identifier of the performace monitoring point of this
          resource. If the resource is a NE, the sub-resource should
          be termination point. If the resource is a termination
          point contained in this NE, the sub-resource should be the
          logic channel on this TP";
      config false;
      type leafref {
        path "../rpm:resource";
      }
    }
  }
}

}

  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 {
      description
        "the identifier of network resource on which the performance
        monitoring task is running";

      type leafref {
        path "/rpm:performance-monitoring/rpm:resources" +
        "/rpm:resource-list/rpm:resource";
      }
    }

    leaf resource-type {
      description
        "the type of resource, such as NE, board or port";

      config false;
      type identityref {
        base rpm-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 rpm-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";

          leaf resource {
            description
              "the identifier of network resource on which threshold
              is configured for TCA purpose";

            type leafref {
              path "/rpm:performance-monitoring/rpm:resources" +
              "/rpm:resource-list/rpm:resource";
            }
          }

          leaf resource-type {
            description
              "the type of resource, such as NE, board or termination
              point";

            config false;

            type identityref {
              base rpm-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 rpm-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 rpm-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 "../../../../../rpm:profiles/rpm:profile" +
            "/rpm: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-pm-data {
    input {

      leaf-list resources {
        description
          "the identifier of resources from which performace
          data is collected";

        type leafref {
          path "/rpm:performance-monitoring/rpm:resources" +
          "/rpm:resource-list/rpm:resource";
        }
      }

      leaf is-requesting-history-data {
        description
        "true indicate this is a request for historic data, then start-time and end-time should be assigned";
        type boolean;
      }
      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;
        }
      }
    }
  }

  rpc clear-performance-monitoring-data {
        description
        "This operation clears (reset) the PM registers for a list of
        Measurement Points. Within the request for each Measurement
        Point, it is possible to specify the granularity (15min, 24hr,
        NA) and location (nearEnd and/or farEnd and/or bidirectional)
        for the PM registers that are to be reset.";
    input {

      leaf-list resources {
        description
          "the identifier of measurement points to clear PM data";

        type leafref {
          path "/rpm:performance-monitoring/rpm:resources" +
          "/rpm:resource-list/rpm:resource";
        }
      }
    }
    output {
      leaf-list failed-resources {
        description
          "the identifier of measurement points which are failed to
          clear PM data. An empty list indicates that the total
          request was successful.";

        type leafref {
          path "/rpm:performance-monitoring/rpm:resources" +
          "/rpm:resource-list/rpm:resource";
        }
      }
    }
  }

  rpc get-profile-associated-resources {
    input {

      leaf profile-id {
        description
          "the identifier of profile which the client want to
          retrieve";

        type leafref {
          path "/rpm:performance-monitoring/rpm:tca-management"
          + "/rpm:profiles/rpm:profile/rpm:profile-id";
        }
      }

    }
    output {
      leaf-list resource-list {
        description
          "Provides the set of Resources associated with the profile
          provided.";

        type leafref {
          path "/rpm:performance-monitoring/rpm:resources" +
          "/rpm:resource-list/rpm:resource";
        }
      }
    }
  }

  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 "/rpm:performance-monitoring/rpm:resources" +
        "/rpm:resource-list/rpm:resource";
      }
    }

    leaf-list task-id {
       description
        "the task id list of the tasks from which the pm data is retrieved";

        type yang:uuid;
    }
    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 rpm-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-resource-performance-monitoring-types">
      <name>YANG Model for Resource Performance Monitoring Types</name>
      <figure anchor="fig-rpm-type-yang">
        <name>Resource Performance Monitoring Types YANG module</name>
        <sourcecode type="yang" markers="true" name="ietf-resource-pm-types@2025-07-04.yang"><![CDATA[
module ietf-resource-pm-types {
  yang-version 1.1;
  namespace
  "urn:ietf:params:xml:ns:yang:ietf-resource-pm-types";

  prefix rpm-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>

     Editor:   Fabio Peruzzini
               <fabio.peruzzini@fibercop.com>

     Editor:   Yanlei Zheng
               <zhengyanlei@chinaunicom.cn>

     Editor:   Victor Lopez
               <victor.lopez@nokia.com>

     Editor:   Italo Busi
               <italo.busi@huawei.com>

     Editor:   Aihua Guo
               <aihuaguo.ietf@gmail.com>

     Editor:   Xing Zhao
               <zhaoxing@caict.ac.cn>

     Editor:   Mingshuang Jin
               <jinmingshuang@huawei.com>";

  description
    "This module defines types model for resource performance
    monitoring which will be imported by ietf-resource-pm
    data model.

    The model fully conforms to the Network Management
    Datastore Architecture (NMDA).

    Copyright (c) 2025 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 2025-07-04 {
    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 interface {
      base resource-type;
      description "Network interface";
   }

  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 major {
    description
        "major 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;
  }

  identity layer-rate-type {
    description
        "It is used to indicate the layer rate of network element when
        retrieving the pm parameters supported";
  }
}

]]></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-resource-pm
   namespace:    urn:ietf:params:xml:ns:yang:ietf-resource-pm
   prefix:       dvcrpm
   reference:    RFC XXXX: A YANG Data Model for Resource Performance Monitoring</t>
      <t>name:         ietf-resource-pm-types
   namespace:    urn:ietf:params:xml:ns:yang:ietf-resource-pm-types
   prefix:       dvcrpm-types
   reference:    RFC XXXX: A YANG Data Model for Resource Performance Monitoring</t>
    </section>
  </middle>
  <back>
    <references anchor="sec-combined-references">
      <name>References</name>
      <references anchor="sec-normative-references">
        <name>Normative References</name>
        <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="ITU-T_G.874" target="https://www.itu.int/rec/T-REC-G.874/en">
          <front>
            <title>Management aspects of optical transport network elements</title>
            <author>
              <organization>International Telecommunication Union</organization>
            </author>
            <date year="2020" month="October"/>
          </front>
          <seriesInfo name="ITU-T Recommendation G.874" value=""/>
        </reference>
        <reference anchor="RFC9375">
          <front>
            <title>A YANG Data Model for Network and VPN Service Performance Monitoring</title>
            <author fullname="B. Wu" initials="B." role="editor" surname="Wu"/>
            <author fullname="Q. Wu" initials="Q." role="editor" surname="Wu"/>
            <author fullname="M. Boucadair" initials="M." role="editor" surname="Boucadair"/>
            <author fullname="O. Gonzalez de Dios" initials="O." surname="Gonzalez de Dios"/>
            <author fullname="B. Wen" initials="B." surname="Wen"/>
            <date month="April" year="2023"/>
            <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="RFC" value="9375"/>
          <seriesInfo name="DOI" value="10.17487/RFC9375"/>
        </reference>
        <reference anchor="RFC8194">
          <front>
            <title>A YANG Data Model for LMAP Measurement Agents</title>
            <author fullname="J. Schoenwaelder" initials="J." surname="Schoenwaelder"/>
            <author fullname="V. Bajpai" initials="V." surname="Bajpai"/>
            <date month="August" year="2017"/>
            <abstract>
              <t>This document defines a data model for Large-Scale Measurement Platforms (LMAPs). The data model is defined using the YANG data modeling language.</t>
            </abstract>
          </front>
          <seriesInfo name="RFC" value="8194"/>
          <seriesInfo name="DOI" value="10.17487/RFC8194"/>
        </reference>
        <reference anchor="RFC8342">
          <front>
            <title>Network Management Datastore Architecture (NMDA)</title>
            <author fullname="M. Bjorklund" initials="M." surname="Bjorklund"/>
            <author fullname="J. Schoenwaelder" initials="J." surname="Schoenwaelder"/>
            <author fullname="P. Shafer" initials="P." surname="Shafer"/>
            <author fullname="K. Watsen" initials="K." surname="Watsen"/>
            <author fullname="R. Wilton" initials="R." surname="Wilton"/>
            <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">
          <front>
            <title>Routing and Wavelength Assignment Information Model for Wavelength Switched Optical Networks</title>
            <author fullname="Y. Lee" initials="Y." role="editor" surname="Lee"/>
            <author fullname="G. Bernstein" initials="G." role="editor" surname="Bernstein"/>
            <author fullname="D. Li" initials="D." surname="Li"/>
            <author fullname="W. Imajuku" initials="W." surname="Imajuku"/>
            <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">
          <front>
            <title>Routing and Wavelength Assignment Information Encoding for Wavelength Switched Optical Networks</title>
            <author fullname="G. Bernstein" initials="G." role="editor" surname="Bernstein"/>
            <author fullname="Y. Lee" initials="Y." role="editor" surname="Lee"/>
            <author fullname="D. Li" initials="D." surname="Li"/>
            <author fullname="W. Imajuku" initials="W." surname="Imajuku"/>
            <author fullname="J. Han" initials="J." surname="Han"/>
            <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 "Routing and Wavelength Assignment Information Model for Wavelength Switched Optical Networks" (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">
          <front>
            <title>The YANG 1.1 Data Modeling Language</title>
            <author fullname="M. Bjorklund" initials="M." role="editor" surname="Bjorklund"/>
            <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">
          <front>
            <title>Network Configuration Protocol (NETCONF)</title>
            <author fullname="R. Enns" initials="R." role="editor" surname="Enns"/>
            <author fullname="M. Bjorklund" initials="M." role="editor" surname="Bjorklund"/>
            <author fullname="J. Schoenwaelder" initials="J." role="editor" surname="Schoenwaelder"/>
            <author fullname="A. Bierman" initials="A." role="editor" surname="Bierman"/>
            <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">
          <front>
            <title>YANG Tree Diagrams</title>
            <author fullname="M. Bjorklund" initials="M." surname="Bjorklund"/>
            <author fullname="L. Berger" initials="L." role="editor" surname="Berger"/>
            <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">
          <front>
            <title>Common YANG Data Types</title>
            <author fullname="J. Schoenwaelder" initials="J." role="editor" surname="Schoenwaelder"/>
            <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">
          <front>
            <title>RESTCONF Protocol</title>
            <author fullname="A. Bierman" initials="A." surname="Bierman"/>
            <author fullname="M. Bjorklund" initials="M." surname="Bjorklund"/>
            <author fullname="K. Watsen" initials="K." surname="Watsen"/>
            <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">
          <front>
            <title>Using the NETCONF Protocol over Secure Shell (SSH)</title>
            <author fullname="M. Wasserman" initials="M." surname="Wasserman"/>
            <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">
          <front>
            <title>The Transport Layer Security (TLS) Protocol Version 1.3</title>
            <author fullname="E. Rescorla" initials="E." surname="Rescorla"/>
            <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">
          <front>
            <title>Network Configuration Access Control Model</title>
            <author fullname="A. Bierman" initials="A." surname="Bierman"/>
            <author fullname="M. Bjorklund" initials="M." surname="Bjorklund"/>
            <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">
          <front>
            <title>YANG Data Model for Traffic Engineering (TE) Topologies</title>
            <author fullname="X. Liu" initials="X." surname="Liu"/>
            <author fullname="I. Bryskin" initials="I." surname="Bryskin"/>
            <author fullname="V. Beeram" initials="V." surname="Beeram"/>
            <author fullname="T. Saad" initials="T." surname="Saad"/>
            <author fullname="H. Shah" initials="H." surname="Shah"/>
            <author fullname="O. Gonzalez de Dios" initials="O." surname="Gonzalez de Dios"/>
            <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">
          <front>
            <title>YANG - A Data Modeling Language for the Network Configuration Protocol (NETCONF)</title>
            <author fullname="M. Bjorklund" initials="M." role="editor" surname="Bjorklund"/>
            <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 anchor="sec-informative-references">
        <name>Informative References</name>
        <reference anchor="I-D.ietf-teas-actn-pm-telemetry-autonomics">
          <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</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>Cisco</organization>
            </author>
            <date day="13" month="October" year="2025"/>
            <abstract>
              <t>   This document provides YANG data models that describe the performance
   monitoring parameters and scaling intent mechanisms for TE-tunnels
   and Virtual Networks (VNs).  Their 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-16"/>
        </reference>
        <reference anchor="I-D.zheng-ccamp-client-pm-yang">
          <front>
            <title>A YANG Data Model for Client Signal Performance Monitoring</title>
            <author fullname="Chaode Yu" initials="C." surname="Yu">
              <organization>Huawei Technologies</organization>
            </author>
            <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="29" month="August" year="2025"/>
            <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-13"/>
        </reference>
        <reference anchor="I-D.ietf-opsawg-yang-vpn-service-pm">
          <front>
            <title>A YANG Data 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="RFC8454">
          <front>
            <title>Information Model for Abstraction and Control of TE Networks (ACTN)</title>
            <author fullname="Y. Lee" initials="Y." surname="Lee"/>
            <author fullname="S. Belotti" initials="S." surname="Belotti"/>
            <author fullname="D. Dhody" initials="D." surname="Dhody"/>
            <author fullname="D. Ceccarelli" initials="D." surname="Ceccarelli"/>
            <author fullname="B. Yoon" initials="B." surname="Yoon"/>
            <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">
          <front>
            <title>Subscription to YANG Notifications for Datastore Updates</title>
            <author fullname="A. Clemm" initials="A." surname="Clemm"/>
            <author fullname="E. Voit" initials="E." surname="Voit"/>
            <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>
      </references>
    </references>
    <?line 1330?>

<section numbered="false" anchor="acknowledgments">
      <name>Acknowledgments</name>
      <t>This document was prepared using kramdown.</t>
    </section>
  </back>
  <!-- ##markdown-source:
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

-->

</rfc>
