You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
dependabot[bot] 0f7bf7b099
build(deps): bump blinker from 1.4 to 1.5 (#1767)
3 months ago
.github Bump support versions for Python and MongoDB (#1717) 5 months ago
alerta fix: Do not 400 error if content type not application/json (#1756) 3 months ago
contrib Update contrib apache config 3 years ago
docs Add state transition diagram to docs 3 years ago
examples Add forwarder plugin for federated Alerta (#1161) 3 years ago
tests fix: Keycloak url base (#1683) 5 months ago
.dockerignore build(docker): fix test docker builds (#1473) 2 years ago
.env try6 1 year ago
.flake8 Fix flake W504 issues and ignore flake W503 (#1061) 3 years ago
.flaskenv Use Flask dotenv file to set default env and port (#812) 4 years ago
.gitignore Allow custom resource IDs on all resources 2 years ago
.isort.cfg Bump support versions for Python and MongoDB (#1717) 5 months ago
.pre-commit-config.yaml Fix linting errors (#1618) 1 year ago Bump version 8.5.0 -> 8.6.0 2 years ago Fix linting errors (#1618) 1 year ago
Dockerfile fix: Switch docker build from alpine to debian buster 1 year ago
LICENSE First commit for Release 5.x 5 years ago Restore old wsgi file as symlink to new (#1216) 3 years ago
Makefile Fix release workflow 1 year ago
NOTICE Update README for Release 7 4 years ago Bump support versions for Python and MongoDB (#1717) 5 months ago
VERSION Bump version 8.6.5 -> 8.7.0 1 year ago Add integration test for SAML2 auth provider 2 years ago
docker-compose.yml try6 1 year ago
mypy.ini mypy should ignore missing imports by default (#1113) 3 years ago
pref-db-rawdata-history perf(db): Do not query for rawData or history if not required 2 years ago
pylintrc Merge pull request #1206 from frasy/master 2 years ago
requirements-ci.txt build(deps): bump pysaml2 from 7.1.2 to 7.2.1 (#1764) 3 months ago
requirements-dev.txt build(deps-dev): bump pylint from 2.14.4 to 2.15.2 (#1763) 3 months ago
requirements.txt build(deps): bump blinker from 1.4 to 1.5 (#1767) 3 months ago
setup.cfg fix: change housekeeping delete threshold to seconds (#1508) 2 years ago Bump support versions for Python and MongoDB (#1717) 5 months ago
tox.ini Bump support versions for Python and MongoDB (#1717) 5 months ago Do not init http handler for CLI commands (#1212) 3 years ago

Alerta Release 8.7

Actions Status Slack chat Coverage Status Docker Pulls

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



Release 8 only supports Python 3.7 or higher.

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

  • Postgres version 10 or better
  • MongoDB version 4.2 or better


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
$ tar zxvf alerta-webui.tar.gz
$ cd dist
$ python3 -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 .[postgres]
$ flask run --debugger --port 8080 --with-threads --reload


Enable debug log output by setting DEBUG=True in the API server configuration:


LOG_HANDLERS = ['console','file']
LOG_FORMAT = 'verbose'
LOG_FILE = '$HOME/alertad.log'

It can also be helpful to check the web browser developer console for JavaScript logging, network problems and API error responses.


To run the all the tests there must be a local Postgres and MongoDB database running. Then run:

$ TOXENV=ALL make test

To just run the Postgres or MongoDB tests run:

$ TOXENV=postgres make test
$ TOXENV=mongodb make test

To run a single test run something like:

$ TOXENV="mongodb -- tests/" make test
$ TOXENV="postgres -- tests/" make test

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-2021 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.