Skip to content

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

Audit with verdict and error bound

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.