ntp_mon - Monitoring Options


ntpd includes a comprehensive monitoring facility suitable for continuous, long term recording of server and client timekeeping performance. See the statistics command below for a listing and example of each type of statistics currently supported. Statistic files are managed using file generation sets and scripts in the ./scripts directory of this distribution. Using these facilities and Unix cron jobs, the datacan be automatically summarized and archived for retrospective analysis.


statistics name [...]

Enables writing of statistics records. Currently, six kinds of namestatistics are supported.

Enables recording of clock driver statistics information. Each update received from a clock driver appends a line of the following form to the file generation set named clockstats: 49213 525.624 93 226 00:08:29.606 D The first two fields show the date (Modified Julian Day) and time (seconds and fraction past UTC midnight). The next field shows the clock address in dotted-quad notation, The final field shows the last timecode received from the clock in decoded ASCII format, where meaningful. In some clock drivers a good deal of additional information can be gathered and displayed as well. See information specific to each clock for further details.


This option requires the OpenSSL cryptographic software library. It enables recording of cryptographic public key protocol information. Each message received by the protocol module appends a line of the following form to the file generation set named cryptostats: 49213 525.624 message The first two fields show the date (Modified Julian Day) and time (seconds and fraction past UTC midnight). The next field shows the peer address in dotted-quad notation, The final message field includes the message type and certain ancillary information. See the Authentication Options page for further information.


Enables recording of loop filter statistics information. Each update of the local clock outputs a line of the following form to the file generation set named loopstats: 50935 75440.031 0.000006019 13.778190 0.000351733 0.0133806 6 The first two fields show the date (Modified Julian Day) and time (seconds and fraction past UTC midnight). The next five fields show time offset (seconds), frequency offset (parts per million - PPM), RMS jitter (seconds), Allan deviation (PPM) and clock discipline time constant.


Enables recording of peer statistics information. This includes statistics records of all peers of a NTP server and of special signals, where present and configured. Each valid update appends a line of the following form to the current element of a file generation set named peerstats:

48773 10847.650 9714 -0.001605376 0.000000000
0.001424877 0.000958674

The first two fields show the date (Modified Julian Day) and time (seconds and fraction past UTC midnight). The next two fields show the peer address in dotted-quad notation and status, respectively. The status field is encoded in hex in the format described in Appendix B of the NTP specification RFC 1305. The final four fields show the offset, delay, dispersion and RMS jitter, all in seconds.


Enables recording of raw-timestamp statistics information. This includes statistics records of all peers of a NTP server and of special signals, where present and configured. Each NTP message received from a peer or clock driver appends a line of the following form to the file generation set named rawstats:

50928 2132.543 3102453281.584327000
3102453281.58622800031 02453332.540806000 3102453332.541458000

The first two fields show the date (Modified Julian Day) and time (seconds and fraction past UTC midnight). The next two fields show the remote peer or clock address followed by the local address in dotted-quad notation, The final four fields show the originate, receive, transmit and final NTP timestamps in order. The timestamp values are as received and before processing by the various data smoothing and mitigation algorithms.


Enables recording of ntpd statistics counters on a periodic basis. Each hour a line of the following form is appended to the file generation set named sysstats: 50928 2132.543 36000 81965 0 9546 56 71793 512 540 10 147 The first two fields show the date (Modified Julian Day) and time (seconds and fraction past UTC midnight). The remaining ten fields show the statistics counter values accumulated since the last generated line.
Time since restart 36000

Time in hours since the system was last rebooted.

Packets received 81965

Total number of packets received.

Packets processed 0

Number of packets received in response to previous packets sent

Current version 9546

Number of packets matching the current NTP version.

Previous version 56

Number of packets matching the previous NTP version.

Bad version 71793

Number of packets matching neither NTP version.

Access denied 512

Number of packets denied access for any reason.

Bad length or format 540

Number of packets with invalid length, format or port number.

Bad authentication 10

Number of packets not verified as authentic.

Rate exceeded 147

Number of packets discarded due to rate limitation.


ONLY available when the deamon is compiled with process time debugging support (--enable-debug-timing - costs performance). Enables recording of ntpd processing time information for various selected code paths: 53876 36.920 1 0.000014592 input processing delay The first two fields show the date (Modified Julian Day) and time (seconds and fraction past UTC midnight). The next field is a potential peer address, - or -REFCLOCK- depending on the associated io source. Then an event count for the number of processed events in the code path follows. The fifth field is the total time spend for the events. The rest of the line denotes the code path description (see source for more information).

statsdir directory_path

Indicates the full path of a directory where statistics files should be created (see below). This keyword allows the (otherwise constant) filegen filename prefix to be modified for file generation sets, which is useful for handling statistics logs.

filegen name [file filename] [type typename] [link | nolink]
[enable | disable]

Configures setting of generation file set name. Generation file sets provide a means for handling files that are continuously growing during the lifetime of a server. Server statistics are a typical example for such files. Generation file sets provide access to a set of files used to store the actual data. At any time at most one element of the set is being written to. The type given specifies when and how data will be directed to a new element of the set. This way, information stored in elements of a file set that are currently unused are available for administrational operations without the risk of disturbing the operation of ntpd. (Most important: they can be removed to free space for new data produced.) Note that this command can be sent from the ntpdc program running at a remote location.


This is the type of the statistics records, as shown in the statistics command.

file filename

This is the file name for the statistics records. Filenames of set members are built from three concatenated elements prefix, filename and suffix:


This is a constant filename path. It is not subject to modifications via the filegen option. It is defined by the server, usually specified as a compile-time constant. It may, however, be configurable for individual file generation sets via other commands. For example, the prefix used with loopstats and peerstats generation can be configured using the statsdir option explained above.


This string is directly concatenated to the prefix mentioned above (no intervening / (slash)). This can be modified using the file argument to the filegen statement. No .. elements are allowed in this component to prevent filenames referring to parts outside the filesystem hierarchy denoted by prefix.


This part is reflects individual elements of a file set. It is generated according to the type of a file set.

type typename

A file generation set is characterized by its type. The following types are supported:


The file set is actually a single plain file.


One element of file set is used per incarnation of a ntpd server. This type does not perform any changes to file set members during runtime, however it provides an easy way of separating files belonging to different ntpd server incarnations. The set member filename is built by appending a . (dot) to concatenated prefix and filename strings, and appending the decimal representation of the process ID of the ntpd server process.


One file generation set element is created per day. A day is defined as the period between 00:00 and 24:00 UTC. The file set member suffix consists of a . (dot) and a day specification in the form YYYYMMdd. YYYY is a 4-digit year number (e.g., 1992). MM is a two digit month number. dd is a two digit day number. Thus, all information written at 10 December 1992 would end up in a file named prefix filename.19921210.


Any file set member contains data related to a certain week of a year. The term week is defined by computing day-of-year modulo 7. Elements of such a file generation set are distinguished by appending the following suffix to the file set filename base: A dot, a 4-digit year number, the letter W, and a 2-digit week number. For example, information from January, 10th 1992 would end up in a file with suffix .1992W1.


One generation file set element is generated per month. The file name suffix consists of a dot, a 4-digit year number, and a 2-digit month.


One generation file element is generated per year. The filename suffix consists of a dot and a 4 digit year number.


This type of file generation sets changes to a new element of the file set every 24 hours of server operation. The filename suffix consists of a dot, the letter a, and an 8-digit number. This number is taken to be the number of seconds the server is running at the start of the corresponding 24-hour period. Information is only written to a file generation by specifying enable; output is prevented by specifying disable.

link | nolink

It is convenient to be able to access the current element of a file generation set by a fixed name. This feature is enabled by specifying link and disabled using nolink. If link is specified, a hard link from the current file set element to a file without suffix is created. When there is already a file with this name and the number of links of this file is one, it is renamed appending a dot, the letter C, and the pid of the ntpd server process. When the number of links is greater than one, the file is unlinked. This allows the current file to be accessed by a constant name.

enable | disable

Enables or disables the recording function.



Primary source of documentation: /usr/share/doc/ntp-*

This file was automatically generated from HTML source.

More Linux Commands

mvwhline_set(3ncurses) - create curses borders or lines usin
The border_set and wborder_set functions draw a border around the edges of the current or specified window. These functions do not change the cursor position, a

fts_read(3) - traverse a file hierarchy - Linux manual page
The fts functions are provided for traversing file hierarchies. A simple overview is that the fts_open() function returns a handle on a file hierarchy, which is

bzcat(1) - decompresses files to stdout - Linux manual page
bzip2 compresses files using the Burrows-Wheeler block sorting text compression algorithm, and Huffman coding. Compression is generally considerably better than

gnutls_pkcs11_token_init(3) - API function - Linux man page
This function will initialize (format) a token. If the token is at a factory defaults state the security officers PIN given will be set to be the default. Other

Tcl_RegisterObjType(3) - manipulate Tcl object types........
The procedures in this man page manage Tcl object types. They are used to register new object types, look up types, and force conversions from one type to anoth

strequate(3) map a list of characters to the same value.....
Each character in the input string get mapped to the first character in the string. This function name is mapped to option_strequate so as to not conflict with

gnutls_openpgp_privkey_init(3) - API function (Man Page)....
gnutls_openpgp_privkey_init.3 - This function will initialize an OpenPGP key structure. RETURNS GNUTLS_E_SUCCESS on success, or an error code. REPORTING BUGS Re

koi8-r(7) - Russian character set encoded in octal, decimal,
KOI8-R is the character set of choice for encoding Russian texts for many UNIX-like operation systems. KOI8-R is a successor for KOI-8, a de-facto standard for

smbtree(1) - A text based smb network browser (Man Page)....
This tool is part of the samba(7) suite. smbtree is a smb browser program in text mode. It is similar to the Network Neighborhood found on Windows computers. It

Mail::SpamAssassin::Plugin::Reuse(3pm) - For reusing old rul
The purpose of this plugin is to work in conjunction with mass-check --reuse to map rules hit in input messages to rule hits in the mass-check output. Mail::Spa

Mail::SpamAssassin::AutoWhitelist(3pm) - auto-whitelist hand
Mail::SpamAssassin::AutoWhitelist.3pm - Mail::SpamAssassin is a module to identify spam using text analysis and several internet-based realtime blacklists. This

smixlate(1) - translate SMI/SPPI identifiers (Man Page).....
The smixlate program is used to translate identifiers and especially OIDs into a more human readable format. OPTIONS -V, --version Show the smixlate version and

We can't live, work or learn in freedom unless the software we use is free.