Alerta Release 4.6
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.
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.
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 https://github.com/guardian/alerta.git alerta $ cd alerta $ sudo pip install -r requirements.txt $ sudo python setup.py install
The configuration file format has changed in Release 3.2 to a python
settings.py file. To override default settings in this file create
/etc/alertad.conf or set
ALERTA_SVR_CONF_FILE environment variable to
~/.config/alertad or something similar. Make sure to to export the environment variable before running the server, like so:
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:
To send some test alerts run:
To view alerts in a terminal run:
$ alerta query
To view alerts in a web console install the Alerta Web UI
Running tests in a python virtual environment:
$ ALERTA_SVR_CONF_FILE= python -m nose
Deploy to the Cloud
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 http://www.apache.org/licenses/LICENSE-2.0 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.