Explore the docs »
Report Bug
·
Request Feature
The Vhoops is a tool for using consolidate alerts that comes from different sources. It collects, de-duplicates, and consolidates the alerts. Also, you could define routing definitions for these alerts and get some action when alerts come from sources that match the defined patterns.
To get a local copy up and running follow these simple steps.
- Install following software components
- RabbitMQ
- Couchbase
- MongoDB
- MySQL
- Redis
- Clone the repo
git clone https://github.com/yigitbasalma/vhoops.git
- Go to static directory
cd /path/to/vhoops/vhoops/static
- Install necessaries npm packages and build css and js
npm install && \ gulp dist
- Install python libraries. (you should run as root or pass the --user flag)
pip install -r requirements.txt
- Move config.example.py to config.py
mv /path/to/vhoops/vhoops/config/config.example.py /path/to/vhoops/vhoops/config/config.py
- Create MySQL database.
create database vhoops character set utf8 collate utf8_bin;
- Configure the sqlalchemy connection string.
SQLALCHEMY_DATABASE_URI = "mysql+pymysql://username:password@192.168.56.2:3306/vhoops"
- Configure the mail.
MAIL_USERNAME = "vhoops@vhoops.com" MAIL_PASSWORD = "123456" MAIL_SERVER = "smtp.mail.com"
- Configure the couchbase. (You need to create buckets manually for now)
CACHE_CONN_STRING = "couchbase://192.168.56.2" CACHE_USERNAME = "Administrator" CACHE_PASSWORD = "123456*" CACHE_BUCKETS = [ "app_cache" ]
- Configure redis for page cache.
CACHE_TYPE = "redis" CACHE_REDIS_HOST = "192.168.56.2"
- Configure celery.
CELERY_BROKER_URL = "redis://192.168.56.2:6379/1"
- Configure AMQP for alert queue (in the celery_config.py)
amqp_config = dict( host="192.168.56.3:5672", userid="admin", password="admin", hearbeat=30 )
- Start run.py command. (you should run as root or manually create /var/log/vhoops directory)
python /path/to/vhoops/run.py
- Start celery
cd /path/to/vhoops && \ celery -A vhoops.celery worker --loglevel=info && \ celery beat -l info -A vhoops.celery
Use this space to show useful examples of how a project can be used. Additional screenshots, code examples and demos work well in this space. You may also link to more resources.
For more examples, please refer to the Documentation
See the open issues for a list of proposed features (and known issues).
Contributions are what make the open source community such an amazing place to be learn, inspire, and create. Any contributions you make are greatly appreciated.
- Fork the Project
- Create your Feature Branch (
git checkout -b feature/AmazingFeature
) - Commit your Changes (
git commit -m 'Add some AmazingFeature'
) - Push to the Branch (
git push origin feature/AmazingFeature
) - Open a Pull Request
Distributed under the MIT License. See LICENSE
for more information.