0
0
mirror of https://github.com/alerta/alerta.git synced 2024-10-11 05:55:35 +00:00
Go to file
2024-09-04 20:08:56 +02:00
.github Update codeql github action 2024-04-12 06:15:58 +02:00
alerta Bump version 9.0.3 -> 9.0.4 2024-09-04 20:08:56 +02:00
contrib Update contrib apache config 2020-05-04 16:10:27 +02:00
docs Add state transition diagram to docs 2020-04-28 07:38:27 +02:00
examples Support custom backends defined as entry point (#1826) 2023-03-09 18:27:53 +01:00
tests feat: implement "post_action" for post processing actions. (#1899) 2024-04-12 17:46:02 +02:00
.dockerignore build(docker): fix test docker builds (#1473) 2021-02-28 11:04:15 +01:00
.env try6 2021-12-07 09:23:33 +01:00
.flake8 Release/9.1 (#1898) 2023-12-22 14:03:45 +01:00
.flaskenv fix: Replace FLASK_ENV with FLASK_DEBUG (#1824) 2023-03-08 12:29:31 +01:00
.gitignore Allow custom resource IDs on all resources 2020-07-05 16:22:13 +02:00
.isort.cfg Split out linting in to separate workflow 2023-12-21 12:49:37 +00:00
.pre-commit-config.yaml Release/9.1 (#1898) 2023-12-22 14:03:45 +01:00
CHANGELOG.md Bump version 9.0.0 -> 9.0.1 2023-06-22 22:14:53 +02:00
CONTRIBUTING.md Fix linting errors (#1618) 2021-11-21 17:26:37 +01:00
docker-compose.ci.yml Add integration test for SAML2 auth provider 2020-11-01 00:07:28 +01:00
docker-compose.yml try6 2021-12-07 09:23:33 +01:00
Dockerfile fix(docker): manifest endpoint build info 2023-12-23 17:20:51 +01:00
fly.toml Switch try.alerta.io to basic auth 2023-03-20 09:10:30 +01:00
LICENSE First commit for Release 5.x 2017-09-09 16:38:13 +01:00
Makefile build(deps): bump flask from 2.2.2 to 2.3.2 (#1841) 2023-06-25 10:07:27 +02:00
MANIFEST.in Restore old wsgi file as symlink to new (#1216) 2020-05-04 16:14:10 +02:00
mypy.ini mypy should ignore missing imports by default (#1113) 2019-11-28 21:40:59 +01:00
NOTICE Update README for Release 7 2019-04-15 20:31:15 +02:00
pref-db-rawdata-history perf(db): Do not query for rawData or history if not required 2020-12-04 20:05:18 +01:00
pylintrc Merge pull request #1206 from frasy/master 2020-10-28 10:59:34 +01:00
README.md Release/9.1 (#1898) 2023-12-22 14:03:45 +01:00
requirements-ci.txt build(deps): bump lxml from 5.1.0 to 5.2.1 (#1942) 2024-04-12 10:24:12 +02:00
requirements-dev.txt build(deps): Bump python dependencies (#1989) 2024-09-04 19:59:22 +02:00
requirements.txt build(deps): Bump python dependencies (#1989) 2024-09-04 19:59:22 +02:00
setup.cfg fix: change housekeeping delete threshold to seconds (#1508) 2021-04-28 13:15:42 +02:00
setup.py fix(docker): manifest endpoint build info 2023-12-23 17:20:51 +01:00
tox.ini Bump support versions for Python and MongoDB (#1717) 2022-07-04 00:02:55 +02:00
VERSION Bump version 9.0.3 -> 9.0.4 2024-09-04 20:08:56 +02:00
wsgi.py Do not init http handler for CLI commands (#1212) 2020-05-03 20:20:18 +02:00

Alerta Release 9.1

Actions Status Slack chat Coverage Status Docker Pulls

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

webui


Requirements

Release 9 only supports Python 3.9 or higher.

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

  • Postgres version 13 or better
  • MongoDB version 6.0 or better

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 https://github.com/alerta/alerta-webui/releases/latest/download/alerta-webui.tar.gz
$ tar zxvf alerta-webui.tar.gz
$ cd dist
$ python3 -m http.server 8000

>> browse to http://localhost:8000

Docker

Alerta and MongoDB can also run using Docker containers, see 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_DEBUG=1
$ pip install -e .
$ flask run

To run in development mode, listening on port 8080, using Postgres and reporting errors to Sentry:

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

Troubleshooting

Enable debug log output by setting DEBUG=True in the API server configuration:

DEBUG=True

LOG_HANDLERS = ['console','file']
LOG_FORMAT = 'verbose'
LOG_FILE = '$HOME/alertad.log'

It can also be helpful to check the web browser developer console for JavaScript logging, network problems and API error responses.

Tests

To run the all the tests there must be a local Postgres and MongoDB database running. Then run:

$ TOXENV=ALL make test

To just run the Postgres or MongoDB tests run:

$ TOXENV=postgres make test
$ TOXENV=mongodb make test

To run a single test run something like:

$ TOXENV="mongodb -- tests/test_search.py::QueryParserTestCase::test_boolean_operators" make test
$ TOXENV="postgres -- tests/test_queryparser.py::PostgresQueryTestCase::test_boolean_operators" make test

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-2023 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.