time-sync-diagnosis

Diagnose Linux time synchronization failures using chronyc, ntpq, and diagnostic scripts.

1|1|Updated Apr 25, 2026
One-click install
npx skills add https://github.com/linfordWu/owls --skill time-sync-diagnosis
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: time-sync-diagnosis
Source: https://github.com/linfordWu/owls/tree/main/skills/time-sync-diagnosis
Command: npx skills add https://github.com/linfordWu/owls --skill time-sync-diagnosis

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires chronyd, chronyc, ntpd, nc, mtr, traceroute, ss, getent, systemctl, and includes scripts (resource) components.

What problem does it solve?

Linux time synchronization issues can cause drift, failed jumps, and unstable service clocks. This skill provides a structured approach to diagnose Linux time-sync faults, including NTP/chrony misconfigurations, UDP 123 reachability problems, and clock source instability.

Core Features & Use Cases

  • Four-stage diagnostic workflow: information gathering, scenario deep-dives, cross-validation, and root-cause reporting.
  • Scenario-specific drills for control plane, management channel, network, kernel, and protocol layers, with deterministic scripts to reproduce findings.
  • Script-driven remediation and evidence collection to support rapid incident containment and long-term prevention.

Quick Start

Run sudo bash scripts/time_master_diag.sh to perform a full time-sync fault diagnosis and generate a report.

Frequently Asked Questions about time-sync-diagnosis

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I diagnose Linux time synchronization failures with chrony or ntpd?

Linux time synchronization failures are diagnosed by collecting system state, validating chrony or ntpd configurations, and testing UDP 123 reachability. A structured four-stage workflow uses chronyc and ntpq to perform scenario-specific drills for root-cause reporting.

What causes unstable clock sources and time drift on Linux hosts?

Unstable clock sources and time drift on Linux hosts are caused by NTP or chrony misconfigurations, network reachability problems on UDP 123, and kernel-level clock source instability. Cross-validation of system state and network paths identifies the specific failing layer.

How do I troubleshoot UDP 123 reachability for NTP time sync?

Troubleshooting UDP 123 reachability for NTP time sync involves validating network paths using traceroute and mtr alongside socket statistics. Script-driven drills check control plane and management channel connectivity to pinpoint source instability across local and cloud environments.

Does this time-sync diagnosis workflow work in cloud environments?

Yes, this time-sync diagnosis workflow works in cloud environments by validating chrony and ntpd state across local Linux hosts and cloud instances. It applies deterministic scripts to gather robust data and cross-validate clock sources regardless of deployment context.

What is the best way to automate root-cause analysis for chrony time sync issues?

Automating root-cause analysis for chrony time sync issues is best achieved through a four-stage diagnostic workflow. Script-driven remediation collects evidence using chronyc and system tools, applying deterministic steps for rapid incident containment and long-term prevention.

Why does chrony show source instability despite a reachable NTP server?

Chrony shows source instability despite a reachable NTP server due to kernel clock source issues or protocol layer discrepancies. Cross-validating network reachability with system state and chronyc outputs isolates whether the fault is network, kernel, or protocol related.