Internet-Draft | On-Path delay for IOAM | March 2023 |
Huang Feng, et al. | Expires 4 September 2023 | [Page] |
This document defines a Data Field In Situ Operations, Administration, and Maintenance (IOAM) architecture for on-path delay information. This data field is registered as a new entry in the "IOAM Trace-Type" registry.¶
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.¶
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 4 September 2023.¶
Copyright (c) 2023 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.¶
Network operators want to measure the On-Path delay of the customers packets across their networks to determine where how much delay has been accumulated for a given application to optimize and maintain their networks.¶
This document proposes an IOAM Trace-Type data field and its associated bit field to export delay measurements. The delay measurements is obtained in passport-based IOAM based on the "timestamp seconds" and "timestamp fractions" Trace-Type data fields defined in [RFC9197]. In postcard-based IOAM the delay is obtained using the timestamp extensions defined in [I-D.ahuang-ippm-dex-timestamp-ext].¶
Section 3 describes the suggested solution and Section 4 describes the proposed IOAM data field.¶
This document makes use of the following terms as defined in [RFC9197].¶
The On-path delay is computed between the encapsulation node and the transit or decapsulation node of the IOAM-domain as shown in Figure 1. The calculated delays in Figure 1 are computed as following:¶
IOAM Domain ......................................... . . . D1 . . <------> . . . . D2 . . <--------------------> . . . . D3 . . <-----------------------------------> . . . (H1) ------ (R1) ------- (R2) ------- (R3) -------- (R4) ------ (H2) Host 1 Encapsulation Transit Transit Decapsulation Host 2 Node Node 1 Node 2 Node . . . . .........................................
In passport-based IOAM this delay is exported using Pre-allocated Trace-Option and Incremental Trace-Option as defined in [RFC9197] and in postcard-based IOAM, the delay is computed using IOAM DEX Option as defined in [RFC9326].¶
Section 3.1 describes how the delay is computed using the existing Trace-Type data fields and Section 3.2 describes how the delay can be calculated using a timestamp extension.¶
In passport-based IOAM, telemetry data is added to the data-plane packet at each node of the IOAM-domain and all collected metrics are exported by the decapsulation node.¶
Pre-allocated Trace Option-type and Incremental Trace Option-type, as defined in Section 4.4 of [RFC9197], is used to transport the different metrics. The exported metrics are defined by the bit field in IOAM Trace-Type as defined in Section 4.4.1 of [RFC9197].¶
To compute the delay at the transit and decapsulation node, a timestamp reference from the encapsulation node is added. Bit 2 (timestamp seconds) and bit 3 (timestamp fraction) from the IOAM Trace-type field [RFC9197] is used for this purpose and at each node, the On-path delay is computed using the delay from the encapsulation and the current node.¶
To export the On-path delay, a new bit in the IOAM Trace-Type bit field is required. Section 4 defines the data field.¶
Section 3.3 describes how the On-path delay metrics can be exported.¶
In postcard-based IOAM, telemetry data is exported at the transit nodes and decapsulation node of the IOAM domain. The telemetry data is aggregated at each node before being exported to a collector.¶
DEX Option-type, as defined in [RFC9326], is used for this purpose. The exported telemetry data is defined in IOAM Trace-Type bit field. The export of the On-path delay is based on the On-Path Delay field defined in Section 4.¶
The timestamp reference needs to be added to the IOAM DEX Option-type header. [I-D.ahuang-ippm-dex-timestamp-ext] defines an extension to allow the timestamp being added in the encapsulation node. Bit 2 (timestamp seconds) and bit 3 (timestamp fraction) from the IOAM DEX Extension-Flags, defined in [I-D.ahuang-ippm-dex-timestamp-ext], are used to add this time reference. At each transit and decapsulation node, the difference between the timestamp in the header and the current timestamp is computed.¶
Section 3.3 describes how the On-path delay metrics can be exported.¶
The export of the On-path delay is out of scope of this document. [I-D.spiegel-ippm-ioam-rawexport] proposes a way to export the raw IOAM header for both passport-mode and postcard-mode and [I-D.ietf-opsawg-ipfix-on-path-telemetry] proposes IPFIX Information Elements to allow aggregation before the export.¶
The "On-Path Delay" field type is a 4-octet unsigned integer. This field indicates the On-path delay between the encapsulation node and the transit or decapsulation node measured in microseconds.¶
TBD 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 +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ | On-Path Delay | +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
The Data-Field is allocated by IANA, as defined in Section 6.¶
The security considerations for the IOAM Trace-Type and IOAM DEX Option-type are defined in [RFC9197] and in [RFC9326]. This document adds no additional security considerations.¶
This document requests IANA to add the following bit in the "IOAM Trace-Type" Registry.¶
Bit: [TBD] Description: On-path delay between the encapsulated node and the transit or decapsulation node measured in microseconds. Reference: [This-RFC-to-be]¶
The authors would like to thank xxx for their review and valuable comments.¶