Skip to content
Alerta monitoring system
Python Shell HTML JavaScript Makefile
Latest commit 8b6c21b @satterly satterly Bump version to 4.7.1

Alerta Release 4.6

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


More screenshots are available here

Related projects can be found here.


The only requirement is MongoDB. Everything else is optional.

  • MongoDB


A messaging transport that supports AMQP is required for notification to alert subscribers. It is recommended to use RabbitMQ, but Redis and even MongoDB have been tested and shown to work.

  • RabbitMQ
  • Redis
  • MongoDB

Note: The default setting uses MongoDB so that no additional configuration is required.


To install and configure on Debian/Ubuntu:

$ sudo apt-get update
$ sudo apt-get install mongodb-server

To use RabbitMQ as the message transport instead of the default MongoDB install the additional packages:

$ sudo apt-get install rabbitmq-server

To install from git:

$ git clone alerta
$ cd alerta
$ sudo pip install -r requirements.txt
$ sudo python install


The configuration file format has changed in Release 3.2 to a python file. To override default settings in this file create /etc/alertad.conf or set ALERTA_SVR_CONF_FILE environment variable to ~/.alertad.conf or ~/.config/alertad or something similar. Make sure to to export the environment variable before running the server, like so:

export ALERTA_SVR_CONF_FILE=~/.alertad.conf

The default configuration should work. If you are using RabbitMQ change the AMQP_URL setting to:

AMQP_URL = 'amqp://guest:guest@localhost:5672//'


To start the alerta server simply run:

$ alertad

To send some test alerts run:

$ contrib/examples/

To view alerts in a terminal run:

$ alerta query

To view alerts in a web console install the Alerta Web UI

Running Tests

Running tests in a python virtual environment:

$ ALERTA_SVR_CONF_FILE= python -m nose

Deploy to the Cloud


More Information

See the alerta docs. Documentation is a work in progress. Feedback welcome.


If you'd like to contribute to Alerta, start by forking this repo on GitHub.

Create a branch for your work and then send us a pull request.


Alerta monitoring system and console
Copyright 2012-2015 Guardian News & Media

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.
Something went wrong with that request. Please try again.