x/surveil
Code Issues Proposed changes

Docs: Administration - surveil-os-interface

Browse Source 
Change-Id: I41fadf95a9e1d753d35197f2a5b86a0ae7ee5fc2
This commit is contained in:
flavien peyre 2015-06-26 11:09:20 -04:00 committed by aviau
parent 85534c95b5
commit ff0baba7a8
3 changed files with 42 additions and 1 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

2
doc/source/administration/index.rst
View File

@ -7,3 +7,5 @@ This section will covers the administration and configuration of the Surveil ser
:maxdepth: 1
surveil_api
surveil-os-interface

25
doc/source/administration/surveil-os-interface.rst Normal file
View File

@ -0,0 +1,25 @@
Surveil Openstack Interface
~~~~~~~~~~~~~~~~~~~~~~~~~~~
surveil-os-interface is a daemon that connects to the OpenStack message queue. It reacts to various events and automatically configures Surveil monitoring. For example, instances created in Nova will automatically be monitored by Surveil.
======================= =====================================
**package name (RPM)** surveil
**services** surveil-os-interface.service
**configuration** /etc/surveil/surveil_os_interface.cfg
======================= =====================================
Surveil-os-interface needs acces to OpenStack's message queue. The following options must be set in ``/etc/nova/nova.conf``: ::
notification_driver=nova.openstack.common.notifier.rpc_notifier
notification_topics=notifications,surveil
notify_on_state_change=vm_and_task_state
notify_on_any_change=True
Configuration samples
---------------------
/etc/surveil/surveil_os_interface.cfg
*************************************
.. literalinclude:: ../../../etc/surveil/surveil_os_interface.cfg

16
etc/surveil/surveil_os_interface.cfg
View File

@ -1,15 +1,29 @@
[surveil-os-interface]
# Surveil API URL
SURVEIL_API_URL=http://surveil:8080/v2
# Surveil Auth URL
SURVEIL_AUTH_URL=http://surveil:8080/v2/auth
# Surveil version
SURVEIL_VERSION=2_0
# OpenStack Credentials. Used for creating hosts in Surveil.
SURVEIL_OS_AUTH_URL=http://localhost/v2.0
SURVEIL_OS_USERNAME=admin
SURVEIL_OS_PASSWORD=password
SURVEIL_OS_TENANT_NAME=admin
# Default monitoring pack to use with all OpenStack instances
SURVEIL_DEFAULT_TAGS=openstack-host
# Network used to monitor hosts. Surveil must have access to this network.
SURVEIL_NETWORK_LABEL=surveil
# AMQP credentials
RABBIT_HOST=192.168.49.239
RABBIT_PORT=5672
QUEUE=test
QUEUE=surveil
RABBIT_USER=admin
RABBIT_PASSWORD=admin