Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/mtulio/go-url
go-url is a cool URL tester that discovers all endpoints (IP address) and makes HTTP/S requests to each. It also can push metrics to the Pushgateway.
https://github.com/mtulio/go-url
Last synced: 8 days ago
JSON representation
go-url is a cool URL tester that discovers all endpoints (IP address) and makes HTTP/S requests to each. It also can push metrics to the Pushgateway.
- Host: GitHub
- URL: https://github.com/mtulio/go-url
- Owner: mtulio
- License: apache-2.0
- Created: 2018-09-30T20:05:08.000Z (about 6 years ago)
- Default Branch: master
- Last Pushed: 2022-01-12T05:01:29.000Z (almost 3 years ago)
- Last Synced: 2024-06-19T20:51:04.495Z (5 months ago)
- Language: Go
- Homepage:
- Size: 73.2 KB
- Stars: 5
- Watchers: 4
- Forks: 0
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# 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](./hack/config-sample.json)
* 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](./samples-stdout.md#Option---config)***
### `-dns`
Force to resolve DNS and test on each IP address endpoint
`go run *.go -config hack/config-sample.json -dns`
***[sample stdout](./samples-stdout.md#Option--dns)***
### `-url`
Read url from option `-url`
`go run *.go -url https://www.google.com`
***[sample stdout](./samples-stdout.md#Option--url)***
### `-header`
Supporting header option
```bash
go-url -dns -watch-period 20 -watch-interval 2 -header "user-agent=eu" https://www.google.com
```
or more advanced in config (url item):
```json
{
"url": "https://www.google.com/",
"headers": {
"user-agent": "gurl"
}
},
```
### `-watch-*`
Add a option to watch requests (repeat requests):
```bash
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](./samples-stdout.md#Argument)***
### Docker
Run with multiple options:
* `-dns` and `-config`
```bash
docker run \
-v $PWD/hack/config-sample.json:/config.json \
-i mtulio/go-url:docker \
-dns -config /config.json
```
* argument
```bash
docker run \
-v $PWD/hack/config-sample.json:/config.json \
-i mtulio/go-url:docker https://g1.globo.com
```
***[sample stdout](./samples-stdout.md#Docker)***
### Metrics
* create local metrics stack (Prometheus + Pushgateway)
`make test-run-metrics-stack`
* send metrics to pushgateway using opt `-metric`
```bash
HOSTNAME=MyNode go run *.go \
-dns \
-url=http://www.google.com \
-metric=http://localhost:9091
```
***[sample stdout](./samples-stdout.md#metrics)***
* look at the metric on the Pushgateway
## Contributing
1. Fork it
1. Create your feature branch (git checkout -b my-new-feature)
1. Commit your changes (git commit -am 'Added some feature')
1. Push to the branch (git push origin my-new-feature)
1. Create new Pull Request
Open an Issue or PR. =]