X-Git-Url: https://osm.etsi.org/gitweb/?a=blobdiff_plain;f=README.rst;h=ef34a3d74eedc930c810df827fa23e27a808e5d1;hb=de3d570360a0a31d3054a6ff72b09ae9f559b59c;hp=9093b6d6044f2190fe1b199eb524ebde3b153555;hpb=6c3e7842b5ac04959058263c88ef185da352058e;p=osm%2FMON.git diff --git a/README.rst b/README.rst index 9093b6d..ef34a3d 100644 --- a/README.rst +++ b/README.rst @@ -1,66 +1,57 @@ .. - # Copyright 2017 Intel Research and Development Ireland Limited - # ************************************************************* - # This file is part of OSM Monitoring module - # All Rights Reserved to Intel Corporation - # - # 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. - # - # For those usages not covered by the Apache License, Version 2.0 please - # contact: prithiv.mohan@intel.com or adrian.hoban@intel.com + Copyright 2018 Whitestack, LLC + ************************************************************* + + This file is part of OSM Monitoring module + All Rights Reserved to Whitestack, LLC + + 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. + For those usages not covered by the Apache License, Version 2.0 please + contact: bdiaz@whitestack.com or glavado@whitestack.com OSM MON Module **************** -MON is a monitoring module for OSM. This module leverages the monitoring -tool of the supported VIMs through MON's native plugin to send and receive -metrics and alarms for a VNF. +MON is a monitoring module for OSM. +It collects metrics from VIMs and VNFs and exports them to a Prometheus TSDB. +It manages and evaluates alarms based on those metrics. Components ********** MON module has the following components: - - MON Core, which includes Message Bus and Models - - Plugin drivers for various VIMs - -The MON module communication is classified as - - - External to MON(requests to MON from SO) - - Internal to MON(responses to MON from plugins) + - MON Central: Handles vim accounts registration and alarms CRUD operations, through messages in the Kafka bus. + - MON Collector: Collects metrics from VIMs and VNFs and then exports them to a TSDB. It uses a plugin model both for collectors and for backends. + - MON Evaluator: Evaluates alarms and sends notifications through the Kafka bus when they trigger. -Supported Plugins -****************** -Supported VIMs are OpenStack, VMWare, AWS for now. MON can send/receive metrics -and alarms from the following plugins in this release. +Supported Collector Plugins +*************************** - - Gnocchi, Aodh (OpenStack) - - vROps (VMWare) - - CloudWatch (AWS) + - OpenStack: Requires Aodh and Gnocchi to be enabled. + - VROPS: TBD + - AWS: TBD Developers ********** - - Prithiv Mohan, Intel Research and Development Ltd, Ireland - - Helena McGough, Intel Research and Development Ltd, Ireland - - Sachin Bhangare, VMWare, India - - Wajeeha Hamid, XFlow Research, Pakistan + - Benjamín Díaz, Whitestack, Argentina Maintainers *********** - - Adrian Hoban, Intel Research and Development Ltd, Ireland + - Gianpietro Lavado, Whitestack, Peru Contributions *************