chrony

package

v0.46.0 Latest Latest Go to latest Published: Dec 9, 2022 License: GPL-3.0 Imports: 7 Imported by: 1

Details

Valid go.mod file
Redistributable license
Tagged version
Stable version
Learn more about best practices

Repository

github.com/netdata/go.d.plugin

Links

Open Source Insights

README ¶

Chrony monitoring with Netdata

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 ¶

Constants ¶

This section is empty.

Variables ¶

This section is empty.

Functions ¶

This section is empty.

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"`
}

Source Files ¶

View all Source files

?	: This menu
/	: Search site
f or F	: Jump to
y or Y	: Canonical URL