All scripts
fault
Advanced
2–6 min

NTP / PTP Time Sync Auditor

Clock plane integrity: NTP stratum/offset/jitter audit, PTP master/slave state, BMCA winner verification, holdover detection, asymmetric path delay, and grandmaster failover validation.

Cisco IOS/XE/XR
Juniper
Arista
Nokia SR-OS
Open in GeneratorOpen in Platform
You're viewing a preview

The full script, parameters, and execution console are available with a free account.

Already have access? Sign in →

Capabilities

  • NTP stratum drift
  • Offset/jitter outliers
  • Peer reachability bitmap
  • PTP port state matrix
  • BMCA winner audit
  • Asymmetry detection
  • Holdover/free-run flag
  • Grandmaster failover test

Required inputs

Parameters the script accepts. Defaults shown; some are vendor- or context-gated.

ParameterTypeDefaultNotes
Max NTP offset (ms)
max_offset_ms
number50
Max NTP jitter (ms)
max_jitter_ms
number10
Min acceptable stratum
min_stratum
number4
Verify PTP plane
check_ptp
booltrue
Expected PTP grandmaster
expected_gm
string00:1B:19:FF:FE:00:00:01
PTP grandmaster only relevant when PTP verification is enabled.

Hint 1Name your vendors and OS versions

Mention the exact platforms you run (Cisco IOS/XE/XR, Juniper, Arista, …) so the generated fault logic uses the right CLI/NETCONF syntax.

Hint 2State your real thresholds

Provide concrete values for Max NTP offset (ms), Max NTP jitter (ms), Min acceptable stratum instead of the defaults — they shape what counts as a fault.

Hint 3Prioritize the checks you need

This tool can nTP stratum drift and offset/jitter outliers. Ask for the subset relevant to your incident to keep output focused.

Hint 4Describe your inventory format

Tell the assistant whether your device list is CSV, YAML, or JSON and which columns it has, so parsing matches your data.

Sample inventory schema

Authoritative shape of the device/policy data this script consumes.

No bundled inventory sample. The script accepts standard device lists (CSV/YAML) with hostname, mgmt IP, vendor, and credentials.

Expected output

Reference terminal output the script should produce — used as a stylistic and structural target.

terminal
TIME SYNC AUDIT — 47 devices
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

NTP PEERS:
  Device         Peer            St  Offset(ms)  Jitter(ms)  Reach
  core-rtr-01    10.0.0.1        2     0.412       0.187     377  ✓
  core-rtr-01    10.0.0.2        2     0.398       0.201     377  ✓
  core-rtr-02    10.0.0.1        2    47.220       1.412     377  ⚠ near threshold
  edge-rtr-03    pool.ntp.org    3   142.880      18.420     273  ← OFFSET+JITTER FAIL
  edge-rtr-07    (unsynced)      16    —           —         000  ← FREE-RUN