Go to file
Alexander "PapaTutuWawa 32517b4e41
All checks were successful
ci/woodpecker/push/woodpecker Pipeline was successful
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

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.