go-url

Go-url is an tool to make HTTP requests on command line.

The big differencial are:

• make the request for each IP of the DNS endpoint
• read config from a file, it could schedulle the tests on an docker, for example

Install

from source code

• clone this repo
• create the config file, see sample config
• run the code without build go run *.go -config hack/config-sample.json

install from latest version

• clone this repo
• make build
• see binary on bin/ dir

Usage

-config

Read URLs tests from config:

go run *.go -config hack/config-sample.json

sample stdout

-dns

Force to resolve DNS and test on each IP address endpoint

go run *.go -config hack/config-sample.json -dns

sample stdout

-url

Read url from option -url

go run *.go -url https://www.google.com

sample stdout

-header

Supporting header option

go-url -dns -watch-period 20 -watch-interval 2 -header "user-agent=eu" https://www.google.com

or more advanced in config (url item):

    {
      "url": "https://www.google.com/",
      "headers": {
        "user-agent": "gurl"
      }
    },

-watch-*

Add a option to watch requests (repeat requests):

go-url -dns -watch-period 20 -watch-interval 2 https://www.google.com

Argument

Read url from argument (argv[1])

./bin/go-url https://www.google.com

sample stdout

Docker

Run with multiple options:

• -dns and -config

docker run \
    -v $PWD/hack/config-sample.json:/config.json \
    -i mtulio/go-url:docker \
    -dns -config /config.json

• argument

docker run \
    -v $PWD/hack/config-sample.json:/config.json \
    -i mtulio/go-url:docker https://g1.globo.com

sample stdout

Metrics

• create local metrics stack (Prometheus + Pushgateway)

make test-run-metrics-stack

• send metrics to pushgateway using opt -metric

HOSTNAME=MyNode go run *.go \
    -dns \
    -url=http://www.google.com \
    -metric=http://localhost:9091

sample stdout

• look at the metric on the Pushgateway

Contributing

1. Fork it
2. Create your feature branch (git checkout -b my-new-feature)
3. Commit your changes (git commit -am 'Added some feature')
4. Push to the branch (git push origin my-new-feature)
5. Create new Pull Request

Open an Issue or PR. =]