x509check

README

x509 certificate monitoring with Netdata

This module checks the time until a x509 certificate expiration and its revocation status.

Charts

It produces the following charts:

• Time Until Certificate Expiration in seconds
• Revocation Status in status

Configuration

Edit the go.d/x509check.conf configuration file using edit-config from the your agent's config directory, which is typically at /etc/netdata.

cd /etc/netdata # Replace this path with your Netdata config directory
sudo ./edit-config go.d/x509check.conf

Needs only source.

Use smtp scheme for smtp servers, file for files and https or tcp for others. Port is mandatory for all non-file schemes.

Here is an example for 3 sources:

update_every : 60

jobs:
  - name   : my_site_cert
    source : https://my_site.org:443
    
  - name   : my_file_cert
    source : file:///home/me/cert.pem

  - name   : my_smtp_cert
    source : smtp://smtp.my_mail.org:587

For all available options and defaults please see module configuration file.

Revocation status

Revocation status check is disabled by default. To enable it set check_revocation_status to yes.

jobs:
  - name: my_site_cert
    source: https://my_site.org:443
    check_revocation_status: yes

Troubleshooting

Check the module debug output. Run the following command as netdata user:

./go.d.plugin -d -m x509check

Documentation

Index

• type Charts
• type Config
• type Dims
• type Opts
• type Vars
• type X509Check
  • func New() *X509Check
  • func (x X509Check) Charts() *Charts
  • func (x *X509Check) Check() bool
  • func (X509Check) Cleanup()
  • func (x *X509Check) Collect() map[string]int64
  • func (x *X509Check) Init() bool

Types

type Charts

type Charts = module.Charts

type Config

type Config struct {
	Source            string
	Timeout           web.Duration
	tlscfg.TLSConfig  `yaml:",inline"`
	DaysUntilWarn     int64 `yaml:"days_until_expiration_warning"`
	DaysUntilCritical int64 `yaml:"days_until_expiration_critical"`
	CheckRevocation   bool  `yaml:"check_revocation_status"`
}

type Dims

type Dims = module.Dims

type Opts

type Opts = module.Opts

type Vars

type Vars = module.Vars

type X509Check

type X509Check struct {
	module.Base
	Config `yaml:",inline"`
	// contains filtered or unexported fields
}

func New

func New() *X509Check

func (X509Check) Charts

func (x X509Check) Charts() *Charts

func (*X509Check) Check

func (x *X509Check) Check() bool

func (X509Check) Cleanup

func (X509Check) Cleanup()

func (*X509Check) Collect

func (x *X509Check) Collect() map[string]int64

func (*X509Check) Init

func (x *X509Check) Init() bool