Files
windows_exporter/docs/runbooks/windowsclocknotsynchronising.md
T
Jan-Otto Kröpke f8f2a71d77 mixin: remove enableActiveDirectory and enableTime
collectors.ad and collectors.time are the only switches for the Active
Directory and clock alerts, like every other opt-in collector. Setting
the removed keys fails the build with a message naming the replacement.

Signed-off-by: Jan-Otto Kröpke <mail@jkroepke.de>
2026-10-17 07:27:15 +00:00

1.6 KiB

title
title
WindowsClockNotSynchronising

Meaning

Windows Time reports no active NTP time source for ten minutes. This alert is generated only with collectors+: { time: true } and requires the time collector and its ntp subcollector. Enable it on hosts expected to synchronize through NTP; hosts intentionally using another clock source may legitimately report zero.

Impact

The clock can drift without a working time source. Clock errors can affect Kerberos authentication, TLS validation, scheduled work, and event timestamps.

Diagnosis

  1. Inspect windows_time_ntp_client_time_sources and the exporter collector success metric. Missing metrics indicate a different problem than a zero value.

  2. On the affected host, inspect Windows Time:

    Get-Service W32Time
    w32tm /query /status
    w32tm /query /source
    w32tm /query /peers
    w32tm /query /configuration
    
  3. Check the Windows Time-Service event log, source DNS resolution, and network access to the source over UDP port 123.

  4. For domain members, inspect the domain time hierarchy and the PDC emulator's upstream source. For virtual machines, check hypervisor time integration.

Mitigation

Restore the expected Windows Time service, configured source, and UDP reachability. Respect domain policy; configure external peers on the appropriate authoritative server rather than overriding every domain member. After correcting the cause, request rediscovery with w32tm /resync /rediscover and verify a valid source and successful synchronization. Follow WindowsClockSkewDetected if a significant offset remains.