x/surveil
Code Issues Proposed changes

Merge "Docs: Administration - surveil-os-interface"

Browse Source
This commit is contained in:
Jenkins 2015-06-26 19:05:15 +00:00 committed by Gerrit Code Review
commit 212e248b98
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 :maxdepth: 1
surveil_api 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-os-interface]
# Surveil API URL
SURVEIL_API_URL=http://surveil:8080/v2 SURVEIL_API_URL=http://surveil:8080/v2
# Surveil Auth URL
SURVEIL_AUTH_URL=http://surveil:8080/v2/auth SURVEIL_AUTH_URL=http://surveil:8080/v2/auth
# Surveil version
SURVEIL_VERSION=2_0 SURVEIL_VERSION=2_0
# OpenStack Credentials. Used for creating hosts in Surveil.
SURVEIL_OS_AUTH_URL=http://localhost/v2.0 SURVEIL_OS_AUTH_URL=http://localhost/v2.0
SURVEIL_OS_USERNAME=admin SURVEIL_OS_USERNAME=admin
SURVEIL_OS_PASSWORD=password SURVEIL_OS_PASSWORD=password
SURVEIL_OS_TENANT_NAME=admin SURVEIL_OS_TENANT_NAME=admin
# Default monitoring pack to use with all OpenStack instances
SURVEIL_DEFAULT_TAGS=openstack-host SURVEIL_DEFAULT_TAGS=openstack-host
# Network used to monitor hosts. Surveil must have access to this network.
SURVEIL_NETWORK_LABEL=surveil SURVEIL_NETWORK_LABEL=surveil
# AMQP credentials
RABBIT_HOST=192.168.49.239 RABBIT_HOST=192.168.49.239
RABBIT_PORT=5672 RABBIT_PORT=5672
QUEUE=test QUEUE=surveil
RABBIT_USER=admin RABBIT_USER=admin
RABBIT_PASSWORD=admin RABBIT_PASSWORD=admin