X-Git-Url: https://osm.etsi.org/gitweb/?a=blobdiff_plain;f=README.rst;h=ef34a3d74eedc930c810df827fa23e27a808e5d1;hb=44ebeeb78ca62e3e86dc218723bc417a3c4bd698;hp=9c4381bd69fe411a3965602429f48e22ee8cb683;hpb=b7e9ec0fe0dd55677c3a61e3221b6f9af1b303d2;p=osm%2FMON.git diff --git a/README.rst b/README.rst index 9c4381b..ef34a3d 100644 --- a/README.rst +++ b/README.rst @@ -1,45 +1,57 @@ +.. + 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 *************