38 lines
1.7 KiB
Markdown
38 lines
1.7 KiB
Markdown
# Global Route Collector
|
|
|
|
The global route collector is a common resource for collecting route data from across the DN42 network. This data can then be used to provide statistics and a global map of the DN42 network.
|
|
|
|
## Providing Routes to the Collector
|
|
|
|
All DN42 users are invited to provide routes to the collector; the more users that take part, the more useful the collector becomes.
|
|
|
|
1. Contact burble@hackint or mail dn42@burble.com, including your AS number and BGP peer address(es)
|
|
|
|
The collector runs bird2 and supports multiprotocol BGP; the preference is for multiprotocol peering over IPv6.
|
|
If you can't support multiprotocol BGP, please provide both IPv4 and IPv6 peer addresses.
|
|
|
|
2. Configure a BGP session for the collector on your router.
|
|
|
|
Some example client configurations are included in the 'examples' directory.
|
|
Users are encouraged to configure the [BGP Add-Path](https://tools.ietf.org/html/rfc7911) extension to provide a comprehensive set of routes to the collector.
|
|
|
|
3. Profit !
|
|
|
|
|
|
## Route Collector Services
|
|
|
|
### Looking Glass
|
|
|
|
[http://collector.dn42:5001/](http://collector.dn42:5001/) (DN42 link)
|
|
[https://grc.burble.com/](https://grc.burble.com/) (public internet link)
|
|
|
|
The burble.dn42 looking glass is based on [bird-lg](https://github.com/sileht/bird-lg) with
|
|
patches by [Zhaofeng](https://github.com/zhaofengli/bird-lg) and [Burble](https://github.com/sesa-me/bird-lg)
|
|
to fix formating and bird2 compatibility.
|
|
|
|
### Prometheus Metrics
|
|
|
|
[http://collector.dn42:9324/metrics](http://collector.dn42:9324/metrics)
|
|
|
|
The collector runs [bird_exporter](https://github.com/czerwonk/bird_exporter) and the metrics are publically available on the default bird_exporter port.
|