ripe-atlas-traceroute2kml

A Python script which reads results from RIPE Atlas traceroute measurements (both IPv4 and IPv6) and generates a *.kml file.

Overview

• the script analyzes the traceroute results and then shows a plain text summary of traversed ASes:

   [...]
  
   2 probes:  7922, COMCAST-7922 - Comcast Cable Communications, Inc.,US
              3356, LEVEL3 - Level 3 Communications, Inc.,US
              3333, RIPE-NCC-AS Reseaux IP Europeens Network Coordination Centre (RIPE NCC),NL
   
   3 probes:  1273, CW Cable and Wireless Worldwide plc,GB
              1200, AMS-IX1 Amsterdam Internet Exchange B.V.,NL
              3333, RIPE-NCC-AS Reseaux IP Europeens Network Coordination Centre (RIPE NCC),NL
   
   [...]
  

• additionally it generates a kml file for route visualisation in google maps

Installation

Prerequirements

import ipaddr http://code.google.com/p/ipaddr-py/ - pip install ipaddr
import simplekml https://code.google.com/p/simplekml/ - pip install simplekml
import geoip2.database https://github.com/maxmind/GeoIP2-python - with easy_install or pip install geoip2
import html - with pip install html 

Download latest GeoLite2 Free Database: http://geolite.maxmind.com/download/geoip/database/GeoLite2-City.mmdb.gz

Generate Config File in the same directory as the generate-kml-from-measurement.py resides

config.py
#!/usr/bin/python

import os

__version__ = "0.1"


DATA_DIR = "/ripe-atlas-traceroute2kml/cache"
KML_FILE = "output.kml"
GEOIP_FILE = "/resources/GeoLite2-City.mmdb"

Usage

For each run, the RIPE Atlas measurement ID is required; if the measurement is not public, the API key is also needed in order to access the results.

Results are then downloaded in a local file for later use; traceroute hops IP addresses are analyzed using the "ipdetailscache" library (https://github.com/pierky/ipdetailscache) and their details locally cached.

Command line mode syntax:

./ripeatlastracepath [-k api_key ] [-f] measurement_id

Options:
    -k      RIPEAtlas API key to access the measurement
    -f      Skip local measurement cache and force its download

Third-party Libraries

Part of this work is based of the project ripeatlastracepath. Thanks a lot to Pier Carlo Chiodi - http://www.pierky.com