chrony

README

Chrony collector

chrony is a versatile implementation of the Network Time Protocol (NTP).

This module monitors the system's clock performance and peers activity status using Chrony communication protocol v6.

Metrics

All metrics have "chrony." prefix.

Metric	Scope	Dimensions	Units
stratum	global	stratum	level
current_correction	global	current_correction	seconds
root_delay	global	root_delay	seconds
root_dispersion	global	root_dispersion	seconds
last_offset	global	offset	seconds
rms_offset	global	offset	seconds
frequency	global	frequency	ppm
residual_frequency	global	residual_frequency	ppm
skew	global	skew	frequency
update_interval	global	update_interval	seconds
ref_measurement_time	global	ref_measurement_time	seconds
leap_status	global	normal, insert_second, delete_second, unsynchronised	status
activity	global	online, offline, burst_online, burst_offline, unresolved	sources

Configuration

Edit the go.d/chrony.conf configuration file using edit-config from the Netdata config directory, which is typically at /etc/netdata.

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

Configuration example:

jobs:
  - name: local
    address: '127.0.0.1:323'
    timeout: 1

  - name: remote
    address: '203.0.113.0:323'
    timeout: 3

For all available options please see module configuration file.

---

Troubleshooting

To troubleshoot issues with the chrony collector, run the go.d.plugin with the debug option enabled. The output should give you clues as to why the collector isn't working.

• Navigate to the plugins.d directory, usually at /usr/libexec/netdata/plugins.d/. If that's not the case on your system, open netdata.conf and look for the plugins setting under [directories].

  cd /usr/libexec/netdata/plugins.d/
  

• Switch to the netdata user.

  sudo -u netdata -s
  

• Run the go.d.plugin to debug the collector:

  ./go.d.plugin -d -m chrony
  

Documentation

Index

• type Chrony
  • func New() *Chrony
  • func (c *Chrony) Charts() *module.Charts
  • func (c *Chrony) Check() bool
  • func (c *Chrony) Cleanup()
  • func (c *Chrony) Collect() map[string]int64
  • func (c *Chrony) Init() bool
• type Config

Types

type Chrony

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

func New

func New() *Chrony

func (*Chrony) Charts

func (c *Chrony) Charts() *module.Charts

func (*Chrony) Check

func (c *Chrony) Check() bool

func (*Chrony) Cleanup

func (c *Chrony) Cleanup()

func (*Chrony) Collect

func (c *Chrony) Collect() map[string]int64

func (*Chrony) Init

func (c *Chrony) Init() bool

type Config

type Config struct {
	Address string       `yaml:"address"`
	Timeout web.Duration `yaml:"timeout"`
}