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.

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

• Installation
  • Run from binary
  • Run from source code
• Monitored prefixes list
  • Generate prefix list
  • Prefix attributes description
• Configuration
  • Composition
    • Connectors
    • Monitors
    • Reports
      • reportFile
      • reportEmail
      • reportSlack
      • reportKafka
      • reportSyslog
  • Uptime monitoring
• More information for developers
  • All npm commands