jyapayne/traceroute
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
Multi-source traceroute with geolocation information. https://dazzlepod.com/ip/
25 commits 2 branches 0 tags 436 KiB
Find a file
Brian Martin 1d168d48f6 - made progress on self hop parser
2015-07-14 11:10:17 -04:00
LICENSE update LICENSE and sources 2015-01-28 22:58:53 +11:00
README.md - testing webhook 2015-07-08 22:33:50 -04:00
requirements.txt - changed a few methods to be private 2015-07-08 09:33:38 -04:00
screenshot.png update LICENSE and sources 2015-01-28 22:58:53 +11:00
sources.json update LICENSE and sources 2015-01-28 22:58:53 +11:00
traceroute.py - made progress on self hop parser 2015-07-14 11:10:17 -04:00

README.md

traceroute

Multi-source traceroute with geolocation information. Demo: IP Address Lookup (under "Traceroute" tab)

Using output from traceroute.py to plot hops on Google Map

Installation

  1. Install dependencies listed in requirements.txt file. Pip is recommended. You could also use virtualenv to keep things isolated.
  2. Save traceroute.py into a directory with its path stored in your PYTHONPATH environment variable. (if using virtualenv, copy it here)

Usage

Try the following from your Python interpreter:

>>> from traceroute import Traceroute
>>> traceroute = Traceroute("8.8.8.8")
>>> hops = traceroute.hops
>>> hops
[{'hostname': 'core-87-router', 'longitude': -74.6597, 'rtt': '2.208 ms', 'hop_num': 1, 'latitude': 40.3756, 'ip_address': '128.112.128.2'}, {'hostname': 'border-87-router', 'longitude': -74.6597, 'rtt': '0.422 ms', 'hop_num': 2, 'latitude': 40.3756, 'ip_address': '128.112.12.142'}, {'hostname': 'te0-0-1-1.204.rcr12.phl03.atlas.cogentco.com', 'longitude': -97.0, 'rtt': '3.775 ms', 'hop_num': 3, 'latitude': 38.0, 'ip_address': '38.122.150.1'}, {'hostname': 'te0-0-1-3.rcr21.phl01.atlas.cogentco.com', 'longitude': -97.0, 'rtt': '3.689 ms', 'hop_num': 4, 'latitude': 38.0, 'ip_address': '154.54.27.117'}, {'hostname': 'te0-0-1-3.rcr22.phl01.atlas.cogentco.com', 'longitude': -97.0, 'rtt': '4.340 ms', 'hop_num': 4, 'latitude': 38.0, 'ip_address': '66.28.4.233'}, {'hostname': 'te0-7-0-10.mpd22.dca01.atlas.cogentco.com', 'longitude': -97.0, 'rtt': '8.082 ms', 'hop_num': 5, 'latitude': 38.0, 'ip_address': '154.54.42.101'}, {'hostname': 'te0-7-0-10.ccr21.dca01.atlas.cogentco.com', 'longitude': -97.0, 'rtt': '7.860 ms', 'hop_num': 5, 'latitude': 38.0, 'ip_address': '154.54.42.89'}, {'hostname': 'be2112.ccr41.iad02.atlas.cogentco.com', 'longitude': -97.0, 'rtt': '8.628 ms', 'hop_num': 6, 'latitude': 38.0, 'ip_address': '154.54.5.233'}, {'hostname': '38.88.214.50', 'longitude': -97.0, 'rtt': '8.197 ms', 'hop_num': 7, 'latitude': 38.0, 'ip_address': '38.88.214.50'}, {'hostname': '209.85.255.1', 'longitude': -122.0574, 'rtt': '9.230 ms', 'hop_num': 8, 'latitude': 37.4192, 'ip_address': '209.85.255.1'}, {'hostname': '209.85.251.101', 'longitude': -122.0574, 'rtt': '9.719 ms', 'hop_num': 8, 'latitude': 37.4192, 'ip_address': '209.85.251.101'}, {'hostname': '216.239.51.11', 'longitude': -122.0574, 'rtt': '9.811 ms', 'hop_num': 9, 'latitude': 37.4192, 'ip_address': '216.239.51.11'}, {'hostname': '72.14.238.115', 'longitude': -122.0574, 'rtt': '10.142 ms', 'hop_num': 9, 'latitude': 37.4192, 'ip_address': '72.14.238.115'}, {'hostname': '216.239.51.101', 'longitude': -122.0574, 'rtt': '9.568 ms', 'hop_num': 9, 'latitude': 37.4192, 'ip_address': '216.239.51.101'}, {'hostname': 'google-public-dns-a.google.com', 'longitude': -122.0838, 'rtt': '9.127 ms', 'hop_num': 10, 'latitude': 37.386, 'ip_address': '8.8.8.8'}]
>>>

You can also run the script directly by passing in the --ip_address option:

$ python traceroute.py --help
Usage: traceroute.py --ip_address=IP_ADDRESS

Options:
  -h, --help            show this help message and exit
  -i IP_ADDRESS, --ip_address=IP_ADDRESS
                        IP address of destination host (default: 8.8.8.8)
  -j JSON_FILE, --json_file=JSON_FILE
                        List of sources in JSON file (default: sources.json)
  -c COUNTRY, --country=COUNTRY
                        Traceroute will be initiated from this country; choose
                        'LO' for localhost to run traceroute locally, 'BY' for
                        Belarus, 'CH' for Switzerland, 'JP' for Japan, 'RU'
                        for Russia, 'UK' for United Kingdom or 'US' for United
                        States (default: US)
  -t TMP_DIR, --tmp_dir=TMP_DIR
                        Temporary directory to store downloaded traceroute
                        results (default: /tmp)
  -n, --no_geo          No geolocation data (default: False)
  -s TIMEOUT, --timeout=TIMEOUT
                        Timeout in seconds for all downloads (default: 120)
  -d, --debug           Show debug output (default: False)

$ python traceroute.py --ip_address=8.8.8.8
[
    {
        "hostname": "core-87-router",
        "longitude": -74.6597,
        "rtt": "3.035 ms",
        "hop_num": 1,
        "latitude": 40.3756,
        "ip_address": "128.112.128.2"
    },
    {
        "hostname": "border-87-router",
        "longitude": -74.6597,
        "rtt": "3.440 ms",
        "hop_num": 2,
        "latitude": 40.3756,
        "ip_address": "128.112.12.142"
    },
    {
        "hostname": "te0-0-1-1.204.rcr12.phl03.atlas.cogentco.com",
        "longitude": -97.0,
        "rtt": "3.588 ms",
        "hop_num": 3,
        "latitude": 38.0,
        "ip_address": "38.122.150.1"
    },
    {
        "hostname": "te0-0-1-3.rcr22.phl01.atlas.cogentco.com",
        "longitude": -97.0,
        "rtt": "3.441 ms",
        "hop_num": 4,
        "latitude": 38.0,
        "ip_address": "66.28.4.233"
    },
    {
        "hostname": "te0-7-0-10.mpd22.dca01.atlas.cogentco.com",
        "longitude": -97.0,
        "rtt": "7.455 ms",
        "hop_num": 5,
        "latitude": 38.0,
        "ip_address": "154.54.42.101"
    },
    {
        "hostname": "te0-7-0-10.ccr21.dca01.atlas.cogentco.com",
        "longitude": -97.0,
        "rtt": "7.573 ms",
        "hop_num": 5,
        "latitude": 38.0,
        "ip_address": "154.54.42.89"
    },
    {
        "hostname": "te0-7-0-10.mpd22.dca01.atlas.cogentco.com",
        "longitude": -97.0,
        "rtt": "7.521 ms",
        "hop_num": 5,
        "latitude": 38.0,
        "ip_address": "154.54.42.101"
    },
    {
        "hostname": "be2112.ccr41.iad02.atlas.cogentco.com",
        "longitude": -97.0,
        "rtt": "8.611 ms",
        "hop_num": 6,
        "latitude": 38.0,
        "ip_address": "154.54.5.233"
    },
    {
        "hostname": "be2176.ccr41.iad02.atlas.cogentco.com",
        "longitude": -97.0,
        "rtt": "8.640 ms",
        "hop_num": 6,
        "latitude": 38.0,
        "ip_address": "154.54.41.53"
    },
    {
        "hostname": "38.88.214.50",
        "longitude": -97.0,
        "rtt": "8.655 ms",
        "hop_num": 7,
        "latitude": 38.0,
        "ip_address": "38.88.214.50"
    },
    {
        "hostname": "209.85.251.101",
        "longitude": -122.0574,
        "rtt": "9.783 ms",
        "hop_num": 8,
        "latitude": 37.4192,
        "ip_address": "209.85.251.101"
    },
    {
        "hostname": "209.85.246.227",
        "longitude": -122.0574,
        "rtt": "9.313 ms",
        "hop_num": 8,
        "latitude": 37.4192,
        "ip_address": "209.85.246.227"
    },
    {
        "hostname": "209.85.246.225",
        "longitude": -122.0574,
        "rtt": "8.308 ms",
        "hop_num": 8,
        "latitude": 37.4192,
        "ip_address": "209.85.246.225"
    },
    {
        "hostname": "216.239.51.101",
        "longitude": -122.0574,
        "rtt": "12.102 ms",
        "hop_num": 9,
        "latitude": 37.4192,
        "ip_address": "216.239.51.101"
    },
    {
        "hostname": "216-239-51-13.google.com",
        "longitude": -122.0574,
        "rtt": "8.993 ms",
        "hop_num": 9,
        "latitude": 37.4192,
        "ip_address": "216.239.51.13"
    },
    {
        "hostname": "216.239.51.9",
        "longitude": -122.0574,
        "rtt": "8.731 ms",
        "hop_num": 9,
        "latitude": 37.4192,
        "ip_address": "216.239.51.9"
    },
    {
        "hostname": "google-public-dns-a.google.com",
        "longitude": -122.0838,
        "rtt": "8.775 ms",
        "hop_num": 10,
        "latitude": 37.386,
        "ip_address": "8.8.8.8"
    }
]