Skip to content

robert-kisteleki/goat

Repository files navigation

goat - Go (RIPE) Atlas Tools - CLI & API Wrapper

goat is a Go package to interact with RIPE Atlas APIs using Golang. It also provides a CLI interface to most of the APIs. It is similar to Cousteau, Sagan and Magellan combined.

It supports:

  • finding probes, anchors and measurements
  • scheduling new measurements and immediately show their results
  • stopping existing measurements
  • modify participants of an existing measurement (add/remove probes)
  • downloading results of measurements and turning them into Go objects, or displaying them
  • tuning in to result streaming and turning them into Go objects
  • loading a local file containing measurement results and turning them into Go objects
  • various kinds of output formatters for displaying and aggregating measurement results

The tool needs Go 1.21 to compile.

Context

RIPE Atlas is an open, community based active Internet measurement network developed by the RIPE NCC since 2010. It provides a number of vantage points ("probes") run by volunteers, that allow various kinds of network measurements (pings, traceroutes, DNS queries, ...) to be run by any user.

Quick Start

Check the API Wrapper Quick Start Guide and the CLI Quick Start Guide.

Future Additions / TODO

  • check credit balance, transfer credits, ...

Copyright, Contributing

(C) 2022, 2023 Robert Kisteleki & RIPE NCC

Contribution is possible and encouraged via the Github repo

License

See the LICENSE file