BMP Sequence Number, Timestamp and Flags TLVs

Introduction This document defines three new BMP Version 4 TLVs to enhance the metadata exported by the BMP station. BMP defines a Timestamp field in the Per-Peer header. This Timestamp field contains the time of reception of a route , the time the route was installed in the local-rib or the time the routes were advertised to a peer . As this information is sometimes unavailable in some implementations, some of them abuse this field by filling it with the time of export of the messages, misguiding collectors and operators which assume the value is correct. In this document, we deprecate the Timestamp field of the Per-Peer Header and define a Timestamp TLV that can carry multiple types of Timestamps. This allows implementations of BMP to export all the timestamps available while being explicit about the their meaning. Using a TLV for the timestamp field also allows exporting the timestamp of the Adj-Rib-In in the Local-RIB route monitoring messages. This removes the need to export entire RIBs just for the purpose of obtaining route reception timestamps. Currently, the Timestamp field is also optional, which means it might be zero-filled. When it is the case, timestamp-based ordering of BMP messages cannot work. In this document, we also define a Sequence Number TLV that carries for each message its sequence number. This allows ordering of BMP messages, even when no timestamps are available. Finally, the Flags field of the Per-Peer Header is close to running out of bits to allocate for Adj-In and Adj-Out. We thus move these flags to an extensible TLV that will allow for bits to be allocated more freely. To do that, we allocate the rightmost bit of the Per-Peer Header Flags. This bit indicates that the flags in the TLV MUST be used in place of the ones in the Per-Peer Header.

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 when, and only when, they appear in all capitals, as shown here.

Timestamp TLV In this section, we describe the optional Timestamp TLV. This BMPv4 TLV carries one of multiple types of Timestamp for a BMP message. A TLV type "Timestamp TLV" needs to be reserved from the BMP Route Monitoring TLVs registry. The value of the type field of this TLV is TBD1. The value of the TLV is the "Timestamp Type" code, defined in , followed by the timestamp values expressed in seconds and microseconds since midnight (zero hour), January 1, 1970 (UTC). The encoding of the timestamp is identical to existing BMP documents , , and , except that the timestamp MUST NOT be set to zero to indicate unavailability. The "Timestamp TLV" is optional, a timestamp MUST NOT be included if it is not available. The value of the Length field is 9 bytes (1 byte for the "Timestamp Type" field plus the length of the "Timestamp" fields which are 4 bytes each). The "Index" field is, as described by , not included in the length. The TLV structure is illustrated in .

Timestamp TLV 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 +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ | Type (2 octets) | Length (2 octets) | +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ |G| Index (2 octets) | Timestmp Type | ~ +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ ~ Timestamp (seconds) | ~ +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ ~ Timestamp (microseconds) ~ +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ The defines the list of currently defined Timestamp Types.

Timestamp Types The defines the list of timestamp types that can be carried in the "Timestamp TLV". Each timestamp type is described in the section associated with its name and code in the table.

Code	Name	Section
0x00	Trigger Time
0x01	Message Export Time
0x02	Adj-In Time
0x03	Local-RIB Time
0x04	Adj-Out Time

Trigger Time The Trigger Time is the timestamp of the event which triggered BMP to report the event. This might be a received message, a BGP peering or a BMP session going down or up, etc.

Message Export Time The Message Export Time is the time at which BMP generates the BMP message.

Adj-In Time The Adj-In Time is the time at which the route has been installed in the Adj-RIB-In, as per .

Local-RIB Time The Local-RIB Time is the time at which the route has been installed in the Local-RIB, as per .

Adj-Out Time The Adj-Out Time is the time at which the route has been installed in the Adj-RIB-Out, as per .

Sequence Number TLV In this section, we describe the Sequence Number TLV. This TLV carries the sequence number of a message in a BMP session. Ordering of BMP messages based on timestamp becomes complicated when timestamps have conflicting meanings or when they are simply unavailable. A Sequence Number on a per BMP session basis allows the operator to easily and uniquely identify BMP messages on a BMP session. A TLV type "Sequence Number TLV" needs to be reserved from the BMP Route Monitoring TLVs registry. The value of the type field of this TLV is TBD2. The value of the TLV is the sequence number of the BMP message in the BMP session, starting at 0, and encoded on 8 bytes. The value of the Length field is 8. The "Index" field is, as described by , not included in the length. The TLV structure is illustrated in .

Sequence Number TLV 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 +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ | Type (2 octets) | Length (2 octets) | +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ |G| Index (2 octets) | ~ +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + ~ Sequence Number (8 octets) ~ + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ ~ | +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+

Extended Flags TLV In this section, we describe the Extended Flags TLV. This TLV carries the Flags field usually present in the Per-Peer Header, while extending the length of the field. This allows for a larger range of flags to be allocated in the future. A TLV type "Extended Flags TLV" needs to be reserved from the BMP Route Monitoring TLVs registry. The value of the type field of this TLV is TBD3. The value of the TLV is a sequence of bytes of variable size. The minimum size of the sequence is one, to fit at least the already existing flags. The flags carried in this TLV are defined in the "BMP Extended Peer Flags" IANA registry defined by this document. The first byte of the sequence carries all flags defined previous to this document, that is Flags V, L, A, O, and F. Newly allocated bits will be carried in the following byte of the sequence. The value of the "Length" field is the number of bytes in the sequence. The "Index" field is, as described by , not included in the length. The "Index" field is set to 0 to indicate the global scope of the TLV. The TLV structure is illustrated in .

Extended Flags TLV 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 +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ | Type (2 octets) | Length (2 octets) | +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ |G| Index (2 octets) | Flags (Variable) ~ +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ When this TLV is included in a BMP message, the rightmost bit (X Flag) of the Per-Peer Header Flags MUST be set to 1 to indicate that the flags to consider are carried in this TLV. The flags in the Per-Peer Header are still set according to the current specification, allowing collectors that do not understand the X Flag and "Extended Flags TLV" to still function.

IANA Considerations This document requests that IANA assigns the following new parameters to the "BMP Route Monitoring TLVs" registry:

Type = TBD1: Timestamp TLV type. This TLV carries a timestamp along with a code identifying which type of event it qualifies.
Type = TBD2: Sequence Number TLV type. This TLV carries a sequence number for a BMP Message.
Type = TBD3: Extended Flags TLV type. This TLV carries a sequence of bytes representing the Per-Peer Header Flags for a BMP Message.

This document requests that IANA assigns the following new parameters to the "BMP Peer Flags for Peer Types 0 through 2" registry and to the "BMP Peer Flags for Loc-RIB Instance Peer Type 3" registry: * Flag = "7": X Flag (Extended Flags). Set if the Flags are carried in the Extended Flags TLV instead of the Per-Peer Header. This document also requests the definition of a "BMP Extended Peer Flags" registry which contains flags contained in the "Extended Flags TLV". The size of this registry is TBD. The registration policy for this registry is Standards Action as defined in . The registry is seeded as follows: * Flag 0: V flag [RFC7854] * Flag 1: L flag [RFC7854] * Flag 2: A flag [RFC7854] * Flag 3: O flag [RFC8671] * Flag 4: F flag [RFC9069] This document also requests the definition of a "BMP Timestamp Types" registry. This registry contains type codes for the kinds of timestamps carried by the "Timestamp TLV". The size of the registry matches the size of the "Timestamp Type" field defined in {#fig-timestamp-tlv} which is 1 byte. The registration policy for this registry is Expert Review as defined in . The registry is seeded as follows:

Type = 0x00: Trigger Time. Set to 0x00 if the timestamp corresponds to the event that triggered BMP to report the route or state, such as receiving a message or a session transition.
Type = 0x01: Message Export Time. Set to 0x01 if the timestamp corresponds to the time when the BMP message was generated for export.
Type = 0x02: Adj-In Time. Set to 0x02 if the timestamp corresponds to when the route was installed in the Adj-RIB-In, as per {@RFC7854}.
Type = 0x03: Local-RIB Time. Set to 0x03 if the timestamp corresponds to when the route was installed in the Local-RIB, as per {@RFC9069}.
Type = 0x04: Adj-Out Time. Set to 0x04 if the timestamp corresponds to when the route was installed in the Adj-RIB-Out, as per {@RFC8671}.

Security Considerations This document does not introduce new security considerations.

Acknowledgements