2019-12-13 03:01:59 +01:00
|
|
|
[](https://travis-ci.org/nttgin/BGPalerter)
|
2019-10-25 17:56:33 +02:00
|
|
|
|
2019-10-27 22:28:06 +01:00
|
|
|
[](https://houndci.com)
|
2019-10-25 17:56:33 +02:00
|
|
|
|
2019-09-21 03:55:25 +02:00
|
|
|
# BGPalerter
|
|
|
|
|
Real-time BGP monitoring tool, pre-configured for visibility loss and hijacks detection.
|
2019-09-21 03:55:46 +02:00
|
|
|
|
2019-10-25 19:13:49 +02:00
|
|
|
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.
|
2019-10-05 19:18:11 +02:00
|
|
|
|
2019-09-21 03:55:25 +02:00
|
|
|
It can deliver alerts on files, by email, on slack, and more.
|
2019-09-21 03:55:46 +02:00
|
|
|
|
2019-09-21 03:55:25 +02:00
|
|
|
|
2019-07-15 10:36:01 +00:00
|
|
|
|
2020-03-09 01:26:55 +01:00
|
|
|
## TL;DR (1 minute setup)
|
2019-08-15 13:31:56 +02:00
|
|
|
> This section is useful if you don't care about the source code but you just want to run the monitor.
|
2020-01-30 00:10:30 +01:00
|
|
|
Instead, if you want to run the source code (which is completely open) or develop, please read directly the documentation.
|
2019-07-15 10:36:01 +00:00
|
|
|
|
2019-09-19 23:33:47 +02:00
|
|
|
1. Download the binary [here](https://github.com/nttgin/BGPalerter/releases) (be sure to select the one for your OS)
|
2019-07-15 10:36:01 +00:00
|
|
|
|
2020-04-07 16:42:21 -07:00
|
|
|
2. Execute the binary (e.g. `chmod +x bgpalerter-linux-x64 && ./bgpalerter-linux-x64`)
|
2020-03-12 14:48:51 +01:00
|
|
|
The first time you run it, the auto-configuration will start.
|
|
|
|
|
|
2019-07-15 10:36:01 +00:00
|
|
|
|
2020-03-09 01:26:55 +01:00
|
|
|
If something happens (e.g. a hijack) you will see the alerts in `logs/reports-YYYY-MM-DD.log`.
|
|
|
|
|
In `config.yml` you can find other reporting mechanisms (e.g. email and slack) in addition to logging on files.
|
2020-01-30 00:10:30 +01:00
|
|
|
Please uncomment the related section and configure according to your needs.
|
|
|
|
|
|
2020-03-09 01:26:55 +01:00
|
|
|
If the installation doesn't go smoothly, read [here](docs/installation.md).
|
2020-01-30 00:10:30 +01:00
|
|
|
Read the documentation below for more options.
|
2019-07-15 10:36:01 +00:00
|
|
|
|
2019-10-05 19:18:11 +02:00
|
|
|
## Documentation
|
|
|
|
|
|
|
|
|
|
- [Installation](docs/installation.md)
|
2019-12-12 22:47:00 +01:00
|
|
|
- [Run from binary](docs/installation.md#running-bgpalerter-from-binaries)
|
|
|
|
|
- [Run from source code](docs/installation.md#running-bgpalerter-from-the-source-code)
|
2020-01-18 19:05:10 +01:00
|
|
|
- [Run in Docker](docs/installation.md#running-bgpalerter-in-docker)
|
2019-10-05 19:18:11 +02:00
|
|
|
- [Monitored prefixes list](docs/prefixes.md#prefixes)
|
|
|
|
|
- [Generate prefix list](docs/prefixes.md#generate)
|
|
|
|
|
- [Prefix attributes description](docs/prefixes.md#prefixes-fields)
|
|
|
|
|
- [Configuration](docs/configuration.md)
|
2019-11-27 15:39:21 +01:00
|
|
|
- [Composition](docs/configuration.md#composition)
|
|
|
|
|
- [Connectors](docs/configuration.md#connectors)
|
|
|
|
|
- [Monitors](docs/configuration.md#monitors)
|
|
|
|
|
- [Reports](docs/configuration.md#reports)
|
|
|
|
|
- [reportFile](docs/configuration.md#reportfile)
|
|
|
|
|
- [reportEmail](docs/configuration.md#reportemail)
|
|
|
|
|
- [reportSlack](docs/configuration.md#reportslack)
|
|
|
|
|
- [reportKafka](docs/configuration.md#reportkafka)
|
2019-12-11 01:41:26 +01:00
|
|
|
- [reportSyslog](docs/configuration.md#reportsyslog)
|
2020-01-07 12:52:13 +00:00
|
|
|
- [reportAlerta](docs/configuration.md#reportalerta)
|
2020-01-27 18:02:53 -05:00
|
|
|
- [reportWebex](docs/configuration.md#reportwebex)
|
2020-04-14 04:17:14 +02:00
|
|
|
- [reportHTTP](docs/configuration.md#reporthttp)
|
2020-01-18 19:05:56 +01:00
|
|
|
- [Process/Uptime monitoring](docs/process-monitors.md)
|
2020-03-21 18:33:43 +01:00
|
|
|
- [Notification user groups](docs/usergroups.md)
|
2019-10-05 19:18:11 +02:00
|
|
|
- [More information for developers](docs/develop.md)
|
|
|
|
|
- [All npm commands](docs/develop.md#all-npm-commands)
|
2019-07-15 10:36:01 +00:00
|
|
|
|
