Alerta monitoring system
Switch branches/tags
Clone or download
Failed to load latest commit information.
alerta Add sub-query support to query parser (#714) Oct 19, 2018
contrib [WIP] Trigger user-configurable actions in plugins (#708) Oct 13, 2018
docs Whitespace fixes (#651) Sep 15, 2018
examples Type annotate plugins and webhooks (#700) Oct 10, 2018
tests Add sub-query support to query parser (#714) Oct 19, 2018
.flake8 Flake8 fixes (#652) Sep 15, 2018
.gitignore Do not track python virtual envs (#540) May 11, 2018
.isort.cfg Replace mongo-specific query stirng syntax with database agnostic (#712) Oct 18, 2018
.pre-commit-config.yaml Flake8 fixes (#652) Sep 15, 2018
.travis.yml Run CI tests against Python 3.7 (#696) Oct 9, 2018
LICENSE First commit for Release 5.x Sep 9, 2017 Fix deployment issues with docker Sep 22, 2017
Makefile Use twine to upload to PyPi (#662) Sep 19, 2018
NOTICE Update NOTICE and README following copyright assignment (#485) Mar 6, 2018 Update (#711) Oct 14, 2018
VERSION Bump version to 6.2.1 Oct 14, 2018 Whitespace fixes (#651) Sep 15, 2018
mypy.ini Replace mongo-specific query stirng syntax with database agnostic (#712) Oct 18, 2018
pylintrc First commit for Release 5.x Sep 9, 2017 Whitespace fixes (#651) Sep 15, 2018
requirements-dev.txt Update requirements for development Oct 12, 2018
requirements.txt Make requirements.txt just a reference to (#537) May 10, 2018
setup.cfg Add pre-commit checks (#648) Sep 15, 2018 Replace mongo-specific query stirng syntax with database agnostic (#712) Oct 18, 2018

Alerta Release 6.2

Build Status Gitter chat

The Alerta monitoring tool was developed with the following aims in mind:

  • distributed and de-coupled so that it is SCALABLE
  • minimal CONFIGURATION that easily accepts alerts from any source
  • quick at-a-glance VISUALISATION with drill-down to detail


Related projects can be found on the Alerta Org Repo at

Python 2.7 support is EOL

Starting with Release 6.0 only Python 3.5+ is supported. Release 5.2 was the last to support Python 2.7 and feature enhancements for this release ended on August 31, 2018. Only critical bug fixes will be backported to Release 5.2.


The only mandatory dependency is MongoDB or PostgreSQL. Everything else is optional.

  • Postgres version 9.5 or better
  • MongoDB version 3.x


To install MongoDB on Debian/Ubuntu run:

$ sudo apt-get install -y mongodb-org
$ mongod

To install MongoDB on CentOS/RHEL run:

$ sudo yum install -y mongodb
$ mongod

To install the Alerta server and client run:

$ pip install alerta-server alerta
$ alertad run

To install the web console run:

$ wget -O alerta-web.tgz
$ tar zxvf alerta-web.tgz
$ cd alerta-angular-alerta-webui-*/app
$ python -m http.server 8000

>> browse to http://localhost:8000


Alerta and MongoDB can also run using Docker containers, see alerta/docker-alerta.


To configure the alertad server override the default settings in /etc/alertad.conf or using ALERTA_SVR_CONF_FILE environment variable::

$ ALERTA_SVR_CONF_FILE=~/.alertad.conf


More information on configuration and other aspects of alerta can be found at


To run in development mode, listening on port 5000:

$ export FLASK_APP=alerta FLASK_ENV=development
$ pip install -e .
$ flask run

To run in development mode, listening on port 8080, using Postgres and reporting errors to Sentry:

$ export FLASK_APP=alerta FLASK_ENV=development
$ export DATABASE_URL=postgres://localhost:5432/alerta5
$ export SENTRY_DSN=
$ pip install -e .
$ flask run --debugger --port 8080 --with-threads --reload


Problems following a direct upgrade from versions 4.x to 5.x could be related to the flattening of the directory structure for the app. An example app.wsgi file which works for both release 4 and 5 is as follows:

#!/usr/bin/env python

    from alerta import app  # alerta >= 5.0
except Exception:
    from import app  # alerta < 5.0


To run the tests using a local Postgres database run:

$ pip install -r requirements.txt
$ pip install -e .
$ createdb test5
$ ALERTA_SVR_CONF_FILE= DATABASE_URL=postgres:///test5 nosetests

Cloud Deployment

Alerta can be deployed to the cloud easily using Heroku, AWS EC2, or Google Cloud Platform


Alerta monitoring system and console
Copyright 2012-2018 Nick Satterly

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
See the License for the specific language governing permissions and
limitations under the License.