alerta-server 5.0.0rc1

Alerta server WSGI application

[](https://travis-ci.org/guardian/alerta) [](https://gitter.im/alerta/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 <https://github.com/alerta/>.

---

Requirements

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

• MongoDB version 3.x

• Postgres version 9.5 or better

Installation

To install MongoDB on Debian/Ubuntu run:

$ sudo apt-get install -y mongodb-org
$ 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 https://github.com/alerta/angular-alerta-webui/tarball/master
$ tar zxvf alerta-web.tgz
$ cd alerta-angular-alerta-webui-*/app
$ python -m SimpleHTTPServer 8000

>> browse to http://localhost:8000

Configuration

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
$ echo "DEBUG=True" > $ALERTA_SVR_CONF_FILE

Documentation

More information on configuration and other aspects of alerta can be found at <http://docs.alerta.io>

Development

To run in development mode, listening on port 5000:

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

To run in development mode, listening on port 8080, using Postgres and reporting errors to [Sentry](https://sentry.io)

$ export FLASK_APP=alerta $ export DATABASE_URL=postgres://localhost:5432/alerta5 $ export SENTRY_DSN=https://8b56098250544fb78b9578d8af2a7e13:[e-mail]/153768 $ pip install -e . $ flask run –debugger –port 8080 –with-threads –reload

Tests

To run the tests use:

$ ALERTA_SVR_CONF_FILE= nosetests

Cloud Deployment

Alerta can be deployed to the cloud easily using Heroku <https://github.com/alerta/heroku-api-alerta>, AWS EC2 <https://github.com/alerta/alerta-cloudformation>, or RedHat OpenShift <https://github.com/alerta/openshift-api-alerta>

License

Alerta monitoring system and console Copyright 2012-2017 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.