https://github.com/pierky/invalidroutesreporter

An ExaBGP process to elaborate and report/log invalid routes received by route servers.
https://github.com/pierky/invalidroutesreporter

bgp ixps routing

Last synced: 5 months ago
JSON representation

An ExaBGP process to elaborate and report/log invalid routes received by route servers.

• Host: GitHub
• URL: https://github.com/pierky/invalidroutesreporter
• Owner: pierky
• License: gpl-3.0
• Created: 2017-06-21T10:42:59.000Z (almost 9 years ago)
• Default Branch: master
• Last Pushed: 2017-06-30T16:44:29.000Z (almost 9 years ago)
• Last Synced: 2025-10-27T08:33:15.649Z (8 months ago)
• Topics: bgp, ixps, routing
• Language: Python
• Size: 563 KB
• Stars: 15
• Watchers: 3
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.rst
  • Changelog: CHANGES.rst
  • License: LICENSE

Awesome Lists containing this project

README

          
.. DO NOT EDIT: this file is automatically created by /utils/build_doc

InvalidRoutesReporter

=====================

|Documentation| |Build Status| |PYPI Version|

This script is intended to be used as an `ExaBGP `_ process to elaborate and report/log invalid routes that have been tagged with meaningful dedicated BGP communities by route servers.

Invalid routes are those routes that, for some reason, didn't pass the route server's validation process (invalid/private ASNs in the AS_PATH, bogon prefixes, invalid NEXT_HOP, IRRDBs data mismatch, ...). Route servers, instead of discarding them, can keep these routes and tag them with a BGP community that describes the reason for which they have been considered as invalid.

A session with an ExaBGP-based route collector can be used to announce these invalid routes to this script, that finally processes them, extracts the reject reason and uses this information to log a record or to send an email alert to the involved networks.

If deployed in conjunction with `ARouteServer`_, the `"tag" reject policy option `_ can be used to easily setup the route server to work together with this script.

.. _ARouteServer: https://github.com/pierky/arouteserver

.. image:: diagram.png

For more information: https://invalidroutesreporter.readthedocs.io

Author

++++++

Pier Carlo Chiodi - https://pierky.com

Blog: https://blog.pierky.com Twitter: `@pierky `_

.. |Documentation| image:: https://readthedocs.org/projects/invalidroutesreporter/badge/?version=latest

    :target: https://invalidroutesreporter.readthedocs.org/en/latest/?badge=latest

.. |Build Status| image:: https://travis-ci.org/pierky/invalidroutesreporter.svg?branch=master

    :target: https://travis-ci.org/pierky/invalidroutesreporter

.. |PYPI Version| image:: https://img.shields.io/pypi/v/invalidroutesreporter.svg

    :target: https://pypi.python.org/pypi/invalidroutesreporter/