Home

Awesome

RIPE Atlas Tracepath

A JavaScript/Python web-app which reads results from RIPE Atlas traceroute measurements (both IPv4 and IPv6) and shows the Autonomous Systems and Internet Exchange Points that probes traverse to reach the target.

Overview

Given a RIPE Atlas traceroute measurement, it builds a graph with all the ASs and IXPs traversed by probes and shows their average RTT toward the target. Graphs can be saved in JSON format and loaded later for further analysis, or they can be exported as PNG images.

Example

A demo can be found at http://www.pierky.com/ripeatlastracepath/demo.

Dependencies

Python

Yes, Python 2.7 (probably it's already on your system).

Other modules

You can run

pip install -r requirements.txt

to install dependencies.

Installation

Simply fetch the GitHub repository (or its last release) into your local directory:

git clone https://github.com/pierky/ripeatlastracepath.git /opt/ripeatlastracepath

(replace /opt/ripeatlastracepath with your preferred destination directory)

Configuration

Application specific configurations

Rename the config-distrib.py to config.py and edit it with your preferred text editor.

mv config-distrib.py config.py

IMPORTANT: when done, set the CONFIG_DONE at the end of the file to True.

Local var directory

Build the var directory referenced by the VAR_DIR variable:

mkdir var

Cached IP addresses' details will be stored here.

Web front-end

The web front-end can be deployed in two flavors:

In this document you can find two brief guides about the builtin server and the Apache configuration.

Please consider security aspects of your network before installing RIPE Atlas Tracepath; it is intended for a restricted audience of trusted people and it does not implement any kind of security mechanism.

Flask builtin web server

ripeatlastracepathapp.run(host="0.0.0.0",threaded=True)

python web.py

The output will show how to reach the application:

* Running on http://0.0.0.0:5000/
* Restarting with reloader

Any output debug message will be written to stdout.

Apache

An example is provided in the ripeatlastracepath.apache file.

A quick setup guide is available on Flask web-site.

See http://www.modwsgi.org/ for more details.

chown -R :www-data var
chmod -R g+w var
chmod g+s var

Docker image

If you want to quickly take a peek at how this web-app works, you can use the Docker image available on DockerHub.

Third-party Libraries

Part of this work is based on D3.js library. Please see its web sites to verify browser compatibility.

Old releases

The old version of this tool, CGI-based, has been moved in the old_style branch.

Bug? Issues?

Have a bug? Please create an issue here on GitHub at https://github.com/pierky/ripeatlastracepath/issues.

Author

Pier Carlo Chiodi - https://www.pierky.com/

Blog: https://blog.pierky.com Twitter: <a href="http://twitter.com/pierky">@pierky</a>