wiki:GENIMonitoring/HowTo

Version 50 (modified by lnevers@bbn.com, 9 years ago) (diff)

--

GENI Monitoring How-to

This page provides an overview of the 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 Getting an Account page.

GENI Monitoring Layout

When you first login to the GENI Monitoring system you will be presented with the following page:

No image "GENIMonMain.jpg" attached to GENIMonitoring/HowTo

The areas of the page numbered above provide access to the following functions:

[1] All monitoring functions are available from the "Main Navigation" area in the left side of the page.
[2] The "Main Panel" area shows status information and initially displays the "Dashboard".
[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.
[4] User ID/Operations. This link provides access to "Sign Out" and "Profile" function, where you can change your password.
[5] Enter a term to search for within the "Main Panel" data shown.
[6] Enter a term to search for in all monitoring data, regardless of display area.

Monitoring Data by User Account Type

The data available to you is based on the user type associated with your account. The following user types are available:

  • Admin - User has all administrative functions and can see all data
  • Operator - User can access all monitoring data, but has not adminstrative access.
  • Experimenter - User can access all data except for user email data. No adminstrative access.

Following is a table that highlight which function are available by user type:

Main Navigation functionAdminOperatorExperimenter
(User) Administration Yes No No
GENI Alerts Yes Yes Yes
GENI Objects - Users Yes Yes No
GENI Objects - Slices Yes Yes Yes
GENI Objects - Slivers Yes Yes Yes
GENI Objects - Checks Yes Yes Yes
GENI Stores - Aggregates Yes Yes Yes
GENI Stores - Authorities Yes Yes Yes
GENI Stores - Check Stores Yes Yes Yes
GENI Hardware - Nodes Yes Yes Yes
GENI Hardware - Interfaces Yes Yes Yes
GENI Hardware - Links Yes Yes Yes
GENI Hardware - VLANs Yes Yes Yes

Finding an Experimenter Slice

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.

Traffic Statistics

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.

Starting with Slice

Select "Slices" and find your slice. Once your slice is selected, you can see the "Information" window, which looks like this screen capture:

No image "slice-info.jpg" attached to GENIMonitoring/HowTo

This page includes a summary of slice information (URN, creation time, expiration time, etc) and several tabs that provide monitoring functions. The tabs are:

  • "Map" - Shows a diagram of the monitored components and their relationship within the monitoring system. This is not a topology map.
  • "Members" - Shows the project members for the slice.
  • "Slivers" - Show the list of slice slivers being monitored for the slice.

To get traffic statistics, select the "Slivers" tab, and click on the Sliver ID:

No image "sliver-tab.jpg" attached to GENIMonitoring/HowTo

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:

No image "endpoints.jpg" attached to GENIMonitoring/HowTo

One of the slice endpoints shown above is the AL2S Router (sd-sn.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:

No image "report-stats.jpg" attached to GENIMonitoring/HowTo

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.

Starting with VLAN(s)

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:

No image "vlan-search.jpg" attached to GENIMonitoring/HowTo

Note: Information returned at this time does not combine the view of the AL2S Network Aggregate and the Compute Resource aggregates.

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.

GENI External Checks

In addtion to collecting information from the GENI aggregates directly, 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:

No image "checks.jpg" attached to GENIMonitoring/HowTo

Selecting any of the checks returns Ping Time Metrics between the sites described in the Check ID:

No image "ping-metric.jpg" attached to GENIMonitoring/HowTo

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.

Aggregate Reports

The 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.)

Authority Reports

The GENI Monitoring system monitors the GENI Clearinghouse for Users and Slices statistics. Clearinghouse information is available by selecting GENI Stores->Authorities .

No image "authorities.jpg" attached to GENIMonitoring/HowTo

Selecting the ch.geni.net authority will show an "Authority History Report" for Users and Slices activity for the date range selected:

No image "clearinghouse.jpg" attached to GENIMonitoring/HowTo

Nodes Reports

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:

No image "node-metrics.jpg" attached to GENIMonitoring/HowTo

Interface Reports

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.

Note: Currently ExoGENI racks do not report an interface role, and "unknown" is shown in the interface role column.

Note: Currently there are no interface statistics available, only overall node statistics.


Email help@geni.net for GENI support or email me with feedback on this page!