green R. Xiong Internet-Draft C. Liu Intended status: Standards Track Y. Guo Expires: 19 April 2025 China Unicom 16 October 2024 A YANG Data Model for Host Power Monitoring draft-xiong-green-host-power-monitoring-yang-00 Abstract This document will build a hierarchical YANG data model of SDN controller/management platform, router/switch and host to monitor the energy consumption of network devices and servers. SDN controller/ management platform obtains data from routers/switches, and routers/ switches obtain data from hosts. Therefore, in the overall hierarchical structure, the SDN controller/management platform directly obtains energy consumption data of all routers/switches, and indirectly obtains the specific energy consumption data of all hosts through routers/switches. 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." This Internet-Draft will expire on 19 April 2025. Copyright Notice Copyright (c) 2024 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 Xiong, et al. Expires 19 April 2025 [Page 1] Internet-Draft YANG Host Power Monitoring October 2024 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 . . . . . . . . . . . . . . . . . . . . . . . . 2 1.1. Requirement Language . . . . . . . . . . . . . . . . . . 3 2. Model Structure . . . . . . . . . . . . . . . . . . . . . . . 3 2.1. Basic Elements and Layers . . . . . . . . . . . . . . . . 3 2.2. Relationship Between Layers . . . . . . . . . . . . . . . 3 2.3. Hierarchy Representation . . . . . . . . . . . . . . . . 4 3. YANG Data Model . . . . . . . . . . . . . . . . . . . . . . . 4 3.1. Tree Diagram . . . . . . . . . . . . . . . . . . . . . . 4 3.2. YANG Model . . . . . . . . . . . . . . . . . . . . . . . 4 4. Security Considerations . . . . . . . . . . . . . . . . . . . 5 5. IANA Considerations . . . . . . . . . . . . . . . . . . . . . 6 6. Normative References . . . . . . . . . . . . . . . . . . . . 6 Authors' Addresses . . . . . . . . . . . . . . . . . . . . . . . 6 1. Introduction In the era of computing power, the energy consumption of data centers has increased exponentially, which is mainly reflected in IT equipment. IT equipments account for 45% of the overall energy consumption of data centers, of which hosts account for about 50%, storage systems account for about 35%, and network devices account for about 15%. Therefore, it is particularly important to focus on the energy consumption of network devices and hosts. This document will build a hierarchical YANG data model of SDN controller/management platform, router/switch and host to monitor the energy consumption of network devices and servers. SDN controller/ management platform obtains data from routers/switches, and routers/ switches obtain data from hosts. Therefore, in the overall hierarchical structure, the SDN controller/management platform directly obtains energy consumption data of all routers/switches, and indirectly obtains the specific energy consumption data of all hosts through routers/switches. Xiong, et al. Expires 19 April 2025 [Page 2] Internet-Draft YANG Host Power Monitoring October 2024 1.1. Requirement Language 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. These words may also appear in this document in lower case as plain English words, absent their normative meanings. 2. Model Structure 2.1. Basic Elements and Layers Layer 1: SDN controller/management platform SDN controller/management platform send requests to routers/switches to obtain configuration and status data, including power information of routers/switches themselves and what they have obtained from hosts. Layer 2: Routers/switches Routers/switches provide configuration and status data, including power information of routers/switches themselves and what they have obtained from hosts, and respond to requests from the SDN controller/ management platform. In addition, routers/switches send requests to hosts to obtain configuration and status data, including power information. Layer 3: Hosts Agent needs to be installed to interact with routers/switches for NETCONF information. Hosts collect their energy consumption, and provide configuration and status data to routers/switches. 2.2. Relationship Between Layers Relationship 1: Between router/switch and host Router/switch acts as a NETCONF client and host acts as a NETCONF server. Host collects its energy consumption, and responds to the request of the upper-layer router/switch through the NETCONF agent to provide configuration and status data. Router/switch obtains energy consumption data of its lower-layer hosts. Relationship 2: Between SDN controller/management platform and router/switch Xiong, et al. Expires 19 April 2025 [Page 3] Internet-Draft YANG Host Power Monitoring October 2024 SDN controller/management platform acts as a NETCONF client, and router/switch acts as a NETCONF server. The SDN controller/ management platform obtains energy consumption data of routers/ switches, and energy consumption data of hosts which has been already obtained. 2.3. Hierarchy Representation +--------------------------------------------------+ | | | SDN controller/management platform | | | +----------+----------------------------+----------+ | | +----------+-----------+ +-----------+----------+ | router/switch | | router/switch | | 1 | | 2 | +----+------------+----+ +----+------------+----+ | | | | +----+----+ +----+----+ +----+----+ +----+----+ | host | | host | | host | | host | | 1.1 | | 1.2 | | 2.1 | | 2.2 | +---------+ +---------+ +---------+ +---------+ Figure 1: Hierarchy representation 3. YANG Data Model 3.1. Tree Diagram module: power-statistics +--ro power-statistics +--ro network-device-statistics* [network-device-name] +--ro network-device-name string +--ro network-device-power uint32 +--ro host-statistics* [host-name] +--ro host-name string +--ro host-power uint32 See [RFC8340] for a description of YANG trees. 3.2. YANG Model This model contains references to [RFC6991]. Xiong, et al. Expires 19 April 2025 [Page 4] Internet-Draft YANG Host Power Monitoring October 2024 module power-statistics { description "Module of power statistics."; list network-device-statistics { description "List of network devices statistics, i.e. routers/switches."; key "network-device-name"; leaf network-device-name { type string; description "Names of network devices."; } leaf network-device-power { type uint32; units "watts"; description "Power consumption of each network devices."; } list host-statistics { description "List of hosts."; key "host-name"; leaf host-name { type string; description "Names of hosts."; } leaf host-power { type uint32; units "watts"; description "Power consumption of each host."; } } } } 4. Security Considerations YANG and other mechanisms already exist that help secure these interactions. This document extends the scope of what can be controlled by the management plane, but creates no new access paths. Besides, all nodes in this document are "config false". Once information leakage occures, the exposure of the topology of the entire network would be the worst situation. Xiong, et al. Expires 19 April 2025 [Page 5] Internet-Draft YANG Host Power Monitoring October 2024 5. IANA Considerations This document makes no requests for IANA. 6. Normative References [RFC6991] Schoenwaelder, J., Ed., "Common YANG Data Types", RFC 6991, DOI 10.17487/RFC6991, July 2013, . [RFC8340] Bjorklund, M. and L. Berger, Ed., "YANG Tree Diagrams", BCP 215, RFC 8340, DOI 10.17487/RFC8340, March 2018, . [RFC2119] Bradner, S., "Key words for use in RFCs to Indicate Requirement Levels", BCP 14, RFC 2119, DOI 10.17487/RFC2119, March 1997, . [RFC8174] Leiba, B., "Ambiguity of Uppercase vs Lowercase in RFC 2119 Key Words", BCP 14, RFC 8174, DOI 10.17487/RFC8174, May 2017, . Authors' Addresses Ruizhe Xiong China Unicom Email: xiongrz@chinaunicom.cn Chang Liu China Unicom Email: liuchang77@chinaunicom.cn Yue Guo China Unicom Email: guoy23@chinaunicom.cn Xiong, et al. Expires 19 April 2025 [Page 6]