ntpstats¶
Validate, evaluate and study network time synchronisation.
ntpstats reads what time systems already produce: - logs of ntpd, NTPsec, chrony, ntpd-rs, linuxptp and gpsd, u-blox receivers and TAPR TICC counters; - packet captures of NTP, NTP over PTP (RFC 10030) and PTP; - GNSS time-transfer and laboratory files; - network-simulator results.
It computes the statistics used in timing research and telecom standards, each with a stated uncertainty: frequency stability with confidence intervals and noise identification, time error, an audited error bound to UTC, and the true error of a clock against an independent GNSS PPS reference. It measures servers itself with NTPv4, NTS, NTPv5 and Roughtime clients, and its simulator with ground truth is a test bench for synchronisation algorithms. Use it as a command-line tool, a Python library with a stable API, a local web UI, or in your browser.
pip install ntpstats # or: conda install -c conda-forge ntpstats
ntpstats ui /var/log/chrony/measurements.log # local web UI
ntpstats stability tracking.log -k oadev,tdev --ci 0.95

Start here¶
| Page | What it covers |
|---|---|
| Getting started | install, the web UI and its shortcuts, first analyses |
| CLI reference | every command and its options |
| In your browser | the web UI running locally in the page (Pyodide), no install |
| Notebooks & gallery | runnable notebooks and reproductions of published results |
Analyse¶
| Page | What it covers |
|---|---|
| Formats | every supported input, sign conventions, how to enable the logs |
| Statistics | ADEV … TheoH, MTIE, EDF and confidence intervals, masks, dynamic views |
| Network & estimators | delay floor, wedge, FPP, filters and estimators |
| PTP captures & time error | PTP and NTP over PTP from captures, max|TE|, cTE, dTE, limits and masks |
| Sources, instruments & bounds | live daemons, PTP hardware clocks and the OCP Time Card, instrument profiles and column mapping, ClockBound and fbclock bounds |
| Metrology | power-law noise model, spectra, cornered hat, holdover, poll-interval advice |
| Research data | CGGTTS, RINEX clock, Circular T, RIPE Atlas, NTP Pool, the interop dataset |
Operate and comply¶
| Page | What it covers |
|---|---|
| Audit, events & CI checks | UTC traceability audit, change detection, GitHub Action, pytest assertions |
| Fleet view | many hosts ranked against the same limits, and matching alert rules |
| Monitoring | Prometheus/OpenMetrics, OpenTelemetry, Grafana |
| Protocols | NTS, NTS pools, NTPv5, Roughtime, RFC 9769 interleaved mode |
Research and integration¶
| Page | What it covers |
|---|---|
| Trace replay & PTP chains | the estimator bench and clock disciplines (ntpd, LOCKCLOCK), real network delays, PTP exchanges and transparent clocks, boundary-clock chains, OMNeT++/INET and ns-3, reference algorithms |
| Dataframes & Parquet | pandas, xarray, Parquet/Arrow |
| Writing a plugin | add formats, estimators, detectors, masks and profiles from your own package |
| Stable32, TimeLab, allantools | moving data and code over, and checking the numbers agree |
| Stable API and API reference | the 3.x API promise and every module |
Trust¶
| Page | What it covers |
|---|---|
| Validation | how correctness is established: NIST SP 1065, Stable32 cross-check, simulations |
| Validation campaign | a real chrony client against a GNSS PPS with ntpstats validate |
| Live interop | monthly results against public NTP/NTS/NTPv5/Roughtime servers |
| State of the art and Tools landscape | where network time is in 2026, and how ntpstats relates to other tools |
ntpstats is MIT-licensed, © 2012–2026 Thiago de Freitas. The only runtime dependency is numpy; everything else (plots, NTS, dataframes) is an optional extra.