x/surveil

Monitoring as a Service for OpenStack

Go to file

Frédéric Vachon 4c4eda9ee7 Drastically reduces mongo container size Change-Id: I2834ea33c39c3c685d131b029c5b59a24761eeec		2015-04-21 17:01:21 -04:00
doc	Status API: Return live hosts and services	2015-04-19 16:41:17 -04:00
etc/surveil	Policies support	2015-04-15 18:34:47 -04:00
surveil	Specify Surveil version when using surveilclient	2015-04-21 16:04:07 -04:00
tools/docker/shinken_container	Remove shinken plugins	2015-04-17 16:32:21 -04:00
.dockerignore	Surveil Container: Override PBR_VERSION + .dockerignore	2015-04-16 10:57:32 -04:00
.gitignore	Enh: Add swp to gitignore	2015-03-20 11:03:54 -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
docker-compose.yml	Drastically reduces mongo container size	2015-04-21 17:01:21 -04:00
Dockerfile	Surveil Container: Override PBR_VERSION + .dockerignore	2015-04-16 10:57:32 -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	Updated to grafana 2.0	2015-04-20 13:33:26 -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	Added checkresult post on hosts	2014-08-27 17:00:49 -04:00
tox.ini	License pack_upload.py under AGPL	2015-04-08 11:14:52 -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

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