1
0
mirror of https://github.com/Luzifer/promcertcheck.git synced 2024-09-19 09:22:57 +00:00
promcertcheck/README.md
Knut Ahlers 0642ebfe7a
Update meta files
Signed-off-by: Knut Ahlers <knut@ahlers.me>
2017-06-26 15:27:56 +02:00

1.5 KiB

Luzifer / PromCertcheck

This project contains a small monitoring tool to check URLs for their certificate validity. The URLs are polled once per hour and the certificates from that URLs are validated against the root certificates available to the program. (Provided by the operating systems distributor or manually set by you if you're using a docker container.)

Features

  • Validates the certification chain including provided intermediate certificates
  • Warns before the certificates expires
  • Gives a handy overview over all monitored URLs
  • Data is made available in Prometheus readable format for monitoring

Usage

# ./certcheck --help
Usage of ./certcheck:
      --debug[=false]: Output debugging data
      --expire-warning="744h": When to warn about a soon expiring certificate
      --probe=[]: URLs to check for certificate issues

# ./certcheck --probe=https://www.google.com/ --probe=https://www.facebook.com/
PromCertcheck dev...
Starting to listen on 0.0.0.0:3000

URLs

Endpoint Description
/ Shows you a human readable version of the check data
/httpStatus Endpoint for simple automated health checks: Delivers HTTP200 in case everything is fine or HTTP500 when one or more certificates are broken
/metrics Prometheus compatible output of the check data
/results.json Gives you a JSON version of the check results including certificate details