[[PageOutline]] = GENI Monitoring Tips = This page highlights how to use GENI Monitoring features to investigate GENI Operations issues. All procedures assume that GENI Monitoring user is logged into the [http://genimon.uky.edu/ GENI Monitoring System]. == Determine a Slice Topology and Usage at each Aggregate == In a scenario where the slice name is known, it is possible to determine its topology (nodes and links) and bandwidth usage for each site. In this sections we will show how to determine the topology for a slice named "triangle" and then show usage for one of the sites in this experiment. 1. In the left-hand navigation bar, type `"triangle"` in `Search` box. This will show matching any item in monitoring containing the string `"triangle"` in the main panel. 2. In the `Slices` listing select the slice ID `"ch.geni.net_ln-test_slice_triangle"`. This will show all slice details in the main panel including: - Map tab - A resource allocation map, not the actual topology of the slice. - Active Members tab - The project owner of the the slice - Slivers tab - The list of compute resource slivers and network slivers associated with the slice. 3. For our triangle slice, the `Slivers` tab will include a lists of 4 slivers (1 from AL2S and 3 from Rack Aggregates). From this list you can see that te slice has 3 nodes (1 at each site) and 3 links at AL2S, as shown below: [[Image(triangle-sliver-details.jpg, 80%)]] 4. You can select the each of the site slivers to determine which VM server or raw device the compute resource is allocated on. For example, selecting: - `"geni.uchicago.edu_sliver_5003"` shows that compute resource is on `"geni.uchicago.edu_node_pcvm3-1"` - `"instageni.cenic.net_sliver_1266"` shows that compute resource is on `"instageni.cenic.net_node_pcvm2-2"` - `"instageni.nysernet.org_sliver_24968"` shows that compute resource is on `"instageni.nysernet.org_node_pcvm3-4"` 5. You can determine the slice topology and the site usage statistics by using the VLANs IDs allocated to the slice. VLANs can be determined from the AL2S sliver details: - Selected the AL2S sliver `"urn:publicid:IDN+ch.geni.net:ln-test+slice+triangle:1bc9e85e-146c-4991-a4e9-96c5f3a5dee9"` for the list of slivers for this slice. - Select each of the links that are part of the sliver to find VLANs allocated: * I2-LOSA-NEWY32AOA-VLAN-51145 includes `sdn-sw.losa.net.internet2.edu:eth5/1:1550` and `sdn-sw.newy32aoa.net.internet2.edu:eth7/2:1714` * I2-LOSA-STAR-VLAN-51146 includes `sdn-sw.losa.net.internet2.edu:eth5/1:1565` and `sdn-sw.star.net.internet2.edu:eth7/1:3092` * I2-NEWY32AOA-STAR-VLAN-51144 includes `sdn-sw.newy32aoa.net.internet2.edu:eth7/2:1715` and `sdn-sw.star.net.internet2.edu:eth7/1:3076` NOTE: Steps 3, 4 and 5 provide information to determine the topology for the slice. Following is a diagram of the details reported from step 3, 4 and 5: [[Image(Triangle-details.jpg,60%)]] 6. Assuming we are interested in the bandwidth usage for the NYSERNet connections (sdn-sw.newy32aoa.net.internet2.edu), you can see from the previous step that there are two VLANs associated with the site (1714 and 1715). 7. Select '''Dashborad->VLANs''', this will show the full list of VLAN in use in GENI. In the resulting VLAN listing type the VLAN ID `1715` in the panel search to narrow the results to you sliver: [[Image(nysernet-1715.jpg)]] 8. Select the ID `instageni.nysernet.org_interface_pc3:eth1:1715` to see usage statistics: [[Image(nysernet-1715-usage.jpg, 80%)]] 9. For the seconds NYSERNet connection, select '''Dashborad->VLANs''', this will show the full list of VLAN in use in GENI. In the resulting VLAN listing type the VLAN ID `1714` in the panel search to narrow the results to you sliver: [[Image(nysernet-1714.jpg, 80%)]] 10. Select the ID `instageni.nysernet.org_interface_pc3:eth1:1714` to see usage statistics: [[Image(nysernet-1714-usage.jpg, 80%)]] == Determine Largest Traffic Source at an Aggregate == This scenario shows the Largest Traffic Source at a Site. We assume the site that is being investigated is Clemson. 1. In `Dashboard` click on the `Aggregates` button, this will display all known aggregates. 2. Narrow down the list by typing "clemson" in the upper-right `Search` field, which will show only Clemson aggregates. As you can see from the Nodes and Slivers counts, the InstaGENI rack has the most activity and most likely the source of the issue. So will we focus on clemson-ig: [[Image(clemson-aggregates.jpg)]] 3. We will use GENI reporting to find the VLAN that is the source of most traffic. Select `GENI Reporting`-> `Reports`. 4. On the resulting page select the "Report Type" `VLAN Network Throughput [By Aggregate] from the pull-down and in the "Report Target" type start typing clemson, the field will automatically list all aggregate names that match, select "clemson-ig". 5. In the `Reports List` results section, choose the report named "VLAN Network Throughput for Aggregate [clemson-ig]". The report will show VLAN usage for the aggregate form highest to lowest. Pick the highest usage VLAN ID (ex. VLAN 1234) 6. Go to `Dashboard` and click on the `Aggregates` button, this shows list of all known VLANs. Narrow down the list by typing "1234" in the upper-right `Search` field. Results will now include AL2S and Clemson monitored VLANs. 6. Select "instageni.clemson.edu_interface_pc3:eth2:1234" and you will get data metrics for the VLAN 1234 at Clemson IG. 7. Go back to the list of VLAN Metric available and this time choose the AL2S entry "sdn-sw.atla.net.internet2.edu:eth5/2:1234" to view statistics reported from the AL2S switch in Atlanta where Clemson is connected to AL2S Network.