Internet-Draft | Path Tracing | December 2023 |
Filsfils, et al. | Expires 3 June 2024 | [Page] |
Path Tracing provides a record of the packet path as a sequence of interface ids. In addition, it provides a record of end-to-end delay, per-hop delay, and load on each egress interface along the packet delivery path.¶
Path Tracing allows to trace 14 hops with only a 40-bytes IPv6 Hop-by-Hop extension header.¶
Path Tracing supports fine grained timestamp. It has been designed for linerate hardware implementation in the base pipeline.¶
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 3 June 2024.¶
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.¶
Path Tracing provides a record of the packet path as a sequence of interface ids. In addition, it provides a record of end-to-end delay, per-hop delay, and load on each egress interface along the packet delivery path.¶
Path Tracing allows to trace 14 hops with only a 40 bytes IPv6 Hop-by-Hop header. The overhead is lower than [INT], [RFC9197], [I-D.song-opsawg-ifit-framework], and [I-D.kumar-ippm-ifa].¶
Path Tracing supports fine-grained timestamps. It has been designed for linerate hardware implementation in the base pipeline.¶
Path Tracing is applicable to both SR-MPLS [RFC8660], as well as SRv6 [RFC8986]. This document defines the Path Tracing specification for the SRv6 dataplane. The SR-MPLS dataplane will be detailed in a separate document.¶
The specification proposed in this document has been implemented successfully in different interoperable hardware platforms at linerate (Section 11).¶
The following terms used within this document are defined in [RFC8402], [RFC8754] and [RFC8986]: Segment Routing (SR), SR Domain, Segment ID (SID), SRv6, SRv6 SID, SR Policy, Segment Routing Header (SRH), SR source node, transit node, SR Endpoint, SA, DA.¶
The following terms are used in this document as defined below:¶
PT: Path Tracing¶
MCD: Midpoint Compressed Data (MCD). Information that every transit router adds to the packet for PT purposes. Defined in Section 3 of this document.¶
HbH-PT: IPv6 Hop-by-Hop Option [RFC8200] for Path Tracing. It contains a stack of MCDs. It is defined in Section 9.1 of this document¶
DOH-PT: IPv6 Destination Option [RFC8200] for Path Tracing. It is defined in Section 9.2 of this document.¶
PT Source: A Source node that starts a PT Probing Instance (defined in Section 5) and generates PT probes.¶
PT Midpoint: A transit node that performs plain IPv6 forwarding (or SR Endpoint processing) and in addition records PT information in the HbH-PT.¶
PT Sink: A node that receives PT probes sent from the SRC containing the information recorded by every PT Midpoint along the path, and forwards them to a regional collector after recording its PT information.¶
RC: Regional collector that receives PT probes, parses, and stores them in TimeSeries Database. It uses the information in the HBH-PT and the DOH-PT to construct the packet delivery path as well as the timestamp at each node.¶
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.¶
Every PT Midpoint along the packet delivery path -from Source to Sink- records its PT information into the HbH-PT header. This information is known as Midpoint Compressed Data (MCD). It contains the following information:¶
MCD.OIF (Outgoing Interface ID): An 8-bit or 12-bit interface ID associated with the egress physical interface of the router¶
The interface ID is assigned by an operator. The Interface IDs are not globally unique across the entire network. Indeed the same Interface ID may be repeated multiple times in the network as long as the end-to-end path can be deterministically inferred based on the chain of Interface IDs.¶
The programming of the Interface ID in the device may be done by CLI/NETCONF or any other means, and it is out of the scope of this document.¶
The usage of an 8-bit or 12-bit Interface ID is an operator choice, but the Interface ID size MUST be consistent across the entire network.¶
In case of Link Aggregation Groups (LAG/bundle) [LAG], each one of the members is configured with a different interface ID.¶
MCD.OIL (Outgoing Interface Load): A 4-bit representation of the egress interface load (i.e., current throughout relative to the interface bandwidth).¶
The load is represented using a 4-bit value in logarithmic scale. This allows more granular information as the load is higher.¶
MCD.TTS (Truncated Timestamp): An 8-bit timestamp encoding the time at which the packet egress the router.¶
Each egress interface in the device is configured with a TTS template.¶
The TTS template defines the position of 8-bits to be selected from the egress timestamp. Section 4 of this document discusses the timestamp format used in path tracing.¶
A Path Tracing Midpoint implementation MAY support one or more TTS templates. Each TTS template provides a different time precision.¶
An operator configures an egress interface with a single TTS template. The choice of the TTS template for a given interface is based on the type of the link connected to that interface. For example, an interface connected to DC link will have a different TTS Template from an interface connected to intercontinental or WAN link, as they have different precision requirements.¶
Path Tracing uses a 64-bit timestamp format. [RFC8877] recommends two 64-bit timestamp formats: 64-bit Truncated PTP timestamp format and NTP 64-bit timestamp format. Path Tracing can work with both formats indifferently.¶
All routers across the network MUST have time-synchronization. PTP [IEEE1588] and NTP [RFC5905] are example protocols that can be used for time-synchronization.¶
The controller configures a PT Probing Instance at the source node. A PT Probing Instance is configured with the following parameters:¶
SA: the source address of the PT probe. Typically, it is the loopback address of the PT SRC.¶
Session ID: A 16-bit value.¶
Probe-rate: Number of probes per second to generate as part of this PT Probing Instance. The probe-rate is the aggregate of the probes generated across all the sweeping ranges.¶
SRv6 SID List: The SRv6 SID list associated with the packet. The last SID is the Sink node.¶
DSCP value¶
Hop-limit Value¶
IPv6 Flow-Label sweeping range:¶
If set, different Flow-Label values must be used in the probe packets. It may be specified as a range of specific Flow-Label values to enumerate, or it may be specified as the number of different random Flow-Label values to use in a round-robin.¶
HbH-PT size¶
MTU sweeping range:¶
If set, payload must be included at the end of the packet to test different packet sizes.¶
For each configured PT Probing Instance, according to the probe-rate, the PT SRC generates a PT probe packet as follows:¶
S01. Generate a new IPv6 packet S02. Set the IPv6 SA as per PT Probing Instance configuration S03. Set the IPv6 DA to the first SID from the SRv6 SID List S04. Set the IPv6 Next Header field to zero (HbH) S05. Set the DSCP and Flow Label values as per PT Probing Instance configuration S06. Append an IPv6 Hop-by-Hop header with HbH-PT S07. Set all bits of the HbH-PT MCD Stack to zero S08. IF SID List has more than one SID S09. Append an SRH S10. Set the Next Header field to 60 (IPv6 Destinations Options header) S11. Write the remaining SIDs of the SID list in the SRH S12. Append an IPv6 Destinations Option header with DOH-PT S13. Set the Next Header field of the IPv6 Destinations Options Header to 59 (IPv6 No Next Header) S14. Add padding bytes after the IPv6 Destinations Option header to reach the desired packet size as per the MTU sweeping range configuration S15. Set the session ID field of the DOH-PT as per PT Probing Instance configuration S16. Perform an IPv6 FIB lookup to determine the Outgoing Interface (IFACE-OUT) on which packet will be forwarded S17. Record Transmit 64-bit timestamp (SRC.T64) in the T64 field of the DOH-PT S18. Record IFACE-OUT ID (SRC.OIF) in the IF_ID field of the DOH-PT S19. Record IFACE-OUT Load (SRC.OIL) in the IF_LD field of the DOH-PT S20. Forward the packet via IFACE-OUT¶
Notes:¶
The pseudocode describes local processing at a node. An implementation of the pseudocode is compliant as long as the externally observable wire protocol is as described in the pseudocode.¶
When a midpoint node receives an IPv6 packet that contains an IPv6 HbH-PT option, the node processes the HbH-PT as follows:¶
S01. When processing HbH-PT option { S02. Compute the MCD information as per Section 3 S03. HbH-PT.MCD_Stack[MCD_Size:HbH-PT.OPT_Data_Len-1] = HbH-PT.MCD_Stack[0:HbH-PT.OPT_Data_Len-(MCD_Size+1)] //Shift HbH-PT MCD Stack to the right by MCD_Size bytes S04. HbH-PT.MCD_Stack[0:MCD_Size-1] = MCD[0:MCD_Size-1] //Push the MCD at the beginning of the Stack S05. }¶
Notes:¶
The PT Midpoint behavior MUST be implemented in the normal pipeline to experience the regular datapath (i.e., linerate with full PPS and full BW). Offloading the processing of this option to either the slow-path or a co-processors is not acceptable and yields invalid results.¶
We define a new SRv6 Endpoint Behavior called "Endpoint Behavior bound to an SRv6 Policy with Timestamp, Encapsulation and Forward" ("End.B6.TEF" for short).¶
It is a Binding SID instantiated, at Sink nodes, that encapsulates the packet with a new IPv6 header, an SRH that contains the SID list associated to End.B6.TEF SID, and an IPv6 Destinations Option header with DOH-PT that is used to carry Path Tracing information of Sink node.¶
When N receives a packet whose IPv6 DA is S and S is a local End.B6.TEF SID, N does the following:¶
S01. Record Rx 64-bit timestamp (SNK.T64) S02. Record incoming interface ID (SNK.IIF) S03. Record incoming interface Load (SNK.IIL) S04. Push a new IPv6 header S05. Set the IPv6 SA to the Sink node loopback S06. Set the IPv6 DA to the first SID in the SRv6 SID List S07. IF SID List has more than one SID S08. Append an SRH S09. Set the SRH Next Header field to 60 (IPv6 Destinations Options header) S10. Write the remaining SIDs of the SID list in the SRH S11. Append an IPv6 Destinations Option header with DOH-PT S12. Set the Next Header field of the IPv6 Destinations Options Header to 41 (IPv6 header) S13. Set the session ID field of the DOH-PT to zero S14. Write SNK.T64 in the T64 field of the DOH-PT S15. Write SNK.IIF in the IF_ID field of the DOH-PT S16. Write SNK.IIL in the IF_LD field of the DPH-PT S17. Submit the packet to the egress IPv6 FIB lookup for transmission to the new destination¶
Notes:¶
The pseudocode describes local processing at a node. An implementation of the pseudocode is compliant as long as the externally observable wire protocol is as described in the pseudocode.¶
This document defines a new IPv6 Option for Path Tracing to be carried in the IPv6 Hop-by-Hop Header. The option has the following format:¶
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ | Option Type | Opt Data Len | +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ | | ~ MCD Stack ~ | | +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ Figure 1: IPv6 Hop-by-Hop Option for Path Tracing (HbH-PT)¶
Where:¶
Option Type: TBA1-1¶
Opt Data Len: the length of the MCD stack in bytes.¶
MCD Stack: metadata scratchpad where PT Midpoints record their MCDs¶
Note: The HbH-PT has a variable length. It is RECOMMENDED that implementations support a 38-octet HbH-PT Option. The operator, upon configuring the Source node behavior, MUST select an option length that is supported by all the routers in the network.¶
This document defines a new IPv6 Option for Path Tracing to be carried in the IPv6 Destination Options Header. The option has the following format:¶
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ | Option Type | Opt Data Len | +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ | | + T64 + | | +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ | Session ID | IF_ID | IF_LD | +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ Figure 2: IPv6 Destination Option for Path Tracing (DOH-PT)¶
Where:¶
Option Type: TBA1-2¶
Opt Data Len: the length of the DOH-PT in bytes (12).¶
T64: 64-bit Timestamp¶
Session ID: Session identifier set by SRC node generating the probes. Used to co-relate probes of the same session. Value of zero means unset.¶
IF_ID: 12-bit Interface ID¶
IF_LD: 4-bit Interface Load¶
Note: The DOH-PT is generated by both the PT SRC and the PT SNK. When used at the PT SNK node, the Session ID field MUST be set to zero.¶
Low overhead:¶
A 40Byte Hop-By-Hop header allows for 14 hops path measurements: 1 at the PT SRC, 12 at PT Midpoint routers and 1 at the PT SNK¶
PT has the lowest MTU overhead compared to alternative solutions such as [INT], [RFC9197], [I-D.song-opsawg-ifit-framework], and [I-D.kumar-ippm-ifa].¶
Linerate and HW friendliness:¶
Implemented at linerate in current hardware, using the regular forwarding pipeline. No offloading to co-processors or slow-path whose databases might defer from forwarding pipeline.¶
Leverages mature hardware capabilities (basic shift operation); no packet resizing at every node along the path¶
High number of diverse linerate interoperable hardware Implementations (see Section 11)¶
Scalable Fine-grained Timestamp:¶
Scalable Load measurement¶
Editorial note: Please remove this section prior publication.¶
The following routing platforms have participated in an interop testing:¶
Cisco 8802 (based on Cisco Silicon One Q200)¶
Cisco ASR9904 with Lightspeed linecard¶
Cisco NCS5508 (based on Broadcom Jericho2 platform)¶
Cisco Nexus N3K-C3464C (based on Barefoot Tofino)¶
SONiC Whitebox (based on Cisco Silicon One Q200)¶
Marvell Prestera Falcon¶
Keysight IxNetwork¶
The following open-source software networking stacks have also participated in the interop:¶
The following opensource applications also have extensions to support Path Tracing:¶
The security considerations for Segment Routing are discussed in [RFC8402]. Section 5 of [RFC8754] describes the SR Deployment Model and the requirements for securing the SR Domain. The security considerations of [RFC8754] also cover topics such as attack vectors and their mitigation mechanisms that also apply to the behaviors introduced in this document. Together, they describe the required security mechanisms that allow establishment of an SR domain of trust. Having such a well-defined trust boundary is necessary in order to operate SRv6-based services for internal traffic while preventing any external traffic from accessing or exploiting the SRv6-based services.¶
This document defines the Path Tracing architecture, which is deployed on a secured SRv6-domain. As such, all the security considerations defined in [RFC8754], [RFC8402], and [RFC8986] are applicable.¶
In addition, any border router in an SR Domain network where Path Tracing is enabled, MUST support the configuration of the following ACLs:¶
If there is a packet coming from an external interface destined towards an internal interface that contains an IPv6 Hop-by-Hop header with a Path Tracing option, then such packet is silently dropped.¶
If there is a packet coming from an internal interface destined towards an external interface that contains an IPv6 Hop-by-Hop header with a Path Tracing option, then such packet is silently dropped.¶
These ACLs SHOULD be enabled by default. An operator MAY disable them individually based on local configuration.¶
The processing of IPv6 Hop-by-Hop headers could sometimes be used as an attack vector to overload the CPU of the router. As defined in Section 7 of this document, the HBH-PT option MUST be processed in the router's fast path. Therefore, there is no impact on the router's CPU.¶
This document requests the following IPv6 Option Type assignments from the Destination Options and Hop-by-Hop Options sub-registry of Internet Protocol Version 6 (IPv6) Parameters.¶
Hex Value Binary Value Description Reference act chg rest --------------------------------------------------------- TBA1-1 00 1 TBA1 HbH-PT [This.ID] TBA1-2 00 0 TBA1 DOH-PT [This.ID]¶
The authors of this document would like to thank the team that has collaborated on the design and implementation of the Path Tracing framework at Cisco, Broadcom, Marvel, Keysight, Swisscom, Alibaba, Softbank, University of Rome "Tor Vergata", and ETH Zurich. In particular: Eyal Dagan, Guy Caspary, Elad Naor, Aviran Kadosh, Eli Stein, Oren Yabo, Aviad Behar, Anand Sridharan, Anju Dey, John Bettink, Kamran Raza, Asif Islam, Yue Gao, Jakub Horn, Sam Kheirallah, Shelly Cadora, Kris Michielsen, Francois Clad, Stefano Salsano, Andrea Mayer, Paolo Lungaroni, Giulio Sidoretti, Leonardo Rodoni, Marco Tollini, Yuanwen Sun, Anirban Bhattacharya, Ajay Ramamurthy, Manomugdha Biswas, Kingshuk Mandal.¶