/contrib/ntp/scripts/stats/README.stats

https://bitbucket.org/freebsd/freebsd-head/ · Unknown · 246 lines · 183 code · 63 blank · 0 comment · 0 complexity · 4b5dc7df5a670ab832030d11ba3ab262 MD5 · raw file

  1. Statistics file formats (README.stats)
  2. The xntp3 daemon can produce a variety of statistics files which are
  3. useful for maintenance, evaluation and retrospective calibration
  4. purposes. See the xntpd.8 man page for instructions on how to configure
  5. this feature. Since these files can become rather large and cumbersome,
  6. they are ordinarily reduced to summary form by running the summary.sh
  7. shell script once per day, week or month, as appropriate. There are
  8. three file collections presently defined: peerstats, loopstats and
  9. clockstats, each of which is described in this note.
  10. peerstats
  11. The following data are collected in the peerstats files. The files are
  12. reduced to summary data using the peer.sh shell script. See the peer.awk
  13. script for further information. A line in the file is produced upon
  14. reception of each valid update from a configured peer.
  15. 49236 30.756 140.173.96.1 9474 0.000603 0.37532
  16. 49236 modified Julian day number
  17. 30.756 time of day (s) past midnight UTC
  18. 140.173.96.1 peer identifier (IP address or receiver identifier)
  19. 9474 peer status word (hex) (see NTP specification)
  20. 0.000603 offset (s)
  21. 0.08929 delay (s)
  22. 0.37532 dispersion (s)
  23. loopstats
  24. The following data are collected in the loopstats files. The files are
  25. reduced to summary data using the loop.sh shell script. See the loop.awk
  26. script for further information. A line in the file is produced at each
  27. valid update of the local clock.
  28. 49236 11.897 -0.000004 -35.9384 0
  29. 49236 modified Julian day number
  30. 11.897 time of day (s) past midnight UTC
  31. -0.000004 time offset (s)
  32. -35.9384 frequency offset (ppm)
  33. 0 phase-lock loop time constant
  34. clockstats
  35. The following data are collected in the clockstats files. The files are
  36. reduced to summary data using the clock.sh shell script, which also
  37. updates the ensemble, etf, itf and tdata data files as well. See the
  38. clock.awk, ensemble.awk, etf.awk, itf.awk and tdta.awk scripts for
  39. further information. A line in the file is produced at each valid update
  40. received from a configured radio clock. Data are at present recorded for
  41. several radios. The first part of each data line is similar for all
  42. radios, e.g.:
  43. 49234 60517.826 127.127.4.1 93 247 16:48:21.814
  44. 49234 modified Julian day number
  45. 60517.826 time of day (s) past midnight UTC
  46. 127.127.4.1 receiver identifier (Spectracom 8170/Netclock-2)
  47. 93 247 16:48:21.814 timecode (format varies)
  48. In the case of the Austron GPS receiver, a good deal of additional
  49. information is extracted from the radio, as described below. The formats
  50. shown consist of one line with all the fields shown in order. The
  51. timecode formats specific to each radio follow. See the file
  52. README.timecodes for detailed information on the timecode formats used
  53. by these radios.
  54. Spectracom 8170/Netclock-2 WWVB receiver
  55. 49234 60517.826 127.127.4.1 ?A93 247 16:48:21.814
  56. The '?' and 'A' characters are present only when the receiver is
  57. unsynchronized; otherwise, they are replaced by space ' ' characters.
  58. IRIG audio decoder
  59. 49234 60517.826 127.127.6.0 247 16:48:21?
  60. The '?' character is present only when the receiver is unsynchronized.
  61. Austron 2200A/2201A GPS receiver
  62. 49234 60580.843 127.127.10.1 93:247:16:49:24.814?
  63. The '?' character is present only when the receiver is unsynchronized.
  64. Depending on the installed options, the Austron 2200A/2201A recognizes a
  65. number of special commands that report various data items. See the
  66. refclock_as2201.c source module for a list of the commands used. These
  67. data are collected only if the following line is included in the
  68. configuration file ntp.conf:
  69. fudge 127.127.10.1 flag4 1 # enable extended statistics collection
  70. The format of each data line returned is summarized in the following
  71. list.
  72. External time/frequency data (requires input buffer option IN)
  73. These data determine the deviations of external time/frequency inputs
  74. relative to receiver oscillator time. The following data are typical
  75. using an external cesium oscillator PPS and 5-MHz outputs.
  76. 49234 60580.843 127.127.10.1 93:247:16:49:24.814 ETF
  77. -85.9 time interval (ns)
  78. -89.0 average time interval (ns)
  79. 4.0 time interval sigma (ns)
  80. +1.510E-11 time interval rate
  81. -4.500E-11 deltaf/f
  82. +1.592E-11 average deltaf/f
  83. 5.297E-13 sigma deltaf/f
  84. 500 number of samples
  85. Model and option identifiers
  86. These data show the receiver model number and option configuration.
  87. 49234 60708.848 127.127.10.1 93:247:16:51:32.817 ID;OPT;VER
  88. GPS 2201A model ident (must be "GPS 2200A" or "GPS 2201A")
  89. TTY1 rs232 option present (required)
  90. TC1 IRIG option present (optional)
  91. LORAN LORAN assist option present (optional)
  92. IN input buffer option present (optional)
  93. OUT1 output buffer option present (required)
  94. B.00 data processor software version ("B.00" or later)
  95. B.00 signal processor software version ("B.00" or later)
  96. 28-Apr-93 software version date ("28-Apr-93" or later)
  97. Internal time/frequency data
  98. These data determine the deviations of the receiver oscillator with
  99. respect to satellite time.
  100. 49234 60564.846 127.127.10.1 93:247:16:49:08.816 ITF
  101. COCO current mode (must be "COCO")
  102. 0 code coast mode (must be zero)
  103. +6.6152E-08 code sigma (s)
  104. -3.5053E-08 code delta t (s)
  105. -4.0361E-11 deltat/t
  106. -6.4746E-11 oscillator ageing rate
  107. 500.00 loop time constant
  108. 4.984072 electrical tuning (V)
  109. GPS/LORAN ensemble data (requires LORAN assist option LORAN)
  110. These data determine the deviations and weights to calculate ensemble
  111. time from GPS and LORAN data.
  112. 49234 60596.852 127.127.10.1 93:247:16:49:40.812 LORAN ENSEMBLE
  113. +9.06E-08 GPS t (s)
  114. +3.53E-08 GPS sigma (s)
  115. .532 GPS weight
  116. +3.71E-08 LORAN t (s)
  117. +3.76E-08 LORAN sigma (s)
  118. .468 LORAN weight
  119. +6.56E-08 ensemble t
  120. +6.94E-08 ensemble sigma (s)
  121. LORAN stationkeeping data (requires LORAN assist option LORAN)
  122. These data determine which stations of the LORAN chain are being
  123. tracked, together with individual signal/noise ratios, deviations and
  124. weights.
  125. 49234 60532.850 127.127.10.1 93:247:16:48:36.820 LORAN TDATA
  126. M station identifier; data follows
  127. OK status (must be "OK" for tracking)
  128. 0 cw flag
  129. 0 sw flag
  130. 1162.17 time of arrival
  131. -4.6 snr (-30.0 if not "OK" status)
  132. 1.67E-07 2-sample phase-time deviation
  133. .507 weight (included only if "OK" status)
  134. W AQ 0 0 3387.80 -31.0 station identifier and data
  135. X OK 0 0 1740.27 -11.2 2.20E-07 .294 station identifier and data
  136. Y OK 0 0 2180.71 -4.6 2.68E-07 .198 station identifier and data
  137. Z CV 0 0 3392.94 -30.0 station identifier and data
  138. Oscillator status and environment
  139. These data determine the receiver oscillator type, mode, status and
  140. environment. Nominal operating conditions are shown below.
  141. 49234 60628.847 127.127.10.1 93:247:16:50:12.817 OSC;ET;TEMP
  142. 1121 Software Control oscillator model and mode (must be
  143. "Software Control")
  144. Locked status (must be "Locked")
  145. 4.979905 electrical tuning (V)
  146. 44.81 oscillator cavity temperature
  147. Receiver position, status and offsets
  148. These data determine the receiver position and elevation, together with
  149. programmable delay corrections for the antenna cable and receiver.
  150. 49234 60788.847 127.127.10.1 93:247:16:52:52.817 POS;PPS;PPSOFF
  151. +39:40:48.425 receiver latitude (N)
  152. -075:45:02.392 receiver longitude (E)
  153. +74.09 receiver elevation (m)
  154. Stored position status (must be "Stored")
  155. UTC PPS/PPM alignment (must be "UTC")
  156. 0 receiver delay (ns) (should be zero for calibrated
  157. receiver)
  158. 200 cable delay (ns)
  159. 0 user time bias (ns) (must be zero)
  160. Satellite tracking status
  161. These data determine how many satellites are being tracked. At the
  162. present state of constellation development, there should be at least
  163. three visible satellites in view. Much of the time the maximum of
  164. seven are being tracked; rarely this number drops to two.
  165. 49234 60612.850 127.127.10.1 93:247:16:49:56.820 TRSTAT
  166. 24 T satellite prn and status (T = track, A = acquire)
  167. 16 A 13 T 20 T 18 T 07 T 12 T list continued
  168. UTC leap-second information
  169. These data determine when the next leap second is to occur. The exact
  170. method to use is obscure.
  171. 49234 60548.847 127.127.10.1 93:247:16:48:52.818 UTC
  172. -1.2107E-08 A0 term (s)
  173. -1.2790E-13 A1 term (s)
  174. +9.0000E+00 current leap seconds (s)
  175. +2.0480E+05 time for leap seconds (s)
  176. +2.0100E+02 week number for delta leap (weeks)
  177. +1.9100E+02 week number for future leap (weeks)
  178. +4.0000E+00 day number for future leap (days)
  179. +9.0000E+00 future leap seconds (s)
  180. David L. Mills
  181. University of Delaware
  182. mills@udel.edu
  183. 23 October 1993