Fixed issue on compute nodes iteration

In this changeset, I fixed the issue with the basic server
consolidation strategy to now loop over all compute nodes
as expected instead of stopping after the first one.

Change-Id: If594f0df41e39dfb0ef8f0fce41822018490c4ec
Closes-bug: #1548874

.gitreview

@@ -2,3 +2,4 @@
 host=review.openstack.org
 port=29418
 project=openstack/watcher.git
+defaultbranch=stable/newton

CONTRIBUTING.rst

@@ -1,13 +1,13 @@
 If you would like to contribute to the development of OpenStack,
 you must follow the steps in this page:
 
-   https://docs.openstack.org/infra/manual/developers.html
+   http://docs.openstack.org/infra/manual/developers.html
 
 Once those steps have been completed, changes to OpenStack
 should be submitted for review via the Gerrit tool, following
 the workflow documented at:
 
-   https://docs.openstack.org/infra/manual/developers.html#development-workflow
+   http://docs.openstack.org/infra/manual/developers.html#development-workflow
 
 Pull requests submitted through GitHub will be ignored.
 

HACKING.rst

@@ -8,4 +8,4 @@
 watcher Style Commandments
 ==========================
 
-Read the OpenStack Style Commandments https://docs.openstack.org/developer/hacking/
+Read the OpenStack Style Commandments http://docs.openstack.org/developer/hacking/

MANIFEST.in

@@ -0,0 +1,6 @@
+include AUTHORS
+include ChangeLog
+exclude .gitignore
+exclude .gitreview
+
+global-exclude *.pyc

README.rst

@@ -1,12 +1,3 @@
-========================
-Team and repository tags
-========================
-
-.. image:: https://governance.openstack.org/badges/watcher.svg
-    :target: https://governance.openstack.org/reference/tags/index.html
-
-.. Change things from this point on
-
 ..
       Except where otherwise noted, this document is licensed under Creative
       Commons Attribution 3.0 License.  You can view the license at:
@@ -25,7 +16,7 @@ operating costs, increased system performance via intelligent virtual machine
 migration, increased energy efficiency-and more!
 
 * Free software: Apache license
-* Wiki: https://wiki.openstack.org/wiki/Watcher
+* Wiki: http://wiki.openstack.org/wiki/Watcher
 * Source:  https://github.com/openstack/watcher
-* Bugs: https://bugs.launchpad.net/watcher
+* Bugs: http://bugs.launchpad.net/watcher
-* Documentation: https://docs.openstack.org/developer/watcher/
+* Documentation: http://docs.openstack.org/developer/watcher/

devstack/files/apache-watcher-api.template

@@ -1,42 +0,0 @@
-# Licensed under the Apache License, Version 2.0 (the "License"); you may
-# not use this file except in compliance with the License. You may obtain
-# a copy of the License at
-#
-#      http://www.apache.org/licenses/LICENSE-2.0
-#
-# Unless required by applicable law or agreed to in writing, software
-# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
-# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
-# License for the specific language governing permissions and limitations
-# under the License.
-
-# This is an example Apache2 configuration file for using the
-# Watcher API through mod_wsgi.  This version assumes you are
-# running devstack to configure the software.
-
-Listen %WATCHER_SERVICE_PORT%
-
-<VirtualHost *:%WATCHER_SERVICE_PORT%>
-    WSGIDaemonProcess watcher-api user=%USER% processes=%APIWORKERS% threads=1 display-name=%{GROUP}
-    WSGIScriptAlias / %WATCHER_WSGI_DIR%/app.wsgi
-    WSGIApplicationGroup %{GLOBAL}
-    WSGIProcessGroup watcher-api
-    WSGIPassAuthorization On
-
-    ErrorLogFormat "%M"
-    ErrorLog /var/log/%APACHE_NAME%/watcher-api.log
-    CustomLog /var/log/%APACHE_NAME%/watcher-api-access.log combined
-
-
-    <Directory %WATCHER_WSGI_DIR%>
-        WSGIProcessGroup watcher-api
-        WSGIApplicationGroup %{GLOBAL}
-        <IfVersion >= 2.4>
-            Require all granted
-        </IfVersion>
-        <IfVersion < 2.4>
-            Order allow,deny
-            Allow from all
-        </IfVersion>
-    </Directory>
-</VirtualHost>

devstack/lib/watcher

@@ -44,9 +44,6 @@ WATCHER_CONF_DIR=/etc/watcher
 WATCHER_CONF=$WATCHER_CONF_DIR/watcher.conf
 WATCHER_POLICY_JSON=$WATCHER_CONF_DIR/policy.json
 
-WATCHER_DEVSTACK_DIR=$WATCHER_DIR/devstack
-WATCHER_DEVSTACK_FILES_DIR=$WATCHER_DEVSTACK_DIR/files
-
 NOVA_CONF_DIR=/etc/nova
 NOVA_CONF=$NOVA_CONF_DIR/nova.conf
 
@@ -54,13 +51,6 @@ if is_ssl_enabled_service "watcher" || is_service_enabled tls-proxy; then
     WATCHER_SERVICE_PROTOCOL="https"
 fi
 
-WATCHER_USE_MOD_WSGI=$(trueorfalse TRUE WATCHER_USE_MOD_WSGI)
-
-if is_suse; then
-    WATCHER_WSGI_DIR=${WATCHER_WSGI_DIR:-/srv/www/htdocs/watcher}
-else
-    WATCHER_WSGI_DIR=${WATCHER_WSGI_DIR:-/var/www/watcher}
-fi
 # Public facing bits
 WATCHER_SERVICE_HOST=${WATCHER_SERVICE_HOST:-$HOST_IP}
 WATCHER_SERVICE_PORT=${WATCHER_SERVICE_PORT:-9322}
@@ -84,21 +74,10 @@ function is_watcher_enabled {
     return 1
 }
 
-#_cleanup_watcher_apache_wsgi - Remove wsgi files,
-#disable and remove apache vhost file
-function _cleanup_watcher_apache_wsgi {
-    sudo rm -rf $WATCHER_WSGI_DIR
-    sudo rm -f $(apache_site_config_for watcher-api)
-    restart_apache_server
-}
-
 # cleanup_watcher() - Remove residual data files, anything left over from previous
 # runs that a clean run would need to clean up
 function cleanup_watcher {
     sudo rm -rf $WATCHER_STATE_PATH $WATCHER_AUTH_CACHE_DIR
-    if [[ "$WATCHER_USE_MOD_WSGI" == "True" ]]; then
-        _cleanup_watcher_apache_wsgi
-    fi
 }
 
 # configure_watcher() - Set config files, create data dirs, etc
@@ -129,28 +108,6 @@ function create_watcher_accounts {
         "$WATCHER_SERVICE_PROTOCOL://$WATCHER_SERVICE_HOST:$WATCHER_SERVICE_PORT"
 }
 
-# _config_watcher_apache_wsgi() - Set WSGI config files of watcher
-function _config_watcher_apache_wsgi {
-    local watcher_apache_conf
-    if [[ "$WATCHER_USE_MOD_WSGI" == "True" ]]; then
-        sudo mkdir -p $WATCHER_WSGI_DIR
-        sudo cp $WATCHER_DIR/watcher/api/app.wsgi $WATCHER_WSGI_DIR/app.wsgi
-        watcher_apache_conf=$(apache_site_config_for watcher-api)
-        sudo cp $WATCHER_DEVSTACK_FILES_DIR/apache-watcher-api.template $watcher_apache_conf
-        sudo sed -e "
-            s|%WATCHER_SERVICE_PORT%|$WATCHER_SERVICE_PORT|g;
-            s|%WATCHER_WSGI_DIR%|$WATCHER_WSGI_DIR|g;
-            s|%USER%|$STACK_USER|g;
-            s|%APIWORKERS%|$API_WORKERS|g;
-            s|%APACHE_NAME%|$APACHE_NAME|g;
-        " -i $watcher_apache_conf
-        enable_apache_site watcher-api
-        tail_log watcher-access /var/log/$APACHE_NAME/watcher-api-access.log
-        tail_log watcher-api /var/log/$APACHE_NAME/watcher-api.log
-   fi
-
-}
-
 # create_watcher_conf() - Create a new watcher.conf file
 function create_watcher_conf {
     # (Re)create ``watcher.conf``
@@ -169,10 +126,7 @@ function create_watcher_conf {
     iniset $WATCHER_CONF oslo_messaging_rabbit rabbit_password $RABBIT_PASSWORD
     iniset $WATCHER_CONF oslo_messaging_rabbit rabbit_host $RABBIT_HOST
 
-    iniset $WATCHER_CONF oslo_messaging_notifications driver "messagingv2"
-
     iniset $NOVA_CONF oslo_messaging_notifications topics "notifications,watcher_notifications"
-    iniset $NOVA_CONF notifications notify_on_state_change "vm_and_task_state"
 
     configure_auth_token_middleware $WATCHER_CONF watcher $WATCHER_AUTH_CACHE_DIR
     configure_auth_token_middleware $WATCHER_CONF watcher $WATCHER_AUTH_CACHE_DIR "watcher_clients_auth"
@@ -197,13 +151,9 @@ function create_watcher_conf {
         setup_colorized_logging $WATCHER_CONF DEFAULT
     else
         # Show user_name and project_name instead of user_id and project_id
-        iniset $WATCHER_CONF DEFAULT logging_context_format_string "%(asctime)s.%(msecs)03d %(levelname)s %(name)s [%(request_id)s %(project_domain)s %(user_name)s %(project_name)s] %(instance)s%(message)s"
+        iniset $WATCHER_CONF DEFAULT logging_context_format_string "%(asctime)s.%(msecs)03d %(levelname)s %(name)s [%(request_id)s %(user_name)s %(project_name)s] %(instance)s%(message)s"
     fi
 
-    #config apache files
-    if [[ "$WATCHER_USE_MOD_WSGI" == "True" ]]; then
-        _config_watcher_apache_wsgi
-    fi
     # Register SSL certificates if provided
     if is_ssl_enabled_service watcher; then
         ensure_certificates WATCHER
@@ -235,7 +185,7 @@ function init_watcher {
         recreate_database watcher
 
         # Create watcher schema
-        $WATCHER_BIN_DIR/watcher-db-manage --config-file $WATCHER_CONF upgrade head
+        $WATCHER_BIN_DIR/watcher-db-manage --config-file $WATCHER_CONF create_schema
     fi
     create_watcher_cache_dir
 }
@@ -252,26 +202,19 @@ function install_watcherclient {
 function install_watcher {
     git_clone $WATCHER_REPO $WATCHER_DIR $WATCHER_BRANCH
     setup_develop $WATCHER_DIR
-    if [[ "$WATCHER_USE_MOD_WSGI" == "True" ]]; then
-        install_apache_wsgi
-    fi
 }
 
 # start_watcher_api() - Start the API process ahead of other things
 function start_watcher_api {
     # Get right service port for testing
-
     local service_port=$WATCHER_SERVICE_PORT
     local service_protocol=$WATCHER_SERVICE_PROTOCOL
     if is_service_enabled tls-proxy; then
         service_port=$WATCHER_SERVICE_PORT_INT
         service_protocol="http"
     fi
-    if [[ "$WATCHER_USE_MOD_WSGI" == "True" ]]; then
+
-        restart_apache_server
+    run_process watcher-api "$WATCHER_BIN_DIR/watcher-api --config-file $WATCHER_CONF"
-    else
-        run_process watcher-api "$WATCHER_BIN_DIR/watcher-api --config-file $WATCHER_CONF"
-    fi
     echo "Waiting for watcher-api to start..."
     if ! wait_for_service $SERVICE_TIMEOUT $service_protocol://$WATCHER_SERVICE_HOST:$service_port; then
         die $LINENO "watcher-api did not start"
@@ -294,12 +237,7 @@ function start_watcher {
 
 # stop_watcher() - Stop running processes (non-screen)
 function stop_watcher {
-    if [[ "$WATCHER_USE_MOD_WSGI" == "True" ]]; then
+    for serv in watcher-api watcher-decision-engine watcher-applier; do
-        disable_apache_site watcher-api
-    else
-        stop_process watcher-api
-    fi
-    for serv in watcher-decision-engine watcher-applier; do
         stop_process $serv
     done
 }

devstack/local.conf.compute

@@ -44,6 +44,3 @@ LOGDAYS=2
 [[post-config|$NOVA_CONF]]
 [DEFAULT]
 compute_monitors=cpu.virt_driver
-notify_on_state_change = vm_and_task_state
-[notifications]
-notify_on_state_change = vm_and_task_state

devstack/local.conf.controller

@@ -17,10 +17,6 @@ NETWORK_GATEWAY=10.254.1.1 # Change this for your network
 
 MULTI_HOST=1
 
-
-#Set this to FALSE if do not want to run watcher-api behind mod-wsgi
-#WATCHER_USE_MOD_WSGI=TRUE
-
 # This is the controller node, so disable nova-compute
 disable_service n-cpu
 
@@ -42,11 +38,6 @@ enable_plugin ceilometer git://git.openstack.org/openstack/ceilometer
 
 # This is the controller node, so disable the ceilometer compute agent
 disable_service ceilometer-acompute
-# Enable the ceilometer api explicitly(bug:1667678)
-enable_service ceilometer-api
-
-# Enable the Gnocchi plugin
-enable_plugin gnocchi https://git.openstack.org/openstack/gnocchi
 
 LOGFILE=$DEST/logs/stack.sh.log
 LOGDAYS=2
@@ -54,6 +45,3 @@ LOGDAYS=2
 [[post-config|$NOVA_CONF]]
 [DEFAULT]
 compute_monitors=cpu.virt_driver
-notify_on_state_change = vm_and_task_state
-[notifications]
-notify_on_state_change = vm_and_task_state

doc/ext/versioned_notifications.py

@@ -1,133 +0,0 @@
-# Licensed under the Apache License, Version 2.0 (the "License"); you may
-# not use this file except in compliance with the License. You may obtain
-# a copy of the License at
-#
-#   http://www.apache.org/licenses/LICENSE-2.0
-#
-# Unless required by applicable law or agreed to in writing, software
-# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
-# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
-# License for the specific language governing permissions and limitations
-# under the License.
-
-"""
-This provides a sphinx extension able to list the implemented versioned
-notifications into the developer documentation.
-
-It is used via a single directive in the .rst file
-
-  .. versioned_notifications::
-
-"""
-
-from sphinx.util.compat import Directive
-from docutils import nodes
-
-from watcher.notifications import base as notification
-from watcher.objects import base
-
-
-class VersionedNotificationDirective(Directive):
-
-    SAMPLE_ROOT = 'doc/notification_samples/'
-    TOGGLE_SCRIPT = """
-<script>
-jQuery(document).ready(function(){
-    jQuery('#%s-div').toggle('show');
-    jQuery('#%s-hideshow').on('click', function(event) {
-        jQuery('#%s-div').toggle('show');
-    });
-});
-</script>
-"""
-
-    def run(self):
-        notifications = self._collect_notifications()
-        return self._build_markup(notifications)
-
-    def _collect_notifications(self):
-        base.WatcherObjectRegistry.register_notification_objects()
-        notifications = []
-        ovos = base.WatcherObjectRegistry.obj_classes()
-        for name, cls in ovos.items():
-            cls = cls[0]
-            if (issubclass(cls, notification.NotificationBase) and
-                    cls != notification.NotificationBase):
-
-                payload_name = cls.fields['payload'].objname
-                payload_cls = ovos[payload_name][0]
-                for sample in cls.samples:
-                    notifications.append((cls.__name__,
-                                          payload_cls.__name__,
-                                          sample))
-        return sorted(notifications)
-
-    def _build_markup(self, notifications):
-        content = []
-        cols = ['Event type', 'Notification class', 'Payload class', 'Sample']
-        table = nodes.table()
-        content.append(table)
-        group = nodes.tgroup(cols=len(cols))
-        table.append(group)
-
-        head = nodes.thead()
-        group.append(head)
-
-        for _ in cols:
-            group.append(nodes.colspec(colwidth=1))
-
-        body = nodes.tbody()
-        group.append(body)
-
-        # fill the table header
-        row = nodes.row()
-        body.append(row)
-        for col_name in cols:
-            col = nodes.entry()
-            row.append(col)
-            text = nodes.strong(text=col_name)
-            col.append(text)
-
-        # fill the table content, one notification per row
-        for name, payload, sample_file in notifications:
-            event_type = sample_file[0: -5].replace('-', '.')
-
-            row = nodes.row()
-            body.append(row)
-            col = nodes.entry()
-            row.append(col)
-            text = nodes.literal(text=event_type)
-            col.append(text)
-
-            col = nodes.entry()
-            row.append(col)
-            text = nodes.literal(text=name)
-            col.append(text)
-
-            col = nodes.entry()
-            row.append(col)
-            text = nodes.literal(text=payload)
-            col.append(text)
-
-            col = nodes.entry()
-            row.append(col)
-
-            with open(self.SAMPLE_ROOT + sample_file, 'r') as f:
-                sample_content = f.read()
-
-            event_type = sample_file[0: -5]
-            html_str = self.TOGGLE_SCRIPT % ((event_type, ) * 3)
-            html_str += ("<input type='button' id='%s-hideshow' "
-                         "value='hide/show sample'>" % event_type)
-            html_str += ("<div id='%s-div'><pre>%s</pre></div>"
-                         % (event_type, sample_content))
-
-            raw = nodes.raw('', html_str, format="html")
-            col.append(raw)
-
-        return content
-
-
-def setup(app):
-    app.add_directive('versioned_notifications',
-                      VersionedNotificationDirective)

doc/notification_samples/action-create.json

@@ -1,40 +0,0 @@
-{
-  "priority": "INFO",
-  "payload": {
-    "watcher_object.namespace": "watcher",
-    "watcher_object.version": "1.0",
-    "watcher_object.name": "ActionCreatePayload",
-    "watcher_object.data": {
-      "uuid": "10a47dd1-4874-4298-91cf-eff046dbdb8d",
-      "input_parameters": {
-        "param2": 2,
-        "param1": 1
-      },
-      "created_at": "2016-10-18T09:52:05Z",
-      "updated_at": null,
-      "state": "PENDING",
-      "action_plan": {
-        "watcher_object.namespace": "watcher",
-        "watcher_object.version": "1.0",
-        "watcher_object.name": "TerseActionPlanPayload",
-        "watcher_object.data": {
-          "uuid": "76be87bd-3422-43f9-93a0-e85a577e3061",
-          "global_efficacy": {},
-          "created_at": "2016-10-18T09:52:05Z",
-          "updated_at": null,
-          "state": "ONGOING",
-          "audit_uuid": "10a47dd1-4874-4298-91cf-eff046dbdb8d",
-          "strategy_uuid": "cb3d0b58-4415-4d90-b75b-1e96878730e3",
-          "deleted_at": null
-        }
-      },
-      "parents": [],
-      "action_type": "nop",
-      "deleted_at": null
-    }
-  },
-  "publisher_id": "infra-optim:node0",
-  "timestamp": "2017-01-01 00:00:00.000000",
-  "event_type": "action.create",
-  "message_id": "530b409c-9b6b-459b-8f08-f93dbfeb4d41"
-}

doc/notification_samples/action-delete.json

@@ -1,40 +0,0 @@
-{
-  "priority": "INFO",
-  "payload": {
-    "watcher_object.namespace": "watcher",
-    "watcher_object.version": "1.0",
-    "watcher_object.name": "ActionDeletePayload",
-    "watcher_object.data": {
-      "uuid": "10a47dd1-4874-4298-91cf-eff046dbdb8d",
-      "input_parameters": {
-        "param2": 2,
-        "param1": 1
-      },
-      "created_at": "2016-10-18T09:52:05Z",
-      "updated_at": null,
-      "state": "DELETED",
-      "action_plan": {
-        "watcher_object.namespace": "watcher",
-        "watcher_object.version": "1.0",
-        "watcher_object.name": "TerseActionPlanPayload",
-        "watcher_object.data": {
-          "uuid": "76be87bd-3422-43f9-93a0-e85a577e3061",
-          "global_efficacy": {},
-          "created_at": "2016-10-18T09:52:05Z",
-          "updated_at": null,
-          "state": "ONGOING",
-          "audit_uuid": "10a47dd1-4874-4298-91cf-eff046dbdb8d",
-          "strategy_uuid": "cb3d0b58-4415-4d90-b75b-1e96878730e3",
-          "deleted_at": null
-        }
-      },
-      "parents": [],
-      "action_type": "nop",
-      "deleted_at": null
-    }
-  },
-  "publisher_id": "infra-optim:node0",
-  "timestamp": "2017-01-01 00:00:00.000000",
-  "event_type": "action.delete",
-  "message_id": "530b409c-9b6b-459b-8f08-f93dbfeb4d41"
-}

doc/notification_samples/action-execution-end.json

@@ -1,41 +0,0 @@
-{
-  "priority": "INFO",
-  "payload": {
-    "watcher_object.namespace": "watcher",
-    "watcher_object.version": "1.0",
-    "watcher_object.name": "ActionExecutionPayload",
-    "watcher_object.data": {
-      "uuid": "10a47dd1-4874-4298-91cf-eff046dbdb8d",
-      "input_parameters": {
-        "param2": 2,
-        "param1": 1
-      },
-      "fault": null,
-      "created_at": "2016-10-18T09:52:05Z",
-      "updated_at": null,
-      "state": "SUCCEEDED",
-      "action_plan": {
-        "watcher_object.namespace": "watcher",
-        "watcher_object.version": "1.0",
-        "watcher_object.name": "TerseActionPlanPayload",
-        "watcher_object.data": {
-          "uuid": "76be87bd-3422-43f9-93a0-e85a577e3061",
-          "global_efficacy": {},
-          "created_at": "2016-10-18T09:52:05Z",
-          "updated_at": null,
-          "state": "ONGOING",
-          "audit_uuid": "10a47dd1-4874-4298-91cf-eff046dbdb8d",
-          "strategy_uuid": "cb3d0b58-4415-4d90-b75b-1e96878730e3",
-          "deleted_at": null
-        }
-      },
-      "parents": [],
-      "action_type": "nop",
-      "deleted_at": null
-    }
-  },
-  "event_type": "action.execution.end",
-  "publisher_id": "infra-optim:node0",
-  "timestamp": "2017-01-01 00:00:00.000000",
-  "message_id": "530b409c-9b6b-459b-8f08-f93dbfeb4d41"
-}

doc/notification_samples/action-execution-error.json

@@ -1,51 +0,0 @@
-{
-  "priority": "ERROR",
-  "payload": {
-    "watcher_object.namespace": "watcher",
-    "watcher_object.version": "1.0",
-    "watcher_object.name": "ActionExecutionPayload",
-    "watcher_object.data": {
-      "uuid": "10a47dd1-4874-4298-91cf-eff046dbdb8d",
-      "input_parameters": {
-        "param2": 2,
-        "param1": 1
-      },
-      "fault": {
-        "watcher_object.namespace": "watcher",
-        "watcher_object.version": "1.0",
-        "watcher_object.name": "ExceptionPayload",
-        "watcher_object.data": {
-          "module_name": "watcher.tests.notifications.test_action_notification",
-          "exception": "WatcherException",
-          "exception_message": "TEST",
-          "function_name": "test_send_action_execution_with_error"
-        }
-      },
-      "created_at": "2016-10-18T09:52:05Z",
-      "updated_at": null,
-      "state": "FAILED",
-      "action_plan": {
-        "watcher_object.namespace": "watcher",
-        "watcher_object.version": "1.0",
-        "watcher_object.name": "TerseActionPlanPayload",
-        "watcher_object.data": {
-          "uuid": "76be87bd-3422-43f9-93a0-e85a577e3061",
-          "global_efficacy": {},
-          "created_at": "2016-10-18T09:52:05Z",
-          "updated_at": null,
-          "state": "ONGOING",
-          "audit_uuid": "10a47dd1-4874-4298-91cf-eff046dbdb8d",
-          "strategy_uuid": "cb3d0b58-4415-4d90-b75b-1e96878730e3",
-          "deleted_at": null
-        }
-      },
-      "parents": [],
-      "action_type": "nop",
-      "deleted_at": null
-    }
-  },
-  "event_type": "action.execution.error",
-  "publisher_id": "infra-optim:node0",
-  "timestamp": "2017-01-01 00:00:00.000000",
-  "message_id": "530b409c-9b6b-459b-8f08-f93dbfeb4d41"
-}

doc/notification_samples/action-execution-start.json

@@ -1,41 +0,0 @@
-{
-  "priority": "INFO",
-  "payload": {
-    "watcher_object.namespace": "watcher",
-    "watcher_object.version": "1.0",
-    "watcher_object.name": "ActionExecutionPayload",
-    "watcher_object.data": {
-      "uuid": "10a47dd1-4874-4298-91cf-eff046dbdb8d",
-      "input_parameters": {
-        "param2": 2,
-        "param1": 1
-      },
-      "fault": null,
-      "created_at": "2016-10-18T09:52:05Z",
-      "updated_at": null,
-      "state": "ONGOING",
-      "action_plan": {
-        "watcher_object.namespace": "watcher",
-        "watcher_object.version": "1.0",
-        "watcher_object.name": "TerseActionPlanPayload",
-        "watcher_object.data": {
-          "uuid": "76be87bd-3422-43f9-93a0-e85a577e3061",
-          "global_efficacy": {},
-          "created_at": "2016-10-18T09:52:05Z",
-          "updated_at": null,
-          "state": "ONGOING",
-          "audit_uuid": "10a47dd1-4874-4298-91cf-eff046dbdb8d",
-          "strategy_uuid": "cb3d0b58-4415-4d90-b75b-1e96878730e3",
-          "deleted_at": null
-        }
-      },
-      "parents": [],
-      "action_type": "nop",
-      "deleted_at": null
-    }
-  },
-  "event_type": "action.execution.start",
-  "publisher_id": "infra-optim:node0",
-  "timestamp": "2017-01-01 00:00:00.000000",
-  "message_id": "530b409c-9b6b-459b-8f08-f93dbfeb4d41"
-}

doc/notification_samples/action-update.json

@@ -1,49 +0,0 @@
-{
-  "priority": "INFO",
-  "payload": {
-    "watcher_object.namespace": "watcher",
-    "watcher_object.version": "1.0",
-    "watcher_object.name": "ActionUpdatePayload",
-    "watcher_object.data": {
-      "uuid": "10a47dd1-4874-4298-91cf-eff046dbdb8d",
-      "input_parameters": {
-        "param2": 2,
-        "param1": 1
-      },
-      "created_at": "2016-10-18T09:52:05Z",
-      "updated_at": null,
-      "state_update": {
-        "watcher_object.namespace": "watcher",
-        "watcher_object.version": "1.0",
-        "watcher_object.name": "ActionStateUpdatePayload",
-        "watcher_object.data": {
-          "old_state": "PENDING",
-          "state": "ONGOING"
-        }
-      },
-      "state": "ONGOING",
-      "action_plan": {
-        "watcher_object.namespace": "watcher",
-        "watcher_object.version": "1.0",
-        "watcher_object.name": "TerseActionPlanPayload",
-        "watcher_object.data": {
-          "uuid": "76be87bd-3422-43f9-93a0-e85a577e3061",
-          "global_efficacy": {},
-          "created_at": "2016-10-18T09:52:05Z",
-          "updated_at": null,
-          "state": "ONGOING",
-          "audit_uuid": "10a47dd1-4874-4298-91cf-eff046dbdb8d",
-          "strategy_uuid": "cb3d0b58-4415-4d90-b75b-1e96878730e3",
-          "deleted_at": null
-        }
-      },
-      "parents": [],
-      "action_type": "nop",
-      "deleted_at": null
-    }
-  },
-  "event_type": "action.update",
-  "publisher_id": "infra-optim:node0",
-  "timestamp": "2017-01-01 00:00:00.000000",
-  "message_id": "530b409c-9b6b-459b-8f08-f93dbfeb4d41"
-}

doc/notification_samples/action_plan-create.json

@@ -1,54 +0,0 @@
-{
-  "publisher_id": "infra-optim:node0",
-  "payload": {
-    "watcher_object.version": "1.0",
-    "watcher_object.data": {
-      "strategy_uuid": "cb3d0b58-4415-4d90-b75b-1e96878730e3",
-      "strategy": {
-        "watcher_object.version": "1.0",
-        "watcher_object.data": {
-          "uuid": "cb3d0b58-4415-4d90-b75b-1e96878730e3",
-          "display_name": "test strategy",
-          "name": "TEST",
-          "updated_at": null,
-          "parameters_spec": {},
-          "created_at": "2016-10-18T09:52:05Z",
-          "deleted_at": null
-        },
-        "watcher_object.namespace": "watcher",
-        "watcher_object.name": "StrategyPayload"
-      },
-      "created_at": null,
-      "audit_uuid": "10a47dd1-4874-4298-91cf-eff046dbdb8d",
-      "audit": {
-        "watcher_object.version": "1.0",
-        "watcher_object.data": {
-          "audit_type": "ONESHOT",
-          "scope": [],
-          "uuid": "10a47dd1-4874-4298-91cf-eff046dbdb8d",
-          "goal_uuid": "bc830f84-8ae3-4fc6-8bc6-e3dd15e8b49a",
-          "strategy_uuid": "75234dfe-87e3-4f11-a0e0-3c3305d86a39",
-          "parameters": {},
-          "interval": null,
-          "deleted_at": null,
-          "state": "PENDING",
-          "created_at": "2016-10-18T09:52:05Z",
-          "updated_at": null
-        },
-        "watcher_object.namespace": "watcher",
-        "watcher_object.name": "TerseAuditPayload"
-      },
-      "uuid": "76be87bd-3422-43f9-93a0-e85a577e3061",
-      "global_efficacy": {},
-      "deleted_at": null,
-      "state": "RECOMMENDED",
-      "updated_at": null
-    },
-    "watcher_object.namespace": "watcher",
-    "watcher_object.name": "ActionPlanCreatePayload"
-  },
-  "priority": "INFO",
-  "message_id": "5148bff1-ea06-4ad6-8e4e-8c85ca5eb629",
-  "event_type": "action_plan.create",
-  "timestamp": "2016-10-18 09:52:05.219414"
-}

doc/notification_samples/action_plan-delete.json

@@ -1,54 +0,0 @@
-{
-  "publisher_id": "infra-optim:node0",
-  "timestamp": "2016-10-18 09:52:05.219414",
-  "payload": {
-    "watcher_object.data": {
-      "uuid": "76be87bd-3422-43f9-93a0-e85a577e3061",
-      "created_at": "2016-10-18T09:52:05Z",
-      "audit_uuid": "10a47dd1-4874-4298-91cf-eff046dbdb8d",
-      "audit": {
-        "watcher_object.data": {
-          "uuid": "10a47dd1-4874-4298-91cf-eff046dbdb8d",
-          "goal_uuid": "bc830f84-8ae3-4fc6-8bc6-e3dd15e8b49a",
-          "strategy_uuid": "75234dfe-87e3-4f11-a0e0-3c3305d86a39",
-          "interval": null,
-          "audit_type": "ONESHOT",
-          "scope": [],
-          "updated_at": null,
-          "deleted_at": null,
-          "state": "PENDING",
-          "created_at": "2016-10-18T09:52:05Z",
-          "parameters": {}
-        },
-        "watcher_object.version": "1.0",
-        "watcher_object.name": "TerseAuditPayload",
-        "watcher_object.namespace": "watcher"
-      },
-      "global_efficacy": {},
-      "updated_at": null,
-      "deleted_at": null,
-      "strategy_uuid": "cb3d0b58-4415-4d90-b75b-1e96878730e3",
-      "strategy": {
-        "watcher_object.data": {
-          "uuid": "cb3d0b58-4415-4d90-b75b-1e96878730e3",
-          "created_at": "2016-10-18T09:52:05Z",
-          "name": "TEST",
-          "display_name": "test strategy",
-          "deleted_at": null,
-          "updated_at": null,
-          "parameters_spec": {}
-        },
-        "watcher_object.version": "1.0",
-        "watcher_object.name": "StrategyPayload",
-        "watcher_object.namespace": "watcher"
-      },
-      "state": "DELETED"
-    },
-    "watcher_object.version": "1.0",
-    "watcher_object.name": "ActionPlanDeletePayload",
-    "watcher_object.namespace": "watcher"
-  },
-  "event_type": "action_plan.delete",
-  "message_id": "3d137686-a1fd-4683-ab40-c4210aac2140",
-  "priority": "INFO"
-}

doc/notification_samples/action_plan-execution-end.json

@@ -1,55 +0,0 @@
-{
-  "event_type": "action_plan.execution.end",
-  "payload": {
-    "watcher_object.namespace": "watcher",
-    "watcher_object.name": "ActionPlanActionPayload",
-    "watcher_object.version": "1.0",
-    "watcher_object.data": {
-      "created_at": "2016-10-18T09:52:05Z",
-      "deleted_at": null,
-      "audit_uuid": "10a47dd1-4874-4298-91cf-eff046dbdb8d",
-      "audit": {
-        "watcher_object.namespace": "watcher",
-        "watcher_object.name": "TerseAuditPayload",
-        "watcher_object.version": "1.0",
-        "watcher_object.data": {
-          "created_at": "2016-10-18T09:52:05Z",
-          "deleted_at": null,
-          "uuid": "10a47dd1-4874-4298-91cf-eff046dbdb8d",
-          "goal_uuid": "bc830f84-8ae3-4fc6-8bc6-e3dd15e8b49a",
-          "strategy_uuid": "75234dfe-87e3-4f11-a0e0-3c3305d86a39",
-          "scope": [],
-          "audit_type": "ONESHOT",
-          "state": "SUCCEEDED",
-          "parameters": {},
-          "interval": null,
-          "updated_at": null
-        }
-      },
-      "uuid": "76be87bd-3422-43f9-93a0-e85a577e3061",
-      "fault": null,
-      "state": "ONGOING",
-      "global_efficacy": {},
-      "strategy_uuid": "cb3d0b58-4415-4d90-b75b-1e96878730e3",
-      "strategy": {
-        "watcher_object.namespace": "watcher",
-        "watcher_object.name": "StrategyPayload",
-        "watcher_object.version": "1.0",
-        "watcher_object.data": {
-          "created_at": "2016-10-18T09:52:05Z",
-          "deleted_at": null,
-          "name": "TEST",
-          "uuid": "cb3d0b58-4415-4d90-b75b-1e96878730e3",
-          "parameters_spec": {},
-          "display_name": "test strategy",
-          "updated_at": null
-        }
-      },
-      "updated_at": null
-    }
-  },
-  "priority": "INFO",
-  "message_id": "3984dc2b-8aef-462b-a220-8ae04237a56e",
-  "timestamp": "2016-10-18 09:52:05.219414",
-  "publisher_id": "infra-optim:node0"
-}

doc/notification_samples/action_plan-execution-error.json

@@ -1,65 +0,0 @@
-{
-  "event_type": "action_plan.execution.error",
-  "publisher_id": "infra-optim:node0",
-  "priority": "ERROR",
-  "message_id": "9a45c5ae-0e21-4300-8fa0-5555d52a66d9",
-  "payload": {
-    "watcher_object.version": "1.0",
-    "watcher_object.namespace": "watcher",
-    "watcher_object.name": "ActionPlanActionPayload",
-    "watcher_object.data": {
-      "fault": {
-        "watcher_object.version": "1.0",
-        "watcher_object.namespace": "watcher",
-        "watcher_object.name": "ExceptionPayload",
-        "watcher_object.data": {
-          "exception_message": "TEST",
-          "module_name": "watcher.tests.notifications.test_action_plan_notification",
-          "function_name": "test_send_action_plan_action_with_error",
-          "exception": "WatcherException"
-        }
-      },
-      "uuid": "76be87bd-3422-43f9-93a0-e85a577e3061",
-      "created_at": "2016-10-18T09:52:05Z",
-      "strategy_uuid": "cb3d0b58-4415-4d90-b75b-1e96878730e3",
-      "strategy": {
-        "watcher_object.version": "1.0",
-        "watcher_object.namespace": "watcher",
-        "watcher_object.name": "StrategyPayload",
-        "watcher_object.data": {
-          "uuid": "cb3d0b58-4415-4d90-b75b-1e96878730e3",
-          "created_at": "2016-10-18T09:52:05Z",
-          "name": "TEST",
-          "updated_at": null,
-          "display_name": "test strategy",
-          "parameters_spec": {},
-          "deleted_at": null
-        }
-      },
-      "updated_at": null,
-      "deleted_at": null,
-      "audit_uuid": "10a47dd1-4874-4298-91cf-eff046dbdb8d",
-      "audit": {
-        "watcher_object.version": "1.0",
-        "watcher_object.namespace": "watcher",
-        "watcher_object.name": "TerseAuditPayload",
-        "watcher_object.data": {
-          "parameters": {},
-          "uuid": "10a47dd1-4874-4298-91cf-eff046dbdb8d",
-          "goal_uuid": "bc830f84-8ae3-4fc6-8bc6-e3dd15e8b49a",
-          "strategy_uuid": "75234dfe-87e3-4f11-a0e0-3c3305d86a39",
-          "created_at": "2016-10-18T09:52:05Z",
-          "scope": [],
-          "updated_at": null,
-          "audit_type": "ONESHOT",
-          "interval": null,
-          "deleted_at": null,
-          "state": "PENDING"
-        }
-      },
-      "global_efficacy": {},
-      "state": "ONGOING"
-    }
-  },
-  "timestamp": "2016-10-18 09:52:05.219414"
-}

doc/notification_samples/action_plan-execution-start.json

@@ -1,55 +0,0 @@
-{
-  "event_type": "action_plan.execution.start",
-  "payload": {
-    "watcher_object.namespace": "watcher",
-    "watcher_object.name": "ActionPlanActionPayload",
-    "watcher_object.version": "1.0",
-    "watcher_object.data": {
-      "created_at": "2016-10-18T09:52:05Z",
-      "deleted_at": null,
-      "audit_uuid": "10a47dd1-4874-4298-91cf-eff046dbdb8d",
-      "audit": {
-        "watcher_object.namespace": "watcher",
-        "watcher_object.name": "TerseAuditPayload",
-        "watcher_object.version": "1.0",
-        "watcher_object.data": {
-          "created_at": "2016-10-18T09:52:05Z",
-          "deleted_at": null,
-          "uuid": "10a47dd1-4874-4298-91cf-eff046dbdb8d",
-          "goal_uuid": "bc830f84-8ae3-4fc6-8bc6-e3dd15e8b49a",
-          "strategy_uuid": "75234dfe-87e3-4f11-a0e0-3c3305d86a39",
-          "scope": [],
-          "audit_type": "ONESHOT",
-          "state": "PENDING",
-          "parameters": {},
-          "interval": null,
-          "updated_at": null
-        }
-      },
-      "uuid": "76be87bd-3422-43f9-93a0-e85a577e3061",
-      "fault": null,
-      "state": "ONGOING",
-      "global_efficacy": {},
-      "strategy_uuid": "cb3d0b58-4415-4d90-b75b-1e96878730e3",
-      "strategy": {
-        "watcher_object.namespace": "watcher",
-        "watcher_object.name": "StrategyPayload",
-        "watcher_object.version": "1.0",
-        "watcher_object.data": {
-          "created_at": "2016-10-18T09:52:05Z",
-          "deleted_at": null,
-          "name": "TEST",
-          "uuid": "cb3d0b58-4415-4d90-b75b-1e96878730e3",
-          "parameters_spec": {},
-          "display_name": "test strategy",
-          "updated_at": null
-        }
-      },
-      "updated_at": null
-    }
-  },
-  "priority": "INFO",
-  "message_id": "3984dc2b-8aef-462b-a220-8ae04237a56e",
-  "timestamp": "2016-10-18 09:52:05.219414",
-  "publisher_id": "infra-optim:node0"
-}

doc/notification_samples/action_plan-update.json

@@ -1,63 +0,0 @@
-{
-  "payload": {
-    "watcher_object.version": "1.0",
-    "watcher_object.data": {
-      "audit_uuid": "10a47dd1-4874-4298-91cf-eff046dbdb8d",
-      "audit": {
-        "watcher_object.version": "1.0",
-        "watcher_object.data": {
-          "audit_type": "ONESHOT",
-          "scope": [],
-          "created_at": "2016-10-18T09:52:05Z",
-          "uuid": "10a47dd1-4874-4298-91cf-eff046dbdb8d",
-          "goal_uuid": "bc830f84-8ae3-4fc6-8bc6-e3dd15e8b49a",
-          "strategy_uuid": "75234dfe-87e3-4f11-a0e0-3c3305d86a39",
-          "interval": null,
-          "updated_at": null,
-          "state": "PENDING",
-          "deleted_at": null,
-          "parameters": {}
-        },
-        "watcher_object.namespace": "watcher",
-        "watcher_object.name": "TerseAuditPayload"
-      },
-      "created_at": "2016-10-18T09:52:05Z",
-      "uuid": "76be87bd-3422-43f9-93a0-e85a577e3061",
-      "updated_at": null,
-      "state_update": {
-        "watcher_object.version": "1.0",
-        "watcher_object.data": {
-          "old_state": "PENDING",
-          "state": "ONGOING"
-        },
-        "watcher_object.namespace": "watcher",
-        "watcher_object.name": "ActionPlanStateUpdatePayload"
-      },
-      "state": "ONGOING",
-      "deleted_at": null,
-      "strategy_uuid": "cb3d0b58-4415-4d90-b75b-1e96878730e3",
-      "strategy": {
-        "watcher_object.version": "1.0",
-        "watcher_object.data": {
-          "name": "TEST",
-          "uuid": "cb3d0b58-4415-4d90-b75b-1e96878730e3",
-          "display_name": "test strategy",
-          "created_at": "2016-10-18T09:52:05Z",
-          "updated_at": null,
-          "deleted_at": null,
-          "parameters_spec": {}
-        },
-        "watcher_object.namespace": "watcher",
-        "watcher_object.name": "StrategyPayload"
-      },
-      "global_efficacy": {}
-    },
-    "watcher_object.namespace": "watcher",
-    "watcher_object.name": "ActionPlanUpdatePayload"
-  },
-  "publisher_id": "infra-optim:node0",
-  "priority": "INFO",
-  "timestamp": "2016-10-18 09:52:05.219414",
-  "event_type": "action_plan.update",
-  "message_id": "0a8a7329-fd5a-4ec6-97d7-2b776ce51a4c"
-}

doc/notification_samples/audit-create.json

@@ -1,71 +0,0 @@
-{
-  "priority": "INFO",
-  "payload": {
-    "watcher_object.data": {
-      "audit_type": "ONESHOT",
-      "parameters": {
-        "para2": "hello",
-        "para1": 3.2
-      },
-      "state": "PENDING",
-      "updated_at": null,
-      "deleted_at": null,
-      "goal_uuid": "bc830f84-8ae3-4fc6-8bc6-e3dd15e8b49a",
-      "goal": {
-        "watcher_object.data": {
-          "uuid": "bc830f84-8ae3-4fc6-8bc6-e3dd15e8b49a",
-          "name": "dummy",
-          "updated_at": null,
-          "deleted_at": null,
-          "efficacy_specification": [],
-          "created_at": "2016-11-04T16:25:35Z",
-          "display_name": "Dummy goal"
-        },
-        "watcher_object.name": "GoalPayload",
-        "watcher_object.version": "1.0",
-        "watcher_object.namespace": "watcher"
-      },
-      "interval": null,
-      "scope": [],
-      "strategy_uuid": "75234dfe-87e3-4f11-a0e0-3c3305d86a39",
-      "strategy": {
-        "watcher_object.data": {
-          "parameters_spec": {
-            "properties": {
-              "para2": {
-                "type": "string",
-                "default": "hello",
-                "description": "string parameter example"
-              },
-              "para1": {
-                "description": "number parameter example",
-                "maximum": 10.2,
-                "type": "number",
-                "default": 3.2,
-                "minimum": 1.0
-              }
-            }
-          },
-          "name": "dummy",
-          "uuid": "75234dfe-87e3-4f11-a0e0-3c3305d86a39",
-          "updated_at": null,
-          "deleted_at": null,
-          "created_at": "2016-11-04T16:25:35Z",
-          "display_name": "Dummy strategy"
-        },
-        "watcher_object.name": "StrategyPayload",
-        "watcher_object.version": "1.0",
-        "watcher_object.namespace": "watcher"
-      },
-      "created_at": "2016-11-04T16:29:20Z",
-      "uuid": "4a97b9dd-2023-43dc-b713-815bdd94d4d6"
-    },
-    "watcher_object.name": "AuditCreatePayload",
-    "watcher_object.version": "1.0",
-    "watcher_object.namespace": "watcher"
-  },
-  "publisher_id": "infra-optim:localhost",
-  "timestamp": "2016-11-04 16:31:36.264673   ",
-  "event_type": "audit.create",
-  "message_id": "cbcf9f2c-7c53-4b4d-91ec-db49cca024b6"
-}

doc/notification_samples/audit-delete.json

@@ -1,71 +0,0 @@
-{
-  "priority": "INFO",
-  "payload": {
-    "watcher_object.data": {
-      "audit_type": "ONESHOT",
-      "parameters": {
-        "para2": "hello",
-        "para1": 3.2
-      },
-      "state": "DELETED",
-      "updated_at": null,
-      "deleted_at": null,
-      "goal_uuid": "bc830f84-8ae3-4fc6-8bc6-e3dd15e8b49a",
-      "goal": {
-        "watcher_object.data": {
-          "uuid": "bc830f84-8ae3-4fc6-8bc6-e3dd15e8b49a",
-          "name": "dummy",
-          "updated_at": null,
-          "deleted_at": null,
-          "efficacy_specification": [],
-          "created_at": "2016-11-04T16:25:35Z",
-          "display_name": "Dummy goal"
-        },
-        "watcher_object.name": "GoalPayload",
-        "watcher_object.version": "1.0",
-        "watcher_object.namespace": "watcher"
-      },
-      "interval": null,
-      "scope": [],
-      "strategy_uuid": "75234dfe-87e3-4f11-a0e0-3c3305d86a39",
-      "strategy": {
-        "watcher_object.data": {
-          "parameters_spec": {
-            "properties": {
-              "para2": {
-                "type": "string",
-                "default": "hello",
-                "description": "string parameter example"
-              },
-              "para1": {
-                "description": "number parameter example",
-                "maximum": 10.2,
-                "type": "number",
-                "default": 3.2,
-                "minimum": 1.0
-              }
-            }
-          },
-          "name": "dummy",
-          "uuid": "75234dfe-87e3-4f11-a0e0-3c3305d86a39",
-          "updated_at": null,
-          "deleted_at": null,
-          "created_at": "2016-11-04T16:25:35Z",
-          "display_name": "Dummy strategy"
-        },
-        "watcher_object.name": "StrategyPayload",
-        "watcher_object.version": "1.0",
-        "watcher_object.namespace": "watcher"
-      },
-      "created_at": "2016-11-04T16:29:20Z",
-      "uuid": "4a97b9dd-2023-43dc-b713-815bdd94d4d6"
-    },
-    "watcher_object.name": "AuditDeletePayload",
-    "watcher_object.version": "1.0",
-    "watcher_object.namespace": "watcher"
-  },
-  "publisher_id": "infra-optim:localhost",
-  "timestamp": "2016-11-04 16:31:36.264673   ",
-  "event_type": "audit.delete",
-  "message_id": "cbcf9f2c-7c53-4b4d-91ec-db49cca024b6"
-}

doc/notification_samples/audit-planner-end.json

@@ -1,72 +0,0 @@
-{
-  "priority": "INFO",
-  "payload": {
-    "watcher_object.data": {
-      "audit_type": "ONESHOT",
-      "parameters": {
-        "para2": "hello",
-        "para1": 3.2
-      },
-      "state": "ONGOING",
-      "updated_at": null,
-      "deleted_at": null,
-      "fault": null,
-      "goal_uuid": "bc830f84-8ae3-4fc6-8bc6-e3dd15e8b49a",
-      "goal": {
-        "watcher_object.data": {
-          "uuid": "bc830f84-8ae3-4fc6-8bc6-e3dd15e8b49a",
-          "name": "dummy",
-          "updated_at": null,
-          "deleted_at": null,
-          "efficacy_specification": [],
-          "created_at": "2016-11-04T16:25:35Z",
-          "display_name": "Dummy goal"
-        },
-        "watcher_object.name": "GoalPayload",
-        "watcher_object.version": "1.0",
-        "watcher_object.namespace": "watcher"
-      },
-      "interval": null,
-      "scope": [],
-      "strategy_uuid": "75234dfe-87e3-4f11-a0e0-3c3305d86a39",
-      "strategy": {
-        "watcher_object.data": {
-          "parameters_spec": {
-            "properties": {
-              "para2": {
-                "type": "string",
-                "default": "hello",
-                "description": "string parameter example"
-              },
-              "para1": {
-                "description": "number parameter example",
-                "maximum": 10.2,
-                "type": "number",
-                "default": 3.2,
-                "minimum": 1.0
-              }
-            }
-          },
-          "name": "dummy",
-          "uuid": "75234dfe-87e3-4f11-a0e0-3c3305d86a39",
-          "updated_at": null,
-          "deleted_at": null,
-          "created_at": "2016-11-04T16:25:35Z",
-          "display_name": "Dummy strategy"
-        },
-        "watcher_object.name": "StrategyPayload",
-        "watcher_object.version": "1.0",
-        "watcher_object.namespace": "watcher"
-      },
-      "created_at": "2016-11-04T16:29:20Z",
-      "uuid": "4a97b9dd-2023-43dc-b713-815bdd94d4d6"
-    },
-    "watcher_object.name": "AuditActionPayload",
-    "watcher_object.version": "1.0",
-    "watcher_object.namespace": "watcher"
-  },
-  "publisher_id": "infra-optim:localhost",
-  "timestamp": "2016-11-04 16:31:36.264673   ",
-  "event_type": "audit.planner.end",
-  "message_id": "cbcf9f2c-7c53-4b4d-91ec-db49cca024b6"
-}

doc/notification_samples/audit-planner-error.json

@@ -1,82 +0,0 @@
-{
-  "priority": "ERROR",
-  "payload": {
-    "watcher_object.data": {
-      "audit_type": "ONESHOT",
-      "parameters": {
-        "para2": "hello",
-        "para1": 3.2
-      },
-      "state": "ONGOING",
-      "updated_at": null,
-      "deleted_at": null,
-      "fault": {
-        "watcher_object.data": {
-          "exception": "WatcherException",
-          "exception_message": "TEST",
-          "function_name": "test_send_audit_action_with_error",
-          "module_name": "watcher.tests.notifications.test_audit_notification"
-        },
-        "watcher_object.name": "ExceptionPayload",
-        "watcher_object.namespace": "watcher",
-        "watcher_object.version": "1.0"
-      },
-      "goal_uuid": "bc830f84-8ae3-4fc6-8bc6-e3dd15e8b49a",
-      "goal": {
-        "watcher_object.data": {
-          "uuid": "bc830f84-8ae3-4fc6-8bc6-e3dd15e8b49a",
-          "name": "dummy",
-          "updated_at": null,
-          "deleted_at": null,
-          "efficacy_specification": [],
-          "created_at": "2016-11-04T16:25:35Z",
-          "display_name": "Dummy goal"
-        },
-        "watcher_object.name": "GoalPayload",
-        "watcher_object.version": "1.0",
-        "watcher_object.namespace": "watcher"
-      },
-      "interval": null,
-      "scope": [],
-      "strategy_uuid": "75234dfe-87e3-4f11-a0e0-3c3305d86a39",
-      "strategy": {
-        "watcher_object.data": {
-          "parameters_spec": {
-            "properties": {
-              "para2": {
-                "type": "string",
-                "default": "hello",
-                "description": "string parameter example"
-              },
-              "para1": {
-                "description": "number parameter example",
-                "maximum": 10.2,
-                "type": "number",
-                "default": 3.2,
-                "minimum": 1.0
-              }
-            }
-          },
-          "name": "dummy",
-          "uuid": "75234dfe-87e3-4f11-a0e0-3c3305d86a39",
-          "updated_at": null,
-          "deleted_at": null,
-          "created_at": "2016-11-04T16:25:35Z",
-          "display_name": "Dummy strategy"
-        },
-        "watcher_object.name": "StrategyPayload",
-        "watcher_object.version": "1.0",
-        "watcher_object.namespace": "watcher"
-      },
-      "created_at": "2016-11-04T16:29:20Z",
-      "uuid": "4a97b9dd-2023-43dc-b713-815bdd94d4d6"
-    },
-    "watcher_object.name": "AuditActionPayload",
-    "watcher_object.version": "1.0",
-    "watcher_object.namespace": "watcher"
-  },
-  "publisher_id": "infra-optim:localhost",
-  "timestamp": "2016-11-04 16:31:36.264673   ",
-  "event_type": "audit.planner.error",
-  "message_id": "cbcf9f2c-7c53-4b4d-91ec-db49cca024b6"
-}

doc/notification_samples/audit-planner-start.json

@@ -1,72 +0,0 @@
-{
-  "priority": "INFO",
-  "payload": {
-    "watcher_object.data": {
-      "audit_type": "ONESHOT",
-      "parameters": {
-        "para2": "hello",
-        "para1": 3.2
-      },
-      "state": "ONGOING",
-      "updated_at": null,
-      "deleted_at": null,
-      "fault": null,
-      "goal_uuid": "bc830f84-8ae3-4fc6-8bc6-e3dd15e8b49a",
-      "goal": {
-        "watcher_object.data": {
-          "uuid": "bc830f84-8ae3-4fc6-8bc6-e3dd15e8b49a",
-          "name": "dummy",
-          "updated_at": null,
-          "deleted_at": null,
-          "efficacy_specification": [],
-          "created_at": "2016-11-04T16:25:35Z",
-          "display_name": "Dummy goal"
-        },
-        "watcher_object.name": "GoalPayload",
-        "watcher_object.version": "1.0",
-        "watcher_object.namespace": "watcher"
-      },
-      "interval": null,
-      "scope": [],
-      "strategy_uuid": "75234dfe-87e3-4f11-a0e0-3c3305d86a39",
-      "strategy": {
-        "watcher_object.data": {
-          "parameters_spec": {
-            "properties": {
-              "para2": {
-                "type": "string",
-                "default": "hello",
-                "description": "string parameter example"
-              },
-              "para1": {
-                "description": "number parameter example",
-                "maximum": 10.2,
-                "type": "number",
-                "default": 3.2,
-                "minimum": 1.0
-              }
-            }
-          },
-          "name": "dummy",
-          "uuid": "75234dfe-87e3-4f11-a0e0-3c3305d86a39",
-          "updated_at": null,
-          "deleted_at": null,
-          "created_at": "2016-11-04T16:25:35Z",
-          "display_name": "Dummy strategy"
-        },
-        "watcher_object.name": "StrategyPayload",
-        "watcher_object.version": "1.0",
-        "watcher_object.namespace": "watcher"
-      },
-      "created_at": "2016-11-04T16:29:20Z",
-      "uuid": "4a97b9dd-2023-43dc-b713-815bdd94d4d6"
-    },
-    "watcher_object.name": "AuditActionPayload",
-    "watcher_object.version": "1.0",
-    "watcher_object.namespace": "watcher"
-  },
-  "publisher_id": "infra-optim:localhost",
-  "timestamp": "2016-11-04 16:31:36.264673   ",
-  "event_type": "audit.planner.start",
-  "message_id": "cbcf9f2c-7c53-4b4d-91ec-db49cca024b6"
-}

doc/notification_samples/audit-strategy-end.json

@@ -1,72 +0,0 @@
-{
-  "priority": "INFO",
-  "payload": {
-    "watcher_object.data": {
-      "audit_type": "ONESHOT",
-      "parameters": {
-        "para2": "hello",
-        "para1": 3.2
-      },
-      "state": "ONGOING",
-      "updated_at": null,
-      "deleted_at": null,
-      "fault": null,
-      "goal_uuid": "bc830f84-8ae3-4fc6-8bc6-e3dd15e8b49a",
-      "goal": {
-        "watcher_object.data": {
-          "uuid": "bc830f84-8ae3-4fc6-8bc6-e3dd15e8b49a",
-          "name": "dummy",
-          "updated_at": null,
-          "deleted_at": null,
-          "efficacy_specification": [],
-          "created_at": "2016-11-04T16:25:35Z",
-          "display_name": "Dummy goal"
-        },
-        "watcher_object.name": "GoalPayload",
-        "watcher_object.version": "1.0",
-        "watcher_object.namespace": "watcher"
-      },
-      "interval": null,
-      "scope": [],
-      "strategy_uuid": "75234dfe-87e3-4f11-a0e0-3c3305d86a39",
-      "strategy": {
-        "watcher_object.data": {
-          "parameters_spec": {
-            "properties": {
-              "para2": {
-                "type": "string",
-                "default": "hello",
-                "description": "string parameter example"
-              },
-              "para1": {
-                "description": "number parameter example",
-                "maximum": 10.2,
-                "type": "number",
-                "default": 3.2,
-                "minimum": 1.0
-              }
-            }
-          },
-          "name": "dummy",
-          "uuid": "75234dfe-87e3-4f11-a0e0-3c3305d86a39",
-          "updated_at": null,
-          "deleted_at": null,
-          "created_at": "2016-11-04T16:25:35Z",
-          "display_name": "Dummy strategy"
-        },
-        "watcher_object.name": "StrategyPayload",
-        "watcher_object.version": "1.0",
-        "watcher_object.namespace": "watcher"
-      },
-      "created_at": "2016-11-04T16:29:20Z",
-      "uuid": "4a97b9dd-2023-43dc-b713-815bdd94d4d6"
-    },
-    "watcher_object.name": "AuditActionPayload",
-    "watcher_object.version": "1.0",
-    "watcher_object.namespace": "watcher"
-  },
-  "publisher_id": "infra-optim:localhost",
-  "timestamp": "2016-11-04 16:31:36.264673   ",
-  "event_type": "audit.strategy.end",
-  "message_id": "cbcf9f2c-7c53-4b4d-91ec-db49cca024b6"
-}

doc/notification_samples/audit-strategy-error.json

@@ -1,82 +0,0 @@
-{
-  "priority": "ERROR",
-  "payload": {
-    "watcher_object.data": {
-      "audit_type": "ONESHOT",
-      "parameters": {
-        "para2": "hello",
-        "para1": 3.2
-      },
-      "state": "ONGOING",
-      "updated_at": null,
-      "deleted_at": null,
-      "fault": {
-        "watcher_object.data": {
-          "exception": "WatcherException",
-          "exception_message": "TEST",
-          "function_name": "test_send_audit_action_with_error",
-          "module_name": "watcher.tests.notifications.test_audit_notification"
-        },
-        "watcher_object.name": "ExceptionPayload",
-        "watcher_object.namespace": "watcher",
-        "watcher_object.version": "1.0"
-      },
-      "goal_uuid": "bc830f84-8ae3-4fc6-8bc6-e3dd15e8b49a",
-      "goal": {
-        "watcher_object.data": {
-          "uuid": "bc830f84-8ae3-4fc6-8bc6-e3dd15e8b49a",
-          "name": "dummy",
-          "updated_at": null,
-          "deleted_at": null,
-          "efficacy_specification": [],
-          "created_at": "2016-11-04T16:25:35Z",
-          "display_name": "Dummy goal"
-        },
-        "watcher_object.name": "GoalPayload",
-        "watcher_object.version": "1.0",
-        "watcher_object.namespace": "watcher"
-      },
-      "interval": null,
-      "scope": [],
-      "strategy_uuid": "75234dfe-87e3-4f11-a0e0-3c3305d86a39",
-      "strategy": {
-        "watcher_object.data": {
-          "parameters_spec": {
-            "properties": {
-              "para2": {
-                "type": "string",
-                "default": "hello",
-                "description": "string parameter example"
-              },
-              "para1": {
-                "description": "number parameter example",
-                "maximum": 10.2,
-                "type": "number",
-                "default": 3.2,
-                "minimum": 1.0
-              }
-            }
-          },
-          "name": "dummy",
-          "uuid": "75234dfe-87e3-4f11-a0e0-3c3305d86a39",
-          "updated_at": null,
-          "deleted_at": null,
-          "created_at": "2016-11-04T16:25:35Z",
-          "display_name": "Dummy strategy"
-        },
-        "watcher_object.name": "StrategyPayload",
-        "watcher_object.version": "1.0",
-        "watcher_object.namespace": "watcher"
-      },
-      "created_at": "2016-11-04T16:29:20Z",
-      "uuid": "4a97b9dd-2023-43dc-b713-815bdd94d4d6"
-    },
-    "watcher_object.name": "AuditActionPayload",
-    "watcher_object.version": "1.0",
-    "watcher_object.namespace": "watcher"
-  },
-  "publisher_id": "infra-optim:localhost",
-  "timestamp": "2016-11-04 16:31:36.264673   ",
-  "event_type": "audit.strategy.error",
-  "message_id": "cbcf9f2c-7c53-4b4d-91ec-db49cca024b6"
-}

doc/notification_samples/audit-strategy-start.json

@@ -1,72 +0,0 @@
-{
-  "priority": "INFO",
-  "payload": {
-    "watcher_object.data": {
-      "audit_type": "ONESHOT",
-      "parameters": {
-        "para2": "hello",
-        "para1": 3.2
-      },
-      "state": "ONGOING",
-      "updated_at": null,
-      "deleted_at": null,
-      "fault": null,
-      "goal_uuid": "bc830f84-8ae3-4fc6-8bc6-e3dd15e8b49a",
-      "goal": {
-        "watcher_object.data": {
-          "uuid": "bc830f84-8ae3-4fc6-8bc6-e3dd15e8b49a",
-          "name": "dummy",
-          "updated_at": null,
-          "deleted_at": null,
-          "efficacy_specification": [],
-          "created_at": "2016-11-04T16:25:35Z",
-          "display_name": "Dummy goal"
-        },
-        "watcher_object.name": "GoalPayload",
-        "watcher_object.version": "1.0",
-        "watcher_object.namespace": "watcher"
-      },
-      "interval": null,
-      "scope": [],
-      "strategy_uuid": "75234dfe-87e3-4f11-a0e0-3c3305d86a39",
-      "strategy": {
-        "watcher_object.data": {
-          "parameters_spec": {
-            "properties": {
-              "para2": {
-                "type": "string",
-                "default": "hello",
-                "description": "string parameter example"
-              },
-              "para1": {
-                "description": "number parameter example",
-                "maximum": 10.2,
-                "type": "number",
-                "default": 3.2,
-                "minimum": 1.0
-              }
-            }
-          },
-          "name": "dummy",
-          "uuid": "75234dfe-87e3-4f11-a0e0-3c3305d86a39",
-          "updated_at": null,
-          "deleted_at": null,
-          "created_at": "2016-11-04T16:25:35Z",
-          "display_name": "Dummy strategy"
-        },
-        "watcher_object.name": "StrategyPayload",
-        "watcher_object.version": "1.0",
-        "watcher_object.namespace": "watcher"
-      },
-      "created_at": "2016-11-04T16:29:20Z",
-      "uuid": "4a97b9dd-2023-43dc-b713-815bdd94d4d6"
-    },
-    "watcher_object.name": "AuditActionPayload",
-    "watcher_object.version": "1.0",
-    "watcher_object.namespace": "watcher"
-  },
-  "publisher_id": "infra-optim:localhost",
-  "timestamp": "2016-11-04 16:31:36.264673   ",
-  "event_type": "audit.strategy.start",
-  "message_id": "cbcf9f2c-7c53-4b4d-91ec-db49cca024b6"
-}

doc/notification_samples/audit-update.json

@@ -1,80 +0,0 @@
-{
-  "publisher_id": "infra-optim:localhost",
-  "timestamp": "2016-11-04 16:51:38.722986   ",
-  "payload": {
-    "watcher_object.name": "AuditUpdatePayload",
-    "watcher_object.data": {
-      "strategy_uuid": "75234dfe-87e3-4f11-a0e0-3c3305d86a39",
-      "strategy": {
-        "watcher_object.name": "StrategyPayload",
-        "watcher_object.data": {
-          "name": "dummy",
-          "parameters_spec": {
-            "properties": {
-              "para2": {
-                "default": "hello",
-                "type": "string",
-                "description": "string parameter example"
-              },
-              "para1": {
-                "maximum": 10.2,
-                "default": 3.2,
-                "minimum": 1.0,
-                "description": "number parameter example",
-                "type": "number"
-              }
-            }
-          },
-          "updated_at": null,
-          "display_name": "Dummy strategy",
-          "deleted_at": null,
-          "uuid": "75234dfe-87e3-4f11-a0e0-3c3305d86a39",
-          "created_at": "2016-11-04T16:25:35Z"
-        },
-        "watcher_object.namespace": "watcher",
-        "watcher_object.version": "1.0"
-      },
-      "scope": [],
-      "created_at": "2016-11-04T16:51:21Z",
-      "uuid": "f1e0d912-afd9-4bf2-91ef-c99cd08cc1ef",
-      "goal_uuid": "bc830f84-8ae3-4fc6-8bc6-e3dd15e8b49a",
-      "goal": {
-        "watcher_object.name": "GoalPayload",
-        "watcher_object.data": {
-          "efficacy_specification": [],
-          "updated_at": null,
-          "name": "dummy",
-          "display_name": "Dummy goal",
-          "deleted_at": null,
-          "uuid": "bc830f84-8ae3-4fc6-8bc6-e3dd15e8b49a",
-          "created_at": "2016-11-04T16:25:35Z"
-        },
-        "watcher_object.namespace": "watcher",
-        "watcher_object.version": "1.0"
-      },
-      "parameters": {
-        "para2": "hello",
-        "para1": 3.2
-      },
-      "deleted_at": null,
-      "state_update": {
-        "watcher_object.name": "AuditStateUpdatePayload",
-        "watcher_object.data": {
-          "state": "ONGOING",
-          "old_state": "PENDING"
-        },
-        "watcher_object.namespace": "watcher",
-        "watcher_object.version": "1.0"
-      },
-      "interval": null,
-      "updated_at": null,
-      "state": "ONGOING",
-      "audit_type": "ONESHOT"
-    },
-    "watcher_object.namespace": "watcher",
-    "watcher_object.version": "1.0"
-  },
-  "priority": "INFO",
-  "event_type": "audit.update",
-  "message_id": "697fdf55-7252-4b6c-a2c2-5b9e85f6342c"
-}

doc/notification_samples/infra-optim-exception.json

@@ -1,16 +0,0 @@
-{
-    "event_type": "infra-optim.exception",
-    "payload": {
-        "watcher_object.data": {
-            "exception": "NoAvailableStrategyForGoal",
-            "exception_message": "No strategy could be found to achieve the server_consolidation goal.",
-            "function_name": "_aggregate_create_in_db",
-            "module_name": "watcher.objects.aggregate"
-        },
-        "watcher_object.name": "ExceptionPayload",
-        "watcher_object.namespace": "watcher",
-        "watcher_object.version": "1.0"
-    },
-    "priority": "ERROR",
-    "publisher_id": "watcher-api:fake-mini"
-}

doc/source/architecture.rst

@@ -21,7 +21,7 @@ Overview
 Below you will find a diagram, showing the main components of Watcher:
 
 .. image:: ./images/architecture.svg
-   :width: 110%
+   :width: 100%
 
 
 .. _components_definition:
@@ -37,12 +37,13 @@ AMQP Bus
 The AMQP message bus handles internal asynchronous communications between the
 different Watcher components.
 
-.. _cluster_datasource_definition:
+.. _cluster_history_db_definition:
 
-Datasource
+Cluster History Database
-----------
+------------------------
 
-This component stores the metrics related to the cluster.
+This component stores the data related to the
+:ref:`Cluster History <cluster_history_definition>`.
 
 It can potentially rely on any appropriate storage system (InfluxDB, OpenTSDB,
 MongoDB,...) but will probably be more performant when using
@@ -50,6 +51,14 @@ MongoDB,...) but will probably be more performant when using
 which are optimized for handling time series data, which are arrays of numbers
 indexed by time (a datetime or a datetime range).
 
+.. _cluster_model_db_definition:
+
+Cluster Model Database
+------------------------
+
+This component stores the data related to the
+:ref:`Cluster Data Model <cluster_data_model_definition>`.
+
 .. _archi_watcher_api_definition:
 
 Watcher API
@@ -184,8 +193,8 @@ data:
   :ref:`Managed resources <managed_resource_definition>` (e.g., the data stored
   in the Nova database). These models gives a strategy the ability to reason on
   the current state of a given :ref:`cluster <cluster_definition>`.
-- The data stored in the :ref:`Cluster Datasource
+- The data stored in the :ref:`Cluster History Database
-  <cluster_datasource_definition>` which provides information about the past of
+  <cluster_history_db_definition>` which provides information about the past of
   the :ref:`Cluster <cluster_definition>`.
 
 Here below is a sequence diagram showing how the Decision Engine builds and
@@ -289,7 +298,7 @@ The :ref:`Watcher Decision Engine <watcher_decision_engine_definition>` also
 builds the :ref:`Cluster Data Model <cluster_data_model_definition>`. This
 data model is needed by the :ref:`Strategy <strategy_definition>` to know the
 current state and topology of the audited
-:ref:`OpenStack cluster <cluster_definition>`.
+:ref:`Openstack cluster <cluster_definition>`.
 
 The :ref:`Watcher Decision Engine <watcher_decision_engine_definition>` calls
 the **execute()** method of the instantiated
@@ -307,7 +316,7 @@ This method finds an appropriate scheduling of
 :ref:`Actions <action_definition>` taking into account some scheduling rules
 (such as priorities between actions).
 It generates a new :ref:`Action Plan <action_plan_definition>` with status
-**RECOMMENDED** and saves it into the :ref:`Watcher Database
+**RECOMMENDED** and saves it into the:ref:`Watcher Database
 <watcher_database_definition>`. The saved action plan is now a scheduled flow
 of actions to which a global efficacy is associated alongside a number of
 :ref:`Efficacy Indicators <efficacy_indicator_definition>` as specified by the
@@ -407,9 +416,6 @@ be one of the following:
 -  **CANCELLED** : the :ref:`Audit <audit_definition>` was in **PENDING** or
    **ONGOING** state and was cancelled by the
    :ref:`Administrator <administrator_definition>`
--  **SUSPENDED** : the :ref:`Audit <audit_definition>` was in **ONGOING**
-   state and was suspended by the
-   :ref:`Administrator <administrator_definition>`
 
 The following diagram shows the different possible states of an
 :ref:`Audit <audit_definition>` and what event makes the state change to a new
@@ -444,12 +450,8 @@ state may be one of the following:
    stored in the :ref:`Watcher database <watcher_database_definition>` but is
    not returned any more through the Watcher APIs.
 -  **CANCELLED** : the :ref:`Action Plan <action_plan_definition>` was in
-   **RECOMMENDED**, **PENDING** or **ONGOING** state and was cancelled by the
+   **PENDING** or **ONGOING** state and was cancelled by the
    :ref:`Administrator <administrator_definition>`
--  **SUPERSEDED** : the :ref:`Action Plan <action_plan_definition>` was in
-   RECOMMENDED state and was automatically superseded by Watcher, due to an
-   expiration delay or an update of the
-   :ref:`Cluster data model <cluster_data_model_definition>`
 
 
 The following diagram shows the different possible states of an

doc/source/conf.py

@@ -1,3 +1,4 @@
+# -*- coding: utf-8 -*-
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.
 # You may obtain a copy of the License at
@@ -10,21 +11,7 @@
 # implied.
 # See the License for the specific language governing permissions and
 # limitations under the License.
-
-import os
-import sys
-
 from watcher import version as watcher_version
-from watcher import objects
-
-objects.register_all()
-
-# If extensions (or modules to document with autodoc) are in another directory,
-# add these directories to sys.path here. If the directory is relative to the
-# documentation root, use os.path.abspath to make it absolute, like shown here.
-sys.path.insert(0, os.path.abspath('../../'))
-sys.path.insert(0, os.path.abspath('../'))
-sys.path.insert(0, os.path.abspath('./'))
 
 # -- General configuration ----------------------------------------------------
 
@@ -39,8 +26,7 @@ extensions = [
     'sphinxcontrib.pecanwsme.rest',
     'stevedore.sphinxext',
     'wsmeext.sphinxext',
-    'ext.term',
+    'watcher.doc',
-    'ext.versioned_notifications',
 ]
 
 wsme_protocols = ['restjson']
@@ -81,8 +67,6 @@ exclude_patterns = [
     # them when scanning for input files.
     'man/footer.rst',
     'man/general-options.rst',
-    'strategies/strategy-template.rst',
-    'image_src/plantuml/README.rst',
 ]
 
 # If true, '()' will be appended to :func: etc. cross-reference text.

doc/source/deploy/apache-mod-wsgi.rst

@@ -1,49 +0,0 @@
-..
-      Except where otherwise noted, this document is licensed under Creative
-      Commons Attribution 3.0 License.  You can view the license at:
-
-          https://creativecommons.org/licenses/by/3.0/
-
-
-Installing API behind mod_wsgi
-==============================
-
-#. Install the Apache Service::
-
-    Fedora 21/RHEL7/CentOS7:
-      sudo yum install httpd
-
-    Fedora 22 (or higher):
-      sudo dnf install httpd
-
-    Debian/Ubuntu:
-      apt-get install apache2
-
-#. Copy ``etc/apache2/watcher.conf`` under the apache sites::
-
-    Fedora/RHEL7/CentOS7:
-      sudo cp etc/apache2/watcher /etc/httpd/conf.d/watcher.conf
-
-    Debian/Ubuntu:
-      sudo cp etc/apache2/watcher /etc/apache2/sites-available/watcher.conf
-
-#. Edit ``<apache-configuration-dir>/watcher.conf`` according to installation
-   and environment.
-
-   * Modify the ``WSGIDaemonProcess`` directive to set the ``user`` and
-     ``group`` values to appropriate user on your server.
-   * Modify the ``WSGIScriptAlias`` directive to point to the
-     watcher/api/app.wsgi script.
-   * Modify the ``Directory`` directive to set the path to the Watcher API
-     code.
-   * Modify the ``ErrorLog and CustomLog`` to redirect the logs to the right
-     directory.
-
-#. Enable the apache watcher site and reload::
-
-    Fedora/RHEL7/CentOS7:
-      sudo systemctl reload httpd
-
-   Debian/Ubuntu:
-    sudo a2ensite watcher
-    sudo service apache2 reload

doc/source/deploy/configuration.rst

@@ -15,7 +15,7 @@ Service overview
 ================
 
 The Watcher system is a collection of services that provides support to
-optimize your IAAS platform. The Watcher service may, depending upon
+optimize your IAAS plateform. The Watcher service may, depending upon
 configuration, interact with several other OpenStack services. This includes:
 
 - the OpenStack Identity service (`keystone`_) for request authentication and
@@ -37,7 +37,7 @@ The Watcher service includes the following components:
 - `watcher-dashboard`_: An Horizon plugin for interacting with the Watcher
   service.
 
-Additionally, the Watcher service has certain external dependencies, which
+Additionally, the Bare Metal service has certain external dependencies, which
 are very similar to other OpenStack services:
 
 - A database to store audit and action plan information and state. You can set
@@ -86,6 +86,7 @@ Configure the Identity service for the Watcher service
         --tenant=KEYSTONE_SERVICE_PROJECT_NAME
       $ keystone user-role-add --user=watcher \
         --tenant=KEYSTONE_SERVICE_PROJECT_NAME --role=admin
+      $ keystone user-role-add --user=watcher --tenant=admin --role=admin
 
    or (by using python-openstackclient 1.8.0+)
 
@@ -96,6 +97,7 @@ Configure the Identity service for the Watcher service
         --project=KEYSTONE_SERVICE_PROJECT_NAME
       $ openstack role add --project KEYSTONE_SERVICE_PROJECT_NAME \
         --user watcher admin
+      $ openstack role add --user watcher --project admin admin
 
 
 #. You must register the Watcher Service with the Identity Service so that
@@ -167,7 +169,7 @@ these following commands::
 
     $ git clone git://git.openstack.org/openstack/watcher
     $ cd watcher/
-    $ tox -e genconfig
+    $ tox -econfig
     $ vi etc/watcher/watcher.conf.sample
 
 
@@ -366,7 +368,7 @@ Configure Nova compute
 Please check your hypervisor configuration to correctly handle
 `instance migration`_.
 
-.. _`instance migration`: http://docs.openstack.org/admin-guide/compute-live-migration-usage.html
+.. _`instance migration`: http://docs.openstack.org/admin-guide-cloud/compute-configuring-migrations.html
 
 Configure Measurements
 ======================

doc/source/deploy/installation.rst

@@ -18,14 +18,14 @@ The source install instructions specifically avoid using platform specific
 packages, instead using the source for the code and the Python Package Index
 (PyPi_).
 
-.. _PyPi: https://pypi.python.org/pypi
+.. _PyPi: http://pypi.python.org/pypi
 
 It's expected that your system already has python2.7_, latest version of pip_,
 and git_ available.
 
-.. _python2.7: https://www.python.org
+.. _python2.7: http://www.python.org
-.. _pip: https://pip.pypa.io/en/latest/installing/
+.. _pip: http://www.pip-installer.org/en/latest/installing.html
-.. _git: https://git-scm.com/
+.. _git: http://git-scm.com/
 
 Your system shall also have some additional system libraries:
 

doc/source/deploy/user-guide.rst

@@ -93,11 +93,11 @@ following command:
 
 .. code:: bash
 
-  $ watcher strategy list --goal <your_goal_uuid_or_name>
+  $ watcher strategy list --goal-uuid <your_goal_uuid>
 
 or::
 
-  $ openstack optimize strategy list --goal <your_goal_uuid_or_name>
+  $ openstack optimize strategy list --goal-uuid <your_goal_uuid>
 
 You can use the following command to check strategy details including which
 parameters of which format it supports:

doc/source/dev/devstack.rst

@@ -92,12 +92,6 @@ Detailed DevStack Instructions
    Note: if you want to use a specific branch, specify WATCHER_BRANCH in the
    local.conf file. By default it will use the master branch.
 
-   Note: watcher-api will default run under apache/httpd, set the variable
-   WATCHER_USE_MOD_WSGI=FALSE if you do not wish to run under apache/httpd.
-   For development environment it is suggested to set WATHCER_USE_MOD_WSGI
-   to FALSE. For Production environment it is suggested to keep it at the
-   default TRUE value.
-
 #. Start stacking from the controller node::
 
        ./devstack/stack.sh
@@ -199,37 +193,6 @@ must exist in every other compute node's stack user's authorized_keys file and
 every compute node's public ECDSA key needs to be in every other compute
 node's root user's known_hosts file.
 
-Disable serial console
-----------------------
-
-Serial console needs to be disabled for live migration to work.
-
-On both the controller and compute node, in /etc/nova/nova.conf
-
-[serial_console]
-enabled = False
-
-Alternatively, in devstack's local.conf:
-
-[[post-config|$NOVA_CONF]]
-[serial_console]
-#enabled=false
-
-
-VNC server configuration
-------------------------
-
-The VNC server listening parameter needs to be set to any address so
-that the server can accept connections from all of the compute nodes.
-
-On both the controller and compute node, in /etc/nova/nova.conf
-
-vncserver_listen = 0.0.0.0
-
-Alternatively, in devstack's local.conf:
-
-VNCSERVER_LISTEN=0.0.0.0
-
 
 Environment final checkup
 -------------------------

doc/source/dev/environment.rst

@@ -16,8 +16,8 @@ for development purposes.
 To install Watcher from packaging, refer instead to Watcher `User
 Documentation`_.
 
-.. _`Git Repository`: https://git.openstack.org/cgit/openstack/watcher
+.. _`Git Repository`: http://git.openstack.org/cgit/openstack/watcher
-.. _`User Documentation`: https://docs.openstack.org/developer/watcher/
+.. _`User Documentation`: http://docs.openstack.org/developer/watcher/
 
 Prerequisites
 =============
@@ -35,10 +35,10 @@ following tools available on your system:
 **Reminder**: If you're successfully using a different platform, or a
 different version of the above, please document your configuration here!
 
-.. _Python: https://www.python.org/
+.. _Python: http://www.python.org/
-.. _git: https://git-scm.com/
+.. _git: http://git-scm.com/
-.. _setuptools: https://pypi.python.org/pypi/setuptools
+.. _setuptools: http://pypi.python.org/pypi/setuptools
-.. _virtualenvwrapper: https://virtualenvwrapper.readthedocs.io/en/latest/install.html
+.. _virtualenvwrapper: https://virtualenvwrapper.readthedocs.org/en/latest/install.html
 
 Getting the latest code
 =======================
@@ -85,9 +85,6 @@ your platform.
 
     $ sudo yum install openssl-devel libffi-devel mysql-devel
 
-* CentOS 7::
-
-    $ sudo yum install gcc python-devel libxml2-devel libxslt-devel mariadb-devel
 
 PyPi Packages and VirtualEnv
 ----------------------------
@@ -175,12 +172,11 @@ The HTML files are available into ``doc/build`` directory.
 Configure the Watcher services
 ==============================
 
-Watcher services require a configuration file. Use tox to generate
+Watcher services require a configuration file. There is a sample configuration
-a sample configuration file that can be used to get started:
+file that can be used to get started:
 
 .. code-block:: bash
 
-  $ tox -e genconfig
   $ cp etc/watcher.conf.sample etc/watcher.conf
 
 Most of the default configuration should be enough to get you going, but you

doc/source/dev/notifications.rst

@@ -1,13 +0,0 @@
-..
-      Except where otherwise noted, this document is licensed under Creative
-      Commons Attribution 3.0 License.  You can view the license at:
-
-          https://creativecommons.org/licenses/by/3.0/
-
-.. _watcher_notifications:
-
-========================
-Notifications in Watcher
-========================
-
-.. versioned_notifications::

doc/source/dev/plugin/action-plugin.rst

@@ -30,12 +30,12 @@ implement:
    implement. This is the first function to be called by the
    :ref:`applier <watcher_applier_definition>` before any further processing
    and its role is to validate the input parameters that were provided to it.
- - The :py:meth:`~.BaseAction.pre_condition` is called before the execution of
+ - The :py:meth:`~.BaseAction.precondition` is called before the execution of
    an action. This method is a hook that can be used to perform some
    initializations or to make some more advanced validation on its input
    parameters. If you wish to block the execution based on this factor, you
    simply have to ``raise`` an exception.
- - The :py:meth:`~.BaseAction.post_condition` is called after the execution of
+ - The :py:meth:`~.BaseAction.postcondition` is called after the execution of
    an action. As this function is called regardless of whether an action
    succeeded or not, this can prove itself useful to perform cleanup
    operations.
@@ -71,11 +71,11 @@ Here is an example showing how you can write a plugin called ``DummyAction``:
             # Does nothing
             pass
 
-        def pre_condition(self):
+        def precondition(self):
             # No pre-checks are done here
             pass
 
-        def post_condition(self):
+        def postcondition(self):
             # Nothing done here
             pass
 

doc/source/dev/plugin/cdmc-plugin.rst

@@ -22,7 +22,7 @@ cluster data model collectors within Watcher.
 Creating a new plugin
 =====================
 
-In order to create a new cluster data model collector, you have to:
+In order to create a new model, you have to:
 
 - Extend the :py:class:`~.base.BaseClusterDataModelCollector` class.
 - Implement its :py:meth:`~.BaseClusterDataModelCollector.execute` abstract
@@ -65,49 +65,6 @@ This implementation is the most basic one. So in order to get a better
 understanding on how to implement a more advanced cluster data model collector,
 have a look at the :py:class:`~.NovaClusterDataModelCollector` class.
 
-Define a custom model
-=====================
-
-As you may have noticed in the above example, we are reusing an existing model
-provided by Watcher. However, this model can be easily customized by
-implementing a new class that would implement the :py:class:`~.Model` abstract
-base class. Here below is simple example on how to proceed in implementing a
-custom Model:
-
-.. code-block:: python
-
-    # Filepath = <PROJECT_DIR>/thirdparty/dummy.py
-    # Import path = thirdparty.dummy
-
-    from watcher.decision_engine.model import base as modelbase
-    from watcher.decision_engine.model.collector import base
-
-
-    class MyModel(modelbase.Model):
-
-        def to_string(self):
-            return 'MyModel'
-
-
-    class DummyClusterDataModelCollector(base.BaseClusterDataModelCollector):
-
-        def execute(self):
-            model = MyModel()
-            # Do something here...
-            return model
-
-        @property
-        def notification_endpoints(self):
-            return []
-
-Here below is the abstract ``Model`` class that every single cluster data model
-should implement:
-
-.. autoclass:: watcher.decision_engine.model.base.Model
-    :members:
-    :special-members: __init__
-    :noindex:
-
 Define configuration parameters
 ===============================
 
@@ -268,5 +225,5 @@ At this point, you can use your new cluster data model plugin in your
     # [...]
     dummy_collector = self.collector_manager.get_cluster_model_collector(
         "dummy")  # "dummy" is the name of the entry point we declared earlier
-    dummy_model = dummy_collector.get_latest_cluster_data_model()
+    dummy_model = collector.get_latest_cluster_data_model()
     # Do some stuff with this model

doc/source/dev/plugin/goal-plugin.rst

@@ -60,8 +60,8 @@ Here is an example showing how you can define a new ``NewGoal`` goal plugin:
     # import path: thirdparty.new
 
     from watcher._i18n import _
-    from watcher.decision_engine.goal import base
     from watcher.decision_engine.goal.efficacy import specs
+    from watcher.decision_engine.strategy.strategies import base
 
     class NewGoal(base.Goal):
 
@@ -79,11 +79,11 @@ Here is an example showing how you can define a new ``NewGoal`` goal plugin:
 
         @classmethod
         def get_efficacy_specification(cls):
-            return specs.Unclassified()
+            return specs.UnclassifiedStrategySpecification()
 
 
 As you may have noticed, the :py:meth:`~.Goal.get_efficacy_specification`
-method returns an :py:meth:`~.Unclassified` instance which
+method returns an :py:meth:`~.UnclassifiedStrategySpecification` instance which
 is provided by Watcher. This efficacy specification is useful during the
 development process of your goal as it corresponds to an empty specification.
 If you want to learn more about what efficacy specifications are used for or to

doc/source/dev/plugin/planner-plugin.rst

@@ -39,7 +39,7 @@ Here is an example showing how you can write a planner plugin called
 
     # Filepath = third-party/third_party/dummy.py
     # Import path = third_party.dummy
-    from oslo_utils import uuidutils
+    import uuid
     from watcher.decision_engine.planner import base
 
 
@@ -47,7 +47,7 @@ Here is an example showing how you can write a planner plugin called
 
         def _create_action_plan(self, context, audit_id):
             action_plan_dict = {
-                'uuid': uuidutils.generate_uuid(),
+                'uuid': uuid.uuid4(),
                 'audit_id': audit_id,
                 'first_action_id': None,
                 'state': objects.action_plan.State.RECOMMENDED

doc/source/dev/plugin/strategy-plugin.rst

@@ -43,7 +43,7 @@ In order to create a new strategy, you have to:
   Note: Do not use a variable to return the translated string so it can be
   automatically collected by the translation tool.
 - Implement its :py:meth:`~.BaseStrategy.get_translatable_display_name`
-  class method to return the translation key (actually the English display
+  class method to return the translation key (actually the english display
   name) of your new strategy. The value return should be the same as the
   string translated in :py:meth:`~.BaseStrategy.get_display_name`.
 - Implement its :py:meth:`~.BaseStrategy.execute` method to return the
@@ -245,70 +245,75 @@ Querying metrics
 
 A large set of metrics, generated by OpenStack modules, can be used in your
 strategy implementation. To collect these metrics, Watcher provides a
-`Helper`_ for two data sources which are `Ceilometer`_ and `Monasca`_. If you
+`Helper`_ to the Ceilometer API, which makes this API reusable and easier
-wish to query metrics from a different data source, you can implement your own
+to used.
-and directly use it from within your new strategy. Indeed, strategies in
-Watcher have the cluster data models decoupled from the data sources which
-means that you may keep the former while changing the latter.
-The recommended way for you to support a new data source is to implement a new
-helper that would encapsulate within separate methods the queries you need to
-perform. To then use it, you would just have to instantiate it within your
-strategy.
 
-If you want to use Ceilometer but with your own metrics database backend,
+If you want to use your own metrics database backend, please refer to the
-please refer to the `Ceilometer developer guide`_. The list of the available
+`Ceilometer developer guide`_. Indeed, Ceilometer's pluggable model allows
-Ceilometer backends is located here_. The `Ceilosca`_ project is a good example
+for various types of backends.  A list of the available backends is located
-of how to create your own pluggable backend. Moreover, if your strategy
+here_. The Ceilosca project is a good example of how to create your own
-requires new metrics not covered by Ceilometer, you can add them through a
+pluggable backend.
-`Ceilometer plugin`_.
 
+Finally, if your strategy requires new metrics not covered by Ceilometer, you
+can add them through a Ceilometer `plugin`_.
 
 .. _`Helper`: https://github.com/openstack/watcher/blob/master/watcher/decision_engine/cluster/history/ceilometer.py
 .. _`Ceilometer developer guide`: http://docs.openstack.org/developer/ceilometer/architecture.html#storing-the-data
-.. _`Ceilometer`: http://docs.openstack.org/developer/ceilometer/
-.. _`Monasca`: https://github.com/openstack/monasca-api/blob/master/docs/monasca-api-spec.md
 .. _`here`: http://docs.openstack.org/developer/ceilometer/install/dbreco.html#choosing-a-database-backend
-.. _`Ceilometer plugin`: http://docs.openstack.org/developer/ceilometer/plugins.html
+.. _`plugin`: http://docs.openstack.org/developer/ceilometer/plugins.html
 .. _`Ceilosca`: https://github.com/openstack/monasca-ceilometer/blob/master/ceilosca/ceilometer/storage/impl_monasca.py
 
-Read usage metrics using the Watcher Datasource Helper
-------------------------------------------------------
 
-The following code snippet shows how to invoke a Datasource Helper class:
+Read usage metrics using the Python binding
+-------------------------------------------
+
+You can find the information about the Ceilometer Python binding on the
+OpenStack `ceilometer client python API documentation
+<http://docs.openstack.org/developer/python-ceilometerclient/api.html>`_
+
+To facilitate the process, Watcher provides the ``osc`` attribute to every
+strategy which includes clients to major OpenStack services, including
+Ceilometer. So to access it within your strategy, you can do the following:
 
 .. code-block:: py
 
-    from watcher.datasource import ceilometer as ceil
+    # Within your strategy "execute()"
-    from watcher.datasource import monasca as mon
+    cclient = self.osc.ceilometer
-
+    # TODO: Do something here
-    @property
-    def ceilometer(self):
-        if self._ceilometer is None:
-            self._ceilometer = ceil.CeilometerHelper(osc=self.osc)
-        return self._ceilometer
-
-    @property
-    def monasca(self):
-        if self._monasca is None:
-            self._monasca = mon.MonascaHelper(osc=self.osc)
-        return self._monasca
 
 Using that you can now query the values for that specific metric:
 
 .. code-block:: py
 
-        if self.config.datasource == "ceilometer":
+    query = None  # e.g. [{'field': 'foo', 'op': 'le', 'value': 34},]
-            resource_id = "%s_%s" % (node.uuid, node.hostname)
+    value_cpu = cclient.samples.list(
-            return self.ceilometer.statistic_aggregation(
+        meter_name='cpu_util',
-                resource_id=resource_id,
+        limit=10, q=query)
-                meter_name='compute.node.cpu.percent',
+
-                period="7200",
+
-                aggregate='avg',
+Read usage metrics using the Watcher Cluster History Helper
-            )
+-----------------------------------------------------------
-        elif self.config.datasource == "monasca":
+
-            statistics = self.monasca.statistic_aggregation(
+Here below is the abstract ``BaseClusterHistory`` class of the Helper.
-                meter_name='compute.node.cpu.percent',
+
-                dimensions=dict(hostname=node.uuid),
+.. autoclass:: watcher.decision_engine.cluster.history.base.BaseClusterHistory
-                period=7200,
+    :members:
-                aggregate='avg'
+    :noindex:
-            )
+
+The following code snippet shows how to create a Cluster History class:
+
+.. code-block:: py
+
+    from watcher.decision_engine.cluster.history import ceilometer as ceil
+
+    query_history  = ceil.CeilometerClusterHistory()
+
+Using that you can now query the values for that specific metric:
+
+.. code-block:: py
+
+    query_history.statistic_aggregation(resource_id=compute_node.uuid,
+                                  meter_name='compute.node.cpu.percent',
+                                  period="7200",
+                                  aggregate='avg'
+                                  )

doc/source/dev/testing.rst

@@ -14,7 +14,7 @@ Unit tests
 ==========
 
 All unit tests should be run using `tox`_. To run the same unit tests that are
-executing onto `Gerrit`_ which includes ``py35``, ``py27`` and ``pep8``, you
+executing onto `Gerrit`_ which includes ``py34``, ``py27`` and ``pep8``, you
 can issue the following command::
 
     $ workon watcher
@@ -26,7 +26,7 @@ If you want to only run one of the aforementioned, you can then issue one of
 the following::
 
     $ workon watcher
-    (watcher) $ tox -e py35
+    (watcher) $ tox -e py34
     (watcher) $ tox -e py27
     (watcher) $ tox -e pep8
 

doc/source/glossary.rst

@@ -96,11 +96,17 @@ The :ref:`Cluster <cluster_definition>` may be divided in one or several
 
 .. _cluster_data_model_definition:
 
-Cluster Data Model (CDM)
+Cluster Data Model
-========================
+==================
 
 .. watcher-term:: watcher.decision_engine.model.collector.base
 
+.. _cluster_history_definition:
+
+Cluster History
+===============
+
+.. watcher-term:: watcher.decision_engine.cluster.history.base
 
 .. _controller_node_definition:
 
@@ -126,7 +132,7 @@ Compute node
 ============
 
 Please, read `the official OpenStack definition of a Compute Node
-<http://docs.openstack.org/ops-guide/arch-compute-nodes.html>`_.
+<http://docs.openstack.org/openstack-ops/content/compute_nodes.html>`_.
 
 .. _customer_definition:
 
@@ -158,8 +164,7 @@ Goal
 Host Aggregate
 ==============
 
-Please, read `the official OpenStack definition of a Host Aggregate
+Please, read `the official OpenStack definition of a Host Aggregate <http://docs.openstack.org/developer/nova/aggregates.html>`_.
-<http://docs.openstack.org/developer/nova/aggregates.html>`_.
 
 .. _instance_definition:
 

doc/source/image_src/plantuml/action_plan_state_machine.txt

@@ -9,10 +9,8 @@ FAILED --> DELETED : Administrator removes\nAction Plan
 SUCCEEDED --> DELETED : Administrator removes\nAction Plan
 ONGOING --> CANCELLED : Administrator cancels\nAction Plan
 RECOMMENDED --> CANCELLED : Administrator cancels\nAction Plan
-RECOMMENDED --> SUPERSEDED : The Watcher Decision Engine supersedes\nAction Plan
 PENDING --> CANCELLED : Administrator cancels\nAction Plan
 CANCELLED --> DELETED
-SUPERSEDED --> DELETED
 DELETED --> [*]
 
 @enduml

doc/source/image_src/plantuml/audit_state_machine.txt

@@ -4,14 +4,11 @@
 PENDING --> ONGOING: Audit request is received\nby the Watcher Decision Engine
 ONGOING --> FAILED: Audit fails\n(no solution found, technical error, ...)
 ONGOING --> SUCCEEDED: The Watcher Decision Engine\ncould find at least one Solution
-ONGOING --> SUSPENDED: Administrator wants to\nsuspend the Audit
-SUSPENDED --> ONGOING: Administrator wants to\nresume the Audit
 FAILED --> DELETED : Administrator wants to\narchive/delete the Audit
 SUCCEEDED --> DELETED : Administrator wants to\narchive/delete the Audit
 PENDING --> CANCELLED : Administrator cancels\nthe Audit
 ONGOING --> CANCELLED : Administrator cancels\nthe Audit
 CANCELLED --> DELETED : Administrator wants to\narchive/delete the Audit
-SUSPENDED --> DELETED: Administrator wants to\narchive/delete the Audit
 DELETED --> [*]
 
 @enduml

doc/source/image_src/plantuml/sequence_overview_watcher_usage.txt

@@ -4,7 +4,7 @@ actor Administrator
 
 == Create some Audit settings ==
 
-Administrator -> Watcher : create new Audit Template (i.e. Audit settings : goal, scope, ...)
+Administrator -> Watcher : create new Audit Template (i.e. Audit settings : goal, scope, deadline,...)
 Watcher -> Watcher : save Audit Template in database
 Administrator <-- Watcher : Audit Template UUID
 

doc/source/image_src/plantuml/watcher_db_schema_diagram.txt

@@ -41,7 +41,9 @@ table(audit_templates) {
     uuid : String[36]
     name : String[63], nullable
     description : String[255], nullable
-    scope : JSONEncodedList
+    host_aggregate : Integer, nullable
+    extra : JSONEncodedDict
+    version : String[15], nullable
 
     created_at : DateTime
     updated_at : DateTime
@@ -57,10 +59,10 @@ table(audits) {
     uuid : String[36]
     audit_type : String[20]
     state : String[20], nullable
+    deadline : DateTime, nullable
     interval : Integer, nullable
     parameters : JSONEncodedDict, nullable
-    scope : JSONEncodedList, nullable
+    host_aggregate : Integer, nullable
-    auto_trigger: Boolean
 
     created_at : DateTime
     updated_at : DateTime
@@ -74,6 +76,7 @@ table(action_plans) {
     foreign_key("audit_id : Integer, nullable")
     foreign_key("strategy_id : Integer")
     uuid : String[36]
+    first_action_id : Integer
     state : String[20], nullable
     global_efficacy : JSONEncodedDict, nullable
 
@@ -91,7 +94,7 @@ table(actions) {
     action_type : String[255]
     input_parameters : JSONEncodedDict, nullable
     state : String[20], nullable
-    parents : JSONEncodedList, nullable
+    next : String[36], nullable
 
     created_at : DateTime
     updated_at : DateTime
@@ -128,18 +131,6 @@ table(scoring_engines) {
     deleted : Integer
 }
 
-table(service) {
-    primary_key(id: Integer)
-    name: String[255]
-    host: String[255]
-    last_seen_up: DateTime
-
-    created_at : DateTime
-    updated_at : DateTime
-    deleted_at : DateTime
-    deleted : Integer
-}
-
  "goals" <.. "strategies" : Foreign Key
  "goals" <.. "audit_templates" : Foreign Key
  "strategies" <.. "audit_templates" : Foreign Key

doc/source/index.rst

@@ -56,8 +56,6 @@ Getting Started
   dev/devstack
   deploy/configuration
   deploy/conf-files
-  deploy/apache-mod-wsgi
-  dev/notifications
   dev/testing
   dev/rally_link
 
@@ -98,7 +96,6 @@ Introduction
   deploy/user-guide
   deploy/policy
   deploy/gmr
-  strategies/strategies
 
 Watcher Manual Pages
 ====================

doc/source/strategies/basic-server-consolidation.rst

@@ -1,99 +0,0 @@
-==================================
-Basic Offline Server Consolidation
-==================================
-
-Synopsis
---------
-
-**display name**: ``basic``
-
-**goal**: ``server_consolidation``
-
-    .. watcher-term:: watcher.decision_engine.strategy.strategies.basic_consolidation
-
-Requirements
-------------
-
-Metrics
-*******
-
-The *basic* strategy requires the following metrics:
-
-============================ ============ ======= =======
-metric                       service name plugins comment
-============================ ============ ======= =======
-``compute.node.cpu.percent`` ceilometer_  none
-``cpu_util``                 ceilometer_  none
-============================ ============ ======= =======
-
-.. _ceilometer: http://docs.openstack.org/admin-guide/telemetry-measurements.html#openstack-compute
-
-Cluster data model
-******************
-
-Default Watcher's Compute cluster data model:
-
-    .. watcher-term:: watcher.decision_engine.model.collector.nova.NovaClusterDataModelCollector
-
-Actions
-*******
-
-Default Watcher's actions:
-
-
-    .. list-table::
-       :widths: 30 30
-       :header-rows: 1
-
-       * - action
-         - description
-       * - ``migration``
-         - .. watcher-term:: watcher.applier.actions.migration.Migrate
-       * - ``change_nova_service_state``
-         - .. watcher-term:: watcher.applier.actions.change_nova_service_state.ChangeNovaServiceState
-
-Planner
-*******
-
-Default Watcher's planner:
-
-    .. watcher-term:: watcher.decision_engine.planner.default.DefaultPlanner
-
-Configuration
--------------
-
-Strategy parameter is:
-
-====================== ====== ============= ===================================
-parameter              type   default Value description
-====================== ====== ============= ===================================
-``migration_attempts`` Number 0             Maximum number of combinations to
-                                            be tried by the strategy while
-                                            searching for potential candidates.
-                                            To remove the limit, set it to 0
-``period``             Number 7200          The time interval in seconds
-                                            for getting statistic aggregation
-                                            from metric data source
-====================== ====== ============= ===================================
-
-Efficacy Indicator
-------------------
-
-.. watcher-func::
-  :format: literal_block
-
-  watcher.decision_engine.goal.efficacy.specs.ServerConsolidation.get_global_efficacy_indicator
-
-How to use it ?
----------------
-
-.. code-block:: shell
-
-    $ openstack optimize audittemplate create \
-      at1 server_consolidation --strategy basic
-
-    $ openstack optimize audit create -a at1 -p migration_attempts=4
-
-External Links
---------------
-None.

doc/source/strategies/outlet_temp_control.rst

@@ -1,104 +0,0 @@
-=================================
-Outlet Temperature Based Strategy
-=================================
-
-Synopsis
---------
-
-**display name**: ``outlet_temperature``
-
-**goal**: ``thermal_optimization``
-
-Outlet (Exhaust Air) temperature is a new thermal telemetry which can be
-used to measure the host's thermal/workload status. This strategy makes
-decisions to migrate workloads to the hosts with good thermal condition
-(lowest outlet temperature) when the outlet temperature of source hosts
-reach a configurable threshold.
-
-Requirements
-------------
-
-This strategy has a dependency on the host having Intel's Power
-Node Manager 3.0 or later enabled.
-
-
-Metrics
-*******
-
-The *outlet_temperature* strategy requires the following metrics:
-
-========================================= ============ ======= =======
-metric                                    service name plugins comment
-========================================= ============ ======= =======
-``hardware.ipmi.node.outlet_temperature`` ceilometer_  IPMI
-========================================= ============ ======= =======
-
-.. _ceilometer: http://docs.openstack.org/admin-guide/telemetry-measurements.html#ipmi-based-meters
-
-Cluster data model
-******************
-
-Default Watcher's Compute cluster data model:
-
-    .. watcher-term:: watcher.decision_engine.model.collector.nova.NovaClusterDataModelCollector
-
-Actions
-*******
-
-Default Watcher's actions:
-
-    .. list-table::
-       :widths: 30 30
-       :header-rows: 1
-
-       * - action
-         - description
-       * - ``migration``
-         - .. watcher-term:: watcher.applier.actions.migration.Migrate
-
-Planner
-*******
-
-Default Watcher's planner:
-
-    .. watcher-term:: watcher.decision_engine.planner.default.DefaultPlanner
-
-Configuration
--------------
-
-Strategy parameter is:
-
-============== ====== ============= ====================================
-parameter      type   default Value description
-============== ====== ============= ====================================
-``threshold``  Number 35.0          Temperature threshold for migration
-``period``     Number 30            The time interval in seconds for
-                                    getting statistic aggregation from
-                                    metric data source
-============== ====== ============= ====================================
-
-Efficacy Indicator
-------------------
-
-None
-
-Algorithm
----------
-
-For more information on the Outlet Temperature Based Strategy please refer to:
-https://specs.openstack.org/openstack/watcher-specs/specs/mitaka/implemented/outlet-temperature-based-strategy.html
-
-How to use it ?
----------------
-
-.. code-block:: shell
-
-    $ openstack optimize audittemplate create \
-      at1 thermal_optimization --strategy outlet_temperature
-
-    $ openstack optimize audit create -a at1 -p threshold=31.0
-
-External Links
---------------
-
-- `Intel Power Node Manager 3.0 <http://www.intel.com/content/www/us/en/power-management/intelligent-power-node-manager-3-0-specification.html>`_

doc/source/strategies/strategies.rst

@@ -1,8 +0,0 @@
-Strategies
-==========
-
-.. toctree::
-   :glob:
-   :maxdepth: 1
-
-   ./*

doc/source/strategies/strategy-template.rst

@@ -1,115 +0,0 @@
-=============
-Strategy name
-=============
-
-Synopsis
---------
-
-**display name**:
-
-**goal**:
-
-Add here a complete description of your strategy
-
-Requirements
-------------
-
-Metrics
-*******
-
-Write here the list of metrics required by your strategy algorithm (in the form
- of a table). If these metrics requires specific Telemetry plugin or other
- additional software, please explain here how to deploy them (and add link to
- dedicated installation guide).
-
-Example:
-
-======================= ============ ======= =======
-metric                  service name plugins comment
-======================= ============ ======= =======
-compute.node.*          ceilometer_  none    one point every 60s
-vm.cpu.utilization_perc monasca_     none
-power                   ceilometer_  kwapi_  one point every 60s
-======================= ============ ======= =======
-
-
-.. _ceilometer: http://docs.openstack.org/admin-guide/telemetry-measurements.html#openstack-compute
-.. _monasca: https://github.com/openstack/monasca-agent/blob/master/docs/Libvirt.md
-.. _kwapi: https://kwapi.readthedocs.io/en/latest/index.html
-
-
-Cluster data model
-******************
-
-Default Watcher's cluster data model.
-
-or
-
-If your strategy implementation requires a new cluster data model, please
- describe it in this section, with a link to model plugin's installation guide.
-
-Actions
-*******
-
-Default Watcher's actions.
-
-or
-
-If your strategy implementation requires new actions, add the list of Action
- plugins here (in the form of a table) with a link to the plugin's installation
- procedure.
-
-======== =================
-action   description
-======== =================
-action1_ This action1 ...
-action2_ This action2 ...
-======== =================
-
-.. _action1 : https://github.com/myrepo/watcher/plugins/action1
-.. _action2 : https://github.com/myrepo/watcher/plugins/action2
-
-Planner
-*******
-
-Default Watcher's planner.
-
-or
-
-If your strategy requires also a new planner to schedule built actions in time,
- please describe it in this section, with a link to planner plugin's
- installation guide.
-
-Configuration
--------------
-
-If your strategy use configurable parameters, explain here how to tune them.
-
-
-Efficacy Indicator
-------------------
-
-Add here the Efficacy indicator computed by your strategy.
-
-Algorithm
----------
-
-Add here either the description of your algorithm or
-link to the existing description.
-
-How to use it ?
----------------
-
-.. code-block:: shell
-
-    $ Write the command line to create an audit with your strategy.
-
-External Links
---------------
-
-If you have written papers, blog articles .... about your strategy into Watcher,
- or if your strategy is based from external publication(s), please add HTTP
- links and references in this section.
-
-- `link1 <http://www.link1.papers.com>`_
-- `link2 <http://www.link2.papers.com>`_

doc/source/strategies/uniform_airflow.rst

@@ -1,107 +0,0 @@
-==================================
-Uniform Airflow Migration Strategy
-==================================
-
-Synopsis
---------
-
-**display name**: ``uniform_airflow``
-
-**goal**: ``airflow_optimization``
-
-.. watcher-term:: watcher.decision_engine.strategy.strategies.uniform_airflow
-
-Requirements
-------------
-
-This strategy has a dependency on the server having Intel's Power
-Node Manager 3.0 or later enabled.
-
-Metrics
-*******
-
-The *uniform_airflow* strategy requires the following metrics:
-
-================================== ============ ======= =======
-metric                             service name plugins comment
-================================== ============ ======= =======
-``hardware.ipmi.node.airflow``     ceilometer_  IPMI
-``hardware.ipmi.node.temperature`` ceilometer_  IPMI
-``hardware.ipmi.node.power``       ceilometer_  IPMI
-================================== ============ ======= =======
-
-.. _ceilometer: http://docs.openstack.org/admin-guide/telemetry-measurements.html#ipmi-based-meters
-
-Cluster data model
-******************
-
-Default Watcher's Compute cluster data model:
-
-    .. watcher-term:: watcher.decision_engine.model.collector.nova.NovaClusterDataModelCollector
-
-Actions
-*******
-
-Default Watcher's actions:
-
-
-    .. list-table::
-       :widths: 30 30
-       :header-rows: 1
-
-       * - action
-         - description
-       * - ``migration``
-         - .. watcher-term:: watcher.applier.actions.migration.Migrate
-
-Planner
-*******
-
-Default Watcher's planner:
-
-    .. watcher-term:: watcher.decision_engine.planner.default.DefaultPlanner
-
-Configuration
--------------
-
-Strategy parameters are:
-
-====================== ====== ============= ===========================
-parameter              type   default Value description
-====================== ====== ============= ===========================
-``threshold_airflow``  Number 400.0         Airflow threshold for
-                                            migration Unit is 0.1CFM
-``threshold_inlet_t``  Number 28.0          Inlet temperature threshold
-                                            for migration decision
-``threshold_power``    Number 350.0         System power threshold for
-                                            migration decision
-``period``             Number 300           Aggregate time period of
-                                            ceilometer
-====================== ====== ============= ===========================
-
-Efficacy Indicator
-------------------
-
-None
-
-Algorithm
----------
-
-For more information on the Uniform Airflow Migration Strategy please refer to:
-https://specs.openstack.org/openstack/watcher-specs/specs/newton/implemented/uniform-airflow-migration-strategy.html
-
-How to use it ?
----------------
-
-.. code-block:: shell
-
-    $ openstack optimize audittemplate create \
-      at1 airflow_optimization --strategy uniform_airflow
-
-    $ openstack optimize audit create -a at1 -p threshold_airflow=410 \
-           -p threshold_inlet_t=29.0 -p threshold_power=355.0 -p period=310
-
-External Links
---------------
-
-- `Intel Power Node Manager 3.0 <http://www.intel.com/content/www/us/en/power-management/intelligent-power-node-manager-3-0-specification.html>`_

doc/source/strategies/vm_workload_consolidation.rst

@@ -1,114 +0,0 @@
-==================================
-VM Workload Consolidation Strategy
-==================================
-
-Synopsis
---------
-
-**display name**: ``vm_workload_consolidation``
-
-**goal**: ``vm_consolidation``
-
-    .. watcher-term:: watcher.decision_engine.strategy.strategies.vm_workload_consolidation
-
-Requirements
-------------
-
-Metrics
-*******
-
-The *vm_workload_consolidation* strategy requires the following metrics:
-
-============================ ============ ======= =======
-metric                       service name plugins comment
-============================ ============ ======= =======
-``memory``             	     ceilometer_  none
-``disk.root.size``           ceilometer_  none
-============================ ============ ======= =======
-
-The following metrics are not required but increase the accuracy of
-the strategy if available:
-
-============================ ============ ======= =======
-metric                       service name plugins comment
-============================ ============ ======= =======
-``memory.usage``             ceilometer_  none
-``cpu_util``                 ceilometer_  none
-============================ ============ ======= =======
-
-.. _ceilometer: http://docs.openstack.org/admin-guide/telemetry-measurements.html#openstack-compute
-
-Cluster data model
-******************
-
-Default Watcher's Compute cluster data model:
-
-    .. watcher-term:: watcher.decision_engine.model.collector.nova.NovaClusterDataModelCollector
-
-Actions
-*******
-
-Default Watcher's actions:
-
-
-    .. list-table::
-       :widths: 30 30
-       :header-rows: 1
-
-       * - action
-         - description
-       * - ``migration``
-         - .. watcher-term:: watcher.applier.actions.migration.Migrate
-       * - ``change_nova_service_state``
-         - .. watcher-term:: watcher.applier.actions.change_nova_service_state.ChangeNovaServiceState
-
-Planner
-*******
-
-Default Watcher's planner:
-
-    .. watcher-term:: watcher.decision_engine.planner.default.DefaultPlanner
-
-
-Configuration
--------------
-
-Strategy parameter is:
-
-====================== ====== ============= ===================================
-parameter              type   default Value description
-====================== ====== ============= ===================================
-``period``             Number 3600          The time interval in seconds
-                                            for getting statistic aggregation
-                                            from metric data source
-====================== ====== ============= ===================================
-
-
-Efficacy Indicator
-------------------
-
-.. watcher-func::
-  :format: literal_block
-
-  watcher.decision_engine.goal.efficacy.specs.ServerConsolidation.get_global_efficacy_indicator
-
-Algorithm
----------
-
-For more information on the VM Workload consolidation strategy please refer to: https://specs.openstack.org/openstack/watcher-specs/specs/mitaka/implemented/zhaw-load-consolidation.html
-
-How to use it ?
----------------
-
-.. code-block:: shell
-
-    $ openstack optimize audittemplate create \
-      at1 server_consolidation --strategy vm_workload_consolidation
-
-    $ openstack optimize audit create -a at1
-
-External Links
---------------
-
-*Spec URL*
-https://specs.openstack.org/openstack/watcher-specs/specs/mitaka/implemented/zhaw-load-consolidation.html

doc/source/strategies/workload-stabilization.rst

@@ -1,141 +0,0 @@
-=============================================
-Watcher Overload standard deviation algorithm
-=============================================
-
-Synopsis
---------
-
-**display name**: ``workload_stabilization``
-
-**goal**: ``workload_balancing``
-
-    .. watcher-term:: watcher.decision_engine.strategy.strategies.workload_stabilization
-
-Requirements
-------------
-
-Metrics
-*******
-
-The *workload_stabilization* strategy requires the following metrics:
-
-============================ ============ ======= =======
-metric                       service name plugins comment
-============================ ============ ======= =======
-``compute.node.cpu.percent`` ceilometer_  none
-``hardware.memory.used``     ceilometer_  SNMP_
-``cpu_util``                 ceilometer_  none
-``memory.resident``          ceilometer_  none
-============================ ============ ======= =======
-
-.. _ceilometer: http://docs.openstack.org/admin-guide/telemetry-measurements.html#openstack-compute
-.. _SNMP: http://docs.openstack.org/admin-guide/telemetry-measurements.html
-
-Cluster data model
-******************
-
-Default Watcher's Compute cluster data model:
-
-    .. watcher-term:: watcher.decision_engine.model.collector.nova.NovaClusterDataModelCollector
-
-Actions
-*******
-
-Default Watcher's actions:
-
-
-    .. list-table::
-       :widths: 30 30
-       :header-rows: 1
-
-       * - action
-         - description
-       * - ``migration``
-         - .. watcher-term:: watcher.applier.actions.migration.Migrate
-
-Planner
-*******
-
-Default Watcher's planner:
-
-    .. watcher-term:: watcher.decision_engine.planner.default.DefaultPlanner
-
-Configuration
--------------
-
-Strategy parameters are:
-
-==================== ====== ===================== =============================
-parameter            type   default Value         description
-==================== ====== ===================== =============================
-``metrics``          array  |metrics|             Metrics used as rates of
-                                                  cluster loads.
-``thresholds``       object |thresholds|          Dict where key is a metric
-                                                  and value is a trigger value.
-
-``weights``          object |weights|             These weights used to
-                                                  calculate common standard
-                                                  deviation. Name of weight
-                                                  contains meter name and
-                                                  _weight suffix.
-``instance_metrics`` object |instance_metrics|    Mapping to get hardware
-                                                  statistics using instance
-                                                  metrics.
-``host_choice``      string retry                 Method of host's choice.
-                                                  There are cycle, retry and
-                                                  fullsearch methods. Cycle
-                                                  will iterate hosts in cycle.
-                                                  Retry will get some hosts
-                                                  random (count defined in
-                                                  retry_count option).
-                                                  Fullsearch will return each
-                                                  host from list.
-``retry_count``      number 1                     Count of random returned
-                                                  hosts.
-``periods``          object |periods|             These periods are used to get
-                                                  statistic aggregation for
-                                                  instance and host metrics.
-                                                  The period is simply a
-                                                  repeating interval of time
-                                                  into which the samples are
-                                                  grouped for aggregation.
-                                                  Watcher uses only the last
-                                                  period of all recieved ones.
-==================== ====== ===================== =============================
-
-.. |metrics| replace:: ["cpu_util", "memory.resident"]
-.. |thresholds| replace:: {"cpu_util": 0.2, "memory.resident": 0.2}
-.. |weights| replace:: {"cpu_util_weight": 1.0, "memory.resident_weight": 1.0}
-.. |instance_metrics| replace:: {"cpu_util": "compute.node.cpu.percent", "memory.resident": "hardware.memory.used"}
-.. |periods| replace:: {"instance": 720, "node": 600}
-
-Efficacy Indicator
-------------------
-
-.. watcher-func::
-  :format: literal_block
-
-  watcher.decision_engine.goal.efficacy.specs.ServerConsolidation.get_global_efficacy_indicator
-
-Algorithm
----------
-
-You can find description of overload algorithm and role of standard deviation
-here: https://specs.openstack.org/openstack/watcher-specs/specs/newton/implemented/sd-strategy.html
-
-How to use it ?
----------------
-
-.. code-block:: shell
-
-    $ openstack optimize audittemplate create \
-      at1 workload_balancing --strategy workload_stabilization
-
-    $ openstack optimize audit create -a at1 \
-      -p thresholds='{"memory.resident": 0.05}' \
-      -p metrics='["memory.resident"]'
-
-External Links
---------------
-
-- `Watcher Overload standard deviation algorithm spec <https://specs.openstack.org/openstack/watcher-specs/specs/newton/implemented/sd-strategy.html>`_

doc/source/strategies/workload_balance.rst

@@ -1,98 +0,0 @@
-===================================
-Workload Balance Migration Strategy
-===================================
-
-Synopsis
---------
-
-**display name**: ``workload_balance``
-
-**goal**: ``workload_balancing``
-
-.. watcher-term:: watcher.decision_engine.strategy.strategies.workload_balance
-
-Requirements
-------------
-
-None.
-
-Metrics
-*******
-
-The *workload_balance* strategy requires the following metrics:
-
-======================= ============ ======= =======
-metric                  service name plugins comment
-======================= ============ ======= =======
-``cpu_util``            ceilometer_  none
-======================= ============ ======= =======
-
-.. _ceilometer: http://docs.openstack.org/admin-guide/telemetry-measurements.html#openstack-compute
-
-
-Cluster data model
-******************
-
-Default Watcher's Compute cluster data model:
-
-    .. watcher-term:: watcher.decision_engine.model.collector.nova.NovaClusterDataModelCollector
-
-Actions
-*******
-
-Default Watcher's actions:
-
-    .. list-table::
-       :widths: 30 30
-       :header-rows: 1
-
-       * - action
-         - description
-       * - ``migration``
-         - .. watcher-term:: watcher.applier.actions.migration.Migrate
-
-Planner
-*******
-
-Default Watcher's planner:
-
-    .. watcher-term:: watcher.decision_engine.planner.default.DefaultPlanner
-
-Configuration
--------------
-
-Strategy parameters are:
-
-============== ====== ============= ====================================
-parameter      type   default Value description
-============== ====== ============= ====================================
-``threshold``  Number 25.0          Workload threshold for migration
-``period``     Number 300           Aggregate time period of ceilometer
-============== ====== ============= ====================================
-
-Efficacy Indicator
-------------------
-
-None
-
-Algorithm
----------
-
-For more information on the Workload Balance Migration Strategy please refer
-to: https://specs.openstack.org/openstack/watcher-specs/specs/mitaka/implemented/workload-balance-migration-strategy.html
-
-How to use it ?
----------------
-
-.. code-block:: shell
-
-    $ openstack optimize audittemplate create \
-      at1 workload_balancing --strategy workload_balance
-
-    $ openstack optimize audit create -a at1 -p threshold=26.0 \
-            -p period=310
-
-External Links
---------------
-
-None.

etc/apache2/watcher

@@ -1,33 +0,0 @@
-# Licensed under the Apache License, Version 2.0 (the "License"); you may
-# not use this file except in compliance with the License. You may obtain
-# a copy of the License at
-#
-#      http://www.apache.org/licenses/LICENSE-2.0
-#
-# Unless required by applicable law or agreed to in writing, software
-# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
-# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
-# License for the specific language governing permissions and limitations
-# under the License.
-
-# This is an example Apache2 configuration file for using
-# Watcher API through mod_wsgi
-Listen 9322
-
-<VirtualHost *:9322>
-    WSGIDaemonProcess watcher-api user=stack group=stack processes=2 threads=2 display-name=%{GROUP}
-    WSGIScriptAlias / /opt/stack/watcher/watcher/api/app.wsgi
-    WSGIProcessGroup watcher-api
-
-    ErrorLog /var/log/httpd/watcher_error.log
-    LogLevel info
-    CustomLog /var/log/httpd/watcher_access.log combined
-
-    <Directory /opt/stack/watcher/watcher/api>
-        WSGIProcessGroup watcher-api
-        WSGIApplicationGroup %{GLOBAL}
-        AllowOverride All
-        Require all granted
-    </Directory>
-</VirtualHost>
-

etc/watcher/README-watcher.conf.txt

@@ -1,4 +1,4 @@
 To generate the sample watcher.conf file, run the following
 command from the top level of the watcher directory:
 
-tox -e genconfig
+tox -econfig

etc/watcher/policy.json

@@ -37,9 +37,5 @@
 
     "strategy:detail": "rule:default",
     "strategy:get": "rule:default",
-    "strategy:get_all": "rule:default",
+    "strategy:get_all": "rule:default"
-
-    "service:detail": "rule:default",
-    "service:get": "rule:default",
-    "service:get_all": "rule:default"
 }

rally-jobs/README.rst

@@ -7,7 +7,7 @@ To launch this task with configured Rally you just need to run:
 
 ::
 
-  rally task start watcher/rally-jobs/watcher-watcher.yaml
+  rally task start watcher/rally-jobs/watcher.yaml
 
 Structure
 ---------

rally-jobs/watcher-watcher.yaml

@@ -17,6 +17,7 @@
                   name: "dummy"
               strategy:
                   name: "dummy"
+              extra: {}
       sla:
         failure_rate:
           max: 0
@@ -28,6 +29,7 @@
           name: "dummy"
         strategy:
           name: "dummy"
+        extra: {}
       runner:
         type: "constant"
         times: 10
@@ -54,10 +56,12 @@
                   name: "workload_balancing"
               strategy:
                   name: "workload_stabilization"
+              extra: {}
             - goal:
                   name: "dummy"
               strategy:
                   name: "dummy"
+              extra: {}
       sla:
         failure_rate:
           max: 0

releasenotes/notes/action-plan-versioned-notifications-api-e8ca4f5d37aa5b4b.yaml

@@ -1,3 +0,0 @@
----
-features:
-  - Add notifications related to Action plan object.

releasenotes/notes/add-scoring-module-fa00d013ed2d614e.yaml

@@ -1,7 +1,7 @@
 ---
 features:
   - Added a generic scoring engine module, which
-    will standardize interactions with scoring engines
+    will standarize interactions with scoring engines
     through the common API. It is possible to use the
     scoring engine by different Strategies, which
     improve the code and data model re-use.

releasenotes/notes/audit-versioned-notifications-api-bca7738e16954bad.yaml

@@ -1,3 +0,0 @@
----
-features:
-  - Add notifications related to Audit object.

releasenotes/notes/automatic-triggering-audit-8a9b0540d547db60.yaml

@@ -1,5 +0,0 @@
----
-features:
-  - Watcher can continuously optimize the OpenStack cloud for a specific
-    strategy or goal by triggering an audit periodically which generates
-    an action plan and run it automatically.

releasenotes/notes/centralise-config-opts-95670987dfbdb0e7.yaml

@@ -1,3 +0,0 @@
----
-features:
-  - Centralize all configuration options for Watcher.

releasenotes/notes/db-migration-e1a705a8b54ccdd2.yaml

@@ -1,3 +0,0 @@
----
-features:
-  - Watcher database can now be upgraded thanks to Alembic.

releasenotes/notes/define-the-audit-scope-e89edc5051dcf3f2.yaml

@@ -1,5 +0,0 @@
----
-features:
-  - Provides a generic way to define the scope of an audit. The set of audited
-    resources will be called "Audit scope" and will be defined in each audit
-    template (which contains the audit settings).

releasenotes/notes/get-goal-from-strategy-396c9b13a38bb650.yaml

@@ -2,4 +2,4 @@
 features:
   - Added a way to return the of available goals depending
     on which strategies have been deployed on the node
-    where the decision engine is running.
+    where the decison engine is running.

releasenotes/notes/graph-based-cluster-model-523937a6f5e66537.yaml

@@ -1,6 +0,0 @@
----
-features:
-  - The graph model describes how VMs are associated to compute hosts.
-    This allows for seeing relationships upfront between the entities and hence
-    can be used to identify hot/cold spots in the data center and influence
-    a strategy decision.

releasenotes/notes/monasca-support-0b0486b8572ac38b.yaml

@@ -1,4 +0,0 @@
----
-features:
-  - Watcher supports multiple metrics backend and relies on Ceilometer and
-    Monasca.

releasenotes/notes/planner-storage-action-plan-26ef37893c5e8648.yaml

@@ -1,4 +0,0 @@
----
-features:
-  - Watcher can now run specific actions in parallel improving the performances
-    dramatically when executing an action plan.

releasenotes/notes/stale-action-plan-b6a6b08df873c128.yaml

@@ -1,4 +0,0 @@
----
-features:
-  - Check the creation time of the action plan, 
-    and set its state to SUPERSEDED if it has expired.

releasenotes/notes/suspended-audit-state-07f998c94e9d9a47.yaml

@@ -1,4 +0,0 @@
----
-features:
-  - |
-    Added SUSPENDED audit state

releasenotes/notes/watcher-notifications-ovo-7b44d52ef6400dd0.yaml

@@ -1,8 +0,0 @@
----
-features:
-  - Provide a notification mechanism into Watcher that supports versioning.
-    Whenever a Watcher object is created, updated or deleted, a versioned
-    notification will, if it's relevant, be automatically sent to notify in order
-    to allow an event-driven style of architecture within Watcher. Moreover, it
-    will also give other services and/or 3rd party softwares (e.g. monitoring
-    solutions or rules engines) the ability to react to such events.

releasenotes/notes/watcher-service-list-7b2f4b64f71e9b89.yaml

@@ -1,3 +0,0 @@
----
-features:
-  - Add a service supervisor to watch Watcher deamons.

releasenotes/notes/watcher-versioned-objects-fc5abf5c81c4590c.yaml

@@ -1,5 +0,0 @@
----
-features:
-  - all Watcher objects have been refactored to support OVO
-    (oslo.versionedobjects) which was a prerequisite step in order to implement
-    versioned notifications.

releasenotes/source/conf.py

@@ -1,16 +1,5 @@
-# Licensed under the Apache License, Version 2.0 (the "License");
+# -*- coding: utf-8 -*-
-# you may not use this file except in compliance with the License.
-# You may obtain a copy of the License at
 #
-#    http://www.apache.org/licenses/LICENSE-2.0
-#
-# Unless required by applicable law or agreed to in writing, software
-# distributed under the License is distributed on an "AS IS" BASIS,
-# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
-# implied.
-# See the License for the specific language governing permissions and
-# limitations under the License.
-
 # watcher documentation build configuration file, created by
 # sphinx-quickstart on Fri Jun  3 11:37:52 2016.
 #
@@ -253,6 +242,3 @@ texinfo_documents = [
 
 # How to display URL addresses: 'footnote', 'no', or 'inline'.
 #texinfo_show_urls = 'footnote'
-
-# -- Options for Internationalization output ------------------------------
-locale_dirs = ['locale/']

releasenotes/source/index.rst

@@ -1,17 +1,3 @@
-..
-      Licensed under the Apache License, Version 2.0 (the "License"); you may
-      not use this file except in compliance with the License. You may obtain
-      a copy of the License at
-
-          http://www.apache.org/licenses/LICENSE-2.0
-
-      Unless required by applicable law or agreed to in writing, software
-      distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
-      WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
-      License for the specific language governing permissions and limitations
-      under the License.
-
-=================================================
 Welcome to watcher's Release Notes documentation!
 =================================================
 
@@ -20,7 +6,5 @@ Contents:
 .. toctree::
    :maxdepth: 1
 
-   unreleased
+   unreleased.rst
-   ocata
-   newton
 

releasenotes/source/locale/fr/LC_MESSAGES/releasenotes.po

@@ -1,33 +0,0 @@
-# Gérald LONLAS <g.lonlas@gmail.com>, 2016. #zanata
-msgid ""
-msgstr ""
-"Project-Id-Version: watcher 1.0.1.dev51\n"
-"Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2017-03-21 11:57+0000\n"
-"MIME-Version: 1.0\n"
-"Content-Type: text/plain; charset=UTF-8\n"
-"Content-Transfer-Encoding: 8bit\n"
-"PO-Revision-Date: 2016-10-22 06:44+0000\n"
-"Last-Translator: Gérald LONLAS <g.lonlas@gmail.com>\n"
-"Language-Team: French\n"
-"Language: fr\n"
-"X-Generator: Zanata 3.9.6\n"
-"Plural-Forms: nplurals=2; plural=(n > 1)\n"
-
-msgid "0.29.0"
-msgstr "0.29.0"
-
-msgid "Contents:"
-msgstr "Contenu :"
-
-msgid "Current Series Release Notes"
-msgstr "Note de la release actuelle"
-
-msgid "New Features"
-msgstr "Nouvelles fonctionnalités"
-
-msgid "Newton Series Release Notes"
-msgstr "Note de release pour Newton"
-
-msgid "Welcome to watcher's Release Notes documentation!"
-msgstr "Bienvenue dans la documentation de la note de Release de Watcher"

releasenotes/source/newton.rst

@@ -1,6 +0,0 @@
-===================================
- Newton Series Release Notes
-===================================
-
-.. release-notes::
-   :branch: origin/stable/newton

releasenotes/source/ocata.rst

@@ -1,6 +0,0 @@
-===================================
- Ocata Series Release Notes
-===================================
-
-.. release-notes::
-   :branch: origin/stable/ocata

requirements.txt

@@ -5,42 +5,37 @@
 apscheduler # MIT License
 enum34;python_version=='2.7' or python_version=='2.6' or python_version=='3.3' # BSD
 jsonpatch>=1.1 # BSD
-keystoneauth1>=2.18.0 # Apache-2.0
+keystoneauth1>=2.10.0 # Apache-2.0
-keystonemiddleware>=4.12.0 # Apache-2.0
+keystonemiddleware!=4.1.0,!=4.5.0,>=4.0.0 # Apache-2.0
-lxml!=3.7.0,>=2.3 # BSD
+lxml>=2.3 # BSD
 oslo.concurrency>=3.8.0 # Apache-2.0
 oslo.cache>=1.5.0 # Apache-2.0
-oslo.config>=3.22.0 # Apache-2.0
+oslo.config>=3.14.0 # Apache-2.0
-oslo.context>=2.12.0 # Apache-2.0
+oslo.context>=2.9.0 # Apache-2.0
-oslo.db>=4.19.0 # Apache-2.0
+oslo.db!=4.13.1,!=4.13.2,>=4.10.0 # Apache-2.0
 oslo.i18n>=2.1.0 # Apache-2.0
-oslo.log>=3.22.0 # Apache-2.0
+oslo.log>=1.14.0 # Apache-2.0
-oslo.messaging>=5.19.0 # Apache-2.0
+oslo.messaging>=5.2.0 # Apache-2.0
-oslo.policy>=1.17.0 # Apache-2.0
+oslo.policy>=1.9.0 # Apache-2.0
 oslo.reports>=0.6.0 # Apache-2.0
 oslo.serialization>=1.10.0 # Apache-2.0
 oslo.service>=1.10.0 # Apache-2.0
-oslo.utils>=3.20.0 # Apache-2.0
+oslo.utils>=3.16.0 # Apache-2.0
-oslo.versionedobjects>=1.17.0 # Apache-2.0
 PasteDeploy>=1.5.0 # MIT
-pbr!=2.1.0,>=2.0.0 # Apache-2.0
+pbr>=1.6 # Apache-2.0
-pecan!=1.0.2,!=1.0.3,!=1.0.4,!=1.2,>=1.0.0 # BSD
+pecan!=1.0.2,!=1.0.3,!=1.0.4,>=1.0.0 # BSD
-PrettyTable<0.8,>=0.7.1 # BSD
+PrettyTable<0.8,>=0.7 # BSD
 voluptuous>=0.8.9 # BSD License
-gnocchiclient>=2.7.0 # Apache-2.0
 python-ceilometerclient>=2.5.0 # Apache-2.0
-python-cinderclient>=2.0.1 # Apache-2.0
+python-cinderclient!=1.7.0,!=1.7.1,>=1.6.0 # Apache-2.0
-python-glanceclient>=2.5.0 # Apache-2.0
+python-glanceclient!=2.4.0,>=2.3.0 # Apache-2.0
-python-keystoneclient>=3.8.0 # Apache-2.0
+python-keystoneclient!=2.1.0,>=2.0.0 # Apache-2.0
-python-monascaclient>=1.1.0 # Apache-2.0
 python-neutronclient>=5.1.0 # Apache-2.0
-python-novaclient>=7.1.0 # Apache-2.0
+python-novaclient!=2.33.0,>=2.29.0 # Apache-2.0
-python-openstackclient>=3.3.0 # Apache-2.0
+python-openstackclient>=2.1.0 # Apache-2.0
 six>=1.9.0 # MIT
-SQLAlchemy!=1.1.5,!=1.1.6,!=1.1.7,!=1.1.8,>=1.0.10 # MIT
+SQLAlchemy<1.1.0,>=1.0.10 # MIT
-stevedore>=1.20.0 # Apache-2.0
+stevedore>=1.16.0 # Apache-2.0
-taskflow>=2.7.0 # Apache-2.0
+taskflow>=1.26.0 # Apache-2.0
-WebOb>=1.7.1 # MIT
+WebOb>=1.2.3 # MIT
 WSME>=0.8 # MIT
-networkx>=1.10 # BSD
-

setup.cfg

@@ -16,6 +16,7 @@ classifier =
     Programming Language :: Python :: 2
     Programming Language :: Python :: 2.7
     Programming Language :: Python :: 3
+    Programming Language :: Python :: 3.4
     Programming Language :: Python :: 3.5
 
 [files]
@@ -31,7 +32,7 @@ setup-hooks =
 
 [entry_points]
 oslo.config.opts =
-    watcher = watcher.conf.opts:list_opts
+    watcher = watcher.opts:list_opts
 
 console_scripts =
     watcher-api = watcher.cmd.api:main
@@ -63,7 +64,6 @@ watcher_scoring_engine_containers =
 watcher_strategies =
     dummy = watcher.decision_engine.strategy.strategies.dummy_strategy:DummyStrategy
     dummy_with_scorer = watcher.decision_engine.strategy.strategies.dummy_with_scorer:DummyWithScorer
-    dummy_with_resize = watcher.decision_engine.strategy.strategies.dummy_with_resize:DummyWithResize
     basic = watcher.decision_engine.strategy.strategies.basic_consolidation:BasicConsolidation
     outlet_temperature = watcher.decision_engine.strategy.strategies.outlet_temp_control:OutletTempControl
     vm_workload_consolidation = watcher.decision_engine.strategy.strategies.vm_workload_consolidation:VMWorkloadConsolidation
@@ -76,14 +76,12 @@ watcher_actions =
     nop = watcher.applier.actions.nop:Nop
     sleep = watcher.applier.actions.sleep:Sleep
     change_nova_service_state = watcher.applier.actions.change_nova_service_state:ChangeNovaServiceState
-    resize = watcher.applier.actions.resize:Resize
 
 watcher_workflow_engines =
     taskflow = watcher.applier.workflow_engine.default:DefaultWorkFlowEngine
 
 watcher_planners =
-    weight = watcher.decision_engine.planner.weight:WeightPlanner
+    default  = watcher.decision_engine.planner.default:DefaultPlanner
-    workload_stabilization  = watcher.decision_engine.planner.workload_stabilization:WorkloadStabilizationPlanner
 
 watcher_cluster_data_model_collectors =
     compute = watcher.decision_engine.model.collector.nova:NovaClusterDataModelCollector

setup.py

@@ -25,5 +25,5 @@ except ImportError:
     pass
 
 setuptools.setup(
-    setup_requires=['pbr>=2.0.0'],
+    setup_requires=['pbr>=1.8'],
     pbr=True)

test-requirements.txt

@@ -2,25 +2,25 @@
 # of appearance. Changing the order has an impact on the overall integration
 # process, which may cause wedges in the gate later.
 
-coverage>=4.0 # Apache-2.0
+coverage>=3.6 # Apache-2.0
 doc8 # Apache-2.0
-freezegun>=0.3.6 # Apache-2.0
+freezegun # Apache-2.0
-hacking!=0.13.0,<0.14,>=0.12.0 # Apache-2.0
+hacking<0.11,>=0.10.2
 mock>=2.0 # BSD
 oslotest>=1.10.0 # Apache-2.0
-os-testr>=0.8.0 # Apache-2.0
+os-testr>=0.7.0 # Apache-2.0
 python-subunit>=0.0.18 # Apache-2.0/BSD
 testrepository>=0.0.18 # Apache-2.0/BSD
 testscenarios>=0.4 # Apache-2.0/BSD
 testtools>=1.4.0 # MIT
 
 # Doc requirements
-oslosphinx>=4.7.0 # Apache-2.0
+oslosphinx!=3.4.0,>=2.5.0 # Apache-2.0
-sphinx>=1.5.1 # BSD
+sphinx!=1.3b1,<1.3,>=1.2.1 # BSD
 sphinxcontrib-pecanwsme>=0.8 # Apache-2.0
 
 # releasenotes
-reno>=1.8.0 # Apache-2.0
+reno>=1.8.0 # Apache2
 
 # bandit
 bandit>=1.1.0 # Apache-2.0

tox.ini

@@ -1,17 +1,20 @@
 [tox]
 minversion = 1.8
-envlist = py35,py27,pep8
+envlist = py35,py34,py27,pep8
 skipsdist = True
 
 [testenv]
 usedevelop = True
 whitelist_externals = find
-install_command = pip install -c{env:UPPER_CONSTRAINTS_FILE:https://git.openstack.org/cgit/openstack/requirements/plain/upper-constraints.txt} {opts} {packages}
+install_command =
+                  constraints: pip install -U --force-reinstall -c{env:UPPER_CONSTRAINTS_FILE:https://git.openstack.org/cgit/openstack/requirements/plain/upper-constraints.txt?h=stable/newton} {opts} {packages}
+                  pip install -U {opts} {packages}
 setenv =
    VIRTUAL_ENV={envdir}
 deps = -r{toxinidir}/test-requirements.txt
 commands =
-  find . -type f -name "*.py[c|o]" -delete
+  find . -type f -name "*.pyc" -delete
+  find . -type d -name "__pycache__" -delete
   ostestr --concurrency=6 {posargs}
 
 [testenv:pep8]
@@ -25,9 +28,7 @@ setenv = PYTHONHASHSEED=0
 commands = {posargs}
 
 [testenv:cover]
-commands =
+commands = python setup.py testr --coverage --testr-args='{posargs}'
-    python setup.py testr --coverage --testr-args='{posargs}'
-    coverage report
 
 [testenv:docs]
 setenv = PYTHONHASHSEED=0
@@ -38,14 +39,14 @@ commands =
 [testenv:debug]
 commands = oslo_debug_helper -t watcher/tests {posargs}
 
-[testenv:genconfig]
+[testenv:config]
 sitepackages = False
 commands =
     oslo-config-generator --config-file etc/watcher/watcher-config-generator.conf
 
 [flake8]
 show-source=True
-ignore= H105,E123,E226,N320
+ignore=
 builtins= _
 exclude=.venv,.git,.tox,dist,doc,*lib/python*,*egg,build,*sqlalchemy/alembic/versions/*,demo/,releasenotes
 

watcher/__init__.py

@@ -1,3 +1,5 @@
+# -*- coding: utf-8 -*-
+
 # Licensed under the Apache License, Version 2.0 (the "License"); you may
 # not use this file except in compliance with the License. You may obtain
 # a copy of the License at

watcher/api/acl.py

@@ -1,7 +1,6 @@
 # -*- encoding: utf-8 -*-
 #
 # Copyright © 2012 New Dream Network, LLC (DreamHost)
-# Copyright (c) 2016 Intel Corp
 #
 # Licensed under the Apache License, Version 2.0 (the "License"); you may
 # not use this file except in compliance with the License. You may obtain
@@ -18,23 +17,32 @@
 
 """Access Control Lists (ACL's) control access the API server."""
 
+from oslo_config import cfg
 from watcher.api.middleware import auth_token
-from watcher import conf
 
-CONF = conf.CONF
+
+AUTH_OPTS = [
+    cfg.BoolOpt('enable_authentication',
+                default=True,
+                help='This option enables or disables user authentication '
+                'via keystone. Default value is True.'),
+]
+
+CONF = cfg.CONF
+CONF.register_opts(AUTH_OPTS)
 
 
 def install(app, conf, public_routes):
     """Install ACL check on application.
 
-    :param app: A WSGI application.
+    :param app: A WSGI applicatin.
     :param conf: Settings. Dict'ified and passed to keystonemiddleware
     :param public_routes: The list of the routes which will be allowed to
                           access without authentication.
     :return: The same WSGI application with ACL installed.
 
     """
-    if not CONF.get('enable_authentication'):
+    if not cfg.CONF.get('enable_authentication'):
         return app
     return auth_token.AuthTokenMiddleware(app,
                                           conf=dict(conf),

watcher/api/app.py

@@ -2,7 +2,6 @@
 
 # Copyright © 2012 New Dream Network, LLC (DreamHost)
 # All Rights Reserved.
-# Copyright (c) 2016 Intel Corp
 #
 #    Licensed under the Apache License, Version 2.0 (the "License"); you may
 #    not use this file except in compliance with the License. You may obtain
@@ -17,14 +16,49 @@
 #    under the License.
 
 
+from oslo_config import cfg
 import pecan
 
+from watcher._i18n import _
 from watcher.api import acl
 from watcher.api import config as api_config
 from watcher.api import middleware
-from watcher import conf
 
-CONF = conf.CONF
+# Register options for the service
+API_SERVICE_OPTS = [
+    cfg.PortOpt('port',
+                default=9322,
+                help=_('The port for the watcher API server')),
+    cfg.StrOpt('host',
+               default='127.0.0.1',
+               help=_('The listen IP for the watcher API server')),
+    cfg.IntOpt('max_limit',
+               default=1000,
+               help=_('The maximum number of items returned in a single '
+                      'response from a collection resource')),
+    cfg.IntOpt('workers',
+               min=1,
+               help=_('Number of workers for Watcher API service. '
+                      'The default is equal to the number of CPUs available '
+                      'if that can be determined, else a default worker '
+                      'count of 1 is returned.')),
+
+    cfg.BoolOpt('enable_ssl_api',
+                default=False,
+                help=_("Enable the integrated stand-alone API to service "
+                       "requests via HTTPS instead of HTTP. If there is a "
+                       "front-end service performing HTTPS offloading from "
+                       "the service, this option should be False; note, you "
+                       "will want to change public API endpoint to represent "
+                       "SSL termination URL with 'public_endpoint' option.")),
+]
+
+CONF = cfg.CONF
+opt_group = cfg.OptGroup(name='api',
+                         title='Options for the watcher-api service')
+
+CONF.register_group(opt_group)
+CONF.register_opts(API_SERVICE_OPTS, opt_group)
 
 
 def get_pecan_config():

watcher/api/app.wsgi

@@ -1,40 +0,0 @@
-# -*- mode: python -*-
-# -*- encoding: utf-8 -*-
-#
-# Licensed under the Apache License, Version 2.0 (the "License"); you may
-# not use this file except in compliance with the License. You may obtain
-# a copy of the License at
-#
-#      http://www.apache.org/licenses/LICENSE-2.0
-#
-# Unless required by applicable law or agreed to in writing, software
-# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
-# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
-# License for the specific language governing permissions and limitations
-# under the License.
-"""
-Use this file for deploying the API service under Apache2 mod_wsgi.
-"""
-
-import sys
-
-from oslo_config import cfg
-import oslo_i18n as i18n
-from oslo_log import log
-
-from watcher.api import app
-from watcher.common import service
-
-
-CONF = cfg.CONF
-
-i18n.install('watcher')
-
-service.prepare_service(sys.argv)
-
-LOG = log.getLogger(__name__)
-LOG.debug("Configuration:")
-CONF.log_opt_values(LOG, log.DEBUG)
-
-application = app.VersionSelectorApplication()
-