Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (pypi.python.org).
Help us improve Python packaging - Donate today!

Alerta server WSGI application

Project Description
Alerta Release 5.0
==================

[![Build Status](https://travis-ci.org/guardian/alerta.png)](https://travis-ci.org/guardian/alerta) [![Gitter chat](https://badges.gitter.im/alerta/chat.png)](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

![console](/docs/images/alert-list-rel32.png?raw=true)

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:fa9d628da9c4459c922293db72a3203f@sentry.io/153768
$ pip install -e .
$ flask run --debugger --port 8080 --with-threads --reload

Troubleshooting
---------------

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

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

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 Google Cloud Platform
<https://github.com/alerta/gcloud-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.
Release History

Release History

This version
History Node

5.0.3

History Node

5.0.2

History Node

5.0.1

History Node

5.0.0

History Node

5.0.0rc3

History Node

5.0.0rc2

History Node

5.0.0rc1

History Node

4.10.5

History Node

4.10.4

History Node

4.10.3

History Node

4.10.2

History Node

4.10.1

History Node

4.10.0

History Node

4.9.6

History Node

4.9.5

History Node

4.9.4

History Node

4.9.3

History Node

4.9.2

History Node

4.9.1

History Node

4.9.0

History Node

4.8.26

History Node

4.8.25

History Node

4.8.24

History Node

4.8.23

History Node

4.8.22

History Node

4.8.21

History Node

4.8.20

History Node

4.8.19

History Node

4.8.18

History Node

4.8.17

History Node

4.8.16

History Node

4.8.15

History Node

4.8.14

History Node

4.8.13

History Node

4.8.12

History Node

4.8.11

History Node

4.8.10

History Node

4.8.9

History Node

4.8.8

History Node

4.8.7

History Node

4.8.6

History Node

4.8.5

History Node

4.8.4

History Node

4.8.3

History Node

4.8.2

History Node

4.8.1

History Node

4.8.0

History Node

4.7.33

History Node

4.7.32

History Node

4.7.31

History Node

4.7.30

History Node

4.7.29

History Node

4.7.28

History Node

4.7.27

History Node

4.7.26

History Node

4.7.25

History Node

4.7.24

History Node

4.7.23

History Node

4.7.22

History Node

4.7.21

History Node

4.7.20

History Node

4.7.19

History Node

4.7.18

History Node

4.7.17

History Node

4.7.16

History Node

4.7.15

History Node

4.7.14

History Node

4.7.13

History Node

4.7.12

History Node

4.7.11

History Node

4.7.10

History Node

4.7.9

History Node

4.7.8

History Node

4.7.7

History Node

4.7.6

History Node

4.7.5

History Node

4.7.4

History Node

4.7.3

History Node

4.7.2

History Node

4.7.1

History Node

4.7.0

History Node

4.6.9

History Node

4.6.8

History Node

4.6.7

History Node

4.6.6

History Node

4.6.5

History Node

4.6.4

History Node

4.6.3

History Node

4.6.2

History Node

4.6.1

History Node

4.6.0

History Node

4.5.5

History Node

4.5.4

History Node

4.5.3

History Node

4.5.2

History Node

4.5.1

History Node

4.5.0

History Node

4.4.13

History Node

4.4.12

History Node

4.4.11

History Node

4.4.10

History Node

4.4.9

History Node

4.4.8

History Node

4.4.7

History Node

4.4.6

History Node

4.4.5

History Node

4.4.2

History Node

4.4.1

History Node

4.4.0

History Node

4.3.2

History Node

4.3.1

History Node

4.3.0

History Node

4.2.6

History Node

4.2.5

History Node

4.2.4

History Node

4.2.3

History Node

4.2.2

History Node

4.2.1

History Node

4.1.8

History Node

4.1.7

History Node

4.1.6

History Node

4.1.5

History Node

4.1.4

History Node

4.1.2

History Node

4.1.1

History Node

4.1.0

History Node

4.0.9

History Node

4.0.8

History Node

4.0.7

History Node

4.0.6

History Node

4.0.5

History Node

4.0.4

History Node

4.0.3

History Node

4.0.2

History Node

4.0.1

History Node

4.0.0

History Node

3.3.7

History Node

3.3.6

History Node

3.3.5

History Node

3.3.4

History Node

3.3.3

History Node

3.3.2

History Node

3.3.1

History Node

3.3.0

History Node

3.2.9

History Node

3.2.8

History Node

3.2.7

History Node

3.2.6

History Node

3.2.4

History Node

3.2.3

History Node

3.2.0

History Node

3.1.2

Download Files

Download Files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
alerta_server-5.0.3-py2.py3-none-any.whl (92.4 kB) Copy SHA256 Checksum SHA256 2.7 Wheel Nov 17, 2017
alerta-server-5.0.3.tar.gz (62.4 kB) Copy SHA256 Checksum SHA256 Source Nov 17, 2017

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting