Changes between Initial Version and Version 1 of GENIMonitoring/Overview


Ignore:
Timestamp:
05/05/15 08:44:46 (9 years ago)
Author:
lnevers@bbn.com
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • GENIMonitoring/Overview

    v1 v1  
     1[[PageOutline]]
     2
     3= GENI Monitoring Overview =
     4
     5This page provides an overview of the [http://genimon.uky.edu/ GENI Monitoring] system available functions and highlights potential usage scenarios and notes restrictions or potential issues for a user.  This sections assumes the user has an account, if you do not have an account see the instructions for [http://groups.geni.net/geni/wiki/GENIMonitoring/Account Getting an Account] page.
     6
     7== GENI Monitoring Layout ==
     8
     9When you first login to the GENI Monitoring system you will be presented with the following page:
     10
     11[[Image(GENIMonMain.jpg, 60%)]]
     12
     13The areas of the page numbered above provide access to the following functions:
     14
     15 ![1] All monitoring functions are available from the "Main Navigation" area in the left side of the page.[[BR]]
     16 ![2] The "Main Panel" area shows status information and initially displays the "Dashboard". [[BR]]
     17 ![3] This toggle icon lets you hide/show the "Main Navigation" area on the left side of the page. Most navigation is possible using only the "Main Panel," so you may choose this to increase the size of the panel.[[BR]]
     18 ![4] User ID/Operations. This link provides access to "Sign Out" and "Profile" function, where you can change your password.[[BR]]
     19 ![5] Enter a term to search for within the "Main Panel" data shown.[[BR]]
     20 ![6] Enter a term to search for in all monitoring data, regardless of display area.[[BR]]
     21
     22== Monitoring Data by User Account Type ==
     23
     24The data available to you is based on the user type associated with your account.  The following user types are available:
     25
     26 - Admin - User has all administrative functions and can see all data
     27 - Operator - User can access all monitoring data, but has not adminstrative access.
     28 - Experimenter - User can access all data except for user email data.  No adminstrative access.
     29
     30Following is a table that highlight which function are available by user type:
     31
     32
     33||'''Main Navigation function'''||'''Admin'''||'''Operator'''||'''Experimenter'''||
     34||(User) Administration         || Yes       || No           || No               ||
     35||GENI Alerts                   || Yes       || Yes          || Yes              ||
     36||GENI Objects - Users          || Yes       || Yes          || No               ||
     37||GENI Objects - Slices         || Yes       || Yes          || Yes              ||
     38||GENI Objects - Slivers        || Yes       || Yes          || Yes              ||
     39||GENI Objects - Checks         || Yes       || Yes          || Yes              ||
     40||GENI Stores - Aggregates      || Yes       || Yes          || Yes              ||
     41||GENI Stores - Authorities     || Yes       || Yes          || Yes              ||
     42||GENI Stores - Check Stores    || Yes       || Yes          || Yes              ||
     43||GENI Hardware - Nodes         || Yes       || Yes          || Yes              ||
     44||GENI Hardware - Interfaces    || Yes       || Yes          || Yes              ||
     45||GENI Hardware - Links         || Yes       || Yes          || Yes              ||
     46||GENI Hardware - VLANs         || Yes       || Yes          || Yes              ||
     47
     48
     49== Finding an Experimenter Slice ==
     50
     51To find a slices, simply select the ''' ''Dashboard->Slices'' ''' icon or from the "Main Navigation" area, or choose ''' ''GENI Objects->Slices'' '''.  Both result in the "Main Panel" listing all active slices. You may further narrow down your search by typing the project or slice name in the search box at the top right hand corner of the main panel.
     52
     53== Traffic Statistics ==
     54
     55If you are interested in traffic statistics for your slice, there are two ways to get to statistics for your experiment: you can start with the name of your slice, or start with a VLAN ID in your slice.
     56
     57=== Starting with Slice ===
     58
     59Select "Slices" and find your slice. Once your slice is selected, you can see the "Information" window, which looks like this screen capture:
     60
     61[[Image(slice-info.jpg, 60%)]]
     62
     63This page includes a summary of slice information (URN, creation time, expiration time, etc) and several tabs that provide monitoring functions. The tabs are:
     64
     65 - "Map" - Shows a diagram of the monitored components and their relationship within the monitoring system. This __is not__ a topology map.
     66 - "Members" - Shows the project members for the slice.
     67 - "Slivers" - Show the list of slice slivers being monitored for the slice.
     68
     69To get traffic statistics, select the "Slivers" tab, and click on the Sliver ID:
     70
     71[[Image(sliver-tab.jpg,60%)]]
     72
     73This will result in a list of links associated with the sliver. Select a link to see the associated (interface:VLAN) endpoints.  Here are example endpoints:
     74
     75[[Image(endpoints.jpg,80%)]]
     76
     77One of the slice endpoints shown above is the AL2S Router (sdn-sw.losa.net.internet.edu), and its eth5/1 interface is configured for traffic on VLAN 1565.  Selecting the Endpoint ID will result in statistics being shown:
     78
     79[[Image(report-stats.jpg,80%)]]
     80
     81Note: You can select the report type to show live data or historical data over the specified date/time range.  Live data will be updated frequently while you are looking at the page.
     82
     83Note: The units in the report above are Megabits per second. The TX shows traffic transmitted by the  sdn-sw.losa.net.internet.edu:eth5/1:1565 VLAN, while the RX is the traffic received by the sdn-sw.losa.net.internet.edu:eth5/1:1565 VLAN.
     84
     85=== Starting with VLAN(s) ===
     86
     87If you know a VLAN ID that is active in your slice, and you want traffic statistics for it, you can simply select ''' ''GENI Hardware->VLANs'' ''' and enter your VLAN in the "Search" box in the main panel. Here is an example to look for statistics on VLAN 1565:
     88
     89[[Image(vlan-search.jpg,60%)]]
     90
     91Note: Information returned at this time does not combine the view of the AL2S Network Aggregate and the Compute Resource aggregates.
     92
     93If we select the sd-sn.losa.net.internet.edu:eth5/1:1565 entry, we will see same information found in the previous section that started with the slice name.
     94
     95== GENI External Checks ==
     96
     97In addtion to collecting information from the GENI aggregates directly, [http://genimon.uky.edu/ GENI Monitoring] can also integrate status information from independent applications. One example of this is the '' ''' GENI Objects->Checks''' ''.  This checker runs at the GPO, capturing status for active !OpenFlow connections between several GENI sites.  The current check, which is still being improved, checks !OpenFlow dataplane availability from the University of Washington InstaGENI rack to several remote sites.  This is the current list of !OpenFlow Campus Checks for AL2S sites:
     98
     99[[Image(checks.jpg,70%)]]
     100
     101
     102Selecting any of the checks returns Ping Time Metrics between the sites described in the Check ID:
     103
     104[[Image(ping-metric.jpg,70%)]]
     105
     106Note: When you mouse-over the report diagram, details about collection time-stamp (ex. Friday, April 3, 23:15:23:29) and milliseconds measured are displayed.
     107
     108
     109== Aggregate Reports ==
     110
     111The [http://genimon.uky.edu/ GENI Monitoring] system monitors GENI Aggregates. This function is available by selecting '' '''GENI Stores->Aggregates''' '', which reports a list of all monitored aggregates. There are several types of Aggregates: InstaGENI, ExoGENI, OpenGENI, FOAM(!OpenFlow), Network-Aggregate, WiMAX, and the Stitcher Service. Each of these Aggregate Types reports an "Aggregate History Report" and an "Aggregate Availability" report, which report resource allocation an aggregate availability respectively.  (Note that some services are reported as aggregates for convenience, even though they are not strictly aggregates.)
     112
     113 
     114== Authority Reports ==
     115
     116The [http://genimon.uky.edu/ GENI Monitoring] system monitors the GENI Clearinghouse for ''Users'' and ''Slices'' statistics.  Clearinghouse information is available by selecting '' '''GENI Stores->Authorities''' ''.
     117
     118[[Image(authorities.jpg,70%)]]
     119
     120
     121Selecting the '''ch.geni.net''' authority will show an "Authority History Report" for  active ''Users'' and ''Slices'' activity for the date range selected:
     122
     123[[Image(clearinghouse.jpg,70%)]]
     124
     125
     126== Nodes Reports ==
     127The ''' ''GENI Hardware->Nodes'' ''' feature provides a list of all GENI Node resources including VM Servers, Switches and WiMAX resources for Compute and Network Aggregates.  Selecting any of the nodes and a Node Metrics Report is shown for the selected date range:
     128
     129[[Image(node-metrics.jpg,60%)]]
     130
     131
     132== Interface Reports ==
     133
     134The ''' ''GENI Hardware->Interfaces'' ''' feature provides a list of all known interfaces, including their role (experimental, control) for each rack type and for WiMAX sites.
     135
     136Note: Currently ExoGENI racks do not report an interface role, and "unknown" is shown in the interface role column.
     137
     138Note: Currently there are no interface statistics available, only overall node statistics.
     139
     140----
     141{{{
     142#!html
     143Email <a href="mailto:help@geni.net"> help@geni.net </a> for GENI support or email <a href="mailto:luisa.nevers@bbn.com">me</a> with feedback on this page!
     144}}}