Quickstart¶
This is a very fast break down of everything you need to start using Ripe Atlas on the command line. Viewing public data is quick & easy, while creation is a little more complicated, since you need to setup your authorisation key.
Viewing Public Data¶
- Install the toolkit.
- View help with:
ripe-atlas --help - View a basic report for a public measurement:
ripe-atlas report <measurement_id> - View the live stream for a measurement:
ripe-atlas stream <measurement_id> - Get a list of probes in ASN 3333:
ripe-atlas probe-search --asn 3333 - Get a list of measurements with the word “wikipedia” in them:
ripe-atlas measurement-search --search wikipedia
Creating a Measurement¶
- Log into RIPE Atlas. If you don’t have an account, you can create one there for free.
- Visit the API Keys page and create a new key
with the permission
Create a new user defined measurement - Install the toolkit as below.
- Configure the toolkit to use your key with
ripe-atlas configure --set authorisation.create=MY_API_KEY - View the help for measurement creation with
ripe-atlas measure --help - Create a measurement with
ripe-atlas measure ping --target example.com
Advanced Use¶
Refer to the complete usage documentation for more advanced options.