blob: fc11f2d92f23945dfde7d630be392214d535bc0a (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
|
plugin_name: timex.plugin
modules:
- meta:
plugin_name: timex.plugin
module_name: timex.plugin
monitored_instance:
name: Timex
link: ""
categories:
- data-collection.system-clock-and-ntp
icon_filename: "syslog.png"
related_resources:
integrations:
list: []
info_provided_to_referring_integrations:
description: ""
keywords: []
most_popular: false
overview:
data_collection:
metrics_description: "Examine Timex metrics to gain insights into system clock operations. Study time sync status, clock drift, and adjustments to ensure accurate system timekeeping."
method_description: "It uses system call adjtimex on Linux and ntp_adjtime on FreeBSD or Mac to monitor the system kernel clock synchronization state."
supported_platforms:
include: []
exclude: []
multi_instance: true
additional_permissions:
description: ""
default_behavior:
auto_detection:
description: ""
limits:
description: ""
performance_impact:
description: ""
setup:
prerequisites:
list: []
configuration:
file:
name: "netdata.conf"
section_name: "[plugin:timex]"
description: "The netdata main configuration file."
options:
description: "At least one option ('clock synchronization state', 'time offset') needs to be enabled for this collector to run."
folding:
title: "Config options"
enabled: true
list:
- name: update every
description: Data collection frequency.
default_value: 1
required: false
- name: clock synchronization state
description: Make chart showing system clock synchronization state.
default_value: yes
required: true
- name: time offset
description: Make chart showing computed time offset between local system and reference clock
default_value: yes
required: true
examples:
folding:
enabled: true
title: "Config"
list:
- name: Basic
description: A basic configuration example.
config: |
[plugin:timex]
update every = 1
clock synchronization state = yes
time offset = yes
troubleshooting:
problems:
list: []
alerts:
- name: system_clock_sync_state
link: https://github.com/netdata/netdata/blob/master/src/health/health.d/timex.conf
metric: system.clock_sync_state
info: when set to 0, the system kernel believes the system clock is not properly synchronized to a reliable server
os: "linux"
metrics:
folding:
title: Metrics
enabled: false
description: ""
availability: []
scopes:
- name: global
description: "These metrics refer to the entire monitored application."
labels: []
metrics:
- name: system.clock_sync_state
description: System Clock Synchronization State
unit: "state"
chart_type: line
dimensions:
- name: state
- name: system.clock_status
description: System Clock Status
unit: "status"
chart_type: line
dimensions:
- name: unsync
- name: clockerr
- name: system.clock_sync_offset
description: Computed Time Offset Between Local System and Reference Clock
unit: "milliseconds"
chart_type: line
dimensions:
- name: offset
|
