v0.7.0-beta.6
Pre-release
Pre-release
github-actions
released this
29 Apr 23:52
·
36 commits
to main
since this release
[New!] NATS notification
Added new-file notification by publishing newly indexed BGP MRT file meta information in JSON format to user-specified
NATS server.
The NATS URL and credentials is configured via environment variables:
BGPKIT_BROKER_NATS_URL
likenats://nats.bgpkit.com:4222
(default)BGPKIT_BROKER_NATS_ROOT_SUBJECT
such aspublic.broker.
(default)
The notification is published to public.broker.{PROJECT}.{COLLECTOR}.{DATA_TYPE}
where
PROJECT
isriperis
orroute-views
COLLECTOR
is the route collector IDs likerrc00
orroute-views2
DATA_TYPE
isrib
orupdates
Example of what a subscriber can be notified for:
public.broker.>
: any new MRT filespublic.broker.route-views.>
: new RouteViews updates filespublic.broker.rrc00.rib
: new RIPE RIS rrc00 RIB dump filespublic.broker.*.rib
: any new RIB dump files
This PR also adds a new subcommand bgpkit-broker live
that listens to the specified NATS server for new file
notification.
Streaming live from a broker NATS server
Usage: bgpkit-broker live [OPTIONS]
Options:
--no-log disable logging
-u, --url <URL> URL to NATS server, e.g. nats://localhost:4222. If not specified, will try to read from BGPKIT_BROKER_NATS_URL env variable
--env <ENV>
-s, --subject <SUBJECT> Subject to subscribe to, default to public.broker.>
-p, --pretty Pretty print JSON output
-h, --help Print help
-V, --version Print version
[New!] bgpkit-broker doctor
subcommand
Added bgpkit-broker doctor
subcommand that checks the broker instance status and missing collectors.
Check broker instance health and missing collectors
Usage: bgpkit-broker doctor [OPTIONS]
Options:
--no-log disable logging
--env <ENV>
-h, --help Print help
-V, --version Print version
Example output:
checking broker instance health...
broker instance at https://api.broker.bgpkit.com/v3 is healthy
checking for missing collectors...
missing the following collectors:
| project | name | country | activated_on | data_url |
|------------|--------------|-----------------|---------------------|----------------------------------------------------|
| routeviews | decix.jhb | Malaysia | 2022-12-20 12:00:00 | http://archive.routeviews.org/decix.jhb/bgpdata |
| routeviews | pacwave.lax | United States | 2023-03-30 12:00:00 | http://archive.routeviews.org/pacwave.lax/bgpdata |
| routeviews | pit.scl | Chile | 2023-08-31 23:45:00 | http://archive.routeviews.org/pit.scl/bgpdata |
| routeviews | amsix.ams | The Netherlands | 2024-02-22 23:20:00 | http://archive.routeviews.org/amsix.ams/bgpdata |
| routeviews | pitmx.qro | Mexico | 2024-02-23 22:15:00 | http://archive.routeviews.org/pitmx.qro/bgpdata |
| routeviews | iraq-ixp.bgw | Iraq | 2024-04-13 00:01:00 | http://archive.routeviews.org/iraq-ixp.bgw/bgpdata |