Skip to content
New issue

Have a question about this project? # for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “#”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? # to your account

Document difference between TLS Cert expiry metrics #1330

Open
wants to merge 1 commit into
base: master
Choose a base branch
from

Conversation

slrtbtfs
Copy link

@slrtbtfs slrtbtfs commented Dec 3, 2024

blackbox-exporter currently offers two metrics to
measure when TLS Certificates will expire.

The difference between those is very subtle, but
using probe_ssl_earliest_cert_expiry
for checking whether a certificate is due to
replacement can lead to false positive alerts.

This documents the difference between those two.

Generally, probe_ssl_last_chain_expiry_timestamp_seconds
seems to be what most people would want to use.

@slrtbtfs slrtbtfs force-pushed the document_ssl_expiry branch from 4084f63 to fece8bc Compare December 3, 2024 12:45
@slrtbtfs
Copy link
Author

slrtbtfs commented Dec 3, 2024

Hm, the CircleCI Tests seem to be failing for reasons unrelated to this PR:

level=error msg="Resolution with IP protocol failed" target=ipv6.google.com ip_protocol=ip4 err="lookup ipv6.google.com on 10.89.4.1:53: no such host"

Looks like the CI Test environment is having some network Issues.

Locally, the tests run fine.

blackbox-exporter currently offers two metrics to
measure when TLS Certificates will expire.

The difference between them is very subtle, but
using `probe_ssl_earliest_cert_expiry`
for checking whether a certificate is due to
replacement can lead to false positive alerts.

This documents the difference between those two.

Generally `probe_ssl_last_chain_expiry_timestamp_seconds`
seems to be what most people would want to use.

Signed-off-by: Tobias Guggenmos <guggenmos@dfn-cert.de>
@slrtbtfs slrtbtfs force-pushed the document_ssl_expiry branch from 82bb799 to 3443a24 Compare February 25, 2025 08:54
@slrtbtfs
Copy link
Author

CI is passing now after a rebase, so this PR is ready.

# for free to join this conversation on GitHub. Already have an account? # to comment
Labels
Projects
None yet
Development

Successfully merging this pull request may close these issues.

1 participant