Skip to content

Conversation

longxiucai
Copy link

Introduces a new gauge metric x509_cert_san to expose Subject Alternative Names (SANs) from X.509 certificates, with detailed metadata labels for enhanced monitoring and troubleshooting.

Key features:

  • Tracks both DNS names and IP addresses via SAN_type label ("dns" or "address")
  • Includes SAN_value label to store the actual DNS/IP entry
  • Adds base labels:filename,filepath,issuer_CN,subject_CN,serial_number, etc.

Example metric output:

# HELP x509_cert_san Indicates the Subject Alternative Names (DNS or IP) present in the certificate
# TYPE x509_cert_san gauge
x509_cert_san{SAN_type="address",SAN_value="10.103.97.2",filename="apiserver.crt",filepath="/file/go/src/test/apiserver.crt",issuer_CN="kubernetes",serial_number="8451564427851205067",subject_CN="kube-apiserver"} 1
...
x509_cert_san{SAN_type="address",SAN_value="10.77.0.1",filename="apiserver.crt",filepath="/file/go/src/test/apiserver.crt",issuer_CN="kubernetes",serial_number="8451564427851205067",subject_CN="kube-apiserver"} 1
x509_cert_san{SAN_type="address",SAN_value="127.0.0.1",filename="apiserver.crt",filepath="/file/go/src/test/apiserver.crt",issuer_CN="kubernetes",serial_number="8451564427851205067",subject_CN="kube-apiserver"} 1
...
x509_cert_san{SAN_type="dns",SAN_value="kubernetes.default.svc.cluster.local",filename="apiserver.crt",filepath="/file/go/src/test/apiserver.crt",issuer_CN="kubernetes",serial_number="8451564427851205067",subject_CN="kube-apiserver"} 1
x509_cert_san{SAN_type="dns",SAN_value="localhost",filename="apiserver.crt",filepath="/file/go/src/test/apiserver.crt",issuer_CN="kubernetes",serial_number="8451564427851205067",subject_CN="kube-apiserver"} 1
x509_cert_san{SAN_type="dns",SAN_value="node1",filename="apiserver.crt",filepath="/file/go/src/test/apiserver.crt",issuer_CN="kubernetes",serial_number="8451564427851205067",subject_CN="kube-apiserver"} 1

This implementation enables granular filtering of SAN entries (e.g., finding all certificates with a specific DNS name) while preserving full certificate context for cross-referencing with existing metrics.

@longxiucai longxiucai closed this Aug 20, 2025
@longxiucai longxiucai deleted the support-san branch August 20, 2025 08:00
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

1 participant