contrib/ntp/scripts/stats/README.stats

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