GlobePEER Looking Glass

With the AqabaIX GlobePEER looking glass service, it is possible to easily search for an AS number, a peer or a particular IP prefix or prefixes with particular BGP communities. In addition, the GlobePEER looking glass service provides information on why a certain route is rejected by the GlobePEER route servers (e.g. due to IRR filters). Below you can find a detailed explanation of how to use the GlobePEER looking glass, how to narrow down search results, what exactly you can see, some typical search examples, and more information about query strings and how to use the API in your own scripts.

The AqabaIX GlobePEER Looking Glass utilizes the open source projects Alice-LG and birdwatcher. A big thank you to all who contributed to these projects!

How to use the AqabaIX GlobePEER Looking Glass

There are two basic ways to get information: 

  • The global search over all GlobePEER route servers (1)
  • The neighbor overview (2)

With the global search, you can search for IP prefixes, peer names, ASNs and BGP communities. This is the fastest way if you need to get information about a specific network. 

With the neighbor overview, you can have a look at a specific GlobePEER route server. It shows you which networks are available at a specific GlobePEERroute server, provides BGP session information (state, last state changed), and gives you a summary of received/accepted/filtered routes from each peer.

UAE-IX Looking Glass

The global search over all GlobePEER route servers 

With the global search, you can search across all AqabaIX GlobePEER route servers. You can directly search for: 

  • Prefixes
  • Peers (by name, e.g. Packet Clearing House)
  • ASNs (by prefixing them with 'AS', e.g. AS42)
  • BGP communities (by prefixing them with '#', e.g. #65535:666)

Just type in what you're looking for.

Narrow down the search results 

On the results page, it is possible to narrow down the search results with three drop-down menus on the right. You can refine your search by: 

  • GlobePEER Route server
  • Neighbor (in case your search matches more than one GlobePEER route server peer)
  • BGP communities (multiple BGP community values can be selected; the communities are ordered by value)

The selected filters appear above the drop-down field and can be removed easily by clicking the red 'X' icon. 

Please note: The database that is used to generate the search results in the global search contains data that may be up to 30 minutes old. The actual cache age is displayed in the upper right corner.

The neighbor overview

Using the neighbor overview, you can have a look at individual AqabaIX GlobePEER route servers and their BGP peers (and their current status, e.g. session up, down, or errors). 

To start the overview, select a AqabaIX GlobePEER route server. This will result in a view that contains all peers that are known to the selected GlobePEER route server. All table columns are sortable in ascending or descending order.

Narrow down the displayed data 

With the search bar at the top, you can narrow down the data displayed. You can search for: 

  • Neighbor IP 
  • Peers (e.g. Packet Clearing House) 
  • ASNs (e.g. AS42)

Get information about specific GlobePEER route server neigbor 

You can see more information about a specific GlobePEER route server neighbor by clicking on its neighbor IP. All routes (filtered, accepted, and not exported) are shown. If the selected peer operates more than one router, you can switch between routers by clicking the tabs shown at the top. There are also quick links available to jump to sections with filtered, accepted and not exported routes directly. Routes that are the best path are marked with a star icon.  

If a route is rejected, the reason is displayed in text below the affected route. You can hover over the text to get a detailed explanation of what went wrong and how to fix it. You can also click on the reject reason to explore the route in question in IRR Explorer

To get more detailed information about a route, just click on it. This will show you the BGP attributes: 

  • Age of the route (when it has been learned)
  • Origin of the route (IGP/EGP/unknown) 
  • Local Preference 
  • BGP next-hop 
  • MED 
  • AS Path 
  • BGP Standard, Extended and Large communities in human readable format if known by the GlobePEER route server (i.e. UAE-IX Action and Informational Communities and well-known BGP Communities)

Typical search examples

Find out which prefixes are filtered on your session(s)

  • Enter your ASN in the global search field on the start page
  • A list of prefixes from your ASN on all GlobePEER route servers is shown
  • Filtered prefixes are shown at the top of the page (before accepted routes)
  • You can narrow down your search by using the dropdown menus on the right
  • You can click on the link in the description column to go the corresponding GlobePEER route server for the selected prefix

Using query strings 

It is possible to use query strings in URLs, e.g. in bookmarks:

  • Search for a prefix (e.g. 185.106.36.0/22) in the global search (lookup on all GlobePEER route servers): https://lg.aqabaix.com/search?q=185.106.36.0/22
  • Search for AS15169 on GlobePEER route server rs1_aqj_ipv4*: https://lg.aqabaix.com/routeservers/rs1_aqj_ipv4?s=asn&o=asc&q=15169
  • Search for prefixes advertised by peer with ID R106_1 (this ID corresponds to the last two octets of the peering LAN IP address) on route server rs1_aqj_ipv4*: aqabaix.com
  • Just replace rs1_aqj_ipv4 with the corresponding RS

Use the API in your own scripts

Alice provides a JSON API for all AqabaIX GlobePEER route servers. You can use the API in your own scripts. The following endpoints are available:

Endpoint/example queryDescription
/api/v1/statusQuery the status of Alice
/api/v1/routeservers/rs1_aqj_ipv4/status Query the status of GlobePEER route server rs1_aqj_ipv4
/api/v1/routeservers/rs1_aqj_ipv4/neighbors/R106_1/routes/received  Query GlobePEER route server rs1_aqj_ipv4 for a list of received routes from peer R106_1 (84.252.106_1)
/api/v1/routeservers/rs1_aqj_ipv4/neighbors/R106_1/routes/not-exported Query GlobePEER route server rs1_aqj_ipv4 for a list of routes not exported to peer R106_1 (84.252.106_1)
/api/v1/routeservers/rs1_aqj_ipv4/neighbors/R106_1/routes/filtered    Query GlobePEER route server rs1_aqj_ipv4 for a list of filtered routes from peer R106_1 (84.252.106_1)
/api/v1/routeservers/rs1_aqj_ipv4/neighborsQuery GlobePEER route server rs1_aqj_ipv4 for a list of its neighbors
/api/v1/routeserversQuery a list of GlobePEER route servers known to Alice
/api/v1/lookup/prefix?q=185.106.36.0/22Query Alice for prefix 185.106.36.0/22
/api/v1/configQuery the Alice configuration

Questions?

If you have any questions, please feel free to contact us