mirceaulinic / BGPalerter

Software to monitor streams of BGP data. Pre-configured for real-time visibility loss and hijacks detection.

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

Build Status Dependabot Status Reviewed by Hound Known Vulnerabilities

BGPalerter

Real-time BGP monitoring tool, pre-configured for visibility loss and hijacks detection.

You just run it. You don't need to provide any data source or connect it to anything in your network since it connects to public repos.

It can deliver alerts on files, by email, on slack, and more.

BGPalerter

TL;DR

This section is useful if you don't care about the source code but you just want to run the monitor. If you want to know more about the source code (which is completely open) please see the following sections.

  1. Download the binary here (be sure to select the one for your OS)

  2. Download config.yml.example as config.yml and prefixes.yml.example as prefixes.yml, and place them in the same directory of the executable (if you skip this step, some default configuration files will be generated during the first execution)

  3. Modify prefixes.yml and add the prefixes you want to monitor (or see below how to auto generate this file)

  4. Run the executable (e.g. chmod 700 bgpalerter-linux-x64 && nohup ./bgpalerter-linux-x64 &)

  5. See the alerts in logs/reports-YYYY-MM-DD.log (e.g. tail -f logs/reports*)

In config.yml.example you can find other reporting mechanisms (e.g. email and slack) in addition to logging to files. Please uncomment the related section and configure according to your needs.

Documentation

About

Software to monitor streams of BGP data. Pre-configured for real-time visibility loss and hijacks detection.

License:BSD 3-Clause "New" or "Revised" License


Languages

Language:JavaScript 99.6%Language:Shell 0.3%Language:Dockerfile 0.1%