luzifer/webcheck
1
0
Fork 0
mirror of https://github.com/Luzifer/webcheck.git synced 2024-11-08 06:30:02 +00:00
Code Issues Releases Wiki Activity
webcheck is a CLI tool to check the health of a web page
12 commits 1 branch 5 tags 1.1 MiB
Go 86.7%
Shell 13%
Makefile 0.3%
Find a file
Knut Ahlers 9c88c0eeea
Be more verbose in README 
Signed-off-by: Knut Ahlers <knut@ahlers.me>
2018-07-23 16:32:32 +02:00
vendor Vendor dependencies 2018-07-23 14:54:12 +02:00
.gitignore Initial version 2018-07-23 14:51:32 +02:00
.repo-runner.yaml Add automated building 2018-07-23 14:52:34 +02:00
Gopkg.lock Vendor dependencies 2018-07-23 14:54:12 +02:00
Gopkg.toml Vendor dependencies 2018-07-23 14:54:12 +02:00
History.md prepare release v0.2.0 2018-07-23 16:21:22 +02:00
LICENSE Add meta files 2018-07-23 14:56:38 +02:00
main.go Rename default values for log directory 2018-07-23 16:20:57 +02:00
Makefile Add automated building 2018-07-23 14:52:34 +02:00
README.md Be more verbose in README 2018-07-23 16:32:32 +02:00

README.md

Go Report Card

Luzifer / webcheck

webcheck is a CLI tool to check the health of a web page. It was written because there are quite a lot of GUI tools or services to monitor websites but I did not find any tool to execute on the CLI to to an ad-hoc monitoring of a page. To fix this I wrote this tool.

webcheck is used to check:

  • HTTP status code 2xx
  • Regular expression match on the response body
  • Response within a certain timeout
  • Response times (only display, no checking)

If the request is marked as a FAIL all headers and the response body are written into a log file to be debugged manually. This can for example be helpful if your webserver delivers weird responses on certain requests and you are using webcheck to find them.

Installation

You either can download a pre-compiled binary for you system from the Releases section of this repository or if you do have a working Go environment you can just go get github.com/Luzifer/webcheck the tool.

Usage

$ webcheck --help
Usage of webcheck:
  -i, --interval duration        Check interval (default 1s)
  -l, --log-dir string           Directory to log non-matched requests to (default "/tmp/resp-log/")
      --log-retention duration   When to clean up file from log-dir (default 24h0m0s)
  -m, --match string             RegExp to match the response body against to validate it (default ".*")
      --no-log                   Disable response body logging
  -t, --timeout duration         Timeout for the request (default 30s)
  -u, --url string               URL to query
      --version                  Prints current version and exits

Example

$ webcheck -u https://bfa1c797.eu.ngrok.io/monitoring.txt -m healthy

[Mon, 23 Jul 2018 16:07:02 CEST] (OKAY) Status was 200 and text matched (13.331ms/14.229ms/115.599ms)
[Mon, 23 Jul 2018 16:07:16 CEST] (FAIL) Response body does not match regexp (13.314ms/14.229ms/15.316ms) (Resp: request-log/request827008143)
[Mon, 23 Jul 2018 16:07:21 CEST] (OKAY) Status was 200 and text matched (13.411ms/14.436ms/18.25ms)
[Mon, 23 Jul 2018 16:07:28 CEST] (FAIL) Status code was != 2xx: 404 (6.923ms/7.011ms/7.237ms) (Resp: request-log/request070057634)

$ cat request-log/request827008143
Accept-Ranges: bytes
Content-Length: 4
Content-Type: text/plain; charset=utf-8
Date: Mon, 23 Jul 2018 14:07:16 GMT
Last-Modified: Mon, 23 Jul 2018 14:07:15 GMT

foo