Skip to main content

Time

Time Collector​

To collect information about the system clock, you can use the time collector.

Parameters​

None.

Example Collector Definition​

apiVersion: troubleshoot.sh/v1beta2
kind: SupportBundle
metadata:
  name: time
spec:
  hostCollectors:
    - time: {}

Included Resources​

The results of the time collector are stored in the host-collectors/system directory of the support bundle.

time.json​

Example of the resulting JSON file:

{"timezone":"UTC","ntp_synchronized":true,"ntp_active":true}

Time Analyzer​

The time analyzer supports multiple outcomes, by checking either the ntp status or the timezone. For example:

  • ntp == unsynchronized+inactive: System clock is not synchronized.
  • ntp == unsynchronized+active: System clock not yet synchronized.
  • ntp == synchronized+active: System clock is synchronized.
  • timezone != UTC: Timezone is not set to UTC.
  • timezone == UTC: Timezone is set to UTC.

Example Analyzer Definition​

apiVersion: troubleshoot.sh/v1beta2
kind: SupportBundle
metadata:
  name: time
spec:
  hostCollectors:
    - time: {}
  hostAnalyzers:
    - time:
        checkName: "NTP Status"
        outcomes:
            - fail:
                when: "ntp == unsynchronized+inactive"
                message: "System clock is not synchronized"
            - warn:
                when: "ntp == unsynchronized+active"
                message: System clock not yet synchronized                
            - pass:
                when: "ntp == synchronized+active"
                message: "System clock is synchronized"
            - warn: 
                when: "timezone != UTC"
                message: "Non UTC timezone can interfere with system function"
            - pass:
                when: "timezone == UTC"
                message: "Timezone is set to UTC"