Package: alerta-server
Alerta Release 9.0The Alerta monitoring tool was developed with the following aims in mind:distributed and de-coupled so that it isSCALABLEminimalCONFIGURATIONthat easily accepts alerts from any sourcequick at-a-glanceVISUALISATIONwith drill-down to detailRequirementsRelease 9 only supports Python 3.8 or higher.The only mandatory dependency is MongoDB or PostgreSQL. Everything else is optional.Postgres version 11 or betterMongoDB version 4.4 or betterInstallationTo install MongoDB on Debian/Ubuntu run:$ sudo apt-get install -y mongodb-org
$ mongodTo install MongoDB on CentOS/RHEL run:$ sudo yum install -y mongodb
$ mongodTo install the Alerta server and client run:$ pip install alerta-server alerta
$ alertad runTo 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:8000DockerAlerta and MongoDB can also run using Docker containers, seealerta/docker-alerta.ConfigurationTo configure thealertadserver override the default settings in/etc/alertad.confor usingALERTA_SVR_CONF_FILEenvironment variable::$ ALERTA_SVR_CONF_FILE=~/.alertad.conf
$ echo "DEBUG=True" > $ALERTA_SVR_CONF_FILEDocumentationMore information on configuration and other aspects of alerta can be found
athttp://docs.alerta.ioDevelopmentTo run in development mode, listening on port 5000:$ export FLASK_APP=alerta FLASK_DEBUG=1
$ pip install -e .
$ flask runTo run in development mode, listening on port 8080, using Postgres and
reporting errors toSentry:$ 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 --reloadTroubleshootingEnable debug log output by settingDEBUG=Truein 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.TestsTo run theallthe tests there must be a local Postgres
and MongoDB database running. Then run:$ TOXENV=ALL make testTo just run the Postgres or MongoDB tests run:$ TOXENV=postgres make test
$ TOXENV=mongodb make testTo 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 testCloud DeploymentAlerta can be deployed to the cloud easily using Herokuhttps://github.com/alerta/heroku-api-alerta,
AWS EC2https://github.com/alerta/alerta-cloudformation, or Google Cloud Platformhttps://github.com/alerta/gcloud-api-alertaLicenseAlerta 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.