tutorial: using ripestat - ripe network coordination centre · 2018-08-17 · ripe ripestat, menog...

TutorialUsing RIPEstatMENOG 13

Christian Teuschel

RIPE RIPEstat MENOG 13

Recap From the RIPEstat Presentation

bull Information system for Internet number resources

bull Data_ Routing data

- Collected by RIS httprisripenet_ Registration data (whois)

_ RIPE Database amp other RIR databases_ MaxMindrsquos geolocation data_ Blacklist data _ And many more httpsstatripenetdata-sources

2


Three Interfaces of RIPEstat

3

httpsstatripenetdatarouting-statusdatajsonresource=AS3333

RIPEstat Web Interface

RIPEstat Widget API

RIPEstat Data API RIPEstat Text


RIPEstat Web Interfacebull Finding Information on RIPEstat

4

Search input

Links to most used features

RIPEstat related articles on

RIPE Labs

Recent new features


RIPEstat Web Interfacebull Information structure on RIPEstat

5

bull FAQbull Data Sourcesbull Widget Listbull Top Queriesbull Feedback

bull Interfaces amp APIsbull Demosbull Roadmapbull Changelog

bull Notable Network Eventsbull Compare Resultsbull Looking For Abuse Informationbull Global Internet Statistics


1 Querying for a Resource (Web Interface)

6

Search box

Your ASN amp network prefix Sample resources

Example Enter ldquoAS3333rdquo in the search box



Result page

7

Search box

Widgets grouped into thematic tabs Widgets display

different types of information


1 Querying for a Resource (Web Interface) Tasks

_ What network announces 140785090_ Is 192342 routed_ In which country is 9122942023 used_ What is its corresponding INETNUM object_ What widget provides real-time routing status_ By what percent did the number of prefixes announced by Kuwait increase over the last two years

_ How would you share interesting network events with a colleague

8


2 MyViewsCreate custom views

9

bull Click theldquoMyViewrdquo Button

bull Drag and drop a widget onto the ldquoMyViewrdquo button


2 MyViews

10

Newly created MyView

MyViews are only visible to you An option to share your views will be available soon


2 MyViewsCustomise MyViews

11

bull Renamebull Re-orderbull Control visibilitybull Remove

Re-order widgets as you like


2 MyViews Tasks

_ Create a RIPE Access account (if you donrsquot already have one)_ Create a MyView for a prefix containing the following widgets

_ Routing Status_ Looking Glass_ Routing History

_ Create another MyView with at least two widgets and give it a meaningful name

12


Create SSO AccountTasks

_ Go to the ldquoLoginrdquo page_ ldquoclick here to create onerdquo

13


3 Comparing Resources (Web Interface)bull Compare results in different widgets

14

Go to ldquoUse Casesrdquo gt ldquoCompare Resultsrdquo

Select a widget



15

Enter a resourcebull Select the ldquoPrefix Size Distributionrdquo widgetbull Enter ldquoAS1205rdquo


3 Comparing Resources (Web Interface)In-widget comparison

16


3 Comparing Resources (Web Interface)Tasks

_ Compare the number of announced prefixes for two networks over the past two years using the widget comparison page

_ How does the Internet in Kuwait compare to the UK Use in-widget comparison

17


4 Finding Abuse Contacts amp Reporting AbuseTake action in an abuse case with the Abuse Contact Finder

18

Go to ldquoUse Casesrdquo gt ldquoLooking For Abuse Informationrdquo

In-depth information about abuse

Enter the IP address


4 Finding Abuse Contacts amp Reporting Abuse

19

Email contact to report abuse to

Rating of the contact



20

Details about the resource and abuse contact


4 Finding Abuse Contacts amp Reporting AbuseTasks

_ What is the abuse contact for 19302022 or the hotel network_ Check an IP address from your home network_ Discussion

What can you do in these cases_ No abuse contact found_ No response on an abuse report

21


5 Letrsquos BGPlay

bull Use BGPlay to see how your network is routed- BGPlay is a tool that show routing history in an animated

and highly-interactive manner

bull Go to httpsstatripenetwidgetbgplay

22


5 Letrsquos BGPlay

23

Interactive graph visualisation

Control timeline

BGP event ASN orASN path details

Selection timeline

Control panel - Covered time period- RRC selection


5 Letrsquos BGPlay

24

Examples

- Prefix with announcements amp withdrawals 8420564024- Check IPv6 connectivity 200167c2e848- Multi-homed prefix 199780024


5 Letrsquos BGPlayTasks

_ Find the up-stream provider for AS1205_ Is AS3333 multi-homed_ Check the IPv6 connectivity of your own network

25


6 Embedding Widgets On Your Own Site Embedding widgets

_ What is the conceptWidgets are based purely on web standards and were developed with embeddability in mind Every widget available via the RIPEstat web interface can be embedded on your own site

_ RIPEstat Widget API documentation httpsstatripenetdocswidget_api

26


6 Embedding Widgets On Your Own Site

27

Prefix Count widget

AS Path Length widget

This ISP embedded widgets on its page


6 Embedding Widgets On Your Own Site (Task)Tasks

_ Create a simple dashboard page to monitor your network_ Create a simple HTML page

_ download the sample page httpsstatripenetwidgetsmenogwidget_homehtml

_ Embed three widgets of your choice_ Make the widget smaller and remove the RIPEstat logo

28


7 RIPEstat Data API Using raw data output

_ What is the conceptThe RIPEstat Data API provides the lowest level of access to data This data can be fed into custom applications or just used for scripting

_ RIPEstat Widget API documentation httpsstatripenetdocsdata_api

29


7 RIPEstat Data API (Task)Tasks

_ Use your browser to retrieve all announced prefixes for the AS6412_ A simple check on your resource if it is seen on the Internet

_ Create a simple script using resource-overview or routing-status

30


8 RIPE AtlasCreating a user-defined measurement

_ httpsatlasripenet

31


9 Create a Nagios check (optional)_ Create a Nagios check using the RIPEstat Data API

_ Nagios is a monitoring tool that supports the development of custom checks (like other similar tools)

_ Result codes for a check show the state

32

State Result Code

Ok

Warning

Error

0

1

2


9 Create a Nagios check (optional)Example of a Python based check

33

if argstransit transit = argstransitsplit()origin = argsoriginsplit()nagios_status = 0origin_errors = 0transit_errors = 0nagios_message = url = httpssdatalooking-glassdatajsonresource=s (argsstatserver urllib2quote(argsprefix ))lookingglass_raw = urllib2urlopen(url)lookingglass_json = jsonload(lookingglass_raw)if lookingglass_json[data_call_status] = supported print WARN s is under maintance (argsstatserver) sysexit(1)for rrc in lookingglass_json[data][rrcs] for peer in lookingglass_json[data][rrcs][rrc][entries] aspath = peer[as_path]split() details = peer[details][0]split() peer_addr = details[0] nexthop = details[2] router_id = details[3] if len(aspath) gt argsminpath if aspath[-1] not in origin origin_errors += 1 nagios_message = nagios_message + ( Origin missmatch s (s) s (rrc peer_addr aspath[-1])) if argstransit if aspath[-2] not in transit transit_errors += 1 nagios_message = nagios_message + ( Transit missmatch s (s) s (rrc peer_addr aspath[-2]))

if origin_errors == 0 and transit_errors == 0 nagios_message = OK s Origin is s (argsprefix argsorigin) if argstransit nagios_message = s and all transits match s (nagios_message argstransit) elif origin_errors gt= argscrit or transit_errors gt= argscrit nagios_status = 2 nagios_message = ERROR + nagios_messageelif origin_errors gt= argswarn or transit_errors gt= argswarn nagios_status = 1 nagios_message = WARN + nagios_message


Recap From the RIPEstat Presentation

bull Information system for Internet number resources

bull Data_ Routing data

- Collected by RIS httprisripenet_ Registration data (whois)

_ RIPE Database amp other RIR databases_ MaxMindrsquos geolocation data_ Blacklist data _ And many more httpsstatripenetdata-sources

2



3



RIPEstat Widget API




4

Search input



RIPE Labs

Recent new features



5






6

Search box





Result page

7

Search box







8



9




2 MyViews

10





11




2 MyViews Tasks




12




13



14


Select a widget



15




16





17



18






19





20






21


5 Letrsquos BGPlay




22


5 Letrsquos BGPlay

23


Control timeline


Selection timeline



5 Letrsquos BGPlay

24

Examples





25





26



27

Prefix Count widget








28





29





30



_ httpsatlasripenet

31





32

State Result Code

Ok

Warning

Error

0

1

2



33





3



RIPEstat Widget API




4

Search input



RIPE Labs

Recent new features



5






6

Search box





Result page

7

Search box







8



9




2 MyViews

10





11




2 MyViews Tasks




12




13



14


Select a widget



15




16





17



18






19





20






21


5 Letrsquos BGPlay




22


5 Letrsquos BGPlay

23


Control timeline


Selection timeline



5 Letrsquos BGPlay

24

Examples





25





26



27

Prefix Count widget








28





29





30



_ httpsatlasripenet

31





32

State Result Code

Ok

Warning

Error

0

1

2



33





4

Search input



RIPE Labs

Recent new features



5






6

Search box





Result page

7

Search box







8



9




2 MyViews

10





11




2 MyViews Tasks




12




13



14


Select a widget



15




16





17



18






19





20






21


5 Letrsquos BGPlay




22


5 Letrsquos BGPlay

23


Control timeline


Selection timeline



5 Letrsquos BGPlay

24

Examples





25





26



27

Prefix Count widget








28





29





30



_ httpsatlasripenet

31





32

State Result Code

Ok

Warning

Error

0

1

2



33





5






6

Search box





Result page

7

Search box







8



9




2 MyViews

10





11




2 MyViews Tasks




12




13



14


Select a widget



15




16





17



18






19





20






21


5 Letrsquos BGPlay




22


5 Letrsquos BGPlay

23


Control timeline


Selection timeline



5 Letrsquos BGPlay

24

Examples





25





26



27

Prefix Count widget








28





29





30



_ httpsatlasripenet

31





32

State Result Code

Ok

Warning

Error

0

1

2



33





6

Search box





Result page

7

Search box







8



9




2 MyViews

10





11




2 MyViews Tasks




12




13



14


Select a widget



15




16





17



18






19





20






21


5 Letrsquos BGPlay




22


5 Letrsquos BGPlay

23


Control timeline


Selection timeline



5 Letrsquos BGPlay

24

Examples





25





26



27

Prefix Count widget








28





29





30



_ httpsatlasripenet

31





32

State Result Code

Ok

Warning

Error

0

1

2



33





Result page

7

Search box







8



9




2 MyViews

10





11




2 MyViews Tasks




12




13



14


Select a widget



15




16





17



18






19





20






21


5 Letrsquos BGPlay




22


5 Letrsquos BGPlay

23


Control timeline


Selection timeline



5 Letrsquos BGPlay

24

Examples





25





26



27

Prefix Count widget








28





29





30



_ httpsatlasripenet

31





32

State Result Code

Ok

Warning

Error

0

1

2



33







8



9




2 MyViews

10





11




2 MyViews Tasks




12




13



14


Select a widget



15




16





17



18






19





20






21


5 Letrsquos BGPlay




22


5 Letrsquos BGPlay

23


Control timeline


Selection timeline



5 Letrsquos BGPlay

24

Examples





25





26



27

Prefix Count widget








28





29





30



_ httpsatlasripenet

31





32

State Result Code

Ok

Warning

Error

0

1

2



33





9




2 MyViews

10





11




2 MyViews Tasks




12




13



14


Select a widget



15




16





17



18






19





20






21


5 Letrsquos BGPlay




22


5 Letrsquos BGPlay

23


Control timeline


Selection timeline



5 Letrsquos BGPlay

24

Examples





25





26



27

Prefix Count widget








28





29





30



_ httpsatlasripenet

31





32

State Result Code

Ok

Warning

Error

0

1

2



33




2 MyViews

10





11




2 MyViews Tasks




12




13



14


Select a widget



15




16





17



18






19





20






21


5 Letrsquos BGPlay




22


5 Letrsquos BGPlay

23


Control timeline


Selection timeline



5 Letrsquos BGPlay

24

Examples





25





26



27

Prefix Count widget








28





29





30



_ httpsatlasripenet

31





32

State Result Code

Ok

Warning

Error

0

1

2



33





11




2 MyViews Tasks




12




13



14


Select a widget



15




16





17



18






19





20






21


5 Letrsquos BGPlay




22


5 Letrsquos BGPlay

23


Control timeline


Selection timeline



5 Letrsquos BGPlay

24

Examples





25





26



27

Prefix Count widget








28





29





30



_ httpsatlasripenet

31





32

State Result Code

Ok

Warning

Error

0

1

2



33




2 MyViews Tasks




12




13



14


Select a widget



15




16





17



18






19





20






21


5 Letrsquos BGPlay




22


5 Letrsquos BGPlay

23


Control timeline


Selection timeline



5 Letrsquos BGPlay

24

Examples





25





26



27

Prefix Count widget








28





29





30



_ httpsatlasripenet

31





32

State Result Code

Ok

Warning

Error

0

1

2



33






13



14


Select a widget



15




16





17



18






19





20






21


5 Letrsquos BGPlay




22


5 Letrsquos BGPlay

23


Control timeline


Selection timeline



5 Letrsquos BGPlay

24

Examples





25





26



27

Prefix Count widget








28





29





30



_ httpsatlasripenet

31





32

State Result Code

Ok

Warning

Error

0

1

2



33





14


Select a widget



15




16





17



18






19





20






21


5 Letrsquos BGPlay




22


5 Letrsquos BGPlay

23


Control timeline


Selection timeline



5 Letrsquos BGPlay

24

Examples





25





26



27

Prefix Count widget








28





29





30



_ httpsatlasripenet

31





32

State Result Code

Ok

Warning

Error

0

1

2



33





15




16





17



18






19





20






21


5 Letrsquos BGPlay




22


5 Letrsquos BGPlay

23


Control timeline


Selection timeline



5 Letrsquos BGPlay

24

Examples





25





26



27

Prefix Count widget








28





29





30



_ httpsatlasripenet

31





32

State Result Code

Ok

Warning

Error

0

1

2



33





16





17



18






19





20






21


5 Letrsquos BGPlay




22


5 Letrsquos BGPlay

23


Control timeline


Selection timeline



5 Letrsquos BGPlay

24

Examples





25





26



27

Prefix Count widget








28





29





30



_ httpsatlasripenet

31





32

State Result Code

Ok

Warning

Error

0

1

2



33







17



18






19





20






21


5 Letrsquos BGPlay




22


5 Letrsquos BGPlay

23


Control timeline


Selection timeline



5 Letrsquos BGPlay

24

Examples





25





26



27

Prefix Count widget








28





29





30



_ httpsatlasripenet

31





32

State Result Code

Ok

Warning

Error

0

1

2



33





18






19





20






21


5 Letrsquos BGPlay




22


5 Letrsquos BGPlay

23


Control timeline


Selection timeline



5 Letrsquos BGPlay

24

Examples





25





26



27

Prefix Count widget








28





29





30



_ httpsatlasripenet

31





32

State Result Code

Ok

Warning

Error

0

1

2



33





19





20






21


5 Letrsquos BGPlay




22


5 Letrsquos BGPlay

23


Control timeline


Selection timeline



5 Letrsquos BGPlay

24

Examples





25





26



27

Prefix Count widget








28





29





30



_ httpsatlasripenet

31





32

State Result Code

Ok

Warning

Error

0

1

2



33





20






21


5 Letrsquos BGPlay




22


5 Letrsquos BGPlay

23


Control timeline


Selection timeline



5 Letrsquos BGPlay

24

Examples





25





26



27

Prefix Count widget








28





29





30



_ httpsatlasripenet

31





32

State Result Code

Ok

Warning

Error

0

1

2



33







21


5 Letrsquos BGPlay




22


5 Letrsquos BGPlay

23


Control timeline


Selection timeline



5 Letrsquos BGPlay

24

Examples





25





26



27

Prefix Count widget








28





29





30



_ httpsatlasripenet

31





32

State Result Code

Ok

Warning

Error

0

1

2



33




5 Letrsquos BGPlay




22


5 Letrsquos BGPlay

23


Control timeline


Selection timeline



5 Letrsquos BGPlay

24

Examples





25





26



27

Prefix Count widget








28





29





30



_ httpsatlasripenet

31





32

State Result Code

Ok

Warning

Error

0

1

2



33




5 Letrsquos BGPlay

23


Control timeline


Selection timeline



5 Letrsquos BGPlay

24

Examples





25





26



27

Prefix Count widget








28





29





30



_ httpsatlasripenet

31





32

State Result Code

Ok

Warning

Error

0

1

2



33




5 Letrsquos BGPlay

24

Examples





25





26



27

Prefix Count widget








28





29





30



_ httpsatlasripenet

31





32

State Result Code

Ok

Warning

Error

0

1

2



33






25





26



27

Prefix Count widget








28





29





30



_ httpsatlasripenet

31





32

State Result Code

Ok

Warning

Error

0

1

2



33







26



27

Prefix Count widget








28





29





30



_ httpsatlasripenet

31





32

State Result Code

Ok

Warning

Error

0

1

2



33





27

Prefix Count widget








28





29





30



_ httpsatlasripenet

31





32

State Result Code

Ok

Warning

Error

0

1

2



33








28





29





30



_ httpsatlasripenet

31





32

State Result Code

Ok

Warning

Error

0

1

2



33







29





30



_ httpsatlasripenet

31





32

State Result Code

Ok

Warning

Error

0

1

2



33







30



_ httpsatlasripenet

31





32

State Result Code

Ok

Warning

Error

0

1

2



33





_ httpsatlasripenet

31





32

State Result Code

Ok

Warning

Error

0

1

2



33







32

State Result Code

Ok

Warning

Error

0

1

2



33





33



tutorial: using ripestat - ripe network coordination centre · 2018-08-17 · ripe ripestat, menog...

Documents