Go to file

Alexander "PapaTutuWawa 32517b4e41 All checks were successful ci/woodpecker/push/woodpecker Pipeline was successful Details fix: I forgot to start the scheduler...		2024-01-08 22:53:01 +01:00
.gitignore	Initial commit	2024-01-07 14:46:05 +01:00
.woodpecker.yml	feat: Add CI	2024-01-07 17:05:57 +01:00
go.mod	feat: Lower the required go version	2024-01-07 15:19:53 +01:00
go.sum	Initial commit	2024-01-07 14:46:05 +01:00
LICENSE	Initial commit	2024-01-07 14:46:05 +01:00
main.go	fix: I forgot to start the scheduler...	2024-01-08 22:53:01 +01:00
README.md	feat: Update README	2024-01-07 17:16:16 +01:00

README.md

cert-status-exporter

A Prometheus exporter that checks the expiry and validity of configured domains once a day.

Usage

To export certificate status metrics, run cert-status-exporter --domain <domain>:<port>:<alpn>[:<name>]. The format means: "Connect to <domain> on port <port> while advertising <alpn> as ALPN during the TLS negotiations. If <name> is specified, then the metric will be labeled as <name>, instead of <domain>. <alpn> is a semi-colon separated list of ALPN protocols.

By default, cert-status-exporter will bind to 0.0.0.0:8888 and expose the metrics at 0.0.0.0:8888/metrics. To change the binding address, you can specify --host and --port to change how cert-status-exporter binds the socket.

Example

cert-status-exporter --host 127.0.0.1 --port 8383 --domain "gnu.org:443:http/1.1;http/1.0;http/0.9": Check the certificate of gnu.org:443, while presenting the HTTP ALPN protocol names during the TLS negotiation. The metrics are exported with the label name equal to gnu.org.
cert-status-exporter --domain "example.org:5223:xmpp-client:xmpp": Check the certificate of example.org:5223, while presenting xmpp-client as the ALPN protocol during the TLS negotiation. Moreover, export the certificate state with the label name equal to xmpp.

License

See LICENSE.