https://github.com/bgpkit/ris-live-rs
Rust SDK for working with RIS-Live real-time BGP data stream.
https://github.com/bgpkit/ris-live-rs
Last synced: 10 months ago
JSON representation
Rust SDK for working with RIS-Live real-time BGP data stream.
- Host: GitHub
- URL: https://github.com/bgpkit/ris-live-rs
- Owner: bgpkit
- License: mit
- Created: 2021-11-24T15:26:21.000Z (over 4 years ago)
- Default Branch: main
- Last Pushed: 2024-10-16T21:58:59.000Z (over 1 year ago)
- Last Synced: 2025-04-12T21:37:02.906Z (about 1 year ago)
- Language: Rust
- Size: 59.6 KB
- Stars: 13
- Watchers: 3
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
# ris-live-rs
`ris-live-reader` is a CLI tool that builds up top of [`bgpkit-parser`](https://github.com/bgpkit/bgpkit-parser)
library's RIS live message parsing functionalities to provide a commandline interface to stream BGP data from the
[RIS-Live project](https://ris-live.ripe.net/).
[](https://asciinema.org/a/zAxCUmUko9H7T8KM9qFY77uPo)
Full command-line options are:
```
ris-live-reader 0.3.0
ris-live-reader is a simple cli tool that can stream BGP data from RIS-Live project with websocket. Check out
https://ris-live.ripe.net/ for more data source information
USAGE:
ris-live-reader [FLAGS] [OPTIONS]
FLAGS:
-h, --help Prints help information
--json Output as JSON objects
--less-specific Match prefixes that are less specific (contain) `prefix`
--more-specific Match prefixes that are more specific (part of) `prefix`
--pretty Pretty-print JSON output
--raw Print out raw message without parsing
-V, --version Prints version information
OPTIONS:
--client client name to identify the stream [default: ris-live-rs]
--host Filter by RRC host: e.g. rrc01. Use "all" for the firehose [default: rrc21]
--msg-type Only include messages of a given BGP or RIS type: UPDATE, OPEN, NOTIFICATION,
KEEPALIVE, or RIS_PEER_STATE
--path ASN or pattern to match against the AS PATH attribute
--peer Only include messages sent by the given BGP peer
--prefix Filter UPDATE messages by prefixes in announcements or withdrawals
--require Only include messages containing a given key
--update-type Only a given BGP update type: announcement (a) or withdrawal (w)
```
### Installation
Install via cargo by:
```bash
cargo install ris-live-rs
```
Or checkout the repo and run:
```bash
cargo install --path .
```
The program `ris-live-reader` will be installed to your `$CARGO_HOME/bin` (e.g. `~/.cargo/bin`).
### Run with Docker
```bash
docker run --rm -it bgpkit/ris-live-reader --help
```
## Built with ❤️ by BGPKIT Team
