Alerta is an open source monitoring tool used to consolidate alerts for 'at-a-glance' visualisation.

Full Description

What is Alerta?

The alerta monitoring system is a tool used to consolidate andde-duplicate alerts from multiple sources for quick ‘at-a-glance’visualisation. With just one system you can monitor alerts frommany other monitoring tools on a single screen.

How to use this image

To use this image run either a mongo or postgres container first:

$ docker run --name alerta-db -d mongo

Then link to the database container when running the alerta-web container:

Installing Plugins

Plugins listed in the INSTALL_PLUGINS environment variable will be installedautomatically at container start time. Only plugins listed in PLUGINS will beenabled. This allows plugins to be installed and enabled at a later time.

In the example below, the reject and blackout plugins are installed bydefault, the slack and prometheus plugins are also installed but of thetwo only the slack plugin is enabled:

PLUGINS=reject,blackout,slack
INSTALL_PLUGINS=slack,prometheus

Alternatively, install all wanted plugins as an additional image layer.

Authentication

To make it easy to get going with Alerta on docker quickly, the default imagewill use Basic Auth for user logins and login will be optional.

To allow users to login using Google OAuth, go to the Google Developer Consoleand create a new client ID for a web application. Then set the CLIENT_IDand CLIENT_SECRET environment variables on the command line as follows:

GitHub and GitLab can also be used as the OAuth2 providers by setting thePROVIDER environment variable to github and gitlab respectively. Formore information on using GitHub, GitHub Enterprise or GitLab as th OAuth2provider see http://docs.alerta.io

Docker Compose

Use docker-compose to create and start Alerta and Postgres withone command: