Monitoring as a Service for OpenStack

Go to file

aviau 1ead9a3c2b httpretty can fail in Python 3.4 with wrong LC_ALL Change-Id: Ic3d4c76f022a102fd8bbf5636cdf8b58393fa7d1		2015-05-14 22:11:34 -04:00
container-data	Added docker-compose production environment	2015-04-23 13:05:21 -04:00
doc	Config API: add check modulation	2015-05-06 14:54:48 -04:00
etc/surveil	policy: admins now match surveil:authenticated	2015-05-07 10:43:21 -04:00
surveil	Merge "Add recheck and fix tests"	2015-05-13 20:48:00 +00:00
tools/docker	Install modules from tarball	2015-05-14 10:01:40 -04:00
.dockerignore	Added docker-compose production environment	2015-04-23 13:05:21 -04:00
.gitignore	Added docker-compose production environment	2015-04-23 13:05:21 -04:00
.gitreview	Added .gitreview	2014-06-25 20:10:36 +00:00
.testr.conf	Added demo API + tests	2014-08-12 18:51:23 -04:00
Dockerfile	Add check-cinder to shinken plugins	2015-05-11 10:55:56 -04:00
LICENSE	Added demo API + tests	2014-08-12 18:51:23 -04:00
Makefile	fig is now deprecated	2015-04-03 18:10:27 -04:00
README.rst	README: style fixes	2015-05-07 12:26:57 -04:00
docker-compose-production.yml	Updated docker-compose-production images	2015-05-08 16:10:45 -04:00
docker-compose.yml	Surveil container: auth backend env var	2015-05-06 16:00:12 -04:00
requirements.txt	Status API: Return live hosts and services	2015-04-19 16:41:17 -04:00
setup.cfg	Add: os_discovery "CLI" interface	2015-01-23 16:20:23 -05:00
setup.py	Added license headers	2014-08-15 10:26:23 -04:00
test-requirements.txt	Fix httpretty requirement	2015-05-12 14:07:14 -04:00
tox.ini	httpretty can fail in Python 3.4 with wrong LC_ALL	2015-05-14 22:11:34 -04:00

README.rst

Surveil

Monitoring as a Service

An OpenStack related project designed to provide highly available, scalable and flexible monitoring for OpenStack.

Project Info

Wiki: https://wiki.openstack.org/wiki/Surveil
IRC: #surveil at freenode
Documentation: https://surveil.readthedocs.org/
Open Gerrit Changesets: https://review.openstack.org/#/q/status:open+surveil,n,z
Bug tracker: https://bugs.launchpad.net/surveil

Getting Started

Developpement environnement

Surveil's developpement environnement is based on Docker and docker-compose.

You can install docker-compose with the following command:

sudo pip install -U docker-compose

You will then be able to use the environment with the following commands:

sudo docker-compose up: Launch Surveil and its dependencies in containers.
sudo docker-compose down: Kill the active docker containers, if any.
sudo docker-compose rm: Remove all containers, if any.
sudo docker-compose: Build the docker images.

Configuration for the different services running in the Docker containers are stored in tools/docker.

After running sudo docker-compose up, you should be able to acces all services at the ports configured in the docker-compose.yml file.

Surveil API: http://localhost:8080/v1/hello
Bansho (surveil web interface): http://localhost:8888 (any login info is fine)
InfluxDB: http://localhost:8083 (user:root pw:root)
Grafana: http://localhost:80 (user:admin pw:admin)
Shinken WebUI: http://localhost:7767/all (user:admin pw:admin)

The Surveil container mounts your local project folder and pecan reloads every time the project files change thus providing a proper development environment.