x509_cert

README

X509 Cert Input Plugin

This plugin provides information about X509 certificate accessible via local file or network connection.

Configuration

# Reads metrics from a SSL certificate
[[inputs.x509_cert]]
  ## List certificate sources
  sources = ["/etc/ssl/certs/ssl-cert-snakeoil.pem", "https://example.org:443"]

  ## Timeout for SSL connection
  # timeout = "5s"

  ## Optional TLS Config
  # tls_ca = "/etc/telegraf/ca.pem"
  # tls_cert = "/etc/telegraf/cert.pem"
  # tls_key = "/etc/telegraf/key.pem"

  ## Use TLS but skip chain & host verification
  # insecure_skip_verify = false

Metrics

• x509_cert
  • tags:
    • source - source of the certificate
    • organization
    • organizational_unit
    • country
    • province
    • locality
  • fields:
    • expiry (int, seconds)
    • age (int, seconds)
    • startdate (int, seconds)
    • enddate (int, seconds)

Example output

x509_cert,host=myhost,source=https://example.org age=1753627i,expiry=5503972i,startdate=1516092060i,enddate=1523349660i 1517845687000000000
x509_cert,host=myhost,source=/etc/ssl/certs/ssl-cert-snakeoil.pem age=7522207i,expiry=308002732i,startdate=1510323480i,enddate=1825848420i 1517845687000000000

Documentation

Overview

Package x509_cert reports metrics from an SSL certificate.

Index

• type X509Cert
  • func (c *X509Cert) Description() string
  • func (c *X509Cert) Gather(acc telegraf.Accumulator) error
  • func (c *X509Cert) SampleConfig() string

Types

type X509Cert

type X509Cert struct {
	Sources []string          `toml:"sources"`
	Timeout internal.Duration `toml:"timeout"`
	_tls.ClientConfig
}

X509Cert holds the configuration of the plugin.

func (*X509Cert) Description

func (c *X509Cert) Description() string

Description returns description of the plugin.

func (*X509Cert) Gather

func (c *X509Cert) Gather(acc telegraf.Accumulator) error

Gather adds metrics into the accumulator.

func (*X509Cert) SampleConfig

func (c *X509Cert) SampleConfig() string

SampleConfig returns configuration sample for the plugin.