From 36c3cacedfdae3e4b4f04e9bc021a20f7a6052f0 Mon Sep 17 00:00:00 2001 From: Yujun Zhang Date: Thu, 10 Nov 2016 14:05:40 +0800 Subject: Inspector design guideline - outline created - detailed guideline to be added in followup patchsets JIRA: DOCTOR-73 Change-Id: I4134e2e34bc4550210246f9e16ad8d90e4c57be1 Signed-off-by: Yujun Zhang --- docs/design/index.rst | 1 + docs/design/inspector-design-guideline.rst | 46 ++++++++++++++++++++++++++++++ 2 files changed, 47 insertions(+) create mode 100644 docs/design/inspector-design-guideline.rst diff --git a/docs/design/index.rst b/docs/design/index.rst index 4efbef17..dbd9d75b 100644 --- a/docs/design/index.rst +++ b/docs/design/index.rst @@ -23,3 +23,4 @@ See also https://wiki.opnfv.org/requirements_projects . notification-alarm-evaluator.rst rfe-port-status-update.rst port-data-plane-status.rst + inspector-design-guideline.rst diff --git a/docs/design/inspector-design-guideline.rst b/docs/design/inspector-design-guideline.rst new file mode 100644 index 00000000..4add8c0f --- /dev/null +++ b/docs/design/inspector-design-guideline.rst @@ -0,0 +1,46 @@ +.. This work is licensed under a Creative Commons Attribution 4.0 International License. +.. http://creativecommons.org/licenses/by/4.0 + +========================== +Inspector Design Guideline +========================== + +.. NOTE:: + This is spec draft of design guideline for inspector component. + JIRA ticket to track the update and collect comments: `DOCTOR-73`_. + +This document summarize the best practise in designing a high performance +inspector to meet the requirements in `OPNFV Doctor project`_. + +Problem Description +=================== + +Some pitfalls has be detected during the development of sample inspector, e.g. +we suffered a significant `performance degrading in listing VMs in a host`_. + +A `patch set for caching the list`_ has been committed to solve issue. When a +new inspector is integrated, it would be nice to have an evaluation of existing +design and give recommendations for improvements. + +This document can be treated as a source of related blueprints in inspector +projects. + +Guidelines +========== + +Host specific VMs list +---------------------- + +TBD, see `DOCTOR-76`_. + +Parallel execution +------------------ + +TBD, see `discussion in mailing list`_. + +.. _DOCTOR-73: https://jira.opnfv.org/browse/DOCTOR-73 +.. _OPNFV Doctor project: https://wiki.opnfv.org/doctor +.. _performance degrading in listing VMs in a host: https://lists.opnfv.org/pipermail/opnfv-tech-discuss/2016-September/012591.html +.. _patch set for caching the list: https://gerrit.opnfv.org/gerrit/#/c/20877/ +.. _DOCTOR-76: https://jira.opnfv.org/browse/DOCTOR-76 +.. _discussion in mailing list: https://lists.opnfv.org/pipermail/opnfv-tech-discuss/2016-October/013036.html -- cgit 1.2.3-korg