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"

Collect and analyze information about the system clock.