BGP Dashboard

A "realtime" web view of your BGP network

• Who do I peer with?
• How many routes do I receive from my peers?
• Who do I use for tranist?
• What AS path does a prefix take out of my network?
• How many routes and autonomous systems do I see?
• BGP Looking Glass (IPv4/IPv6/ASN)

How it works

This is beta code.

• BGP peering session using GoBGP
• GoBGP pipes BGP information into MongoDB
• Flask App queries MongoDB to build website and JSON API

This project uses three Docker containers

• GoBGP (osrg/gobgp)
• MongoDB (mongo)
• Flask (docker-flask)

GoBGP

The GoBGP container serves two functions:

• Peer with the "real" network
  • Configure gobgpd.conf to peer with the real network.
  • Only IPv4-Unicast and IPv6-Unicast supported at this time.
• Pass BGP updates into BGP
  • The gobgp_to_mongo.py script pipes the JSON updates from GoBGP into the MongoDB container

MongoDB

• Mongo receives JSON updates from the GoBGP container
• The Flask App queries Mongo for relevant information

Flask

• Flask presents a Dashboard for realtime BGP updates
• A JSON API is used on the backend to support the frontend and display Looking Glass queries

Screenshot

Install

$ git clone https://github.com/rhicks/bgp-dashboard.git
$ cd bgp-dashboard
$ # modify ./gobgp/gobgpd.conf to peer with your network
$ # modify ./flask/app/constants.py globals to use your ASN and BGP communities
$ docker-compose build
$ docker-compose up (watch the log to verify BGP peeering is established)

Todo

• ???