ribeye 0.3.0

ribeye -- a Rust library for BGP RIB data processing.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29

# ribeye

BGP RIB processing framework written in Rust.

## Progress

Processors:
- [X] `peer-stats`: collector peer information from a given RIB dump file
- [X] `pfx2as`: prefix-to-AS mapping from a given RIB dump file
- [X] `as2rel`: AS-level relationship

Aggregator (aggregate from all files of the same day):
- [X] `peer-stats`
- [X] `pfx2as`
- [X] `as2rel`

## Run

Set up a cronjob (ideally 2+ hours after UTC midnight) and run the following command to generate daily data:

```bash
ribeye cook --dir /DATA/PATH/TO/OUTPUT/DIRECTORY
```

See the Hashicorp Nomad [job spec](deployment/nomad_periodic_raw.hcl) for an example Nomad deployment.

## Examples

See [`examples/`](examples) directory for usage examples.