]> Advanced BGP Monitoring Protocol (BMP) Statistics Types Hewlett Packard Enterprise
10 Technology Park Dr Westford MA 01886 United States of America mukul.srivastava@hpe.com
China Mobile
32 Xuanwumen West Street Beijing Xicheng District 100053 China liuyisong@chinamobile.com
New H3C Technologies
8 Yongjia North Road Beijing Haidian District 100094 China linchangwang.04414@h3c.com
China Mobile
32 Xuanwumen West Street Beijing Xicheng District 100053 China lijinming@chinamobile.com
OPS grow IDR GROW BGP BMP The BGP Monitoring Protocol (BMP) described in RFC 7854 defines statistics message types to observe events that occur on a monitored router. This document defines new statistics types to monitor BMP Adj&nbhy;RIB&nbhy;In and Adj&nbhy;RIB&nbhy;Out Routing Information Bases (RIBs).
Introduction defines a number of different BGP Monitoring Protocol (BMP) statistics types to observe major events that occur on a monitored router. Statistics are either counters or Gauges. also defines several BMP statistics types for Adj&nbhy;RIB&nbhy;Out of a monitored router. New BMP statistics types are needed to enable more-refined BGP route monitoring and analysis to improve operational maintenance and troubleshooting capabilities. This document defines Gauges for new BMP statistics. The applicability scope of these new Gauges (Adj&nbhy;RIB&nbhy;In, Adj&nbhy;RIB&nbhy;Out, Loc-RIB) is provided in . The format of the BMP Statistics Report message remains the same as defined in .
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.
Terminology This document makes use of the following terms:
Adj&nbhy;RIB&nbhy;In:
As defined in :
The Adj-RIBs-In contains unprocessed routing information that has been advertised to the local BGP speaker by its peers.
Pre-policy Adj&nbhy;RIB&nbhy;In:
The result before applying the inbound policy to an Adj&nbhy;RIB&nbhy;In. Note that this is an explicit definition that aligns with the pre-policy Adj&nbhy;RIB&nbhy;In concept specified in .
Post-policy Adj&nbhy;RIB&nbhy;In:
As defined in :
The result of applying inbound policy to an Adj&nbhy;RIB&nbhy;In, but prior to the application of route selection to form the Loc-RIB.
Adj&nbhy;RIB&nbhy;Out:
As defined in :
The Adj-RIBs-Out contains the routes for advertisement to specific peers by means of the local speaker's UPDATE messages.
Pre-policy Adj&nbhy;RIB&nbhy;Out:
As defined in :
The result before applying the outbound policy to an Adj&nbhy;RIB&nbhy;Out. This normally would match what is in the local RIB.
Post-policy Adj&nbhy;RIB&nbhy;Out:
As defined in :
The result of applying outbound policy to an Adj&nbhy;RIB&nbhy;Out. This MUST convey to the BMP receiver what is actually transmitted to the peer.
Loc-RIB:
As defined in :
The Loc-RIB contains the routes that have been selected by the local BGP speaker's Decision Process.
Note that the Loc-RIB state as monitored through BMP might also contain routes imported from other routing protocols such as an IGP or local static routes.
Route:
As defined in :
A unit of information that pairs a set of destinations with the attributes of a path to those destinations.
The terms "producer" and "collector" are equivalent to "monitored router" and "monitoring station", respectively. Also, "implementation" follows the same usage as in .
RIB Monitoring Statistics This section defines different statistics types for Adj&nbhy;RIB&nbhy;In and Adj&nbhy;RIB&nbhy;Out monitoring types. Some of these statistics are also applicable to Loc-RIB; refer to for more details.
Statistics Format The BMP Statistics Report message carries statistic information in Type-Length-Value (TLV) formats. Each statistic is encoded as a TLV (Stat Type, Stat Len, Stat Data) (see ). "Stat Data" is being referred to as "value" when defining various RIB Monitoring Statistics. Statistics defined in this document can be categorized into two granularities: Global Statistics and Per-AFI/SAFI (see ) Statistics. Statistics defined with Per-AFI/SAFI descriptions belong to Per-AFI/SAFI Statistics, while other statistics belong to Global Statistics. Both Global Statistics and their corresponding Per-AFI/SAFI Statistics can be reported simultaneously. The Per-AFI/SAFI Statistics apply only to the AFI/SAFI that a BGP speaker supports and negotiates with its peer. The authoritative registries for AFI/SAFI values are maintained by IANA (see and ). For Global Statistics, the "Stat Data" (value) field is a single 64-bit unsigned integer Gauge where the "Stat Len" field MUST be set to 8. Each global statistic MUST appear only once in a BMP Statistics Report message. For Per-AFI/SAFI Statistics, the "Stat Data" (value) field is a 11-byte structured value formatted as a 2-byte AFI, a 1-byte SAFI, and a 64-bit Gauge. The "Stat Len" MUST be set to 11. For any given per-AFI/SAFI Statistic, duplicate (AFI, SAFI) pairs MUST NOT appear within the same BMP Statistics Report message. Per-AFI/SAFI statistics MUST NOT be included in the BMP Statistics Report message if there is no data to report for that AFI/SAFI. If statistics apply to the Loc-RIB, the "Peer Type" field in the Per-Peer Header of the corresponding BMP Statistics Report message MUST be set to 3 (Loc-RIB Instance Peer) . Otherwise, the "Peer Type" field MUST be set as defined in . A BMP implementation MUST ignore unrecognized Stat Types upon receipt.
Adj&nbhy;RIB&nbhy;In RIB Monitoring Statistics Definition
Type = 18: (64-bit Gauge)
Current number of routes in the pre-policy Adj&nbhy;RIB&nbhy;In. This Gauge is similar to Stat Type 7 defined in and makes it explicitly for the pre-policy Adj&nbhy;RIB&nbhy;In.
Type = 19: (64-bit Gauge)
Current number of routes in the per-AFI/SAFI pre-policy Adj&nbhy;RIB&nbhy;In. This Gauge is similar to Stat Type 9 defined in and makes it explicitly for the pre-policy Adj&nbhy;RIB&nbhy;In.The value is structured as a 2-byte AFI, a 1-byte SAFI, and a 64-bit Gauge.
Type = 20: (64-bit Gauge)
Current number of routes in the post-policy Adj&nbhy;RIB&nbhy;In.
Type = 21: (64-bit Gauge)
Current number of routes in the per-AFI/SAFI post-policy Adj&nbhy;RIB&nbhy;In.The value is structured as a 2-byte AFI, a 1-byte SAFI, and a 64-bit Gauge.
Type = 22: (64-bit Gauge)
Current number of routes in the per-AFI/SAFI pre-policy Adj&nbhy;RIB&nbhy;In rejected by an inbound policy. This Gauge is different from Stat Type 0 defined in . Stat Type 0 is a 32-bit counter that is a monotonically increasing number; the Stat Type 22 is a 64-bit Gauge that represents the current number of routes rejected by an inbound policy due to ongoing policy configuration changes.The value is structured as a 2-byte AFI, a 1-byte SAFI, and a 64-bit Gauge.
Type = 23: (64-bit Gauge)
Current number of routes in the per-AFI/SAFI post-policy Adj&nbhy;RIB&nbhy;In accepted by an inbound policy.The value is structured as a 2-byte AFI, a 1-byte SAFI, and a 64-bit Gauge.
Type = 26: (64-bit Gauge)
Current number of routes in the per-AFI/SAFI post-policy Adj&nbhy;RIB&nbhy;In or Loc-RIB suppressed by a configured route-damping policy.The value is structured as a 2-byte AFI, a 1-byte SAFI, and a 64-bit Gauge.'Suppressed' refers to a route that has been declared suppressed by the BGP Route Flap Damping mechanism as described in .
Type = 27: (64-bit Gauge)
Current number of routes in the per-AFI/SAFI post-policy Adj&nbhy;RIB&nbhy;In or Loc-RIB marked as stale by Graceful Restart (GR) events.The value is structured as a 2-byte AFI, a 1-byte SAFI, and a 64-bit Gauge.'Stale' refers to a route that has been declared stale by the BGP GR mechanism as described in .
Type = 28: (64-bit Gauge)
Current number of routes in the per-AFI/SAFI post-policy Adj&nbhy;RIB&nbhy;In or Loc-RIB marked as stale by Long-Lived Graceful Restart (LLGR).The value is structured as a 2-byte AFI, a 1-byte SAFI, and a 64-bit Gauge.'Stale' refers to a route that has been declared stale by the BGP LLGR mechanism as described in .
Type = 29: (64-bit Gauge)
Current number of routes in the post-policy Adj&nbhy;RIB&nbhy;In left before exceeding the received-route threshold as defined in .
Type = 30: (64-bit Gauge)
Current number of routes in the per-AFI/SAFI in post-policy Adj&nbhy;RIB&nbhy;In left before exceeding the received-route threshold that corresponds to the upper bound of per-AFI/SAFI accepted routes following the model defined in .The value is structured as a 2-byte AFI, a 1-byte SAFI, and a 64-bit Gauge.
Type = 31: (64-bit Gauge)
Current number of routes in the post-policy Adj&nbhy;RIB&nbhy;In or Loc-RIB left before exceeding a license-customized route threshold. If no such license is configured, or if the license does not impose a hard limit, this value MUST NOT be reported.
Type = 32: (64-bit Gauge)
Current number of routes in the per-AFI/SAFI post-policy Adj&nbhy;RIB&nbhy;In or Loc-RIB left before exceeding a license-customized route threshold. If no such license is configured, or if the license does not impose a hard limit, this value MUST NOT be reported.The value is structured as a 2-byte AFI, a 1-byte SAFI, and a 64-bit Gauge.
Type = 33: (64-bit Gauge)
Current number of routes in the pre-policy Adj&nbhy;RIB&nbhy;In rejected due to exceeding the maximum AS_PATH length supported by the local configuration.
Type = 34: (64-bit Gauge)
Current number of routes in the per-AFI/SAFI in pre-policy Adj&nbhy;RIB&nbhy;In rejected due to exceeding the maximum AS_PATH length supported by the local configuration.The value is structured as a 2-byte AFI, a 1-byte SAFI, and a 64-bit Gauge.
Type = 35: (64-bit Gauge)
Current number of routes in the per-AFI/SAFI post-policy Adj&nbhy;RIB&nbhy;In invalidated after verifying the route origin Autonomous System Number (ASN) through the Route Origin Authorization (ROA) of the Resource Public Key Infrastructure (RPKI) . This is the total number of routes invalidated due to a mismatch of origin ASNs and a mismatch of prefix length.The value is structured as a 2-byte AFI, a 1-byte SAFI, and a 64-bit Gauge.
Type = 36: (64-bit Gauge)
Current number of routes in the per-AFI/SAFI post-policy Adj&nbhy;RIB&nbhy;In validated after verifying the route origin ASN through the ROA of the RPKI .The value is structured as a 2-byte AFI, a 1-byte SAFI, and a 64-bit Gauge.
Type = 37: (64-bit Gauge)
Current number of routes in the per-AFI/SAFI post-policy Adj&nbhy;RIB&nbhy;In whose RPKI route origin validation state is NotFound due to the absence of a matching ROA of RPKI .The value is structured as a 2-byte AFI, a 1-byte SAFI, and a 64-bit Gauge.
Adj&nbhy;RIB&nbhy;Out RIB Monitoring Statistics Definition
Type = 38: (64-bit Gauge)
Current number of routes in the per-AFI/SAFI pre-policy Adj&nbhy;RIB&nbhy;Out rejected by an outbound policy. These routes are active routes that otherwise would have been advertised in the absence of an outbound policy that rejected them. The value is structured as a 2-byte AFI, a 1-byte SAFI, and a 64-bit Gauge.
Type = 39: (64-bit Gauge)
Current number of routes in the pre-policy Adj&nbhy;RIB&nbhy;Out filtered due to the AS_PATH length exceeding the locally configured maximum.
Type = 40: (64-bit Gauge)
Current number of routes in the per-AFI/SAFI pre-policy Adj&nbhy;RIB&nbhy;Out filtered due to AS_PATH length exceeding the locally configured maximum.The value is structured as a 2-byte AFI, a 1-byte SAFI, and a 64-bit Gauge.
Type = 41: (64-bit Gauge)
Current number of routes in the per-AFI/SAFI post-policy Adj&nbhy;RIB&nbhy;Out invalidated after verifying the route origin ASN through the ROA of the RPKI . This is the total number of routes invalidated due to a mismatch of origin ASNs and a mismatch of prefix lengths.The value is structured as a 2-byte AFI, a 1-byte SAFI, and a 64-bit Gauge.
Type = 42: (64-bit Gauge)
Current number of routes in the per-AFI/SAFI post-policy Adj&nbhy;RIB&nbhy;Out validated after verifying the route origin ASN through the ROA of the RPKI .The value is structured as a 2-byte AFI, a 1-byte SAFI, and a 64-bit Gauge.
Type = 43: (64-bit Gauge)
Current number of routes in the per-AFI/SAFI post-policy Adj&nbhy;RIB&nbhy;Out whose RPKI route origin validation state is NotFound due to the absence of a matching ROA of RPKI .The value is structured as a 2-byte AFI, a 1-byte SAFI, and a 64-bit Gauge.
Application Scope of Statistics briefly lists the statistics defined in this document and outlines their scope of application. Scope of Application
Type Pre-policy Adj&nbhy;RIB&nbhy;In Post-policy Adj&nbhy;RIB&nbhy;In Loc-RIB Pre-policy Adj&nbhy;RIB&nbhy;Out Post-policy Adj&nbhy;RIB&nbhy;Out
18 Y N N N N
19 Y N N N N
20 N Y N N N
21 N Y N N N
22 Y N N N N
23 N Y N N N
26 N Y Y N N
27 N Y Y N N
28 N Y Y N N
29 N Y N N N
30 N Y N N N
31 N Y Y N N
32 N Y Y N N
33 Y N N N N
34 Y N N N N
35 N Y N N N
36 N Y N N N
37 N Y N N N
38 N N N Y N
39 N N N Y N
40 N N N Y N
41 N N N N Y
42 N N N N Y
43 N N N N Y
Implementation Considerations This document specifies Gauges for new BMP statistics. The format of BMP Statistics Report messages remains unchanged from . This section outlines the implementation considerations for new BMP statistics. For backward compatibility, and absent any other policy, it is RECOMMENDED that BMP producers capable of generating both (Types 7 and 18) and (Types 9 and 19) BMP statistics transmit both corresponding types simultaneously. This allows BMP collectors to process either format according to their needs without disrupting existing implementations that rely on Types 7 or 9. The selection of which statistics types to generate within each pair SHOULD be treated as an implementation decision rather than a protocol requirement, with the BMP collector behavior for handling these statistics types remaining implementation specific. Some statistics are dependent on feature configurations, such as GR, LLGR, and RPKI; therefore, the corresponding statistics SHOULD only be generated and sent when these features are enabled on the BMP producer. These statistics include the following Types: 26, 27, 28, 29, 30, 31, 32, 33, 34, 35, 36, 37, 39, 40, 41, 42, and 43. Some statistics are also relevant for the Loc-RIB view ; therefore, they may apply to the Loc-RIB view after best-path selection is completed. These statistics include Types 26, 27, 28, 31, and 32. When these statistics apply to the Loc-RIB view, the "Peer Type" field in the Per-Peer Header of the corresponding BMP Statistics Report message MUST set to 3. Certain statistics may have logical relationships (e.g., per-AFI/SAFI counts summing to global totals). BMP statistics producers and collectors MAY perform consistency checks but MUST NOT assume strict dependencies (due to potential race conditions or partial failures). Discrepancies (e.g., sum(per-AFI/SAFI) != global count) SHOULD be logged as warnings but MUST NOT disrupt protocol operation. The generation and transmission of Types 27 and 28 during an active GR/LLGR event consumes additional control plane resources (e.g., CPU). BMP statistics producers SHOULD prioritize the core GR/LLGR convergence procedures. To avoid adversely impacting the restart process, a BMP statistics producer MAY choose to sample this value at a lower frequency, buffer the updates, or temporarily suspend reporting for this type during the most critical phases of a switchover. These Gauges may reset due to manual clearance or overflow. BMP statistics producers and collectors MUST track discontinuities and log this anomaly.
Operational Considerations This section outlines some operational considerations of new BMP statistics for BMP operators. Transmission scheduling and triggering mechanisms for new Gauges are implementation dependent. BMP operators SHOULD determine appropriate report generation and delivery strategies, including configurable timing intervals and threshold values. The mechanism for controlling the reporting of new Gauges SHOULD be consistent with that of existing types. BMP operators SHOULD rate-limit statistics updates to minimize performance impact on control plane processes. BMP operators SHOULD only enable necessary statistics to reduce memory and CPU overhead. Implementations SHOULD also support per-router configuration of statistic subsets for collection and reporting. Some BMP statistics producers, or configurations in BMP statistics producers, MAY discard routes that do not match policy; thus, the accepted count (Type 23) and the Adj&nbhy;RIB&nbhy;In counts (Type 21) will be identical in such cases. BMP operators SHOULD be aware of this behavior when interpreting these Gauges. BMP operators SHOULD be aware that BMP statistics producers and collectors MAY log inconsistencies between statistics as warnings.
Security Considerations Procedures and protocol extensions defined in this document do not affect the BMP security model. All security and authentication mechanisms required by , , and are also applicable to the Gauges defined in this document. This document does not add any additional security considerations. Monitored devices SHOULD be configured to implement rate-limited reporting of new Gauges.
IANA Considerations IANA has assigned the following new parameters in the "BMP Statistics Types" registry, part of the "BGP Monitoring Protocol (BMP) Parameters" registry group. IANA has listed these entries as follows. This document serves as a reference for each entry. BMP Statistics Types
Stat Type Description
18 Number of routes currently in the pre-policy Adj&nbhy;RIB&nbhy;In.
19 Number of routes currently in the per-AFI/SAFI pre-policy Adj&nbhy;RIB&nbhy;In.
20 Number of routes currently in the post-policy Adj&nbhy;RIB&nbhy;In.
21 Number of routes currently in the per-AFI/SAFI post-policy Adj&nbhy;RIB&nbhy;In.
22 Number of routes currently in the per-AFI/SAFI pre-policy Adj&nbhy;RIB&nbhy;In rejected by an inbound policy.
23 Number of routes currently in the per-AFI/SAFI post-policy Adj&nbhy;RIB&nbhy;In accepted by an inbound policy.
26 Number of routes currently in the per-AFI/SAFI post-policy Adj&nbhy;RIB&nbhy;In or Loc-RIB suppressed by a configured route-damping policy.
27 Number of routes currently in the per-AFI/SAFI post-policy Adj&nbhy;RIB&nbhy;In or Loc-RIB marked as stale by GR events.
28 Number of routes currently in the per-AFI/SAFI post-policy Adj&nbhy;RIB&nbhy;In or Loc-RIB marked as stale by LLGR.
29 Number of routes currently in the post-policy Adj&nbhy;RIB&nbhy;In left before exceeding the received-route threshold.
30 Number of routes currently in the per-AFI/SAFI post-policy Adj&nbhy;RIB&nbhy;In left before exceeding the received-route threshold.
31 Number of routes currently in the post-policy Adj&nbhy;RIB&nbhy;In or Loc-RIB left before exceeding a license-customized route threshold.
32 Number of routes currently in the per-AFI/SAFI post-policy Adj&nbhy;RIB&nbhy;In or Loc-RIB left before exceeding a license-customized route threshold.
33 Number of routes currently in the pre-policy Adj&nbhy;RIB&nbhy;In rejected due to exceeding the locally configured maximum AS_PATH length.
34 Number of routes currently in the per-AFI/SAFI pre-policy Adj&nbhy;RIB&nbhy;In rejected due to exceeding the locally configured maximum AS_PATH length.
35 Number of routes currently in the per-AFI/SAFI post-policy Adj&nbhy;RIB&nbhy;In invalidated after verifying the route origin ASN through the ROA of the RPKI and mismatch of prefix length.
36 Number of routes currently in the per-AFI/SAFI post-policy Adj&nbhy;RIB&nbhy;In validated after verifying the route origin ASN through the ROA of the RPKI.
37 Number of routes currently in the per-AFI/SAFI post-policy Adj&nbhy;RIB&nbhy;In whose RPKI route origin validation state is NotFound.
38 Number of routes currently in the per-AFI/SAFI pre-policy Adj&nbhy;RIB&nbhy;Out rejected by an outbound policy.
39 Number of routes currently in the pre-policy Adj&nbhy;RIB&nbhy;Out filtered due to AS_PATH length exceeding the locally configured maximum.
40 Number of routes currently in the per-AFI/SAFI pre-policy Adj&nbhy;RIB&nbhy;Out filtered due to AS_PATH length exceeding the locally configured maximum.
41 Number of routes currently in the per-AFI/SAFI post-policy Adj&nbhy;RIB&nbhy;Out invalidated after verifying the route origin ASN through the ROA of the RPKI and mismatch of prefix length.
42 Number of routes currently in the per-AFI/SAFI post-policy Adj&nbhy;RIB&nbhy;Out validated after verifying the route origin ASN through the ROA of the RPKI.
43 Number of routes currently in the per-AFI/SAFI post-policy Adj&nbhy;RIB&nbhy;Out whose RPKI route origin validation state is NotFound.
References Normative References Address Family Numbers IANA Subsequent Address Family Identifiers (SAFI) Parameters IANA
Acknowledgements The authors would like to thank , , , and for their valuable input. Thanks to for the OPSDIR, for the GENART, and for the RTGDIR review. Thanks to , , and for the IESG review.