OPSAWG B. Claise Internet-Draft Everything OPS & Arrcus Intended status: Standards Track J. Quilbeuf Expires: 19 May 2027 Huawei D. Lopez Telefonica I+D I. Dominguez Martinez-Casanueva Telefonica T. Graf Swisscom 15 November 2026 A Data Manifest for Contextualized Telemetry Data draft-ietf-opsawg-collected-data-manifest-17 Abstract Network platforms use Network Telemetry, such as YANG-Push (RFC 8641), to continuously stream information, including both counters and state information. This document describes the metadata that ensure that the collected data can be interpreted correctly. This document specifies the Data Manifest, composed of two YANG data models (the Platform Manifest and the non-normative Data Collection Manifest). These YANG modules are specified at the network level (e.g., network controllers) to provide a model that encompasses several network platforms. The Data Manifest must be streamed and stored along with the data, up to the collection and analytics systems to keep the collected data fully usable by the data scientists and relevant tools. Additionally, this document specifies an augmentation of the YANG-Push model to include the actual collection period, in case it differs from the configured collection period. Status of This Memo This Internet-Draft is submitted in full conformance with the provisions of BCP 78 and BCP 79. Internet-Drafts are working documents of the Internet Engineering Task Force (IETF). Note that other groups may also distribute working documents as Internet-Drafts. The list of current Internet- Drafts is at https://datatracker.ietf.org/drafts/current/. Internet-Drafts are draft documents valid for a maximum of six months and may be updated, replaced, or obsoleted by other documents at any time. It is inappropriate to use Internet-Drafts as reference material or to cite them other than as "work in progress." Claise, et al. Expires 19 May 2027 [Page 1] Internet-Draft Telemetry Data Manifest November 2026 This Internet-Draft will expire on 19 May 2027. Copyright Notice Copyright (c) 2026 IETF Trust and the persons identified as the document authors. All rights reserved. This document is subject to BCP 78 and the IETF Trust's Legal Provisions Relating to IETF Documents (https://trustee.ietf.org/ license-info) in effect on the date of publication of this document. Please review these documents carefully, as they describe your rights and restrictions with respect to this document. Code Components extracted from this document must include Revised BSD License text as described in Section 4.e of the Trust Legal Provisions and are provided without warranty as described in the Revised BSD License. Table of Contents 1. Introduction . . . . . . . . . . . . . . . . . . . . . . . . 3 2. Terminology . . . . . . . . . . . . . . . . . . . . . . . . . 4 3. Use Cases . . . . . . . . . . . . . . . . . . . . . . . . . . 5 3.1. Network Analytics . . . . . . . . . . . . . . . . . . . . 5 3.2. New Device Onboarding . . . . . . . . . . . . . . . . . . 6 3.3. Data Mesh Principles in Networking . . . . . . . . . . . 6 4. The "ietf-yp-current-period" YANG module . . . . . . . . . . 7 5. Platform Manifest . . . . . . . . . . . . . . . . . . . . . . 10 5.1. Overview of the Model . . . . . . . . . . . . . . . . . . 10 5.2. "ietf-platform-manifest" YANG module . . . . . . . . . . 13 6. Data Manifest and the Collected Data . . . . . . . . . . . . 19 6.1. Collecting the Data Manifest . . . . . . . . . . . . . . 19 6.2. Mapping Collected Data to the Data Manifest . . . . . . . 21 7. Operational Considerations . . . . . . . . . . . . . . . . . 24 8. Security Considerations . . . . . . . . . . . . . . . . . . . 24 9. IANA Considerations . . . . . . . . . . . . . . . . . . . . . 26 10. Normative References . . . . . . . . . . . . . . . . . . . . 27 11. Informative References . . . . . . . . . . . . . . . . . . . 28 Appendix A. Data Collection Manifest . . . . . . . . . . . . . . 31 A.1. Overview of the Model . . . . . . . . . . . . . . . . . . 31 A.2. The "example-collection-manifest" YANG module . . . . . . 34 Appendix B. Changes between revisions . . . . . . . . . . . . . 36 Appendix C. Example . . . . . . . . . . . . . . . . . . . . . . 41 Appendix D. An Example Based on Model-Driven Telemetry . . . . . 43 Appendix E. Generating YANG Tree Diagrams . . . . . . . . . . . 46 Appendix F. Validating the Example . . . . . . . . . . . . . . . 50 Appendix G. YANG Catalog Module . . . . . . . . . . . . . . . . 51 Acknowledgements . . . . . . . . . . . . . . . . . . . . . . . . 70 Authors' Addresses . . . . . . . . . . . . . . . . . . . . . . . 70 Claise, et al. Expires 19 May 2027 [Page 2] Internet-Draft Telemetry Data Manifest November 2026 1. Introduction Network platforms use Network Telemetry [RFC9232], such as YANG-Push [RFC8641], to continuously stream information, including both counters and state information. The information to be streamed, and how often, is governed by a subscription [RFC8641], a concept that is also central to this document. In this document, metadata denotes the contextual information about the platform and the collection process that is needed to interpret the streamed data, as opposed to the data values themselves. This document specifies what needs to be kept as metadata to ensure that the collected data can still be interpreted correctly throughout the collection and network analytics toolchain. When streaming YANG- structured data with YANG-Push, there is a semantic definition in the corresponding YANG module definition. This is the semantic information for the collected data nodes: While this semantic is absolutely required to correctly decode and interpret the data, understanding the network platform and collection environment context information is equally important to interpret the data. One part of this information is the actual collection period, as opposed to the configured collection period. On some platforms, that period can be adjusted by the platform, for instance to reduce the load incurred by collecting and sending the telemetry. To later make use of the collected data, getting this actual collection period is crucial. This document defines a YANG model augmenting the YANG-Push model [RFC8641] to expose the actual collection period in Section 4. This document introduces the Data Manifest, which is composed of two YANG modules [RFC7950], namely, the Platform Manifest and the Data Collection Manifest, to keep the collected data usable by the data scientists and relevant tools. The Platform Manifest contains information characterizing the platform streaming the telemetry information, while the Data Collection Manifest contains the required information to characterize how and when the telemetry information was metered. The Platform Manifest is specified in Section 5. An example of a Data Collection Manifest is provided in Appendix A. The latter module is non- normative due to the lack of design-time schema mount in YANG (see Section 1 of [RFC8528]) and is therefore included in the appendix. These two YANG modules do not expose any new information but rather define what should be exposed by a platform streaming or storing telemetry data. Some related YANG modules have been specified to retrieve the platform capabilities such as: Claise, et al. Expires 19 May 2027 [Page 3] Internet-Draft Telemetry Data Manifest November 2026 * "YANG Library" [RFC8525]. * "YANG Modules Describing Capabilities for Systems and Datastore Update Notifications" [RFC9196] for the platform capabilities regarding the production and export of telemetry data. * [I-D.claise-netconf-metadata-for-collection], which is based on [RFC9196] to define the optimal settings to stream specific items (i.e., per path). These related YANG modules are important to discover the capabilities before applying the telemetry configuration (such as on-change subscription). Some of their content is part of the context for the streamed data. This document covers only metadata about the collection context for the telemetry. The collected data is likely to be transformed into usable indicators for the network. The list of such transformation operations applied to the data is often called data lineage. Supplying the data lineage for the computed indicators is out of scope of this document. This document enables retrieving the context in which a particular piece of data was collected, without having to access the platform that emitted the telemetry. This retrieval requires three elements: * the time at which the data was observed; * the originating platform; * the subscription through which the data arrived. The approach described in this document assumes that an underlying database records the history of both the data and the Data Manifest, enabling the data analyst to temporally match the data and the Data Manifest. Therefore, the approach presented here focuses on providing a way to match a platform and a subscription identifier to the collection context. This is consistent with most of the YANG modules for devices, which focus on describing the current state of the device, rather than the evolution of that state through time. 2. Terminology 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 [RFC2119] [RFC8174] when, and only when, they appear in all capitals, as shown here. Claise, et al. Expires 19 May 2027 [Page 4] Internet-Draft Telemetry Data Manifest November 2026 This document reuses the term "Network Telemetry" as defined in [RFC9232]. This document also reuses the subscription-related terminology defined in [RFC8641]. Platform: equipment in the network able to produce telemetry data. Data Manifest: The platform and data-collection context needed to correctly interpret collected telemetry. Platform Manifest: part of the Data Manifest that characterizes the platform producing the telemetry information. Data Collection Manifest: part of the Data Manifest that characterizes how and when the telemetry information was metered. Datapoint: an instance of data collected via Network Telemetry at a specific time. Collector: software that receives the stream of telemetry. Data lineage: the sequence of transformation operations applied to the collected data to produce derived indicators. 3. Use Cases 3.1. Network Analytics Streamed information from network platforms is used for network analytics, incident detection, and in the closed control loop for network automation. See [RFC9940] for definition of some of these terms. This streamed data can be stored in a time-series database (TSDB) or processed in a real-time streaming processor for further analysis. As an example, a database could store a time series representing the evolution of a specific counter collected from a network platform. When analyzing the data, a network operator/data scientist must understand the context information for these data: * The counter definition, typically as defined in the YANG model. * The network platform vendor, model, and OS. * The collection parameters. Claise, et al. Expires 19 May 2027 [Page 5] Internet-Draft Telemetry Data Manifest November 2026 Characterizing the source used for producing the data (vendor, platform, and OS) is useful to complement the data. As an example, knowing the exact data source software specification might reveal a particularity in the observed data, explained by a specific bug, a specific bug fix, or simply a particular specific behavior. This is also necessary to ensure the reliability of the collected data. On top of that, for YANG-Push [RFC8641], it is crucial to know the set of YANG modules supported by the platform, along with their deviations. In some cases, there might even be some backwards incompatible changes in built-in modules (i.e., vendor proprietary modules) between one OS version to the next one. This information is captured by means of the Platform Manifest (see Section 5). From a collection parameters point of view, the data scientists analyzing the collected data must know whether the counter was requested from the network platform as on-change or at specific cadence [RFC8641]. Indeed, an on-change collection explains why there is a single value as opposed to a time series. In case of periodic collection, this exact cadence might not be observable in the time series. Indeed, this time series might report some values as 0 or might even omit some values. The reason for this behavior might be diverse: the network platform may be under stress, with a too small observation period, compared to the minimum-observable- period [I-D.claise-netconf-metadata-for-collection]. Knowing the conditions under which a counter was collected and streamed (along with the platform details) will help in drawing suitably informed conclusions. As an example, some platform might erroneously report a value of 0 for counters when the collection period is too short with respect to the capabilities of the platform. Without context, this value of 0 might lead to a wrong conclusion that the corresponding counter dropped to zero. 3.2. New Device Onboarding When a new device is onboarded, operators must check that the new device streams data (e.g., with YANG-Push), that the Network Telemetry data is of the appropriate form for the device, that the data is correctly collected at the data collector, and finally that the data can be analyzed (compared with other similar devices). For the last point, the Data Manifest, which must be linked to the data up to the collection and analytics system, contains the relevant information, notably in the case where the telemetry subscriptions are not configured by the telemetry collectors. 3.3. Data Mesh Principles in Networking The concepts behind the data mesh ([DataMesh], [DataMeshRA]) are: Claise, et al. Expires 19 May 2027 [Page 6] Internet-Draft Telemetry Data Manifest November 2026 * Data as a Product: The "Domain" owners are responsible for providing the data in a useful way (discoverable through a catalog, addressable with a permanent and unique address, understandable with well-defined semantics, trustworthy and truthful, self-describing for easy consumption, interoperable by supporting standards, secure, self-contained, etc.) and should treat consumers of that data as customers. It requires and relies on the "Domain Ownership" principle. * Domain Ownership: Architecturally and organizationally align business, technology, and analytical data, following the line of responsibility. The Data Mesh principles adopt the boundary of a bounded context to individual data products where each domain is responsible for (and owns) its data and models. * Self-serve Data Platform: This fosters the sharing of cross-domain data to create extra value. * Federated Computational Governance: Describes the operating model and approach to establishing global policies across a mesh of data products. The four principles above describe the full Data Mesh model and are included here for context; of these, the one this document directly supports is the "Data as a Product" principle. The Data Manifest fulfills this principle through the two YANG data models defined in this document, the Platform Manifest and the Data Collection Manifest, which, along with the data, provide all the necessary information in a self-describing way for easy consumption. 4. The "ietf-yp-current-period" YANG module Some platforms will adjust the collection period depending on their capabilities and current load. The YANG module in this section augments the "periodic" container that "ietf-yang-push" [RFC8641] adds to the subscription list of the "ietf-subscribed-notifications" module [RFC8639], with the operational leaf "current-period", next to the configured "period" and "anchor-time". For a periodic subscription, this leaf reports the collection period currently used, i.e., the interval between successive observations of the subscribed data. The configured "period" is the nominal interval at which the publisher observes the subscribed data for each update, consistent with [RFC8641], under which each periodic update carries a snapshot of the subscribed data at the time of the update. Reporting the period explicitly lets a receiver tell a deliberate adjustment apart from missing data, without inferring it from the timing of the received updates, which depends on optional metadata such as the observation timestamp of [I-D.ietf-netconf-notif-envelope]. A Claise, et al. Expires 19 May 2027 [Page 7] Internet-Draft Telemetry Data Manifest November 2026 receiver can cross-check the reported value against the observation timestamps of successive updates [I-D.ietf-netconf-notif-envelope]. The leaf describes when the data is observed, not when each update is generated and sent, and it may differ from the configured "period". The leaf applies to every periodic subscription, typically those collecting the data; it is part of that subscription's state, which can be collected directly or through the Data Collection Manifest (Appendix A), preferably with on-change subscriptions (Section 6.1). Reporting "current-period" does not modify the subscription's configured "period" or "anchor-time". The publisher remains subject to the reliability and notification requirements of Sections 3.4 and 3.11.1 of [RFC8641]. Reporting this leaf MUST NOT replace any notification required by those procedures. [RFC8641] prefers that a publisher decline, when the subscription is established, a request it cannot meet (Section 3.11.2). The leaf addresses an accepted subscription whose period the publisher cannot sustain, for example because the load has changed. Changes to the subscription's periodic schedule use the applicable subscription modification procedures in [RFC8639] and [RFC8641]. Update boundaries continue to follow Section 4.2 of [RFC8641], using the supplied "anchor-time" or, when none is supplied, the creation time of the initial update record. A change to "current-period" is a change to the Data Collection Manifest. Its applicability to collected datapoints is determined using the effective-time and history requirements in Section 6.2. Figure 1 contains the YANG tree diagram [RFC8340] of the "ietf-yp- current-period" module. module: ietf-yp-current-period augment /sn:subscriptions/sn:subscription/yp:update-trigger /yp:periodic/yp:periodic: +--ro current-period? yp:centiseconds Figure 1: YANG tree diagram for "ietf-yp-current-period" module The code of the "ietf-yp-current-period" YANG module is given below. file "ietf-yp-current-period@2026-10-24.yang" module ietf-yp-current-period { yang-version 1.1; namespace "urn:ietf:params:xml:ns:yang:ietf-yp-current-period"; prefix yp-cp; Claise, et al. Expires 19 May 2027 [Page 8] Internet-Draft Telemetry Data Manifest November 2026 import ietf-subscribed-notifications { prefix sn; reference "RFC 8639: Subscription to YANG Notifications"; } import ietf-yang-push { prefix yp; // RFC Ed.: remove revision-date, needed here for datatracker // to properly validate the module, because the latest version // on the server is not the ratified one and validation fails. revision-date 2019-09-09; reference "RFC 8641: Subscription to YANG Notifications for Datastore Updates"; } organization "IETF OPSAWG (Operations and Management Area Working Group)"; contact "WG Web: WG List: Author: Benoit Claise Author: Jean Quilbeuf Author: Diego R. Lopez Author: Ignacio Dominguez Martinez-Casanueva Author: Thomas Graf "; description "This module augments ietf-subscribed-notifications and ietf-yang-push with the current-period leaf reporting the actual collection period, as opposed to the configured one. Copyright (c) 2026 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). All revisions of IETF and IANA published modules can be found at the YANG Parameters registry group (https://www.iana.org/assignments/yang-parameters). This version of this YANG module is part of RFC XXXX; see the RFC itself for full legal notices."; Claise, et al. Expires 19 May 2027 [Page 9] Internet-Draft Telemetry Data Manifest November 2026 revision 2026-10-24 { description "Initial revision"; reference "RFC XXXX: A Data Manifest for Contextualized Telemetry Data"; } augment "/sn:subscriptions/sn:subscription" + "/yp:update-trigger/yp:periodic/yp:periodic" { description "Adds current collection period"; leaf current-period { type yp:centiseconds; units "centiseconds"; config false; description "The period currently used between two successive observation times of the subscribed data for a periodic subscription, i.e., the realized collection period. It may differ from the configured 'period' (RFC 8641) when the publisher cannot meet the configured cadence, for instance under overload. When this leaf is not reported for a periodic subscription, the configured 'period' is in effect. A reported value is a positive period; the value zero is not meaningful."; } } } 5. Platform Manifest 5.1. Overview of the Model Figure 2 contains the YANG tree diagram of the "ietf-platform- manifest" module. module: ietf-platform-manifest +--ro platforms +--ro platform* [id] +--ro id string +--ro name? string {yang-catalog}? +--ro vendor? string {yang-catalog}? +--ro vendor-pen? uint32 {yang-catalog}? +--ro software-version? string {yang-catalog}? +--ro software-flavor? string {yang-catalog}? +--ro os-version? string {yang-catalog}? +--ro os-type? string {yang-catalog}? +--ro system {ietf-system}? Claise, et al. Expires 19 May 2027 [Page 10] Internet-Draft Telemetry Data Manifest November 2026 | +--ro contact? string | +--ro hostname? inet:domain-name | +--ro location? string +--ro system-state {ietf-system}? | +--ro platform | +--ro os-name? string | +--ro os-release? string | +--ro os-version? string | +--ro machine? string +--ro module-set* [name] | +--ro name string | +--ro module* [name] | | +--ro name yang:yang-identifier | | +--ro revision? revision-identifier | | +--ro namespace inet:uri | | +--ro location* inet:uri | | +--ro submodule* [name] | | | +--ro name yang:yang-identifier | | | +--ro revision? revision-identifier | | | +--ro location* inet:uri | | +--ro feature* yang:yang-identifier | | +--ro deviation* -> ../../module/name | +--ro import-only-module* [name revision] | +--ro name yang:yang-identifier | +--ro revision union | +--ro namespace inet:uri | +--ro location* inet:uri | +--ro submodule* [name] | +--ro name yang:yang-identifier | +--ro revision? revision-identifier | +--ro location* inet:uri +--ro schema* [name] | +--ro name string | +--ro module-set* -> ../../module-set/name +--ro datastore* [name] +--ro name ds:datastore-ref +--ro schema -> ../../schema/name Figure 2: YANG tree diagram for ietf-platform-manifest module Claise, et al. Expires 19 May 2027 [Page 11] Internet-Draft Telemetry Data Manifest November 2026 The YANG module contains a list of Platform Manifests (in 'platforms/ platform'), indexed by the identifier of the platform. That identifier should be defined by the network manager so that each platform emitting Network Telemetry has a unique identifier. There are several documents about managing the inventory of the network, e.g., [I-D.ietf-ivy-network-inventory-yang]. The platform identifier should be the same as the identifier used in inventories or the 'node-id' in [RFC8345]. As an example, the identifier could be the 'sysName' from [RFC3418]. Selecting the correct identifier out of the existing works in IETF is out of scope for this document. The scope of the "ietf-platform-manifest" module is the scope of the data collection, i.e., a given network, therefore it contains a collection of Platform Manifests, as opposed to the device scope, which would contain a single Platform Manifest. For a device-level implementation the same module is used, including a single entry in 'platforms/platform', corresponding to the local view of the network from the device point of view. The Platform Manifest platform details are provided via one or both of two optional feature sets. When the 'yang-catalog' feature is supported, the parameters ('name', 'vendor', 'vendor-pen', 'software- version', 'software-flavor', 'os-version', and 'os-type') are inspired from the YANG Catalog (reproduced in Appendix G) so that the YANG Catalog could be used to retrieve the YANG modules later. The vendor of the platform can be identified via its name 'vendor' or its PEN number 'vendor-pen', as described in [RFC9371]. When the 'ietf- system' feature is supported, the parameters are sourced from the RFC 7317 ietf-system module (system/contact, system/hostname, system/ location, and system-state/platform). An implementation of the 'ietf-platform-manifest' module MUST support at least one of the following features: * 'yang-catalog': provides platform details as defined in the YANG Catalog schema reproduced in Appendix G. * 'ietf-system': provides platform details sourced from the RFC 7317 ietf-system module (system/contact, system/hostname, system/ location, and system-state/platform). When both the 'yang-catalog' and 'ietf-system' features are supported, the 'os-version' leaf appears twice with distinct semantics: 'platforms/platform/os-version' conveys the YANG-Catalog- aligned operating-system version, whereas 'platforms/platform/system- state/platform/os-version' conveys the running system's operational version level as defined in [RFC7317]. These two values serve different purposes and are not expected to be identical. Claise, et al. Expires 19 May 2027 [Page 12] Internet-Draft Telemetry Data Manifest November 2026 More generally, when both feature sets are supported they describe overlapping aspects of the platform (notably its operating-system identity) using different leafs: the 'yang-catalog' leafs report YANG Catalog-aligned metadata, while the 'ietf-system' leafs report the running system's state per [RFC7317]. These are populated independently and are complementary rather than competing; no precedence is defined between them. The Platform Manifest also includes the contents of the YANG Library [RFC8525]. That module set is particularly useful to retrieve the YANG modules associated to a subscription by analyzing the xpath filters or the subtree filters. In XPath filters, the prefixes are by default YANG module names (see the description of the leaf 'stream-xpath-filter' in Section 4 of [RFC8639]). Subtree filters are based on namespaces. 5.2. "ietf-platform-manifest" YANG module This section defines the "ietf-platform-manifest" YANG module. file "ietf-platform-manifest@2026-10-24.yang" module ietf-platform-manifest { yang-version 1.1; namespace "urn:ietf:params:xml:ns:yang:ietf-platform-manifest"; prefix p-mf; import ietf-yang-library { prefix yanglib; reference "RFC 8525: YANG Library"; } import ietf-inet-types { prefix inet; reference "RFC 9911: Common YANG Data Types"; } organization "IETF OPSAWG (Operations and Management Area Working Group)"; contact "WG Web: WG List: Author: Benoit Claise Author: Jean Quilbeuf Author: Diego R. Lopez Author: Ignacio Dominguez Martinez-Casanueva Author: Thomas Graf "; Claise, et al. Expires 19 May 2027 [Page 13] Internet-Draft Telemetry Data Manifest November 2026 description "This module describes the platform information to be used as context of data collection from a given network element. The contents of this model must be streamed and stored along with the data streamed and stored from the network element so that the platform context of the data collection can be retrieved when the data is used for analysis. The data content of this model changes infrequently, but it can change during operation, for example the hostname, contact, location, licensing-related software flavor, or the set of supported schemas, and not only at a software upgrade or reboot. 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. An implementation of this module MUST support at least one of the features 'yang-catalog' or 'ietf-system'. Copyright (c) 2026 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). All revisions of IETF and IANA published modules can be found at the YANG Parameters registry group (https://www.iana.org/assignments/yang-parameters). This version of this YANG module is part of RFC XXXX; see the RFC itself for full legal notices."; revision 2026-10-24 { description "Initial revision"; reference "RFC XXXX: A Data Manifest for Contextualized Telemetry Data"; } feature yang-catalog { description Claise, et al. Expires 19 May 2027 [Page 14] Internet-Draft Telemetry Data Manifest November 2026 "The implementation provides platform details following the YANG Catalog conventions (name, vendor, vendor-pen, software-version, software-flavor, os-version, os-type)."; } feature ietf-system { description "The implementation provides platform details sourced from the RFC 7317 ietf-system system-state/platform container (os-name, os-release, os-version, machine)."; reference "RFC 7317: A YANG Data Model for System Management"; } grouping platform-yang-catalog { description "Platform details as stored in the YANG Catalog. Used when feature yang-catalog is supported."; leaf name { type string; description "Model of the platform from which data is collected."; } leaf vendor { type string; description "Organization that implements that platform."; } leaf vendor-pen { type uint32; description "Vendor's registered Private Enterprise Number"; reference "RFC 9371: Registration Procedures for Private Enterprise Numbers (PENs)"; } leaf software-version { type string; description "Name of the version of software. With respect to most network device appliances, this will be the operating system version. But for other YANG module implementation, this would be a version of appliance software. Ultimately, this should correspond to a version string that will be recognizable by the consumers of the platform."; } leaf software-flavor { type string; Claise, et al. Expires 19 May 2027 [Page 15] Internet-Draft Telemetry Data Manifest November 2026 description "A variation of a specific version where YANG model support may be different. Depending on the vendor, this could be a license, additional software component, or a feature set."; } leaf os-version { type string; description "Version of the operating system using this module. This is primarily useful if the software implementing the module is an application that requires a specific operating system version."; } leaf os-type { type string; description "Type of the operating system using this module. This is primarily useful if the software implementing the module is an application that requires a specific operating system type."; } } grouping platform-ietf-system { description "Platform details sourced from the RFC 7317 ietf-system module: system/contact, system/hostname, system/location, and system-state/platform."; reference "RFC 7317: A YANG Data Model for System Management"; container system { description "System group configuration."; reference "RFC 7317: A YANG Data Model for System Management, Section 3.1"; leaf contact { type string; description "The administrator contact information for the system."; reference "RFC 7317: A YANG Data Model for System Management, Section 3.1"; } leaf hostname { type inet:domain-name; description "The name of the host. This name can be a single domain Claise, et al. Expires 19 May 2027 [Page 16] Internet-Draft Telemetry Data Manifest November 2026 label or the fully qualified domain name of the host."; reference "RFC 7317: A YANG Data Model for System Management, Section 3.1"; } leaf location { type string; description "The system location."; reference "RFC 7317: A YANG Data Model for System Management, Section 3.1"; } } container system-state { config false; description "System group operational state."; reference "RFC 7317: A YANG Data Model for System Management, Section 3.1"; container platform { description "Contains vendor-specific information for identifying the system platform and operating system."; reference "RFC 7317: A YANG Data Model for System Management, Section 3.1"; leaf os-name { type string; description "The name of the operating system in use."; reference "RFC 7317: A YANG Data Model for System Management, Section 3.1"; } leaf os-release { type string; description "The current release level of the operating system."; reference "RFC 7317: A YANG Data Model for System Management, Section 3.1"; } leaf os-version { type string; description "The current version level within the release of the Claise, et al. Expires 19 May 2027 [Page 17] Internet-Draft Telemetry Data Manifest November 2026 operating system."; reference "RFC 7317: A YANG Data Model for System Management, Section 3.1"; } leaf machine { type string; description "A vendor-specific identifier string for the hardware of the managed device."; reference "RFC 7317: A YANG Data Model for System Management, Section 3.1"; } } } } container platforms { config false; description "Top container including all platforms in scope. If this model is hosted on a single device, it should contain a single entry in the list. At the network level, it should contain an entry for every monitored platform."; list platform { key "id"; description "Contains information about the platform that allows identifying and understanding the individual data collection information."; leaf id { type string; description "Identifies a given platform on the network, for instance the 'sysName' of the platform. The 'id' has to be unique within the network scope at every point in time. The same id can point to different platform if they are not simultaneously part of the network, e.g., when a device associated to a particular id is replaced."; } uses platform-yang-catalog { if-feature "yang-catalog"; } uses platform-ietf-system { if-feature "ietf-system"; } uses yanglib:yang-library-parameters; Claise, et al. Expires 19 May 2027 [Page 18] Internet-Draft Telemetry Data Manifest November 2026 } } } 6. Data Manifest and the Collected Data This section focuses on associating the collected data to the Data Manifest. As this document specifically focuses on giving context on data collected via Network Telemetry, it is assumed that a Network Telemetry system is available. Another premise of this document is the storage of the collected data into a database for later use. This document assumes that such a database exists and can be used for storing the Data Manifest. 6.1. Collecting the Data Manifest The Data Manifest MUST be streamed and stored along with the collected data so that the collected data can be interpreted correctly. If the collected data are moved to a different place (typically a database), the companion Data Manifest MUST follow the collected data. The Data Manifest MUST be updated when the Data Manifest information changes, for example, when a router is upgraded, when a new Network Telemetry subscription is configured, or when the Network Telemetry subscription parameters change. The Data Manifest can itself be considered as a time series, and stored similarly to the collected data. These requirements concern the information that is kept and its retrievability, not the design of the storage system: a time-series database, a relational database, or files all satisfy them if the manifest versions that applied to a datapoint can be retrieved as described in Section 6.2. A manifest regenerated from the current state of the platform does not satisfy them, since it would not reflect the context at collection time. This document recommends reusing existing Network Telemetry systems (in-band approach) to lower the efforts for implementing this approach. To enable a platform supporting Network Telemetry to also support the Data Manifest, this platform supports the model from Section 5 and, optionally, the non-normative example model from Appendix A. The collection of the Data Manifest MUST be explicitly configured by the collector by requesting the relevant subscriptions. These subscriptions MUST include the Platform Manifest. Where the Data Collection Manifest (the non-normative example model of Appendix A) is implemented, the collector also subscribes to it, possibly limited to the subscriptions for which the context needs to be retrieved later. Appendix D shows how the in-band approach would work while storing to a TSDB. Claise, et al. Expires 19 May 2027 [Page 19] Internet-Draft Telemetry Data Manifest November 2026 Each type of manifest has its own rough frequency of update: the Platform Manifest when the platform information it represents changes, and the Data Collection Manifest when a subscription is modified or when operational state such as "current-period" changes. The Data Manifest SHOULD be streamed with the YANG-Push on-change feature [RFC8641] (also called event-driven telemetry) whenever possible. Most of the Platform Manifest changes infrequently, but its contents can change during operation, for example the hostname, contact, location, licensing-related software flavor, or the set of supported schemas, and not only at a software upgrade or reboot. The Platform Manifest therefore needs to be re-collected whenever the information it represents changes, which the YANG-Push on-change feature makes possible, rather than relying on reboot detection alone. The collector MUST obtain a complete initial snapshot of the Platform Manifest and, where implemented, the relevant Data Collection Manifest before treating historical associations as definitive. An on-change YANG-Push subscription can provide this baseline using "sync-on-start" set to "true" [RFC8641]. Where on-change subscriptions are used to preserve exact manifest history, they should cover all relevant context changes, use a "dampening-period" of zero, and not exclude any change type (such as "replace" or "delete") that can alter the manifest. A publisher can accept an on-change subscription while supporting on-change for only some of the selected nodes [RFC8641]; changes to the other nodes are then not reported. If intermediate changes are unavailable, the affected history MUST be treated as incomplete. A reboot is not signalled by a "subscription-terminated" notification: the reasons listed in Section 2.7.3 of [RFC8639] do not include a reboot, and a rebooting publisher is not positioned to send one. A collector instead learns of a possible reboot when the transport session of a dynamic subscription is lost, or when a configured subscription is re-announced with a "subscription-started" notification (Section 2.7.1 of [RFC8639]). Following a platform restart or replacement, the collector MUST refresh the relevant manifests. Following transport reconnection, subscription resumption, or another collection discontinuity, it MUST likewise refresh them unless continuity of the relevant manifest history has been established, for example through the hostname and sequence number of [I-D.ietf-netconf-notif-envelope]. When an "incomplete-update" indication [RFC8641] or another loss of manifest history is detected, the collector MUST obtain a new complete baseline using a mechanism applicable to the subscription, Claise, et al. Expires 19 May 2027 [Page 20] Internet-Draft Telemetry Data Manifest November 2026 for example the "resync-subscription" RPC for an on-change subscription created with "establish-subscription" [RFC8641]. A new baseline restores knowledge of the current context; it does not, by itself, reconstruct missing historical changes. Datapoints in an unrecovered interval remain subject to the uncertainty rules in Section 6.2. Regarding the Data Collection Manifest, the elements common to all subscriptions, such as the stream definitions and the common filters, might be updated less frequently than the subscriptions. Relying on YANG-Push on-change feature enables keeping an up-to-date version of the Data Collection Manifest. The underlying storage system should accommodate the various rates at which different parts of the Data Manifest are updated. In particular, storing the Platform Manifest should be optimized to avoid duplicating repeated content and only storing a new version when there is a change in the manifest. 6.2. Mapping Collected Data to the Data Manifest As explained in the introduction, three elements are necessary to identify the Data Manifest associated to a datapoint: * the time at which the data was observed on the device, * the originating platform sending the data, and * the identifier of the subscription that produced the data. These elements can be either known to the collector, if it is the one configuring the collection, or retrieved via dedicated headers as proposed, e.g., in [I-D.ietf-netconf-notif-envelope]. The timestamp used here is the observation time, i.e., when the data was observed on the device, as distinct from the event time at which the update was emitted. To enable later retrieval of the Data Manifest associated to a datapoint, the collector MUST keep the subscription identifier, the platform identifier, and the observation timestamp in the metadata of the collected values. The collector MUST also retain the timestamps and continuity information needed to determine the applicability of stored manifest versions (for example, the hostname and sequence number of [I-D.ietf-netconf-notif-envelope]). Claise, et al. Expires 19 May 2027 [Page 21] Internet-Draft Telemetry Data Manifest November 2026 A manifest change has an effective time: the time at which the changed context became applicable to the collected data. This time needs to be expressed on a time base comparable with the datapoint observation timestamps. The notification emission time and the collector reception time should not be substituted for the effective time unless their equivalence has been established. When using [I-D.ietf-netconf-notif-envelope], a change reported after the subscription is established, for example to the hostname in the Platform Manifest, is carried in a "push-change-update" with "ietf- yp-observation:point-in-time" set to "state-changed"; this document uses its observation timestamp ("ietf-yp-observation:timestamp") as the effective time of that change. This is the time at which the change was observed, which can be later than the time at which it became effective. Changes with different effective times are best reported separately if their individual applicability is to be preserved. A dampening period combines the changes made within it into a single update record [RFC8641], so a subscription for which individual change times matter should not use one. An initial or resynchronization snapshot establishes a baseline. Its effective time is the time at which its state was observed or, for the initial snapshot of an on-change subscription with "sync-on- start" set to "true" carried with [I-D.ietf-netconf-notif-envelope], the time given by its "ietf-yp-observation:timestamp" with "ietf-yp- observation:point-in-time" set to "initial-state", as defined in that document. The collector should not infer that this baseline also applied before that time unless retained history establishes that applicability. For a datapoint observed at time T, the collector selects the Platform Manifest matching the platform identifier and, where implemented, the Data Collection Manifest matching both the platform and subscription identifiers. Within each applicable history, it selects the latest version whose effective time is at or before T. This association is definitive only when the collector has established a baseline and a complete relevant change history through T. Manifest updates can arrive after the datapoints they describe. The collector needs to accommodate such updates, either by deferring the association or by treating an existing association as provisional and revising it when necessary. Receipt of a datapoint, or the absence of a manifest update, does not establish that the manifest history is complete through the observation time of the datapoint. Claise, et al. Expires 19 May 2027 [Page 22] Internet-Draft Telemetry Data Manifest November 2026 Missing updates, unreported intermediate changes, or insufficient timestamp accuracy can prevent a unique association. In those cases, the collector MUST preserve an indication that the context is unknown or provisional, rather than presenting the last received manifest as definitively applicable. These indications are collector metadata; this document does not define their encoding. Platform and subscription identifiers are not necessarily unique over time: a subscription identifier may be reassigned to a new subscription, and a platform identifier, which identifies a role rather than a specific device (Section 7), may be taken over by a replacement device. A replacement platform or a newly created subscription using a previous identifier MUST NOT automatically inherit the previous instance's manifest history. When the collector learns that an identifier has been reused, it MUST record a new instance boundary and establish a fresh baseline for the relevant manifests, even if their contents are unchanged; the boundary does not require duplicating unchanged manifest content. Earlier history remains distinguishable from the new instance's history. How the collector learns of a reuse is deployment-specific: the (re-)establishment of the subscription (Section 6.1) is one signal, and an operational event such as a device replacement is another. A reuse that is not learned of is covered by the next paragraph. Like the other indications described above, the instance boundary is collector metadata, and this document does not define its encoding. Identifier and timestamp matching is sufficient only when the applicable instance and its validity interval can be determined unambiguously. If the transition time is unknown, or timestamps cannot distinguish the instances, the collector treats the affected datapoints as having unknown or provisional context, as described above. A fresh baseline is not assigned retrospectively to datapoints preceding its observation time without supporting history, even when its effective time is earlier. The reliability of the collection of the Data Manifest is the same as the reliability of the data collection itself, since the Data Manifest is like any other data. Claise, et al. Expires 19 May 2027 [Page 23] Internet-Draft Telemetry Data Manifest November 2026 7. Operational Considerations The Data Manifest is partially standardized in this document since only the Platform Manifest has a normative YANG module. Appendix A.1 explains why the Data Collection Manifest cannot be normative at the current time. In practice, the Data Collection Manifest might be difficult to implement due to the dependency on YANG Schema Mount and the lack of a normative YANG module. In that case, the solution proposed in the next paragraph covers the creation of the Data Collection Manifest. It is expected that the Data Manifest is streamed directly from the network equipment, along with YANG-Push [RFC8641] data. However, if the equipment Network Telemetry does not yet support the YANG modules from the Data Manifest specified in this document, the telemetry collector could populate the Data Manifest from available information collected from the platform. This latter option requires efforts on the Network Telemetry data collection side, as the information gathered in the Data Manifest proposed in this document could be scattered among various standard and vendor-specific YANG modules [RFC8199], that depend on the platform. The current approach relies on the hostname for identifying platforms, which identifies a role rather than a particular piece of hardware. As a consequence, there is no simple solution for obtaining the Data Manifest of a given piece of hardware reused for different roles in the same network. In general, the problem of having consistent metadata among various protocols is still an open problem as detailed in "An Update of Operators Requirements on Network Management Protocols and Modelling" [I-D.ietf-nmop-rfc3535-20years-later]. The requirement that an implementation support at least one of the 'yang-catalog' or 'ietf-system' features (Section 5.1) is a conformance requirement on implementations: YANG provides no way to mandate that at least one feature from a set be supported, so this constraint cannot be expressed in, or checked by, the schema. A module with neither feature enabled would still validate, but the resulting Platform Manifest conveys no platform details beyond the platform identifier, so implementations are expected to support at least one. 8. Security Considerations This section is modeled after the template described in Section 3.7.1 of [RFC9907]. Claise, et al. Expires 19 May 2027 [Page 24] Internet-Draft Telemetry Data Manifest November 2026 The YANG modules defined in this document are designed to be accessed via YANG-based management protocols, such as NETCONF [RFC6241] and RESTCONF [RFC8040]. These YANG-based management protocols (1) have to use a secure transport layer (e.g., Secure Shell (SSH) [RFC4252], TLS [RFC9846], and QUIC [RFC9000]) and (2) have to use mutual authentication. The Network Configuration Access Control Model (NACM) [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. All data nodes in these modules are read-only (config false), i.e., operational state in the sense of the Network Management Datastore Architecture [RFC8342]; the modules define no writable data nodes and no RPC or action operations. Some of the readable data nodes in the "ietf-platform-manifest" module may be considered sensitive or vulnerable in some network environments. It is thus important to control read access (e.g., via get or notification) to these data nodes. Specifically, the following subtrees and data nodes have particular sensitivities/ vulnerabilities: * platforms/platform contains details about the platform that an attacker could use to find the known vulnerabilities of the platform. Some of the readable data nodes in the "ietf-yp-current-period" module may be considered sensitive or vulnerable in some network environments. It is thus important to control read access (e.g., via get or notification) to these data nodes. Specifically, the following subtrees and data nodes have particular sensitivities/ vulnerabilities: * current-period exposes the actual data collection period, and hence the collection schedule. An attacker that learns when data is collected, and in particular when it is not, could time malicious activity to fall in the gaps between collections to reduce the likelihood of detection. Because this approach reuses an existing telemetry system, the additional exposure lies in the new content carried in the manifests. Read access to the module data nodes is controlled by NACM as described above. The manifests and the collected data are, however, typically also retained in downstream systems, such as a TSDB, whose access-control capabilities vary and may be coarse-grained or absent. The secure transport that protects the data in transit does not Claise, et al. Expires 19 May 2027 [Page 25] Internet-Draft Telemetry Data Manifest November 2026 extend to this retained copy. Operators should therefore store the manifests and the collected data only in systems able to enforce access control appropriate to the sensitivity of the data; where the storing system cannot, the data should be protected by compensating controls, such as restricting network and operator access to the store and encrypting the data at rest. Reporting only the metadata appropriate for the deployment (as discussed below) further limits this exposure. A telemetry system can usually be configured to report some of these metadata items and not others. Operators should expose only the metadata appropriate for their environment: where an item, such as the platform details or the collection period, would reveal information that is sensitive in a given deployment, the corresponding data node should not be reported. Integrity matters for all the information defined or used here (the Platform Manifest, the Data Collection Manifest, and the collected data they describe), both while in transit and while stored. Undetected modification can lead to incorrect interpretation of the data: an attacker could conceal activity by altering or removing context, or cause incorrect conclusions by making correct data appear anomalous. In transit, integrity is provided by the secure transport required above. For the stored copy, integrity and provenance can be protected by a signing mechanism such as [I-D.ietf-opsawg-yang-provenance] and/or by the integrity controls of the storing system. Operators should ensure that the stored manifests and collected data are integrity-protected. 9. IANA Considerations RFC Ed.: replace XXXX with actual RFC number and remove this note. IANA is requested to register the following URIs in the "ns" subregistry within the "IETF XML Registry" [RFC3688]: URI: urn:ietf:params:xml:ns:yang:ietf-platform-manifest Registrant Contact: The IESG. XML: N/A; the requested URI is an XML namespace. URI: urn:ietf:params:xml:ns:yang:ietf-yp-current-period Registrant Contact: The IESG. XML: N/A; the requested URI is an XML namespace. IANA is requested to register the following YANG modules in the "YANG Module Names" subregistry [RFC6020] within the "YANG Parameters" registry. Claise, et al. Expires 19 May 2027 [Page 26] Internet-Draft Telemetry Data Manifest November 2026 Name: ietf-platform-manifest Maintained by IANA? N Namespace: urn:ietf:params:xml:ns:yang:ietf-platform-manifest Prefix: p-mf Reference: RFC XXXX Name: ietf-yp-current-period Maintained by IANA? N Namespace: urn:ietf:params:xml:ns:yang:ietf-yp-current-period Prefix: yp-cp Reference: RFC XXXX 10. Normative References [RFC2119] Bradner, S., "Key words for use in RFCs to Indicate Requirement Levels", BCP 14, RFC 2119, DOI 10.17487/RFC2119, March 1997, . [RFC7317] Bierman, A. and M. Bjorklund, "A YANG Data Model for System Management", RFC 7317, DOI 10.17487/RFC7317, August 2014, . [RFC7950] Bjorklund, M., Ed., "The YANG 1.1 Data Modeling Language", RFC 7950, DOI 10.17487/RFC7950, August 2016, . [RFC8174] Leiba, B., "Ambiguity of Uppercase vs Lowercase in RFC 2119 Key Words", BCP 14, RFC 8174, DOI 10.17487/RFC8174, May 2017, . [RFC8341] Bierman, A. and M. Bjorklund, "Network Configuration Access Control Model", STD 91, RFC 8341, DOI 10.17487/RFC8341, March 2018, . [RFC8525] Bierman, A., Bjorklund, M., Schoenwaelder, J., Watsen, K., and R. Wilton, "YANG Library", RFC 8525, DOI 10.17487/RFC8525, March 2019, . [RFC8639] Voit, E., Clemm, A., Gonzalez Prieto, A., Nilsen-Nygaard, E., and A. Tripathy, "Subscription to YANG Notifications", RFC 8639, DOI 10.17487/RFC8639, September 2019, . Claise, et al. Expires 19 May 2027 [Page 27] Internet-Draft Telemetry Data Manifest November 2026 [RFC8641] Clemm, A. and E. Voit, "Subscription to YANG Notifications for Datastore Updates", RFC 8641, DOI 10.17487/RFC8641, September 2019, . [RFC9911] Schönwälder, J., Ed., "Common YANG Data Types", RFC 9911, DOI 10.17487/RFC9911, December 2025, . 11. Informative References [DataMesh] "Datamesh Architecture", . [DataMeshRA] van der Werf, D., Moreira, J., and J.P.S. Piest, "Towards a Data Mesh Reference Architecture", Enterprise Design, Operations, and Computing. EDOC 2024 Workshops, Lecture Notes in Business Information Processing, vol. 537, Springer, Cham, DOI 10.1007/978-3-031-79059-1_21, 2025, . [I-D.claise-netconf-metadata-for-collection] Claise, B., Nayyar, M., and A. R. Sesani, "Per-Node Capabilities for Optimum Operational Data Collection", Work in Progress, Internet-Draft, draft-claise-netconf- metadata-for-collection-03, 25 January 2022, . [I-D.ietf-ivy-network-inventory-yang] Yu, C., Belotti, S., Bouquier, J., Peruzzini, F., and P. Bedard, "A Base YANG Data Model for Network Inventory", Work in Progress, Internet-Draft, draft-ietf-ivy-network- inventory-yang-20, 29 September 2026, . [I-D.ietf-netconf-notif-envelope] Feng, A. H., Francois, P., Graf, T., and B. Claise, "Extensible YANG Model for YANG-Push Notifications", Work in Progress, Internet-Draft, draft-ietf-netconf-notif- envelope-07, 31 October 2026, . [I-D.ietf-nmop-rfc3535-20years-later] Boucadair, M., Contreras, L. M., de Dios, O. G., Graf, T., and R. Rahman, "An Update of Operators Requirements on Claise, et al. Expires 19 May 2027 [Page 28] Internet-Draft Telemetry Data Manifest November 2026 Network Management Protocols and Modelling", Work in Progress, Internet-Draft, draft-ietf-nmop-rfc3535-20years- later-05, 1 November 2026, . [I-D.ietf-opsawg-yang-provenance] Lopez, D., Pastor, A., Feng, A. H., Pérez, A. M., and H. Birkholz, "Applying COSE Signatures for YANG Data Provenance", Work in Progress, Internet-Draft, draft-ietf- opsawg-yang-provenance-08, 27 October 2026, . [I-D.kll-yang-label-tsdb] Larsson, K., "Mapping YANG Data to Label-Set Time Series", Work in Progress, Internet-Draft, draft-kll-yang-label- tsdb-00, 18 October 2023, . [RFC3418] Presuhn, R., Ed., "Management Information Base (MIB) for the Simple Network Management Protocol (SNMP)", STD 62, RFC 3418, DOI 10.17487/RFC3418, December 2002, . [RFC3688] Mealling, M., "The IETF XML Registry", BCP 81, RFC 3688, DOI 10.17487/RFC3688, January 2004, . [RFC4252] Ylonen, T. and C. Lonvick, Ed., "The Secure Shell (SSH) Authentication Protocol", RFC 4252, DOI 10.17487/RFC4252, January 2006, . [RFC6020] Bjorklund, M., Ed., "YANG - A Data Modeling Language for the Network Configuration Protocol (NETCONF)", RFC 6020, DOI 10.17487/RFC6020, October 2010, . [RFC6241] Enns, R., Ed., Bjorklund, M., Ed., Schoenwaelder, J., Ed., and A. Bierman, Ed., "Network Configuration Protocol (NETCONF)", RFC 6241, DOI 10.17487/RFC6241, June 2011, . [RFC7951] Lhotka, L., "JSON Encoding of Data Modeled with YANG", RFC 7951, DOI 10.17487/RFC7951, August 2016, . Claise, et al. Expires 19 May 2027 [Page 29] Internet-Draft Telemetry Data Manifest November 2026 [RFC8040] Bierman, A., Bjorklund, M., and K. Watsen, "RESTCONF Protocol", RFC 8040, DOI 10.17487/RFC8040, January 2017, . [RFC8199] Bogdanovic, D., Claise, B., and C. Moberg, "YANG Module Classification", RFC 8199, DOI 10.17487/RFC8199, July 2017, . [RFC8340] Bjorklund, M. and L. Berger, Ed., "YANG Tree Diagrams", BCP 215, RFC 8340, DOI 10.17487/RFC8340, March 2018, . [RFC8342] Bjorklund, M., Schoenwaelder, J., Shafer, P., Watsen, K., and R. Wilton, "Network Management Datastore Architecture (NMDA)", RFC 8342, DOI 10.17487/RFC8342, March 2018, . [RFC8343] Bjorklund, M., "A YANG Data Model for Interface Management", RFC 8343, DOI 10.17487/RFC8343, March 2018, . [RFC8345] Clemm, A., Medved, J., Varga, R., Bahadur, N., Ananthakrishnan, H., and X. Liu, "A YANG Data Model for Network Topologies", RFC 8345, DOI 10.17487/RFC8345, March 2018, . [RFC8528] Bjorklund, M. and L. Lhotka, "YANG Schema Mount", RFC 8528, DOI 10.17487/RFC8528, March 2019, . [RFC8792] Watsen, K., Auerswald, E., Farrel, A., and Q. Wu, "Handling Long Lines in Content of Internet-Drafts and RFCs", RFC 8792, DOI 10.17487/RFC8792, June 2020, . [RFC9000] Iyengar, J., Ed. and M. Thomson, Ed., "QUIC: A UDP-Based Multiplexed and Secure Transport", RFC 9000, DOI 10.17487/RFC9000, May 2021, . [RFC9196] Lengyel, B., Clemm, A., and B. Claise, "YANG Modules Describing Capabilities for Systems and Datastore Update Notifications", RFC 9196, DOI 10.17487/RFC9196, February 2022, . Claise, et al. Expires 19 May 2027 [Page 30] Internet-Draft Telemetry Data Manifest November 2026 [RFC9232] Song, H., Qin, F., Martinez-Julia, P., Ciavaglia, L., and A. Wang, "Network Telemetry Framework", RFC 9232, DOI 10.17487/RFC9232, May 2022, . [RFC9371] Baber, A. and P. Hoffman, "Registration Procedures for Private Enterprise Numbers (PENs)", RFC 9371, DOI 10.17487/RFC9371, March 2023, . [RFC9846] Rescorla, E., "The Transport Layer Security (TLS) Protocol Version 1.3", RFC 9846, DOI 10.17487/RFC9846, July 2026, . [RFC9907] Bierman, A., Boucadair, M., Ed., and Q. Wu, "Guidelines for Authors and Reviewers of Documents Containing YANG Data Models", BCP 216, RFC 9907, DOI 10.17487/RFC9907, March 2026, . [RFC9940] Davis, N., Ed., Farrel, A., Ed., Graf, T., Wu, Q., and C. Yu, "Some Key Terms for Network Fault and Problem Management", RFC 9940, DOI 10.17487/RFC9940, April 2026, . [yanglint] "Yanglint", . Appendix A. Data Collection Manifest This section is non-normative. A.1. Overview of the Model Figure 3 contains the YANG tree diagram [RFC8340] of the "example- collection-manifest" module. The module relies upon the YANG Schema mount [RFC8528] to reuse existing YANG modules describing the current data collection status. This module is an example, i.e. non- normative, as YANG Schema mount does not support design-time schema mount. Appendix E explains how the YANG tree is obtained. module: example-collection-manifest +--ro data-collections +--mp data-collection* [platform-id] +--ro platform-id -> /p-mf:platforms/p-mf:platform/p-mf:id +--ro streams/ | +--ro stream* [name] | +--ro name string | +--ro description? string +--ro filters/ Claise, et al. Expires 19 May 2027 [Page 31] Internet-Draft Telemetry Data Manifest November 2026 | +--ro stream-filter* [name] | | +--ro name string | | +--ro (filter-spec)? | | +--:(stream-subtree-filter) | | +--:(stream-xpath-filter) | | +--ro stream-xpath-filter? yang:xpath1.0 | | {xpath}? | +--ro selection-filter* [filter-id] | +--ro filter-id string | +--ro (filter-spec)? | +--:(datastore-subtree-filter) | +--:(datastore-xpath-filter) | +--ro datastore-xpath-filter? yang:xpath1.0 | {sn:xpath}? +--ro subscriptions/ +--ro subscription* [id] +--ro id subscription-id +--ro (target) | +--:(stream) | | +--ro (stream-filter)? | | | +--:(by-reference) | | | | +--ro stream-filter-name | | | | stream-filter-ref | | | +--:(within-subscription) | | | +--ro (filter-spec)? | | | +--:(stream-subtree-filter) | | | +--:(stream-xpath-filter) | | | +--ro stream-xpath-filter? | | | yang:xpath1.0 {xpath}? | | +--ro stream stream-ref | +--:(datastore) | +--ro datastore identityref | +--ro (selection-filter)? | +--:(by-reference) | | +--ro selection-filter-ref | | selection-filter-ref | +--:(within-subscription) | +--ro (filter-spec)? | +--:(datastore-subtree-filter) | +--:(datastore-xpath-filter) | +--ro datastore-xpath-filter? | yang:xpath1.0 {sn:xpath}? +--ro stop-time? yang:date-and-time +--ro encoding? encoding +--ro receivers | +--ro receiver* [name] | +--ro name string | +--ro sent-event-records? Claise, et al. Expires 19 May 2027 [Page 32] Internet-Draft Telemetry Data Manifest November 2026 | | yang:zero-based-counter64 | +--ro excluded-event-records? | | yang:zero-based-counter64 | +--ro state enumeration +--ro (update-trigger)? +--:(periodic) | +--ro periodic! | +--ro period centiseconds | +--ro anchor-time? yang:date-and-time | +--ro current-period? yp:centiseconds +--:(on-change) {on-change}? +--ro on-change! +--ro dampening-period? centiseconds +--ro sync-on-start? boolean +--ro excluded-change* change-type Figure 3: YANG tree diagram for example-collection-manifest module The 'data-collections' container contains the information related to each YANG-Push subscription. As for the Platform Manifest, these subscriptions are indexed by the 'platform-id', so that all subscriptions in the network can be represented at the network level without any conflict. As most of the information related to YANG-Push subscription [RFC8639] and [RFC8641] is stored in the "ietf-yang-push" module, these modules are mounted. These modules have a part common to all subscriptions of the platform, stored in the 'streams' and 'filters' containers. The information about subscriptions themselves are stored in the 'subscriptions/subscription' list, indexed by a subscription identifier. In the 'periodic' container of the subscription object, next to the configured 'period', the 'current-period' indicates the period currently used between two successive observations of the subscribed data. That leaf can therefore only be present when the subscription is periodic. The current period might differ from the configured period if the platform implements a mechanism to increase the collection period when it is overloaded. Having the current period information is crucial to understand if telemetry is missing because of a bug or a packet loss or simply because it was dynamically adjusted by the platform. Claise, et al. Expires 19 May 2027 [Page 33] Internet-Draft Telemetry Data Manifest November 2026 The 'current-period' data node is added by the module 'ietf-yp- current-period' presented in Section 4. This module augments the 'periodic' container that 'ietf-yang-push' adds to the subscription list from the module 'ietf-subscribed-notifications'. It is mounted as well via the YANG Schema Mount mechanism. The module for the Data Collection Manifest is presented in Appendix A.2. A.2. The "example-collection-manifest" YANG module This section includes the code of the "example-collection-manifest" YANG module. The extension data file for YANG schema mount is provided in Appendix E. The Data Collection Manifest should conform to the model obtained by combining these two specifications. module example-collection-manifest { yang-version 1.1; namespace "http://example.com/example-collection-manifest"; prefix ex-d-mf; import ietf-platform-manifest { prefix p-mf; reference "RFC XXXX: A Data Manifest for Contextualized Telemetry Data"; } import ietf-yang-schema-mount { prefix yangmnt; reference "RFC 8528: YANG Schema Mount"; } organization "IETF OPSAWG (Operations and Management Area Working Group)"; contact "WG Web: WG List: Author: Benoit Claise Author: Jean Quilbeuf Author: Diego R. Lopez Author: Ignacio Dominguez Martinez-Casanueva Author: Thomas Graf "; description "This module describes the context of data collection from a given network element. The contents of this model must be streamed along with the data streamed from the network element so that the context of the data collection can be retrieved later. Claise, et al. Expires 19 May 2027 [Page 34] Internet-Draft Telemetry Data Manifest November 2026 This module must be completed with ietf-platform-manifest to capture the whole context of a data collection session. Copyright (c) 2026 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). All revisions of IETF and IANA published modules can be found at the YANG Parameters registry group (https://www.iana.org/assignments/yang-parameters). This version of this YANG module is part of RFC XXXX; see the RFC itself for full legal notices."; revision 2026-10-24 { description "Initial revision"; reference "RFC XXXX: A Data Manifest for Contextualized Telemetry Data"; } container data-collections { config false; description "Contains the configuration and statistics for the collected data, per node in the network."; list data-collection { key "platform-id"; description "Defines the information for each collected object."; leaf platform-id { type leafref { path "/p-mf:platforms/p-mf:platform/p-mf:id"; } description "Identifier of the platform collecting the data. This identifier is the same as the one in the Platform Manifest."; } yangmnt:mount-point "yang-push-collection" { description "This mount point must mount the following modules and Claise, et al. Expires 19 May 2027 [Page 35] Internet-Draft Telemetry Data Manifest November 2026 their dependencies: * ietf-subscribed-notifications * ietf-yang-push * ietf-yp-current-period. This mount point must not mount any other modules."; reference "RFC 8639: Subscription to YANG Notifications RFC 8641: Subscription to YANG Notifications for datastore updates"; } } } } Appendix B. Changes between revisions This section is to be removed before publishing as an RFC. v16 -> v17 * address IESG feedback * Moved 'current-period' into the 'periodic' container (augment target changed, 'when' statement removed) * Clarified what 'current-period' reports and its relation to RFC 8641 (Section 4) * Added effective-time, baseline, late-update and uncertain-context rules (Section 6.2) * Added restart, resynchronization and identifier-reuse handling (Sections 6.1 and 6.2) * Strengthened the Security Considerations for stored data (access control, integrity) * Updated references: added RFC 7950, RFC 7951 and RFC 8342; RFC 8528 now informative; RFC 9846 replaces RFC 8446; draft-ietf- netconf-notif-envelope replaces draft-netana-netconf-notif- envelope * Appendix E now uses the RFC 9911 revisions of the common type modules * Updated the module revision dates to 2026-10-24 v15 -> v16 Claise, et al. Expires 19 May 2027 [Page 36] Internet-Draft Telemetry Data Manifest November 2026 * address the genart directorate review v14 -> v15 * address the YANG doctor and SecDir reviews v13 -> v14 * Removed duplicated text in the Security Considerations section v12 -> v13 * Section 6.1 MUST now applies only to the Platform Manifest * Removed the 1..1023 string length bounds * Noted the distinct semantics of the duplicated os-version leaf * Explained why a platform adjusts rather than rejects the collection (Section 4; superseded in v17) * Tightened the Data Manifest definition * Added no-writable-node/no-RPC statements to the Security Considerations * Noted that "at least one feature" is not schema-enforceable * Dropped the model-catalog reference from the yang-catalog feature * Security template reference updated to RFC 9907; transport aligned with its Section 3.7.1 (SSH now RFC 4252) * Fixed the example namespace mismatch (module vs YANG library) * Updated the provenance reference to draft-ietf-opsawg-yang- provenance * Editorial: module-name typo, RFC spacing, "concepts", mailto:, empty Contributors removed, example revision date v11 -> v12 * Moved the non-normative Data Collection Manifest to the appendix (Appendix A) * Clarified that the example is valid only when the 'yang-catalog' feature is enabled Claise, et al. Expires 19 May 2027 [Page 37] Internet-Draft Telemetry Data Manifest November 2026 v10 -> v11 * Added features 'yang-catalog' and 'ietf-system' to the Platform Manifest: platform details can be sourced from the YANG Catalog fields or the RFC 7317 ietf-system model, and at least one feature must be supported * Added RFC 7317 and RFC 9911 as normative references * Added the RFC 8174 key-words boilerplate to the ietf-platform- manifest module; updated the copyright year to 2026 * Updated the example v09 -> v10 * Address Mahesh comments v08 -> v09 * Removed unused ref, move 9232 to informational * Answer Joe's comments in Operational Consideration (which is re- renamed by the way) v07 -> v08 * Address comments from Thomas v06 -> v07 * Operational +(and management) considerations (draft-opsarea- rfc5706bis) * Make current period config false * Explicit that data collection is non-normative * Adjust security section to RFC8407bis new template * Other comments from Med v05 -> v06 * Example can be validated using yanglint * Applied details comments from Joe and Med Claise, et al. Expires 19 May 2027 [Page 38] Internet-Draft Telemetry Data Manifest November 2026 * Making the "current-period" update more generic and mentioning it in the introduction * Section 7 (previously 5) reworked to clarify how data manifest is collected and retrieved from a datapoint * Remove use of YANG schema mount for the platform manifest and change data collection manifest to example v04 -> v05 * Remove references to full-include draft, use schema mount. * Explain link with schema node id v03 -> v04 * State that data lineage is out of scope * Replace copy-pasted version of the modules with schema mount version, use full-embed for the "real" one * Schema mount version is the fallback plan if full:embed is not there fast enough. * Update examples accordingly v02 -> v03 * Explicit that modules are network (Controller) level * InfluxDB example changed to TSDB example aligned with [I-D.kll-yang-label-tsdb] * Minor edits i.e. network element -> platform , object -> data node v01 -> v02 * Updated example with latest version of the model. v00 (WG adoption) - v01 * Solve integrity issue by delegating to [I-D.ietf-opsawg-yang-provenance]. v05 -> v06 * Remove YANG packages Claise, et al. Expires 19 May 2027 [Page 39] Internet-Draft Telemetry Data Manifest November 2026 * Switch YANG models from device view to network view * Add PEN number to identify vendors * Intro rewritten with uses cases * Added an "Operational Considerations" section * Switch from MDT to YANG-push v04 -> v05 * First version of example scenario * Updated affiliation * Updated YANG module names to ietf-platform-manifest and ietf-data- collection-manifest * Unify used terms as defined in the terminology section * Replaced 'device' with 'platform' * Split Section 5 into two sections for better readibility v03 -> v04 * Fix xym error * Moved terminology after introduction * Clarified the role of the module v02 -> v03 * Add when clause in YANG model * Fix validation errors on YANG modules * Augment YANG library to handle semantic versioning v01 -> v02 * Alignment with YANGCatalog YANG module: name, vendor * Clarify the use of YANG instance file * Editorial improvements Claise, et al. Expires 19 May 2027 [Page 40] Internet-Draft Telemetry Data Manifest November 2026 v00 -> v01 * Adding more into data platform: yang packages, whole yanglib module to specify datastores * Setting the right type for periods: int64 -> uint64 * Specify the origin datastore for mdt subscription * Set both models to config false * Applying text comments from Mohamed Boucadair * Adding an example of data-manifest file * Adding rationale for reusing telemetry system for collection of the manifests * Export manifest with on-change telemetry as opposed to YANG instance file v00 * Initial version Appendix C. Example Figure 4 shows an example, encoded in JSON [RFC7951], of both a Platform Manifest and corresponding Data Collection Manifests. The list of YANG modules in the 'yang-library' container is kept empty for brevity. { "ietf-platform-manifest:platforms": { "platform": [ { "id": "PE1", "name": "PE1", "vendor": "ACME", "vendor-pen": 32473, "software-version": "3.14", "os-version": "2.79", "os-type": "ACME OS" } ] }, "example-collection-manifest:data-collections": { "data-collection": [ Claise, et al. Expires 19 May 2027 [Page 41] Internet-Draft Telemetry Data Manifest November 2026 { "platform-id": "PE1", "ietf-subscribed-notifications:subscriptions": { "subscription": [ { "id": 4242, "ietf-yang-push:datastore": "ietf-datastores:operational", "ietf-yang-push:datastore-xpath-filter": "/ietf-interfaces:interfaces/interface/enabled", "ietf-yang-push:on-change": {}, "receivers": { "receiver": [ { "name": "yp-collector", "state": "active" } ] } }, { "id": 4243, "ietf-yang-push:datastore": "ietf-datastores:operational", "ietf-yang-push:datastore-xpath-filter": "/ietf-interfaces:interfaces/interface/statistics/in-octets", "ietf-yang-push:periodic": { "period": 1000, "ietf-yp-current-period:current-period": 2000 }, "receivers": { "receiver": [ { "name": "yp-collector", "state": "active" } ] } } ] } } ] } } Figure 4: Example of Data Manifest Claise, et al. Expires 19 May 2027 [Page 42] Internet-Draft Telemetry Data Manifest November 2026 Figure 4 contains the Data Collection Manifest for two XPath subscriptions. With the Data Collection Manifest for the first one, with subscription identifier 4242, the exact semantics of the collected path, here the administrative status of the network interfaces, can be obtained by looking up the module in the yang- library of the corresponding Platform Manifest, to obtain the exact revision of ietf-interfaces used at collection time. Also, the "on- change" container indicates that data will be sent only if there is a change, thus not receiving data indicates that the administrative status of the interface did not change. The other example of a Data Collection Manifest, with subscription identifier 4243, shows how a periodic subscription is reported. In that example, the 'current-period' indicates that the configured period of 10s (1000 centiseconds) could not be attained and is now of 20s, for instance because the device is overloaded. Appendix F gives the command line for validating this example using [yanglint]. Appendix D. An Example Based on Model-Driven Telemetry In this example, the goal is to collect the administrative status and number of received bytes for the interfaces of a fictional ACME device, and store the result in a TSDB. The metrics are collected using YANG-Push, which is configured by specifying their XPaths and when they should be collected (periodically or on-change). More precisely, the Xpaths to collect are "/ietf- interfaces:interfaces/interface/enabled" on every change and "/ietf- interfaces:interfaces/interface/statistics/in-octets" every 10 seconds. The paths here are referring to the YANG module from [RFC8343]. The configuration of YANG-Push is out of scope for this document. Since they don't have the same trigger, each of the path must be collected in its own subscription. Figure 5 presents an example for such a collection. +------------+ +--------+ | MDT |--------------> | TSDB | | Collector | +--------+ +------------+ ^ | | +---------+ | Device | +---------+ Figure 5: Example of Collection From a Device to a TSDB Claise, et al. Expires 19 May 2027 [Page 43] Internet-Draft Telemetry Data Manifest November 2026 In the scenario depicted in Figure 5, the collector receives YANG- Push data from the device and stores it into a TSDB. This section first presents a version without Data Manifest and then how to enrich it with the Data Manifest. Examples rely on the notation from [I-D.kll-yang-label-tsdb] to represent how the data is stored in the TSDB. Without the Data Manifest, the result of the collection would be stored as showed in Figure 6. The "host" label indicates the devices from which the data is collected and the YANG keys are included as well. Here the interface "eth0" is enabled and received 1234 octets. In that case, the value is stored, without any way to know how the value was obtained. * Metric: interfaces_interface_enabled * Value: True * Labels: - host: "PE1" - interfaces_interface_name: "eth0" -- * Metric: interfaces_interface_statistics_in_octets * Value: 1234 * Labels: - host: "PE1" - interfaces_interface_name: "eth0" Figure 6: Storing Datapoints without Data Manifest An option for keeping the Data Manifest with the data is to store it directly into the TSDB. In that case, the collector can subscribe to the data exported by the module presented in this document and store it as other metrics. For the Platform Manifest, assuming the platform identifier is "PE1", the collector subscribes to the path "ietf-platform-manifest:platforms/platform[id=PE1]". For the Data Collection Manifests, the collector subscribes to the path "example- collection-manifest:data-collections/data-collection[platform- id="PE1"]/ietf-subscribed-notifications:subscriptions/ subscription[id=X]" where X is the subscription identifier of existing subscriptions. With the approach from [I-D.kll-yang-label-tsdb], the corresponding subtrees would be split into a set of datapoints, one per leaf. Figure 7 shows two examples of storing leafs in a TSDB. The first leaf is the vendor PEN number, which is part of the Platform Manifest. The second leaf is the Xpath filter used for subscription to the interface status. Claise, et al. Expires 19 May 2027 [Page 44] Internet-Draft Telemetry Data Manifest November 2026 * Metric: platforms_platform_vendor_pen * Value: 32473 * Labels: - host: "PE1" - platforms_platform_id: "PE1" -- * Metric: data_collections_data_collection_subscriptions_ subscription_datastore_xpath_filter * Value: "/ietf-interfaces:interfaces/interface/enabled" * Labels: - host: "PE1" - data_collections_data_collection_platform_id: "PE1" - data_collections_data_collection_subscriptions_ subscription_id: 4242 Figure 7: Example of storing Platform and Data Collection Manifest: Vendor PEN and Xpath filter. In the labels, the "host" might be different from the "platforms_platform_id" in case the collector is the one assembling it, i.e. for devices that do not support the Data Manifest. In that case, the value of this label could be the hostname of the collector. The host value does not matter for retrieving the Data Manifest as the platform identifier is the meaningful field. In this example, retrieving the Platform Manifest associated to a collected datapoint is done by looking for datapoints that have the label "platforms_platform_id" equal to the value of the host for that collected datapoint. In order to link a datapoint with the corresponding Data Collection Manifest, an additional label for the subscription identifier is required. For instance, the same datapoints as in Figure 6 could be stored as in Figure 8. * Metric: interfaces_interface_enabled * Value: True * Labels: - host: "PE1" - interfaces_interface_name: "eth0" - data_collections_data_collection_subscriptions_ subscription_id: 4242 -- * Metric: interfaces_interface_statistics_in_octets * Value: 1234 * Labels: - host: "PE1" - interfaces_interface_name: "eth0" - data_collections_data_collection_subscriptions_ subscription_id: 4243 Claise, et al. Expires 19 May 2027 [Page 45] Internet-Draft Telemetry Data Manifest November 2026 Figure 8: Storing datapoints with information to retrieve the Data Manifest From the "interfaces_interface_enabled" datapoint, one can retrieve the corresponding Data Collection Manifest by looking for datapoints whose subscription-id label equals 4242. Various optimizations could be done, such as relying on on-change subscription to modify only the leafs that changed. In that way, the amount of data needed for updating and storing the Data Manifest in the TSDB would be limited. Appendix E. Generating YANG Tree Diagrams This section provides the files needed to generate the YANG tree diagram [RFC8340] from Figure 3. The diagram was obtained using yanglint [yanglint] version 2.1.80, using the YANG Schema Mount [RFC8528]. It was manually edited to remove parts irrelevant to this document such as data nodes from imported modules, notifications and RPCs. In order to get a tree diagram involving YANG Schema Mount with yanglint, two data files are required, in addition to the YANG module, its dependencies and the YANG modules to be mounted. The first required file is the extension data, containing the YANG library to use at the mount point, this file is provided below as "data-collection-extension-data.xml". The second required file is the YANG library to use at the top-level context, this file is provided below as "data-collection-toplevel-yanglib.xml". Lines of these two files that are too long for this document are folded using the single backslash strategy of [RFC8792]; they need to be unfolded, for example with the "rfcfold" script of [RFC8792], before use. The following command was used to obtain the YANG tree diagram (before manual editing). yanglint -f tree \ -x data-collection-extension-data.xml \ -Y data-collection-toplevel-yanglib.xml \ example-collection-manifest@2026-10-24.yang file "data-collection-extension-data.xml" =============== NOTE: '\' line wrapping per RFC 8792 ================ mountee-set Claise, et al. Expires 19 May 2027 [Page 46] Internet-Draft Telemetry Data Manifest November 2026 ietf-subscribed-notifications 2019-09-09 urn:ietf:params:xml:ns:yang:ietf-subscribed-notific\ ations xpath ietf-yang-push 2019-09-09 urn:ietf:params:xml:ns:yang:ietf-yang-push on-change ietf-yp-current-period 2026-10-24 urn:ietf:params:xml:ns:yang:ietf-yp-current-period<\ /namespace> ietf-datastores 2018-02-14 urn:ietf:params:xml:ns:yang:ietf-datastores ietf-yang-library 2019-01-04 urn:ietf:params:xml:ns:yang:ietf-yang-library ietf-inet-types 2025-12-22 urn:ietf:params:xml:ns:yang:ietf-inet-types ietf-interfaces 2018-02-20 urn:ietf:params:xml:ns:yang:ietf-interfaces ietf-ip 2018-02-22 urn:ietf:params:xml:ns:yang:ietf-ip Claise, et al. Expires 19 May 2027 [Page 47] Internet-Draft Telemetry Data Manifest November 2026 ietf-netconf-acm 2018-02-14 urn:ietf:params:xml:ns:yang:ietf-netconf-acm ietf-network-instance 2019-01-21 urn:ietf:params:xml:ns:yang:ietf-network-instance ietf-restconf 2017-01-26 urn:ietf:params:xml:ns:yang:ietf-restconf ietf-yang-patch 2017-02-22 urn:ietf:params:xml:ns:yang:ietf-yang-patch ietf-yang-types 2025-12-22 urn:ietf:params:xml:ns:yang:ietf-yang-types test-schema mountee-set ds:running test-schema ds:operational test-schema 2 2 Claise, et al. Expires 19 May 2027 [Page 48] Internet-Draft Telemetry Data Manifest November 2026 example-collection-manifest file "data-collection-toplevel-yanglib.xml" =============== NOTE: '\' line wrapping per RFC 8792 ================ main-set ietf-datastores 2018-02-14 urn:ietf:params:xml:ns:yang:ietf-datastores ietf-yang-library 2019-01-04 urn:ietf:params:xml:ns:yang:ietf-yang-library\ ietf-yang-schema-mount 2019-01-14 urn:ietf:params:xml:ns:yang:ietf-yang-schema-\ mount example-collection-manifest 2026-10-24 http://example.com/example-collection-manifes\ t ietf-platform-manifest 2026-10-24 urn:ietf:params:xml:ns:yang:ietf-platform-man\ ifest yang-catalog Claise, et al. Expires 19 May 2027 [Page 49] Internet-Draft Telemetry Data Manifest November 2026 ietf-inet-types 2025-12-22 urn:ietf:params:xml:ns:yang:ietf-inet-types ietf-yang-types 2025-12-22 urn:ietf:params:xml:ns:yang:ietf-yang-types main-schema main-set ds:running main-schema ds:operational main-schema 1 2 Appendix F. Validating the Example This section provides the command line for validating the example in Figure 4 using [yanglint]. The files "data-collection-extension- data.xml" and "data-collection-toplevel-yanglib.xml" are provided in the previous section; unfold them as described there before use. The file "manifests-example.json" is the one from Figure 4. The Platform Manifest in this example uses the leafs defined under the 'yang-catalog' feature ('name', 'vendor', 'vendor-pen', 'software-version', 'os-version', and 'os-type'). The example is therefore valid only when the 'ietf-platform-manifest' module is implemented with the 'yang-catalog' feature enabled. Claise, et al. Expires 19 May 2027 [Page 50] Internet-Draft Telemetry Data Manifest November 2026 yanglint -e -x data-collection-extension-data.xml \ -Y data-collection-toplevel-yanglib.xml \ manifests-example.json Appendix G. YANG Catalog Module To keep this document self-contained and to pin a specific version, this appendix reproduces the YANG Catalog module from which the "yang-catalog" feature leafs are inspired. Long lines of the original module have been re-wrapped to fit the line length of this document, using YANG string concatenation for the "pattern" and "path" statements; this does not change the meaning of the module. file "yang-catalog@2018-04-03.yang" module yang-catalog { yang-version 1.1; namespace "urn:ietf:params:xml:ns:yang:yang-catalog"; prefix yc; import ietf-yang-types { prefix yang; } import ietf-yang-library { prefix yanglib; } import ietf-inet-types { prefix inet; } organization "yangcatalog.org"; contact "Benoit Claise Joe Clarke "; description "This module contains metadata pertinent to each YANG module, as well as a list of vendor implementations for each module. The structure is laid out in such a way as to make it possible to locate metadata and vendor implementation on a per-module basis as well as obtain a list of available modules for a given vendor's platform and specific software release."; revision 2018-04-03 { description "Bump the YANG version number to 1.1 for the deref XPath function."; reference "YANG Catalog "; Claise, et al. Expires 19 May 2027 [Page 51] Internet-Draft Telemetry Data Manifest November 2026 } revision 2018-01-23 { description "* Add leafs to track expire modules * Correct a bug with leafref dereferencing"; reference "YANG Catalog "; } revision 2017-09-26 { description "* Add leafs for tracking dependencies and dependents * Simplify the generated-from enumerated values * Refine the type for compilation-result to be an inet:uri * Add leafs for semantic versioning"; reference "YANG Catalog "; } revision 2017-08-18 { description "* Reorder organization to be with the other module keys * Add a belongs-to leaf to track a submodule's parent"; reference "YANG Catalog "; } revision 2017-07-28 { description "* Revert config false nodes as we need to be able to set these via * Make conformance-type optional as not all vendors implement yang-library * Re-add the path typedef"; reference "YANG Catalog "; } revision 2017-07-26 { description "A number of improvements based on YANG Doctor review: * Remove references to 'server' in leafs describing YANG data * Fold the augmentation module leafs directly under /catalog/modules/module * Use identities for protocols instead of an emumeration * Make some extractable fields 'config false' * Fix various types * Normalize enums to be lowercase * Add a leaf for module-classification * Change yang-version to be an enum * Add module conformance, deviation and feature leafs under the implementation branches"; reference "YANG Catalog "; Claise, et al. Expires 19 May 2027 [Page 52] Internet-Draft Telemetry Data Manifest November 2026 } revision 2017-07-14 { description "Modularize some of the leafs and create typedefs so they can be shared between the API input modules."; reference "YANG Catalog "; } revision 2017-07-03 { description "Initial revision."; reference " YANG Catalog "; } /* * Identities */ identity protocol { description "Abstract base identity for a YANG-based protocol."; } identity netconf { base protocol; description "Protocol identity for NETCONF as described in RFC 6241."; } identity restconf { base protocol; description "Protocol identity for RESTCONF as described in RFC 8040."; } typedef email-address { type string { pattern "[a-zA-Z0-9.!#$%&'*+/=?^_`{|}~-]+@" + "[a-zA-Z0-9-]+([.][a-zA-Z0-9-]+)*"; } description "This type represents a string with an email address."; } /* * Typedefs */ Claise, et al. Expires 19 May 2027 [Page 53] Internet-Draft Telemetry Data Manifest November 2026 typedef path { type string { pattern '([A-Za-z]:|[\w-]+(\.[\w-]+)*)?(([/\\][\w@.-]+)+)'; } description "This type represents a string with path to the file."; } typedef semver { type string { pattern '[0-9]+\.[0-9]+\.[0-9]+'; } description "A semantic version in the format of x.y.z, where: x = the major version number y = the minor version number z = the patch version number Changes to the major version number denote backwards-incompatible changes between two revisions of the same module. Changes to the minor version number indicate there have been new backwards-compatible features introduced in the later version of a module. Changes to the patch version indicate bug fixes between two versions of a module."; reference "Semantic Versioning 2.0.0 "; } container catalog { description "Root container of yang-catalog holding two main branches - modules and vendors. The modules sub-tree contains all the modules in the catalog and all of their metadata with their implementations. The vendor sub-tree holds modules for specific vendors, platforms, software-versions, and software-flavors. It contains reference to a name and revision of the module in order to reference the module's full set of metadata."; container modules { description "Container holding the list of modules"; list module { key "name revision organization"; description Claise, et al. Expires 19 May 2027 [Page 54] Internet-Draft Telemetry Data Manifest November 2026 "Each entry represents one revision of one module for one organization."; uses yang-lib-common-leafs; leaf organization { type string; description "This statement defines the party responsible for this module. The argument is a string that is used to specify a textual description of the organization(s) under whose auspices this module was developed."; } uses organization-specific-metadata; leaf namespace { type inet:uri; mandatory true; description "The XML namespace identifier for this module."; } uses yang-lib-schema-leaf; uses catalog-module-metadata; list submodule { key "name revision"; description "Each entry represents one submodule within the parent module."; uses yang-lib-common-leafs; uses yang-lib-schema-leaf; } list dependencies { key "name"; description "Each entry represents one dependency."; uses yang-lib-common-leafs; uses yang-lib-schema-leaf; } list dependents { key "name"; description "Each entry represents one dependent."; uses yang-lib-common-leafs; uses yang-lib-schema-leaf; } leaf semantic-version { type yc:semver; description "The formal semantic version of a module as provided by the module itself. If the module does not provide a semantic version, this leaf will not be specified."; Claise, et al. Expires 19 May 2027 [Page 55] Internet-Draft Telemetry Data Manifest November 2026 } leaf derived-semantic-version { type yc:semver; description "The semantic version of a module as compared to other revisions of the same module. This value is computed algorithmically by ordering all revisions of a given module and comparing them to look for backwards incompatible changes."; } container implementations { description "Container holding lists of per-module implementation details."; list implementation { key "vendor platform software-version software-flavor"; description "List of module implementations."; leaf vendor { type string; description "Organization that implements this module."; } leaf platform { type string; description "Platform on which this module is implemented."; } leaf software-version { type string; description "Name of the version of software. With respect to most network device appliances, this will be the operating system version. But for other YANG module implementation, this would be a version of appliance software. Ultimately, this should correspond to a version string that will be recognizable by the consumers of the platform."; } leaf software-flavor { type string; description "A variation of a specific version where YANG model support may be different. Depending on the vendor, this could be a license, additional software component, or a feature set."; } uses shared-implementation-leafs; Claise, et al. Expires 19 May 2027 [Page 56] Internet-Draft Telemetry Data Manifest November 2026 uses yang-lib-implementation-leafs; } } } } container vendors { description "Container holding lists of organizations that publish YANG modules."; list vendor { key "name"; description "List of organizations publishing YANG modules."; leaf name { type string; description "Name of the maintaining organization -- the name should be supplied in the official format used by the organization. Standards Body examples: IETF, IEEE, MEF, ONF, etc. Commercial entity examples: AT&T, Facebook, Name of industry forum examples: OpenConfig, OpenDaylight, ON.Lab"; } container platforms { description "Container holding list of platforms."; list platform { key "name"; description "List of platforms under specific vendor"; leaf name { type string; description "Name of the platform"; } container software-versions { description "Container holding list of versions of software versions."; list software-version { key "name"; description "List of version of software versions under specific vendor, platform."; leaf name { Claise, et al. Expires 19 May 2027 [Page 57] Internet-Draft Telemetry Data Manifest November 2026 type string; description "Name of the version of software. With respect to most network device appliances, this will be the operating system version. But for other YANG module implementation, this would be a version of appliance software. Ultimately, this should correspond to a version string that will be recognizable by the consumers of the platform."; } container software-flavors { description "Container holding list of software flavors."; list software-flavor { key "name"; description "List of software flavors under specific vendor, platform, software-version."; leaf name { type string; description "A variation of a specific version where YANG model support may be different. Depending on the vendor, this could be a license, additional software component, or a feature set."; } container protocols { description "List of the protocols"; list protocol { key "name"; description "YANG-based protocol that is used on the device. New identities are expected to be added to address other YANG-based protocols."; leaf name { type identityref { base yc:protocol; } description "Identity of the YANG-based protocol that is supported."; } leaf-list protocol-version { type string; description Claise, et al. Expires 19 May 2027 [Page 58] Internet-Draft Telemetry Data Manifest November 2026 "Version of the specific protocol."; } leaf-list capabilities { type string; description "Listed name of capabilities that are supported by the specific device."; } } } container modules { description "Container holding list of modules."; list module { key "name revision organization"; description "List of references to YANG modules under specific vendor, platform, software-version, software-flavor. Using these references, the complete set of metadata can be retrieved for each module."; leaf name { type leafref { path "/catalog/modules/module/name"; } description "Reference to a name of the module that is contained in specific vendor, platform, software-version, software-flavor."; } leaf revision { type leafref { path "deref(../name)/../revision"; } description "Reference to a revision of the module that is contained in specific vendor, platform, software-version, software-flavor."; } leaf organization { type leafref { path "deref(../revision)/../" + "organization"; } description Claise, et al. Expires 19 May 2027 [Page 59] Internet-Draft Telemetry Data Manifest November 2026 "Reference to the authoring organization of the module for the implemented module."; } uses shared-implementation-leafs; uses yang-lib-implementation-leafs; } } } } } } } } } } } grouping catalog-module-metadata { uses shared-module-leafs; leaf compilation-status { type enumeration { enum passed { description "All compilers were able to compile this YANG module without any errors or warnings."; } enum passed-with-warnings { description "All compilers were able to compile this YANG module without any errors, but at least one of them caught a warning."; } enum failed { description "At least one of compilers found an error while compiling this YANG module."; } enum pending { description "The module was just added to the catalog and compilation testing is still in progress."; } enum unknown { description "There is not sufficient information about compilation status. This Could mean compilation crashed causing it not to complete fully."; Claise, et al. Expires 19 May 2027 [Page 60] Internet-Draft Telemetry Data Manifest November 2026 } } description "Status of the module, whether it was possible to compile this YANG module or there are still some errors/warnings."; } leaf compilation-result { type inet:uri; description "Link to the result of the compilation explaining specifically what error or warning occurred. This is not existing if compilation status is PASSED."; } leaf prefix { type string; description "Statement of yang that is used to define the prefix associated with the module and its namespace. The prefix statement's argument is the prefix string that is used as a prefix to access a module. The prefix string MAY be used to refer to definitions contained in the module, e.g., if:ifName."; } leaf yang-version { type enumeration { enum 1.0 { description "YANG version 1.0 as defined in RFC 6020."; } enum 1.1 { description "YANG version 1.1 as defined in RFC 7950."; } } description "The optional yang-version statement specifies which version of the YANG language was used in developing the module."; } leaf description { type string; description "This statement takes as an argument a string that contains a human-readable textual description of this definition. The text is provided in a language (or languages) chosen by the module developer; for the sake of interoperability, it is RECOMMENDED to choose a language that is widely understood among the community of network administrators who will use the module."; Claise, et al. Expires 19 May 2027 [Page 61] Internet-Draft Telemetry Data Manifest November 2026 } leaf contact { type string; description "This statement provides contact information for the module. The argument is a string that is used to specify contact information for the person or persons to whom technical queries concerning this module should be sent, such as their name, postal address, telephone number, and electronic mail address."; } leaf module-type { type enumeration { enum module { description "If YANG file contains module."; } enum submodule { description "If YANG file contains sub-module."; } } description "Whether a file contains a YANG module or sub-module."; } leaf belongs-to { when "../module-type = 'submodule'" { description "Include the module's parent when it is a submodule."; } type yang:yang-identifier; description "Name of the module that includes this submodule."; } leaf tree-type { type enumeration { enum split { description "This module uses a split config/operational state layout."; } enum nmda-compatible { description "This module is compatible with the Network Management Datastores Architecture (NMDA) and combines config and operational state nodes."; } enum transitional-extra { Claise, et al. Expires 19 May 2027 [Page 62] Internet-Draft Telemetry Data Manifest November 2026 description "This module is derived as a '-state' module to allow for transitioning to a full NMDA-compliant tree structure."; } enum openconfig { description "This module uses the Openconfig data element layout."; } enum unclassified { description "This module does not belong to any category or can't be determined."; } enum not-applicable { description "This module is not applicable. For example, because the YANG module only contains typedefs, groupings, or is a submodule"; } } description "The type of data element tree used by the module as it relates to the Network Management Datastores Architecture."; reference "draft-dsdt-nmda-guidelines Guidelines for YANG Module Authors (NMDA)"; } leaf yang-tree { when "../module-type = 'module'"; type inet:uri; description "This leaf provides a URI that points to the ASCII tree format of the module in draft-ietf-netmod-yang-tree-diagrams format."; reference "See draft-ietf-netmod-yang-tree-diagrams."; } leaf expires { type yang:date-and-time; description "Date and time of when this module expires (if it expires). This will typically be used for modules that have not been fully ratified."; } leaf expired { type union { type boolean; type enumeration { enum not-applicable { description Claise, et al. Expires 19 May 2027 [Page 63] Internet-Draft Telemetry Data Manifest November 2026 "This module is not and will not be expired."; } } } default "false"; description "Whether or not this module has expired. If the current date is beyond the expires date, then expired should be true."; } description "Grouping of YANG module metadata that extends the common list defined in the YANG Module Library (RFC 7895)."; } grouping organization-specific-metadata { container ietf { when "../organization = 'ietf'" { description "Include this container specific metadata of the IETF."; } leaf ietf-wg { type string; description "Working group that authored the document containing this module."; } description "Include this container for the IETF-specific organization metadata."; } description "Any organization that has some specific metadata of the yang module and want them add to the yang-catalog, should augment this grouping. This grouping is for any metadata that can`t be used for every yang module."; } grouping yang-lib-common-leafs { leaf name { type yang:yang-identifier; description "The YANG module or submodule name."; } leaf revision { type union { type yanglib:revision-identifier; type string { length "0"; Claise, et al. Expires 19 May 2027 [Page 64] Internet-Draft Telemetry Data Manifest November 2026 } } description "The YANG module or submodule revision date. A zero-length string is used if no revision statement is present in the YANG module or submodule."; } description "The YANG module or submodule revision date. A zero-length string is used if no revision statement is present in the YANG module or submodule."; reference "RFC7895 YANG Module Library : common-leafs grouping"; } grouping yang-lib-schema-leaf { leaf schema { type inet:uri; description "Contains a URL that represents the YANG schema resource for this module or submodule. This leaf will only be present if there is a URL available for retrieval of the schema for this entry."; } description "These are a subset of leafs from the yang-library (RFC 7895) that provide some extractable fields for catalog modules. The module-list grouping cannot be used from yang-library as modules themselves cannot have conformance without a server."; reference "RFC7895 YANG Module Library : schema-leaf grouping"; } grouping yang-lib-implementation-leafs { leaf-list feature { type yang:yang-identifier; description "List of YANG feature names from this module that are supported by the server, regardless of whether they are defined in the module or any included submodule."; } list deviation { key "name revision"; description "List of YANG deviation module names and revisions used by this server to modify the conformance of the module associated with this entry. Note that the same module can be used for deviations for multiple modules, so the same entry MAY appear within multiple 'module' entries. Claise, et al. Expires 19 May 2027 [Page 65] Internet-Draft Telemetry Data Manifest November 2026 The deviation module MUST be present in the 'module' list, with the same name and revision values. The 'conformance-type' value will be 'implement' for the deviation module."; uses yang-lib-common-leafs; } leaf conformance-type { type enumeration { enum implement { description "Indicates that the server implements one or more protocol-accessible objects defined in the YANG module identified in this entry. This includes deviation statements defined in the module. For YANG version 1.1 modules, there is at most one module entry with conformance type 'implement' for a particular module name, since YANG 1.1 requires that, at most, one revision of a module is implemented. For YANG version 1 modules, there SHOULD NOT be more than one module entry for a particular module name."; } enum import { description "Indicates that the server imports reusable definitions from the specified revision of the module but does not implement any protocol-accessible objects from this revision. Multiple module entries for the same module name MAY exist. This can occur if multiple modules import the same module but specify different revision dates in the import statements."; } } // Removing the mandatory true for now as not all vendors may // have this information if they do not implement yang-library. // mandatory true; description "Indicates the type of conformance the server is claiming for the YANG module identified by this entry."; } description "This is a set of leafs extracted from the yang-library that are specific to server implementations."; reference "RFC7895 YANG Module Library : module-list grouping"; } grouping shared-implementation-leafs { leaf os-version { Claise, et al. Expires 19 May 2027 [Page 66] Internet-Draft Telemetry Data Manifest November 2026 type string; description "Version of the operating system using this module. This is primarily useful if the software implementing the module is an application that requires a specific operating system."; } leaf feature-set { type string; description "An optional feature of the software that is required in order to implement this module. Some form of this must be incorporated in software-version or software-flavor, but can be broken out here for additional clarity."; } leaf os-type { type string; description "Type of the operating system using this module. This is primarily useful if the software implementing the module is an application that requires a specific operating system."; } description "Grouping of non-key leafs to be used in the module and vendor sub-trees."; } grouping shared-module-leafs { leaf generated-from { type enumeration { enum mib { description "Module generated from Structure of Management Information (SMI) MIB per RFC6643."; } enum not-applicable { description "Module was not generated but it was authored manually."; } enum native { description "Module generated from platform internal, proprietary structure, or code."; } } default "not-applicable"; description "This statement defines weather the module was generated or not. Default value is set to not-applicable, which means Claise, et al. Expires 19 May 2027 [Page 67] Internet-Draft Telemetry Data Manifest November 2026 that module was created manualy and not generated."; } leaf maturity-level { type enumeration { enum ratified { description "Maturity of a module that is fully approved (e.g., a standard)."; } enum adopted { description "Maturity of a module that is actively being developed by a organization towards ratification."; } enum initial { description "Maturity of a module that has been initially created, but has no official organization-level status."; } enum not-applicable { description "The maturity level is not used for vendor-supplied models, and thus all vendor modules will have a maturity of not-applicable"; } } description "The current maturity of the module with respect to the body that created it. This allows one to understand where the module is in its overall life cycle."; } leaf document-name { type string; description "The name of the document from which the module was extracted or taken; or that provides additional context about the module."; } leaf author-email { type yc:email-address; description "Contact email of the author who is responsible for this module."; } leaf reference { type inet:uri; description "A string that is used to specify a textual cross-reference Claise, et al. Expires 19 May 2027 [Page 68] Internet-Draft Telemetry Data Manifest November 2026 to an external document, either another module that defines related management information, or a document that provides additional information relevant to this definition."; } leaf module-classification { type enumeration { enum network-service { description "Network Service YANG Module that describes the configuration, state data, operations, and notifications of abstract representations of services implemented on one or multiple network elements."; } enum network-element { description "Network Element YANG Module that describes the configuration, state data, operations, and notifications of specific device-centric technologies or features."; } enum unknown { description "In case that there is not sufficient information about how to classify the module."; } enum not-applicable { description "The YANG module abstraction type is neither a Network Service YANG Module nor a Network Element YANG Module."; } } mandatory true; description "The high-level classification of the given YANG module."; reference "RFC8199 YANG Module Classification"; } description "These leafs are shared among the yang-catalog and its API."; } grouping online-source-file { leaf owner { type string; mandatory true; description "Username or ID of the owner of the version control system repository."; } leaf repository { Claise, et al. Expires 19 May 2027 [Page 69] Internet-Draft Telemetry Data Manifest November 2026 type string; mandatory true; description "The name of the repository."; } leaf path { type yc:path; mandatory true; description "Location within the repository of the module file."; } leaf branch { type string; description "Revision control system branch or tag to use to find the module. If this is not specified, the head of the repository is used."; } description "Networked version control system location of the module file."; } } Acknowledgements Thanks to Mohamed Boucadair, Tianran Zhou, Jan Lindblad, Ahmed Elhassany, Joe Clarke, Alex Huang Fang, Zhuoyao Lin, Quifang Ma, Paul Aitken, Mahesh Jethanandani, Elwyn Davies, Hilarie Orman, Susan Hares, Roman Danyliw, Gunter Van de Velde, Deb Cooley, Ketan Talaulikar, Éric Vyncke, Mike Bishop, and Christopher Inacio for their reviews and comments. Authors' Addresses Benoit Claise Everything OPS & Arrcus Belgium Email: benoit@everything-ops.net Jean Quilbeuf Huawei Email: jean.quilbeuf@huawei.com Claise, et al. Expires 19 May 2027 [Page 70] Internet-Draft Telemetry Data Manifest November 2026 Diego R. Lopez Telefonica I+D Don Ramon de la Cruz, 82 Madrid 28006 Spain Email: diego.r.lopez@telefonica.com Ignacio Dominguez Martinez-Casanueva Telefonica Ronda de la Comunicacion, S/N 28050 Madrid Spain Email: i.domingumar@gmail.com Thomas Graf Swisscom Binzring 17 CH-8045 Zurich Switzerland Email: thomas.graf@swisscom.com Claise, et al. Expires 19 May 2027 [Page 71]