Peer Stats

A Rust library and CLI tool for processing BGP RIB dump files to extract peer statistics, AS relationships, and prefix-to-AS mappings.

Hosted Results: Processed data is available at:

• data.bgpkit.com/peer-stats - Peer statistics
• data.bgpkit.com/as2rel - AS relationship inferences
• data.bgpkit.com/pfx2as - Prefix-to-AS mappings

Overview

This crate provides three main processors for analyzing BGP data:

1. Peer Stats (peer_stats.rs): Collects per-peer statistics including ASN, IP, and prefix counts
2. AS2Rel (as2rel.rs): Infers AS relationships (provider-customer) using a tier-1 transit algorithm
3. Pfx2As (pfx2as.rs): Maps IP prefixes to their origin ASes

All processors use a consistent pattern: new() → process_*() → into_*()

Features

• Modular Architecture: Each processor is self-contained in its own module
• Tier-1 Transit Algorithm: Distinguishes between true tier-1 ASes and candidate tier-1 ASes (Zayo 6461, Hurricane Electric 6939) to prevent over-counting downstream ASes
• Processor Pattern: Consistent API across all modules
• SQLite Indexing: Tools to index processed data into SQLite databases

AS Relationship Inference

The AS2Rel processor uses a two-tier algorithm to infer provider-customer relationships:

• True Tier-1 ASes (14 networks): Always considered transit providers
  • Cogent (174), Lumen (3356), NTT (2914), Verizon (701), etc.
• Candidate Tier-1 ASes: Only transit providers when next hop is tier-1
  • AS 6461 (Zayo) - IPv4 and IPv6
  • AS 6939 (Hurricane Electric) - IPv6 only

This prevents over-counting downstream ASes for networks that peer extensively but don't sell transit service.

Installation

Rust toolchain is required:

cargo install --path .

Binaries

The project builds 5 binaries:

peer-stats-single-file

Process a single RIB dump file (outputs all three data types):

peer-stats-single-file --debug http://archive.routeviews.org/route-views.sg/bgpdata/2022.02/RIBS/rib.20220205.1800.bz2

peer-stats-bootstrap

Bootstrap historical data collection:

MAX_THREADS=8 peer-stats-bootstrap --output-dir ./data --ts-start 2022-01-01 --ts-end 2022-02-01

peer-stats-index

Index peer statistics into SQLite:

peer-stats-index --db-path ./peer-stats.db --input-dir ./data

as2rel-index

Index AS relationships into SQLite:

as2rel-index --db-path ./as2rel.db --input-dir ./data

pfx2as-index

Index prefix-to-AS mappings into SQLite:

pfx2as-index --db-path ./pfx2as.db --input-dir ./data

Library Usage

use peer_stats::parse_rib_file;let(peer_stats, pfx2as,(as2rel_global, as2rel_v4, as2rel_v6)) = parse_rib_file("http://archive.routeviews.org/.../rib.20220205.1800.bz2","route-views","route-views.sg").unwrap();

Data Types

Peer Stats Output

{
"project": "route-views",
"collector": "route-views.sg",
"rib_dump_url": "...",
"peers": {
"2001:de8:4::13:6168:1": {
"asn": 136168,
"ip": "2001:de8:4::13:6168:1",
"num_v4_pfxs": 0,
"num_v6_pfxs": 40,
"num_connected_asns": 4
}
}
}

AS2Rel Output

{
"project": "route-views",
"collector": "route-views.sg",
"rib_dump_url": "...",
"as2rel": [
{
"asn1": 174,
"asn2": 13335,
"rel": 1,
"paths_count": 42,
"peers_count": 3
}
]
}

Pfx2As Output

{
"project": "route-views",
"collector": "route-views.sg",
"rib_dump_url": "...",
"pfx2as": [
{
"prefix": "1.1.1.0/24",
"asn": 13335,
"count": 5
}
]
}

Public Dataset

We provide a publicly available dataset at https://data.bgpkit.com.

License

This work is under MIT license.