[[PageOutline]] = Operational monitoring in GENI = Shared operational monitoring data for GENI aggregates, slice authorities, and resources is collected by the [wiki:GENIMetaOps GENI Meta-Operations Center] and made available for use by GENI operators and experimenters. Most of this monitoring data is gathered on individual GENI hosts (slice authorities, aggregates, and resources), and submitted to GMOC's monitoring database via authenticated XML over HTTP. The tango-monitor software packages described below implement the client side of this monitoring. == How to install monitoring software == * [wiki:TangoGeniMonitoring/GmocConfiguration]: tango-monitor-gmoc, the base package for submitting monitoring data using a python module (gmoc.py). All other monitoring software packages require this, and you can install it to submit your own custom monitoring data, or to use its functionality to download GMOC data, as well. * [wiki:TangoGeniMonitoring/FoamConfiguration]: tango-monitor-foam, the monitoring software for [wiki:OpenFlow/FOAM FOAM] aggregates. == Information about what is monitored == In general, monitoring comprises two types of data: * Relational data: names of objects that exist in GENI (slice authorities, aggregates, resources, slices, slivers, etc) and how those objects are related. * Measurement data: real-time values of numerical measurements which have been taken on those objects. Here are some pages with more information about this data: * [wiki:GENIMetaOps/DraftMonitoringMetrics] contains a draft list of monitoring metrics which can currently be submitted using gmoc.py. GMOC monitoring client packages submit a subset of these metrics, depending on the aggregate. * [http://groups.geni.net/geni/attachment/wiki/GENIMetaOps/gmocv3.rng] is the XML schema for authenticated data submission over the network. * [wiki:GeniApiIdentifiers] contains information about the URNs used to uniquely identify various things in GENI. Operational monitoring uses GENI-compliant URNs wherever possible. == How to access monitoring data == Several mechanisms exist for looking at monitoring data: * At GMOC: * [https://gmoc-db.grnoc.iu.edu/protected/]: The GMOC web interface for viewing GENI relational data and some measurement data. You will need to login to look at these pages, but should be able to sign in using any OpenID provider (e.g. google). * [http://gmoc-db.grnoc.iu.edu/api-demo/]: The GMOC SNAPP API for viewing raw measurement data. * At GPO: * [http://monitor.gpolab.bbn.com/tango/]: An alternate display of relational and measurement data downloaded from gmoc-db. * [http://monitor.gpolab.bbn.com/nagios/cgi-bin/status.cgi?hostgroup=tango-geni&style=detail]: Nagios display of GENI operational status information, primarily obtained by downloading and analysing data from gmoc-db. * [wiki:TangoGeniMonitoring/GmocConfiguration]: The tango-monitor-gmoc package supports python-based submission of monitoring data, and can also be used to retrieve recent relational monitoring data. If you use this mechanism to download GMOC data for your own use and are able to do so, please add a link to this section so that other GENI users can use your visualizations.