Skip to content
Find out closest hosts in terms of network latency and performance
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.github/ISSUE_TEMPLATE Update issue templates May 12, 2019
cmd * fix for durationSlice May 17, 2019
loaders
protocols * fix for durationSlice May 17, 2019
.gitignore Initial commit Apr 10, 2019
.travis.yml
LICENSE
README.md Update README.md May 18, 2019
dnsresolvers.txt
hosts.txt
main.go

README.md

get-closer

GoDoc Build Status Go Report Card Maintainability codecov License: GPL v3

Overview

get-closer helps you to find out closest hosts in terms of network latency or application performance.

Warning: project is under heavy development, feel free to open an issue

Motivation

Network services are very sensitive to latency degradation. In era of cloud computing we can get the same services from different providers that will have different locations, so network distance will differs too.
Choosing an optimal performing endpoint is vital part of optimization.
We wanted an easy way to compare different endpoints in case of network latency or application performance.

Install

go get -u github.com/akme/get-closer

How to use

Find out closest hosts in terms of network latency.

Usage:
  get-closer [command]

Available Commands:
  dns         Measuring domain resolve time via DNS resolver
  help        Help about any command
  http        Measuring time for HTTP request.
  icmp        Measuring RTT for hosts from list.
  tcp         Measuring time for connecting to open TCP port.

Flags:
  -c, --concurrency uint      concurrency (default 1)
      --config string         config file (default: ~/.get-closer.yaml)
      --count int             number of tests per host (default 1)
  -d, --delay int             set delay between checks (default 3)
  -r, --dns-resolver string   use custom DNS resolver
  -w, --dns-warm-up           warm up DNS cache before request (default true)
  -f, --from-file string      path to file with hosts to check
  -h, --help                  help for get-closer
  -l, --limit uint            number of hosts to return
  -b, --progress-bar          show progress bar (default true)
  -t, --timeout uint          timeout for request (default 60)
  -v, --verbose               enable verbose mode

Use "get-closer [command] --help" for more information about a command.

Examples

This repo contains hosts.txt and dnsresolvers.txt as an example of hosts file that you can use for test runs.

ICMP

On Linux, you need to enable "unprivileged" mode:

sudo sysctl -w net.ipv4.ping_group_range="0   2147483647"
get closer ping -f hosts.txt

TCP

get closer tcp -f hosts.txt

HTTP

get-closer http -f hosts.txt

DNS

get-closer dns -f hosts.txt

Publications

Contributing

When contributing to this repository, please first discuss the change you wish to make via issue, email, or any other method with the owners of this repository before making a change.

Versioning

We use SemVer for versioning. For the versions available, see the tags on this repository.

License

GNU General Public License v3.0

You can’t perform that action at this time.