Changes between Version 53 and Version 54 of GENIMonitoring/HowTo


Ignore:
Timestamp:
05/05/15 08:45:10 (5 years ago)
Author:
lnevers@bbn.com
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • GENIMonitoring/HowTo

    v53 v54  
    1 [[PageOutline]]
    2 
    3 = GENI Monitoring How-to =
    4 
    5 This 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 
    9 When you first login to the GENI Monitoring system you will be presented with the following page:
    10 
    11 [[Image(GENIMonMain.jpg, 60%)]]
    12 
    13 The 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 
    24 The 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 
    30 Following 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 
    51 To 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 
    55 If 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 
    59 Select "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 
    63 This 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 
    69 To get traffic statistics, select the "Slivers" tab, and click on the Sliver ID:
    70 
    71 [[Image(sliver-tab.jpg,60%)]]
    72 
    73 This 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 
    77 One 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 
    81 Note: 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 
    83 Note: 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 
    87 If 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 
    91 Note: Information returned at this time does not combine the view of the AL2S Network Aggregate and the Compute Resource aggregates.
    92 
    93 If 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 
    97 In 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 
    102 Selecting any of the checks returns Ping Time Metrics between the sites described in the Check ID:
    103 
    104 [[Image(ping-metric.jpg,70%)]]
    105 
    106 Note: 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 
    111 The [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 
    116 The [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 
    121 Selecting 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 ==
    127 The ''' ''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 
    134 The ''' ''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 
    136 Note: Currently ExoGENI racks do not report an interface role, and "unknown" is shown in the interface role column.
    137 
    138 Note: Currently there are no interface statistics available, only overall node statistics.
    139 
    140 ----
    141 {{{
    142 #!html
    143 Email <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 }}}
     1Moved to wiki:GENIMonitoring/Overview