Alerta Release 6.6
==================
[](https://travis-ci.org/alerta/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/>.
----
Python 2.7 support is EOL
-------------------------
Starting with Release 6.0 only Python 3.5+ is supported. Release 5.2 was the
last to support Python 2.7 and feature enhancements for this release ended on
August 31, 2018. Only critical bug fixes will be backported to Release 5.2.
Requirements
------------
The only mandatory dependency is MongoDB or PostgreSQL. Everything else is optional.
- Postgres version 9.5 or better
- MongoDB version 3.x
Installation
------------
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 -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 http.server 8000
>> browse to http://localhost:8000
### Docker
Alerta and MongoDB can also run using Docker containers, see [alerta/docker-alerta](https://github.com/alerta/docker-alerta).
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 FLASK_ENV=development
$ 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 FLASK_ENV=development
$ 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 using a local Postgres database run:
$ pip install -r requirements.txt
$ pip install -e .
$ createdb test5
$ ALERTA_SVR_CONF_FILE= DATABASE_URL=postgres:///test5 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-2018 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
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.
==================
[](https://travis-ci.org/alerta/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/>.
----
Python 2.7 support is EOL
-------------------------
Starting with Release 6.0 only Python 3.5+ is supported. Release 5.2 was the
last to support Python 2.7 and feature enhancements for this release ended on
August 31, 2018. Only critical bug fixes will be backported to Release 5.2.
Requirements
------------
The only mandatory dependency is MongoDB or PostgreSQL. Everything else is optional.
- Postgres version 9.5 or better
- MongoDB version 3.x
Installation
------------
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 -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 http.server 8000
>> browse to http://localhost:8000
### Docker
Alerta and MongoDB can also run using Docker containers, see [alerta/docker-alerta](https://github.com/alerta/docker-alerta).
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 FLASK_ENV=development
$ 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 FLASK_ENV=development
$ 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 using a local Postgres database run:
$ pip install -r requirements.txt
$ pip install -e .
$ createdb test5
$ ALERTA_SVR_CONF_FILE= DATABASE_URL=postgres:///test5 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-2018 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
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.
1 maintainer
Metadata
1 maintainer
Release files for alerta-server 6.8.3
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| alerta-server-6.8.3.tar.gz | 93.1 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| alerta_server-6.8.3-py2.py3-none-any.whl | Python 3, Python 2 | none | any | Details |
Total release size: 226.3 kB
Release files / alerta-server-6.8.3.tar.gz
| Download URL | alerta-server-6.8.3.tar.gz |
|---|---|
| Size | 93.1 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
18626bd50cf3768bfa1405a829603ce150a302779936bb8cc12a3d716317d33e
|
|
BLAKE2b-256 checksum How to use checksums |
2e985e3998b3a68cfda26113d097d714f8c2af2e45f33e229cfc8bb86a56862f
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/1.12.1 pkginfo/1.4.2 requests/2.19.1 setuptools/40.4.3 requests-toolbelt/0.8.0 tqdm/4.26.0 CPython/3.6.5
|
Release files / alerta_server-6.8.3-py2.py3-none-any.whl
| Download URL | alerta_server-6.8.3-py2.py3-none-any.whl |
|---|---|
| Size | 133.2 kB |
| Tags | Python 2 Python 3 |
|
SHA-256 checksum How to use checksums |
3422c31c6f22d0cb8d1a6ef296dafbc2583f671c4bce45ea56b65d3b5e665593
|
|
BLAKE2b-256 checksum How to use checksums |
038acfcd95408c7ff5f7055963c1b162a2fc832da092283f6bb2a1d4fd558fb5
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/1.12.1 pkginfo/1.4.2 requests/2.19.1 setuptools/40.4.3 requests-toolbelt/0.8.0 tqdm/4.26.0 CPython/3.6.5
|
