From: Ryota Mibu Date: Mon, 11 Sep 2017 13:06:26 +0000 (+0000) Subject: Merge "Add host specific VM list to inspector design guide line" X-Git-Tag: opnfv-5.0.RC1~14 X-Git-Url: https://gerrit.opnfv.org/gerrit/gitweb?a=commitdiff_plain;h=5ffd957a87858e026011e4bbde9b493c62c11b8e;hp=dfb3c066a1c325ba7ca028be98d9ec04af994f48;p=doctor.git Merge "Add host specific VM list to inspector design guide line" --- diff --git a/docs/development/design/inspector-design-guideline.rst b/docs/development/design/inspector-design-guideline.rst index 4add8c0f..faa5e424 100644 --- a/docs/development/design/inspector-design-guideline.rst +++ b/docs/development/design/inspector-design-guideline.rst @@ -31,7 +31,24 @@ Guidelines Host specific VMs list ---------------------- -TBD, see `DOCTOR-76`_. +While requirement in doctor project is to have alarm about fault to consumer in one second, it is just a limit we have +set in requirements. When talking about fault management in Telco, the implementation needs to be by all means optimal +and the one second is far from traditional Telco requirements. + +One thing to be optimized in inspector is to eliminate the need to read list of host specific VMs from Nova API, when +it gets a host specific failure event. Optimal way of implementation would be to initialize this list when Inspector +start by reading from Nova API and after this list would be kept up-to-date by ``instance.update`` notifications +received from nova. Polling Nova API can be used as a complementary channel to make snapshot of hosts and VMs list in +order to keep the data consistent with reality. + +This is enhancement and not perhaps something needed to keep under one second in a small system. Anyhow this would be +something needed in case of production use. + +This guideline can be summarized as following: + +- cache the host VMs mapping instead of reading it on request +- subscribe and handle update notifications to keep the list up to date +- make snapshot periodically to ensure data consistency Parallel execution ------------------