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
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.
| Parameter | Type | Default | Notes |
|---|---|---|---|
Max NTP offset (ms) max_offset_ms | number | 50 | — |
Max NTP jitter (ms) max_jitter_ms | number | 10 | — |
Min acceptable stratum min_stratum | number | 4 | — |
Verify PTP plane check_ptp | bool | true | — |
Expected PTP grandmaster expected_gm | string | 00:1B:19:FF:FE:00:00:01 | PTP grandmaster only relevant when PTP verification is enabled. |
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