~cypheon/ecertmon

ref: bbeef54bf90f2c42cc9523a8eb67df7eb4d700c8 ecertmon/README.md -rw-r--r-- 1.2 KiB
bbeef54b — Johann Rudloff Add initial documentation 2 years ago

#ecertmon

Tiny blackbox certificate expiry date exporter for Prometheus written in Erlang.

You configure which hosts should be scanned:

{targets, [
           {"elfelli.sinyax.net", 443},
           {"neo.sinyax.net", 443},
           {"git.sinyax.net", 443}
          ]
}

And ecertmon will export one metric for each configured target presenting the expiration date of the certificate (in Unix epoch seconds):

$ curl http://127.0.0.1:9101/metrics
tls_cert_expiry{hostname="elfelli.sinyax.net", port="443"} 1613347516
tls_cert_expiry{hostname="neo.sinyax.net", port="443"} 1613347549
tls_cert_expiry{hostname="git.sinyax.net", port="443"} 1611533202

#Build

If you're on macOS, use gmake instead of make in all following steps.

# Build the project
# (run from inside the source root directory)

make deps
make app

#Configure

The config file is in config/sys.config under the key certmon. The config settings have quite descriptive names and should be self-explanatory.

#Run (from Source)

# Run the project
# (run from inside the source root directory)

make run

#Run (from Release)

TODO: Publish releases and document how to use them