summaryrefslogtreecommitdiffstats
path: root/src/collectors/timex.plugin/metadata.yaml
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