Internet Engineering Task Force (IETF)                             Z. Li
Request for Comments: 9534                                  China Mobile
Category: Standards Track                                        T. Zhou
ISSN: 2070-1721                                                   Huawei
                                                                  J. Guo
                                                               ZTE Corp.
                                                               G. Mirsky
                                                                Ericsson
                                                               R. Gandhi
                                                     Cisco Systems, Inc.
                                                            January 2024

 Simple Two-Way Active Measurement Protocol Extensions for Performance
                Measurement on a Link Aggregation Group

Abstract

   This document extends Simple Two-way Active Measurement Protocol
   (STAMP) to implement performance measurement on every member link of
   a Link Aggregation Group (LAG).  Knowing the measured metrics of each
   member link of a LAG enables operators to enforce a performance-based
   traffic steering policy across the member links.

Status of This Memo

   This is an Internet Standards Track document.

   This document is a product of the Internet Engineering Task Force
   (IETF).  It represents the consensus of the IETF community.  It has
   received public review and has been approved for publication by the
   Internet Engineering Steering Group (IESG).  Further information on
   Internet Standards is available in Section 2 of RFC 7841.

   Information about the current status of this document, any errata,
   and how to provide feedback on it may be obtained at
   https://www.rfc-editor.org/info/rfc9534.

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 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
     1.1.  Requirements Language
   2.  Micro Sessions on a LAG
   3.  Member Link Validation
     3.1.  Micro-session ID TLV
     3.2.  Micro STAMP-Test Procedures
   4.  Applicability
   5.  IANA Considerations
   6.  Security Considerations
   7.  References
     7.1.  Normative References
     7.2.  Informative References
   Acknowledgements
   Authors' Addresses

1.  Introduction

   A Link Aggregation Group (LAG), as defined in [IEEE802.1AX], provides
   mechanisms to combine multiple physical links into a single logical
   link.  This logical link offers higher bandwidth and better
   resiliency because, if one of the physical member links fails, the
   aggregate logical link can continue to forward traffic over the
   remaining operational physical member links.

   Usually, when forwarding traffic over a LAG, a hash-based mechanism
   is used to load balance the traffic across the LAG member links.  The
   link delay might vary between member links because of different
   transport paths, especially when a LAG is used in a wide area
   network.  To provide low-latency service for time-sensitive traffic,
   we need to explicitly steer the traffic across the LAG member links
   based on the link delay, loss, and so on.  That requires a solution
   to measure the performance metrics of each member link of a LAG.
   Hence, the measured performance metrics can work together with Layer
   2 bundle member link attributes advertisement [RFC8668] for traffic
   steering.

   According to the classifications in [RFC7799], Simple Two-way Active
   Measurement Protocol (STAMP) [RFC8762] is an active measurement
   method, and it can complement passive and hybrid methods.  It
   provides a mechanism to measure both one-way and round-trip
   performance metrics, like delay, delay variation, and packet loss.
   One  A
   STAMP test session over the LAG can be used to measure the
   performance of a member link with fixed five tuples, or it using a specially constructed 5-tuple.
   The session can be used to measure an average of some or all member
   links of the LAG by varying the five tuples. one or more elements of that 5-tuple.
   However, without the knowledge of each member link, a STAMP test
   session cannot measure the performance of every physical member link.

   This document extends STAMP to implement performance measurement on
   every member link of a LAG.  It can provide the same metrics as
   One-Way Active Measurement Protocol (OWAMP) [RFC4656] and Two-Way
   Active Measurement Protocol (TWAMP) [RFC5357] can measure, such as
   delay, jitter, and packet loss.

1.1.  Requirements 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.

2.  Micro Sessions on a LAG

   This document addresses the scenario where a LAG directly connects
   two nodes.  An example of this is in Figure 1, where the LAG
   consisting of four links connects nodes A and B.  The goal is to
   measure the performance of each link of the LAG.

                     +---+                       +---+
                     |   |-----------------------|   |
                     | A |-----------------------| B |
                     |   |-----------------------|   |
                     |   |-----------------------|   |
                     +---+                       +---+

                 Figure 1: Performance Measurement on a LAG

   To measure the performance metrics of every member link of a LAG,
   multiple sessions (one session for each member link) need to be
   established between the two endpoints that are connected by the LAG.
   These sessions are called "micro sessions" in the remainder of this
   document.  Although micro sessions are in fact STAMP sessions
   established on member links of a LAG, test packets of micro sessions
   MUST carry member link information for validation.

   All micro sessions of a LAG share the same Sender IP Address and
   Receiver IP Address of the LAG. Address.  As for the UDP port, the micro sessions may
   share the same Sender Port and Receiver Port pair or each micro
   session may be configured with a different Sender Port and Receiver
   Port pair.  From the operational point of view, the former is simpler
   and is RECOMMENDED.

   Test packets of a micro session MUST carry the member link
   information for validation checks.  For example, when a micro STAMP
   Session-Sender receives a reflected test packet, it checks whether
   the test packet is from the expected member link.  The member link
   information is encoded in the Micro-session ID TLV introduced in
   Section 3, which also provides a detailed description about member
   link validation.

   A micro STAMP Session-Sender MAY include the Follow-Up Telemetry TLV
   [RFC8972] to request information from the micro Session-Reflector.
   This timestamp might be important for the micro Session-Sender, as it
   improves the accuracy of network delay measurement by minimizing the
   impact of egress queuing delays on the measurement.

3.  Member Link Validation

   Test packets MUST carry member link information in the Micro-session
   ID TLV introduced in this section for validation checks.  The micro
   Session-Sender verifies whether the test packet is received from the
   expected member link.  It also verifies whether the packet is sent
   from the expected member link at the Reflector side.  The micro
   Session-Reflector verifies whether the test packet is received from
   the expected member link.

3.1.  Micro-session ID TLV

   The STAMP TLV mechanism [RFC8972] extends STAMP test packets with one
   or more optional TLVs.  This document defines the TLV Type (value 11)
   for the Micro-session ID TLV that carries the micro STAMP Session-
   Sender member link identifier and Session-Reflector member link
   identifier in the Sender Micro-session ID field and the Reflector
   Micro-session ID field, respectively.  The format of the Micro-
   session ID TLV is shown as follows:

       0                   1                   2                   3
       0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
      +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
      |STAMP TLV Flags|  Type = 11    |           Length              |
      +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
      |     Sender Micro-session ID   |   Reflector Micro-session ID  |
      +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+

                       Figure 2: Micro-session ID TLV

   Type (1 octet in length):  This field is defined to indicate this TLV
      is a Micro-session ID TLV.  Value 11 has been allocated by IANA
      (Section 5).

   Length (2 octets in length):  This field is defined to carry the
      length of the Value field in octets.  The Length field value MUST
      be 4.

   Sender Micro-session ID (2 octets in length):  This field is defined
      to carry the LAG member link identifier of the Sender side.  In
      the future, it may be used generically to cover use cases beyond
      LAGs.  The value of this field MUST be unique within a STAMP
      session at the Session-Sender.

   Reflector Micro-session ID (2 octets in length):  This field is
      defined to carry the LAG member link identifier of the Reflector
      side.  In the future, it may be used generically to cover use
      cases beyond LAGs.  The value of this field MUST be unique within
      a STAMP session at the Session-Reflector.

3.2.  Micro STAMP-Test Procedures

   The micro STAMP-Test reuses the procedures as defined in Section 4 of
   STAMP [RFC8762] with the following additions.

   The micro STAMP Session-Sender MUST send the micro STAMP-Test packets
   over the member link with which the session is associated.  The
   mapping between a micro STAMP session and the Sender/Reflector member
   link identifiers can be configured by augmenting the STAMP YANG
   [STAMP-YANG].  The detailed augmentation is not in the scope of this
   document.

   When sending a test packet, the micro STAMP Session-Sender MUST set
   the Sender Micro-session ID field with the member link identifier
   associated with the micro STAMP session.  If the Session-Sender knows
   the Reflector member link identifier, the Reflector Micro-session ID
   field MUST be set.  Otherwise, the Reflector Micro-session ID field
   MUST be zero.  The Reflector member link identifier can be obtained
   from preconfiguration or learned from data plane (e.g., the reflected
   test packet).  This document does not specify the way to obtain the
   Reflector member link identifier.

   When the micro STAMP Session-Reflector receives a test packet, if the
   Reflector Micro-session ID is not zero, the micro STAMP Session-
   Reflector MUST use the Reflector member link identifier to check
   whether it is associated with the micro STAMP session.  If the
   validation fails, the test packet MUST be discarded.  If the
   Reflector Micro-session ID is zero, it will not be verified.  If all
   validations passed, the Session-Reflector sends a reflected test
   packet to the Session-Sender.  The micro STAMP Session-Reflector MUST
   put the Sender and Reflector member link identifiers that are
   associated with the micro STAMP session in the Sender Micro-session
   ID and Reflector Micro-session ID fields, respectively.  The Sender
   member link identifier is copied from the received test packet.

   When receiving a reflected test packet, the micro Session-Sender MUST
   use the Sender Micro-session ID to validate whether the reflected
   test packet is correctly received from the expected member link.  If
   the validation fails, the test packet MUST be discarded.  The micro
   Session-Sender MUST use the Reflector Micro-session ID to validate
   the Reflector's behavior.  If the validation fails, the test packet
   MUST be discarded.

   Two modes of the STAMP Session-Reflector, stateless and stateful,
   characterize the expected behavior as described in Section 4 of STAMP
   [RFC8762].  The micro STAMP-Test also supports both stateless and
   stateful modes.  However, the micro STAMP-Test does not introduce any
   additional state to STAMP, i.e., any procedure with regard to the
   Micro-session ID is stateless.

4.  Applicability

   The micro STAMP Session-Sender sends micro Session-Sender packets
   with the Micro-session ID TLV.  The micro Session-Reflector checks
   whether a test packet is received from the member link associated
   with the correct micro STAMP session if the Reflector Micro-session
   ID field is set.  When reflecting, the micro STAMP Session-Reflector
   copies the Sender Micro-session ID from the received micro Session-
   Sender packet to the micro Session-Reflector packet and sets the
   Reflector Micro-session ID field with the member link identifier that
   is associated with the micro STAMP session.  When receiving the micro
   Session-Reflector packet, the micro Session-Sender uses the Sender
   Micro-session ID to check whether the packet is received from the
   member link associated with the correct micro STAMP session.  The
   micro Session-Sender also use the Reflector Micro-session ID to
   validate the Reflector's behavior.

5.  IANA Considerations

   IANA has allocated the following STAMP TLV Type for the Micro-session
   ID TLV in the "STAMP TLV Types" registry [RFC8972]:

               +=======+==================+===============+
               | Value | Description      | Reference     |
               +=======+==================+===============+
               | 11    | Micro-session ID | This Document |
               +-------+------------------+---------------+

                       Table 1: New STAMP TLV Type

6.  Security Considerations

   The STAMP extension defined in this document is intended for
   deployment in the LAG scenario where Session-Sender and Session-
   Reflector are directly connected.  As such, it's assumed that a node
   involved in a STAMP operation has previously verified the integrity
   of the LAG connection and the identity of its one-hop-away peer node.

   This document does not introduce any additional security issues, and
   the security mechanisms defined in [RFC8762] and [RFC8972] apply in
   this document.

7.  References

7.1.  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,
              <https://www.rfc-editor.org/info/rfc2119>.

   [RFC8174]  Leiba, B., "Ambiguity of Uppercase vs Lowercase in RFC
              2119 Key Words", BCP 14, RFC 8174, DOI 10.17487/RFC8174,
              May 2017, <https://www.rfc-editor.org/info/rfc8174>.

   [RFC8762]  Mirsky, G., Jun, G., Nydell, H., and R. Foote, "Simple
              Two-Way Active Measurement Protocol", RFC 8762,
              DOI 10.17487/RFC8762, March 2020,
              <https://www.rfc-editor.org/info/rfc8762>.

   [RFC8972]  Mirsky, G., Min, X., Nydell, H., Foote, R., Masputra, A.,
              and E. Ruffini, "Simple Two-Way Active Measurement
              Protocol Optional Extensions", RFC 8972,
              DOI 10.17487/RFC8972, January 2021,
              <https://www.rfc-editor.org/info/rfc8972>.

7.2.  Informative References

   [IEEE802.1AX]
              IEEE, "IEEE Standard for Local and metropolitan area
              networks Metropolitan Area
              Networks -- Link Aggregation", IEEE Std 802.1AX-2008, 802.1AX-2020,
              DOI 10.1109/IEEESTD.2008.4668665, November 2008,
              <https://ieeexplore.ieee.org/document/4668665>. 10.1109/IEEESTD.2020.9105034, May 2020,
              <https://ieeexplore.ieee.org/document/9105034>.

   [RFC4656]  Shalunov, S., Teitelbaum, B., Karp, A., Boote, J., and M.
              Zekauskas, "A One-way Active Measurement Protocol
              (OWAMP)", RFC 4656, DOI 10.17487/RFC4656, September 2006,
              <https://www.rfc-editor.org/info/rfc4656>.

   [RFC5357]  Hedayat, K., Krzanowski, R., Morton, A., Yum, K., and J.
              Babiarz, "A Two-Way Active Measurement Protocol (TWAMP)",
              RFC 5357, DOI 10.17487/RFC5357, October 2008,
              <https://www.rfc-editor.org/info/rfc5357>.

   [RFC7799]  Morton, A., "Active and Passive Metrics and Methods (with
              Hybrid Types In-Between)", RFC 7799, DOI 10.17487/RFC7799,
              May 2016, <https://www.rfc-editor.org/info/rfc7799>.

   [RFC8668]  Ginsberg, L., Ed., Bashandy, A., Filsfils, C., Nanduri,
              M., and E. Aries, "Advertising Layer 2 Bundle Member Link
              Attributes in IS-IS", RFC 8668, DOI 10.17487/RFC8668,
              December 2019, <https://www.rfc-editor.org/info/rfc8668>.

   [STAMP-YANG]
              Mirsky, G., Min, X., Luo, W. S., and R. Gandhi, "Simple
              Two-way Active Measurement Protocol (STAMP) Data Model",
              Work in Progress, Internet-Draft, draft-ietf-ippm-stamp-
              yang-12, 5 November 2023,
              <https://datatracker.ietf.org/doc/html/draft-ietf-ippm-
              stamp-yang-12>.

Acknowledgements

   The authors would like to thank Mach Chen, Min Xiao, Fang Xin, Marcus
   Ihlar, and Richard Foote for the valuable comments to this work.

Authors' Addresses

   Zhenqiang Li
   China Mobile
   No. 29 Finance Avenue
   Xicheng District
   Beijing
   China
   Email: li_zhenqiang@hotmail.com

   Tianran Zhou
   Huawei
   China
   Email: zhoutianran@huawei.com

   Jun Guo
   ZTE Corp.
   China
   Email: guo.jun2@zte.com.cn

   Greg Mirsky
   Ericsson
   United States of America
   Email: gregimirsky@gmail.com

   Rakesh Gandhi
   Cisco Systems, Inc.
   Canada
   Email: rgandhi@cisco.com