invalidroutesreporter 0.1.0

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

.. 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 <https://github.com/Exa-Networks/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 <https://arouteserver.readthedocs.io/en/latest/CONFIG.html#reject-policy>`_ 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 <https://twitter.com/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/


Change log
==========

v0.1.0
------

First release as a standalone repository.

- New: make the *reject reason BGP community* optional and track also routes tagged with a *reject BGP community* only.

- New: optional external file containing the reason-code/description matrix.

- Fix: extended BGP communities processing.

- Improvement: ``min_wait`` and ``max_wait`` timers handling.