Christian Teuschel | September 2016 | iWeek ZA
Focus: RIPE Atlas
Network Visualisation
Workshop
Christian Teuschel | iWeek ZA | September 2016 2
Workshop Requirements
• Please make sure you have a RIPE NCC
Access account!
• Voucher for 5,000 Atlas credits
https://access.ripe.net
iweek_2016
Network Visualisation
Overview
Christian Teuschel | iWeek ZA | September 2016 4
Network Visualisation
• Bringing raw data to life, help with
interpretation and understanding
• Three main types of data:
- Registry data
- Routing data (BGP)
- Active measurement data (RIPE Atlas, MLab, etc.)
Christian Teuschel | iWeek ZA | September 2016 5
Registry Data
• Source: RIR databases
- AFRINIC, ARIN, APNIC, LACNIC and RIPE NCC
• Useful as supporting data set
https://stat.ripe.net/widget/allocation-historyhttps://stat.ripe.net/widget/address-space-hierarchy
Christian Teuschel | iWeek ZA | September 2016 6
Routing Data
• RIPE NCC’s RIS
- http://ris.ripe.net
https://stat.ripe.net/widget/bgplay
Christian Teuschel | iWeek ZA | September 2016 7
Routing Data
• RIPE NCC’s RIS
- http://ris.ripe.net
https://stat.ripe.net/widget/routing-history
Christian Teuschel | iWeek ZA | September 2016 8
Active Measurement Data
• RIPE Atlas
• MLab by Google
• Bandwidth measurements
- Speedchecker, Ookla, …
• Google ad measurements done by APNIC
RIPE Atlas
Introduction
Christian Teuschel | iWeek ZA | September 2016 10
RIPE Atlas
• A brief introduction
- Global network for Internet measurements
Christian Teuschel | iWeek ZA | September 2016 11
RIPE Atlas
• Standard Probe
- TP-Link MR3020
- Version 3
• Atlas Anchor
- Higher capacity
- Currently 216 nodes
- Soekris Net6501-70
- https://atlas.ripe.net/anchors/
Version 1/2
Christian Teuschel | iWeek ZA | September 2016 12
RIPE Atlas
Christian Teuschel | iWeek ZA | September 2016 13
RIPE Atlas
• RIPE Atlas probes in South Africa
https://stat.ripe.net/za#tabId=activity
389 registered ASNs
263 routed ASNs
Christian Teuschel | iWeek ZA | September 2016 14
RIPE Atlas
• RIPE Atlas probes in South Africa
https://stat.ripe.net/za#tabId=activity
Christian Teuschel | iWeek ZA | September 2016 15
RIPE Atlas
• RIPE Atlas anchors in South Africa
https://atlas.ripe.net/anchors/list/
Christian Teuschel | iWeek ZA | September 2016 16
Agenda
• Introduction to web UI
• Measurements
• Tools
- LatencyMon, QuickLook, DNSMON, DomainMON and 

IXP-Country-Jedi
• Command line tools
• RIPE Atlas APIs
• DIY workshop
RIPE Atlas
Web UI
Christian Teuschel | iWeek ZA | September 2016 18
Web UI
Christian Teuschel | iWeek ZA | September 2016 19
Exercise I
• Go to https://atlas.ripe.net
• Check if you can log in with your RIPE NCC
Access account!
RIPE Atlas
Measurements
Christian Teuschel | iWeek ZA | September 2016 21
Build-In Measurements
• What is it?
First check for existing measurements
https://atlas.ripe.net/measurements/
Christian Teuschel | iWeek ZA | September 2016 22
Build-In Measurements
• Probe view
https://atlas.ripe.net/probes/
Christian Teuschel | iWeek ZA | September 2016 23
Exercise II
• Pick a probe and look up build-in
measurement results!
Christian Teuschel | iWeek ZA | September 2016 24
Build-In Measurements
• Global view
https://atlas.ripe.net/results/maps/
Christian Teuschel | iWeek ZA | September 2016 25
User-Defined Measurements
• Custom measurements
- All measurement types possible
- Credit system to keep the resource allocation fair
Christian Teuschel | iWeek ZA | September 2016 26
User-Defined Measurements
• Credit system
https://atlas.ripe.net/user/credits
Christian Teuschel | iWeek ZA | September 2016 27
Exercise III
• Redeem your voucher “iweek_2016”
https://atlas.ripe.net/user/credits
Christian Teuschel | iWeek ZA | September 2016 28
Exercise IV
• Create a ping measurement
https://atlas.ripe.net/measurements/
RIPE Atlas
LatencyMON
Christian Teuschel | iWeek ZA | September 2016 30
LatencyMON
• Every running ping measurement
https://atlas.ripe.net/measurements
Christian Teuschel | iWeek ZA | September 2016 31
LatencyMON
Christian Teuschel | iWeek ZA | September 2016 32
LatencyMON
RIPE Atlas
DNSMON & DomainMON
Christian Teuschel | iWeek ZA | September 2016 34
DNSMON
• DNS root and many TLD name servers
https://atlas.ripe.net/dnsmon/
Christian Teuschel | iWeek ZA | September 2016 35
DomainMON
• Same visualisation as DNSMON
• For any domain server
• Runs on RIPE Atlas credits
• https://atlas.ripe.net/domainmon/
RIPE Atlas
IXP-Country-Jedi
Christian Teuschel | iWeek ZA | September 2016 37
IXP-Country-Jedi
IPv6IPv4
http://sg-pub.ripe.net/emile/ixp-country-jedi/latest/ZA/geopath/
RIPE Atlas
Command Line Tool
Christian Teuschel | iWeek ZA | September 2016 39
Command Line Tool
• Access RIPE Atlas from the terminal / shell
console
• Quick and dirty shortcuts for network
troubleshooting
• FLOSS (free software / open-source) tools
- Written and maintained by the RIPE NCC
- Open to community contributions
Christian Teuschel | iWeek ZA | September 2016 40
Command Line Tool
• Before you can use the toolset:
- Download the tools
- Install
- Configure
- ripe-atlas configure --set
authorisation.create=MY_API_KEY
• You need to have one (or more) API Keys
- https://atlas.ripe.net/keys/
Christian Teuschel | iWeek ZA | September 2016 41
Command Line Tool
• Source:
- https://github.com/RIPE-NCC/ripe-atlas-tools/
• Documentation:
- https://ripe-atlas-tools.readthedocs.org/
• Included in the Linux / BSD distributions:
- OpenBSD, FreeBSD, Gentoo, Arch, Debian and Ubuntu
(in progress: Fedora, Windows)
Christian Teuschel | iWeek ZA | September 2016 42
Command Line Tool
• Simple: one-off, using default values
(50 probes to “target”)
• $ ripe-atlas measure ping --target
wikipedia.org
Christian Teuschel | iWeek ZA | September 2016 43
Command Line Tool
• Geo-specific using 20 probes from ZA:
- $ ripe-atlas measure ping --target example.com --probes 20
--from-country za
• 20 ZA probes that support IPv6:
- $ ripe-atlas measure ping --target example.com

-- probes 20 --from-country za —include-tag system-ipv6-
works
• Create a recurring measurement:
- $ ripe-atlas measure ping —target example.com --interval
3600
Christian Teuschel | iWeek ZA | September 2016 44
Exercise V
• Make a note to try it at home!
RIPE Atlas
RIPE Atlas APIs
Christian Teuschel | iWeek ZA | September 2016 46
Rest API
• https://atlas.ripe.net/docs/api/v2/manual/
Christian Teuschel | iWeek ZA | September 2016 47
Streaming API
• RIPE Atlas streaming allows users to receive
measurement results as soon as the probes
send them, in real time
- Publish / subscribe through web sockets
- https://atlas.ripe.net/docs/result-streaming/
• Two types of data:
- Measurement results
- Probe connection status events
Christian Teuschel | iWeek ZA | September 2016 48
User-Defined Measurements
• Credit system
http://sg-pub.ripe.net/demo-area/atlas-stream/dns-instances.html
RIPE Atlas
DIY Visualisation
Christian Teuschel | iWeek ZA | September 2016 50
DIY Visualisation
• Build a simple visualisation
- https://atlas.ripe.net/webinar/streaming01.html
- Open the console of your browser
- Download the source code and edit the behaviour
Questions
christian.teuschel@ripe.net
@cteuschel

Network Visualisation Workshop

  • 1.
    Christian Teuschel |September 2016 | iWeek ZA Focus: RIPE Atlas Network Visualisation Workshop
  • 2.
    Christian Teuschel |iWeek ZA | September 2016 2 Workshop Requirements • Please make sure you have a RIPE NCC Access account! • Voucher for 5,000 Atlas credits https://access.ripe.net iweek_2016
  • 3.
  • 4.
    Christian Teuschel |iWeek ZA | September 2016 4 Network Visualisation • Bringing raw data to life, help with interpretation and understanding • Three main types of data: - Registry data - Routing data (BGP) - Active measurement data (RIPE Atlas, MLab, etc.)
  • 5.
    Christian Teuschel |iWeek ZA | September 2016 5 Registry Data • Source: RIR databases - AFRINIC, ARIN, APNIC, LACNIC and RIPE NCC • Useful as supporting data set https://stat.ripe.net/widget/allocation-historyhttps://stat.ripe.net/widget/address-space-hierarchy
  • 6.
    Christian Teuschel |iWeek ZA | September 2016 6 Routing Data • RIPE NCC’s RIS - http://ris.ripe.net https://stat.ripe.net/widget/bgplay
  • 7.
    Christian Teuschel |iWeek ZA | September 2016 7 Routing Data • RIPE NCC’s RIS - http://ris.ripe.net https://stat.ripe.net/widget/routing-history
  • 8.
    Christian Teuschel |iWeek ZA | September 2016 8 Active Measurement Data • RIPE Atlas • MLab by Google • Bandwidth measurements - Speedchecker, Ookla, … • Google ad measurements done by APNIC
  • 9.
  • 10.
    Christian Teuschel |iWeek ZA | September 2016 10 RIPE Atlas • A brief introduction - Global network for Internet measurements
  • 11.
    Christian Teuschel |iWeek ZA | September 2016 11 RIPE Atlas • Standard Probe - TP-Link MR3020 - Version 3 • Atlas Anchor - Higher capacity - Currently 216 nodes - Soekris Net6501-70 - https://atlas.ripe.net/anchors/ Version 1/2
  • 12.
    Christian Teuschel |iWeek ZA | September 2016 12 RIPE Atlas
  • 13.
    Christian Teuschel |iWeek ZA | September 2016 13 RIPE Atlas • RIPE Atlas probes in South Africa https://stat.ripe.net/za#tabId=activity 389 registered ASNs 263 routed ASNs
  • 14.
    Christian Teuschel |iWeek ZA | September 2016 14 RIPE Atlas • RIPE Atlas probes in South Africa https://stat.ripe.net/za#tabId=activity
  • 15.
    Christian Teuschel |iWeek ZA | September 2016 15 RIPE Atlas • RIPE Atlas anchors in South Africa https://atlas.ripe.net/anchors/list/
  • 16.
    Christian Teuschel |iWeek ZA | September 2016 16 Agenda • Introduction to web UI • Measurements • Tools - LatencyMon, QuickLook, DNSMON, DomainMON and 
 IXP-Country-Jedi • Command line tools • RIPE Atlas APIs • DIY workshop
  • 17.
  • 18.
    Christian Teuschel |iWeek ZA | September 2016 18 Web UI
  • 19.
    Christian Teuschel |iWeek ZA | September 2016 19 Exercise I • Go to https://atlas.ripe.net • Check if you can log in with your RIPE NCC Access account!
  • 20.
  • 21.
    Christian Teuschel |iWeek ZA | September 2016 21 Build-In Measurements • What is it? First check for existing measurements https://atlas.ripe.net/measurements/
  • 22.
    Christian Teuschel |iWeek ZA | September 2016 22 Build-In Measurements • Probe view https://atlas.ripe.net/probes/
  • 23.
    Christian Teuschel |iWeek ZA | September 2016 23 Exercise II • Pick a probe and look up build-in measurement results!
  • 24.
    Christian Teuschel |iWeek ZA | September 2016 24 Build-In Measurements • Global view https://atlas.ripe.net/results/maps/
  • 25.
    Christian Teuschel |iWeek ZA | September 2016 25 User-Defined Measurements • Custom measurements - All measurement types possible - Credit system to keep the resource allocation fair
  • 26.
    Christian Teuschel |iWeek ZA | September 2016 26 User-Defined Measurements • Credit system https://atlas.ripe.net/user/credits
  • 27.
    Christian Teuschel |iWeek ZA | September 2016 27 Exercise III • Redeem your voucher “iweek_2016” https://atlas.ripe.net/user/credits
  • 28.
    Christian Teuschel |iWeek ZA | September 2016 28 Exercise IV • Create a ping measurement https://atlas.ripe.net/measurements/
  • 29.
  • 30.
    Christian Teuschel |iWeek ZA | September 2016 30 LatencyMON • Every running ping measurement https://atlas.ripe.net/measurements
  • 31.
    Christian Teuschel |iWeek ZA | September 2016 31 LatencyMON
  • 32.
    Christian Teuschel |iWeek ZA | September 2016 32 LatencyMON
  • 33.
  • 34.
    Christian Teuschel |iWeek ZA | September 2016 34 DNSMON • DNS root and many TLD name servers https://atlas.ripe.net/dnsmon/
  • 35.
    Christian Teuschel |iWeek ZA | September 2016 35 DomainMON • Same visualisation as DNSMON • For any domain server • Runs on RIPE Atlas credits • https://atlas.ripe.net/domainmon/
  • 36.
  • 37.
    Christian Teuschel |iWeek ZA | September 2016 37 IXP-Country-Jedi IPv6IPv4 http://sg-pub.ripe.net/emile/ixp-country-jedi/latest/ZA/geopath/
  • 38.
  • 39.
    Christian Teuschel |iWeek ZA | September 2016 39 Command Line Tool • Access RIPE Atlas from the terminal / shell console • Quick and dirty shortcuts for network troubleshooting • FLOSS (free software / open-source) tools - Written and maintained by the RIPE NCC - Open to community contributions
  • 40.
    Christian Teuschel |iWeek ZA | September 2016 40 Command Line Tool • Before you can use the toolset: - Download the tools - Install - Configure - ripe-atlas configure --set authorisation.create=MY_API_KEY • You need to have one (or more) API Keys - https://atlas.ripe.net/keys/
  • 41.
    Christian Teuschel |iWeek ZA | September 2016 41 Command Line Tool • Source: - https://github.com/RIPE-NCC/ripe-atlas-tools/ • Documentation: - https://ripe-atlas-tools.readthedocs.org/ • Included in the Linux / BSD distributions: - OpenBSD, FreeBSD, Gentoo, Arch, Debian and Ubuntu (in progress: Fedora, Windows)
  • 42.
    Christian Teuschel |iWeek ZA | September 2016 42 Command Line Tool • Simple: one-off, using default values (50 probes to “target”) • $ ripe-atlas measure ping --target wikipedia.org
  • 43.
    Christian Teuschel |iWeek ZA | September 2016 43 Command Line Tool • Geo-specific using 20 probes from ZA: - $ ripe-atlas measure ping --target example.com --probes 20 --from-country za • 20 ZA probes that support IPv6: - $ ripe-atlas measure ping --target example.com
 -- probes 20 --from-country za —include-tag system-ipv6- works • Create a recurring measurement: - $ ripe-atlas measure ping —target example.com --interval 3600
  • 44.
    Christian Teuschel |iWeek ZA | September 2016 44 Exercise V • Make a note to try it at home!
  • 45.
  • 46.
    Christian Teuschel |iWeek ZA | September 2016 46 Rest API • https://atlas.ripe.net/docs/api/v2/manual/
  • 47.
    Christian Teuschel |iWeek ZA | September 2016 47 Streaming API • RIPE Atlas streaming allows users to receive measurement results as soon as the probes send them, in real time - Publish / subscribe through web sockets - https://atlas.ripe.net/docs/result-streaming/ • Two types of data: - Measurement results - Probe connection status events
  • 48.
    Christian Teuschel |iWeek ZA | September 2016 48 User-Defined Measurements • Credit system http://sg-pub.ripe.net/demo-area/atlas-stream/dns-instances.html
  • 49.
  • 50.
    Christian Teuschel |iWeek ZA | September 2016 50 DIY Visualisation • Build a simple visualisation - https://atlas.ripe.net/webinar/streaming01.html - Open the console of your browser - Download the source code and edit the behaviour
  • 51.