The official command line client for RIPE Atlas
Project description
RIPE Atlas Tools (Magellan)
The official command-line client for RIPE Atlas.
Full Documentation
Everything is up on ReadTheDocs
How Does it Work?
Presently, the setup is pretty crude. You can create a ping or traceroute measurement with limited options from the command line:
$ ripe-atlas measure ping --target example.com
$ ripe-atlas measure ping --packets 7 --size 42 --target example.com
$ ripe-atlas measure traceroute --target example.com
$ ripe-atlas measure traceroute --packets 2 --target example.com
$ ripe-atlas measure dns --query-argument example.com
$ ripe-atlas measure dns --use-probe-resolver --query-type AAAA --query-argument example.comThis will create a one-off measurement and then wait for the results to roll in, formatting them as they do.
You can also use it to connect to a stream of formatted data. This command will start streaming out all of the results from one of our oldest measurements:
$ ripe-atlas stream 1001Or you can generate a simple report:
$ ripe-atlas report 1001Configuration is done by way of a config file, and modifying it can be done from the command line:
$ ripe-atlas configure --set authorisation.create=MY_API_KEYCan I Contribute?
Absolutely. Please read our guide on how to contribute.
Colophon
This project was code-named by means of a poll. In order to conform to the RIPE Atlas theme, it had to be named for an explorer, and so the winning suggestion was for Magellan, “in memory of those times when RTT was ~3 years”.
Release History
1.2.3 (released 2016-03-08)
Changes
Usage of newest Cousteau/Sagan library.
Support of API keys for fetching results on report command.
Default radius for probes filtering is changed to 15.
Several changes for supporting Windows.
1.2.2 (released 2016-01-13)
New Features
Cleaner and more consistent implementation of the renderer plugable architecture.
Usage of newest Cousteau library.
1.2.1 (released 2015-12-15)
Bug Fixes
Restored some required template files.
1.2.0 (released 2015-12-15)
Output Changes
1.1.1 (released 2015-11-25)
Output Changes
#103: Removed header from the report command.
Bug Fixes
#105: Measurement report and stream broken on Python3.4.
1.1.0 (released 2015-11-12)
New features
Support for the creation of NTP, SSLCert, and HTTP measurements.
Additional argument in report command to filter results by probe ASN.
Additional renderer that shows the different destination ASNs and some additional stats about them.
Bug Fixes
Various fixes.
Changes
Better testing.
Additional documentation.
1.0.0 (released 2015-11-02)
Initial release.
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
File details
Details for the file ripe.atlas.tools-1.2.3.tar.gz.
File metadata
- Download URL: ripe.atlas.tools-1.2.3.tar.gz
- Upload date:
- Size: 86.4 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | fa93796623789fbcc2ed651297a704da4d3239b5eed13d637ba1361efccecc1c |
|
| MD5 | d6425e9f0a0c33bd7aafd20953098378 |
|
| BLAKE2b-256 | a3d22e4b428f8acc10ddea597be151e259f30bbd980ee60094338d4efb20ed49 |
File details
Details for the file ripe.atlas.tools-1.2.3-py2.py3-none-any.whl.
File metadata
- Download URL: ripe.atlas.tools-1.2.3-py2.py3-none-any.whl
- Upload date:
- Size: 89.5 kB
- Tags: Python 2, Python 3
- Uploaded using Trusted Publishing? No
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 5f344705d8c96d45b7b8884c180f28fc62f7cf403d79345f77f123dc9682f4c1 |
|
| MD5 | 38d5457215d6e6aafcf647274e2bd52c |
|
| BLAKE2b-256 | 2eb67df0f8076edc78b3c6f999820a3825968af2d651501fce97bb79f33c33c5 |
