diff --git a/doc/source/administration/index.rst b/doc/source/administration/index.rst index 0b9cfef..380983f 100644 --- a/doc/source/administration/index.rst +++ b/doc/source/administration/index.rst @@ -7,3 +7,5 @@ This section will covers the administration and configuration of the Surveil ser :maxdepth: 1 surveil_api + surveil-os-interface + diff --git a/doc/source/administration/surveil-os-interface.rst b/doc/source/administration/surveil-os-interface.rst new file mode 100644 index 0000000..2cf14f3 --- /dev/null +++ b/doc/source/administration/surveil-os-interface.rst @@ -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 diff --git a/etc/surveil/surveil_os_interface.cfg b/etc/surveil/surveil_os_interface.cfg index 438ebe8..c150851 100644 --- a/etc/surveil/surveil_os_interface.cfg +++ b/etc/surveil/surveil_os_interface.cfg @@ -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