Skip to content

v0.25.0

Choose a tag to compare

@github-actions github-actions released this 13 Nov 14:03
· 9 commits to main since this release
705f923

A new bmp stage (BMP station and exporter), 2-byte ASN guessing on by default, RouteViews and RIS Live streams that keep up and stay up, RPKI snapshots straight from RPKIviews, and a batch of security and correctness fixes. Built on bgpfix v0.25.0; version numbers of bgpipe and bgpfix now match.

Highlights

BMP station and exporter: the new bmp stage

Collect BMP from your routers, or turn any BGP session, MRT archive or live feed into a BMP feed, over TCP or TLS. Tested against NLnet Labs Rotonda and FastNetMon Netom.

# BMP station: collect from your routers, keep post-policy routes, archive as MRT
bgpipe -- bmp --listen --peer 192.0.2.0/24 :11019 \
  -- grep 'tag[BMP_RIB] == in-post' -- write --every 15m 'bmp.$TIME.mrt.gz'

# turn RIPE RIS Live into a BMP feed for your own collector
bgpipe -- ris-live -- bmp --write collector.example.net:11019
  • Station:
    • every UPDATE is tagged with its peer and RIB view: PEER_IP, PEER_AS, PEER_ID, BMP_RIB, PEER_RD, PEER_TYPE, ROUTER;
    • ADD-PATH is decoded per peer and address family, as negotiated in the OPENs of Peer Up;
    • Peer Up and Peer Down become bmp/peer-up and bmp/peer-down events;
    • Statistics Reports become bgpipe_bmp_stats Prometheus gauges.
  • Exporter (--write):
    • sends an Initiation, then a Peer Up before the first UPDATE of each peer;
    • for a live BGP session, the Peer Up carries the real OPENs;
    • a station that reads too slowly is dropped, never stalling the pipeline.
  • Security: --peer allow-list, TLS with --cert/--key (listening) or --tls (connecting), and a warning when listening without --peer. BMP has no authentication, so use both on untrusted networks.

See the bmp stage docs.

--format bmp files are complete BMP sessions

write --format bmp now writes an Initiation and a Peer Up per peer, so a file can be replayed straight into any collector: nc station 11019 <file.bmp. Before, Rotonda and Netom ignored such files completely. With --every, each file starts its own session.

2-byte ASNs guessed by default: --as4 auto|on|off

RIS Live, RouteViews and raw BGP input from peers that use 2-byte ASNs used to fail to parse unless you passed -g. Guessing is now the default (--as4 auto): 4-byte ASNs are assumed, with a fallback to 2-byte on parse errors. Live sessions and MRT/BMP input are not affected, as negotiated caps and per-message metadata always win. MRT and BMP output of 2-byte data is no longer mislabelled as 4-byte (data corruption, fixed in bgpfix).

Live feeds that keep up and stay up

  • rv-live:
    • reads with 4 parallel Kafka consumers (--consumers), enough for the whole RouteViews feed (about 13k records/s, against about 3k with one);
    • no more permanent stall on slow or long-distance links;
    • --stale works;
    • offsets resume correctly after a reconnect or rebalance, with no duplicates.
  • ris-live:
    • retries every connection error with backoff, instead of giving up on some;
    • no false timeouts on quiet --sub streams;
    • logs RIS Live error messages.

RPKI snapshots from RPKIviews

--rpki reads CCR files (as written by rpki-client), now also from a .tgz URL. That pins "the RPKI state of that day" in one reproducible command:

bgpipe --rpki https://josephine.sobornost.net/rpkidata/2026/10/25/rpki-20261025T000753Z.tgz \
  -- read updates.20261025.0000.mrt -- rov -- aspa

rov is also faster on RIB dumps, which repeat each prefix once per peer: verdicts are memoized.

Fixes

  • write: --create silently overwrote existing files and --append never appended (both applied to the .tmp file). /dev/null and FIFOs work as targets.
  • Streaming MRT to a router (read file.mrt -- connect ...) exits cleanly without losing the tail of the file. A clean close no longer sends a TCP RST that dropped unread data.
  • connect --tls never worked; it does now.
  • connect --retry also retries a refused connection, eg. while the other side restarts.
  • head after read no longer exits with an error; MRT RIB dumps are detected by content (eg. on stdin).
  • limit: --session N let through only N-1 prefixes; memory is now bounded by the live prefixes.
  • tag --drop with several tags dropped only the first; grep and metrics with -LR had a data race.
  • aspa: the first-hop check now runs before the single-hop shortcut.
  • Text input (JSON, ExaBGP) caps a line at 4 MiB, instead of buffering an endless line without bound.
  • speaker --asn and --remote-asn accept the full 32-bit range on all platforms.
  • HTTP API and websocket servers close idle keep-alive connections after 60 s; a websocket server no longer sends its --header values to clients.
  • connect --md5 rejects a TCP-MD5 password that is too long, instead of truncating it.
  • MPTCP is disabled, for predictable TCP behavior on BGP sessions.

Breaking changes

  • -g/--guess-asn and -2/--short-asn are gone: use --as4 auto (the default), --as4 on (never guess), or --as4 off (the old -2).
  • --format bmp / obmp write only UPDATEs, as Route Monitoring. bmp also adds an Initiation and Peer Ups, so a BMP → BMP round trip is no longer byte-identical.
  • connect --retry retries every connection error, not only timeouts.
  • BMP input carries the new tags above; a zero BMP timestamp becomes the current time.
  • JSON input: the ACTION field is ignored, so a feed cannot accept or drop its own messages past later stages.
  • ris-live --read-timeout defaults to 10 s without --sub, and to none with --sub.
  • rv-live opens 4 Kafka connections by default (--consumers 1 for the old behavior).

Other

  • Release binaries and the Docker image are built with Go 1.27; go.mod still allows Go 1.26.
  • Integration tests run against GoBGP, BIRD, FRR, Rotonda and Netom on every change, and the suite now also runs without docker (docker tests are skipped).
  • Docs: new bmp page, and a reworked landing page.
  • Dependencies: bgpfix v0.25.0, VictoriaMetrics/metrics v1.45.0, spf13/pflag v1.1.0, franz-go v1.22.3, klauspost/compress v1.20.4.

Full Changelog: v0.23.0...v0.25.0