diff options
Diffstat (limited to 'html/monopt.html')
| -rw-r--r-- | html/monopt.html | 637 |
1 files changed, 512 insertions, 125 deletions
diff --git a/html/monopt.html b/html/monopt.html index a4c073a24f4f..cd9f3c656a61 100644 --- a/html/monopt.html +++ b/html/monopt.html @@ -1,132 +1,519 @@ <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> - <html> - - <head> - <meta http-equiv="content-type" content="text/html;charset=iso-8859-1"> - <meta name="generator" content="HTML Tidy, see www.w3.org"> - <title>Monitoring Options</title> - <link href="scripts/style.css" type="text/css" rel="stylesheet"> - </head> - - <body> - <h3>Monitoring Options</h3> - <img src="pic/pogo8.gif" alt="gif" align="left"><a href="http://www.eecis.udel.edu/~mills/pictures.html">from <i>Pogo</i>, Walt Kelly</a> - <p>The pig watches the logs.</p> - <p>Last update: <csobj format="ShortTime" h="25" locale="00000409" region="0" t="DateTime" w="61">00:40</csobj> UTC <csobj format="LongDate" h="25" locale="00000409" region="0" t="DateTime" w="290">Sunday, December 24, 2006</csobj></p> - <br clear="left"> - <h4>Related Links</h4> - <script type="text/javascript" language="javascript" src="scripts/links7.txt"></script> - <hr> - <tt>ntpd</tt> includes a comprehensive monitoring facility suitable for continuous, long term recording of server and client timekeeping performance. See the <tt>statistics</tt> 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 <tt>./scripts</tt> directory of this distribution. Using these facilities and Unix <tt>cron</tt> jobs, the datacan be automatically summarized and archived for retrospective analysis. - <h4>Monitoring Commands</h4> +<head> +<meta http-equiv="content-type" content="text/html;charset=iso-8859-1"> +<meta name="generator" content="HTML Tidy, see www.w3.org"> +<title>Monitoring Options</title> +<link href="scripts/style.css" type="text/css" rel="stylesheet"> +</head> +<body> +<h3>Monitoring Options</h3> +<img src="pic/pogo8.gif" alt="gif" align="left"><a href="http://www.eecis.udel.edu/~mills/pictures.html">from <i>Pogo</i>, +Walt Kelly</a> +<p>Pig was hired to watch the logs.</p> +<p>Last update: + <!-- #BeginDate format:En2m -->10-May-2009 16:19<!-- #EndDate --> + UTC</p> +<br clear="left"> +<h4>Related Links</h4> +<script type="text/javascript" language="javascript" src="scripts/command.txt"></script> +<script type="text/javascript" language="javascript" src="scripts/monopt.txt"></script> +<h4>Table of Contents</h4> +<ul> + <li class="inline"><a href="#intro">introduction</a></li> + <li class="inline"><a href="#cmd">Monitoring Options</a></li> + <li class="inline"><a href="#types">File Set Types</a></li> +</ul> +<hr> +<h4 id="intro">Introduction</h4> +<p>The <tt>ntpd</tt> includes a comprehensive monitoring facility which collects + statistical data of various types and writes the data to files associated with + each type at defined events or intervals. The files associated with a particular + type are collectively called the generation file set for that type. The files + in the file set are the members of that set.</p> +<p>File sets have names specific to the type and generation epoch. The names + are constructed from three concatenated elements <i><tt>prefix</tt></i>, <i><tt>filename</tt></i> and <i><tt>suffix</tt></i>:</p> +<dl> + <dt><i><tt>prefix</tt></i></dt> + <dd>The directory path specified in the <tt>statsdir</tt> command.</dd> + <dt><i><tt>name</tt></i></dt> + <dd>The name specified by the <tt>file</tt> option of the <tt>filegen</tt> command.</dd> + <dt><i><tt>suffix</tt></i></dt> + <dd>A string of elements bdginning with . (dot) followed by a number of elements + depending on the file set type.</dd> +</dl> +<p>Statistics files can be managed using scripts, examples of which are in the <tt>./scripts</tt> directory. + Using these or similar scripts and Unix <tt>cron</tt> jobs, the files can be + automatically summarized and archived for retrospective analysis.</p> +<h4 id="cmd">Monitoring Commands</h4> +<dl> + <dt id="filegen"><tt>filegen <i>name</i> file <i>filename</i> [type <i>type</i>] + [link | nolink] [enable | disable]</tt></dt> + <dd> <dl> - <dt><tt>statistics <i>name</i> [...]</tt> - <dd>Enables writing of statistics records. Currently, six kinds of <i><tt>name</tt></i>statistics are supported. + <dt><i><tt>name</tt></i></dt> + <dd>Specifies the file set type from the list in the next section.</dd> + <dt><tt>file <i>filename</i></tt></dt> + <dd>Specfies the file set name.</dd> + <dt><tt>type <i>typename</i></tt></dt> + <dd>Specifies the file set interval. The following intervals are supported + with default <tt>day</tt>:</dd> + <dd> <dl> - <dt><tt>clockstats</tt> - <dd>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 <tt>clockstats</tt>: - <dd><tt>49213 525.624 127.127.4.1 93 226 00:08:29.606 D</tt> - <dd>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. - <dt><tt>cryptostats</tt> - <dd>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 <tt>cryptostats</tt>: - <dd><tt>49213 525.624 127.127.4.1 <i>message</i></tt> - <dd>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 <tt><i>message</i></tt> field includes the message type and certain ancillary information. See the <a href="authopt.html">Authentication Options</a> page for further information. - <dt><tt>loopstats</tt> - <dd>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 <tt>loopstats</tt>: - <dd><tt>50935 75440.031 0.000006019 13.778190 0.000351733 0.0133806 6</tt> - <dd>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. - <dt><tt>peerstats</tt> - <dd>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 <tt>peerstats</tt>: - <dt><tt>48773 10847.650 127.127.4.1 9714 -0.001605376 0.000000000 0.001424877 0.000958674</tt> - <dd>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. - <dt><tt>rawstats</tt> - <dd>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 <tt>rawstats</tt>: - <dt><tt>50928 2132.543 128.4.1.1 128.4.1.20 3102453281.584327000 3102453281.58622800031 02453332.540806000 3102453332.541458000</tt> - <dd>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. - <dt><tt>sysstats</tt> - <dd>Enables recording of <tt>ntpd</tt> statistics counters on a periodic basis. Each hour a line of the following form is appended to the file generation set named <tt>sysstats</tt>: - <dd><tt>50928 2132.543 36000 81965 0 9546 56 71793 512 540 10 147</tt> - <dd>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. - <dl> - <dt>Time since restart <tt>36000</tt> - <dd>Time in hours since the system was last rebooted. - <dt>Packets received <tt>81965</tt> - <dd>Total number of packets received. - <dt>Packets processed <tt>0</tt> - <dd>Number of packets received in response to previous packets sent - <dt>Current version <tt>9546</tt> - <dd>Number of packets matching the current NTP version. - <dt>Previous version <tt>56</tt> - <dd>Number of packets matching the previous NTP version. - <dt>Bad version <tt>71793</tt> - <dd>Number of packets matching neither NTP version. - <dt>Access denied <tt>512</tt> - <dd>Number of packets denied access for any reason. - <dt>Bad length or format <tt>540</tt> - <dd>Number of packets with invalid length, format or port number. - <dt>Bad authentication <tt>10</tt> - <dd>Number of packets not verified as authentic. - <dt>Rate exceeded <tt>147</tt> - <dd>Number of packets discarded due to rate limitation. - </dl> - <dt><tt>timingstats</tt> - <dd><b>ONLY</b> available when the deamon is compiled with process time debugging support (--enable-debug-timing - costs performance). Enables recording of <tt>ntpd</tt> processing time information for various selected code paths: - <dd><tt>53876 36.920 10.0.3.5 1 0.000014592 input processing delay</tt> - <dd>The first two fields show the date (Modified Julian Day) and time (seconds and fraction past UTC midnight). The next field is a potential <tt>peer address</tt>, <tt>-</tt> or <tt>-REFCLOCK-</tt> 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). - <dt><tt>statsdir <i>directory_path</i></tt> - <dd>Indicates the full path of a directory where statistics files should be created (see below). This keyword allows the (otherwise constant) <tt>filegen</tt> filename prefix to be modified for file generation sets, which is useful for handling statistics logs. - <dt><tt>filegen <i>name</i> [file <i>filename</i>] [type <i>typename</i>] [link | nolink] [enable | disable]</tt> - <dd>Configures setting of generation file set <i>name</i>. 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 <tt>ntpd</tt>. (Most important: they can be removed to free space for new data produced.) - <dd>Note that this command can be sent from the <tt>ntpdc</tt> program running at a remote location. - <dl> - <dt><i><tt>name</tt></i> - <dd>This is the type of the statistics records, as shown in the <tt>statistics</tt> command. - </dl> - <dd><tt>file <i>filename</i></tt> - <dl> - <dd>This is the file name for the statistics records. Filenames of set members are built from three concatenated elements <i><tt>prefix</tt></i>, <i><tt>filename</tt></i> and <i><tt>suffix</tt></i>: - <dl> - <dt><i><tt>prefix</tt></i> - <dd>This is a constant filename path. It is not subject to modifications via the <tt>filegen</tt> 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 <tt>loopstats</tt> and <tt>peerstats</tt> generation can be configured using the <tt>statsdir</tt> option explained above. - <dt><i><tt>filename</tt></i> - <dd>This string is directly concatenated to the prefix mentioned above (no intervening <tt>/</tt> (slash)). This can be modified using the <tt>file</tt> argument to the <tt>filegen</tt> statement. No <tt>..</tt> elements are allowed in this component to prevent filenames referring to parts outside the filesystem hierarchy denoted by <tt>prefix</tt>. - <dt><i><tt>suffix</tt></i> - <dd>This part is reflects individual elements of a file set. It is generated according to the type of a file set. - </dl> - </dl> - <dd><tt>type <i>typename</i></tt> - <dl> - <dd>A file generation set is characterized by its type. The following types are supported: - <dl> - <dt><tt>none</tt> - <dd>The file set is actually a single plain file. - <dt><tt>pid</tt> - <dd>One element of file set is used per incarnation of a <tt>ntpd</tt> 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 <tt>ntpd</tt> server incarnations. The set member filename is built by appending a <tt>.</tt> (dot) to concatenated <i>prefix</i> and <i>filename</i> strings, and appending the decimal representation of the process ID of the <tt>ntpd</tt> server process. - <dt><tt>day</tt> - <dd>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 <tt>.</tt> (dot) and a day specification in the form <tt>YYYYMMdd. YYYY</tt> is a 4-digit year number (e.g., 1992). <tt>MM</tt> is a two digit month number. <tt>dd</tt> is a two digit day number. Thus, all information written at 10 December 1992 would end up in a file named <tt><i>prefix filename</i>.19921210</tt>. - <dt><tt>week</tt> - <dd>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 <tt>W</tt>, and a 2-digit week number. For example, information from January, 10th 1992 would end up in a file with suffix <tt>.1992W1</tt>. - <dt><tt>month</tt> - <dd>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. - <dt><tt>year</tt> - <dd>One generation file element is generated per year. The filename suffix consists of a dot and a 4 digit year number. - <dt><tt>age</tt> - <dd>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 <tt>a</tt>, 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 <tt>enable</tt>; output is prevented by specifying <tt>disable</tt>. - </dl> - </dl> - <dd><tt>link | nolink</tt> - <dl> - <dd>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 <tt>link</tt> and disabled using <tt>nolink</tt>. If <tt>link</tt> 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 <tt>C</tt>, and the pid of the <tt>ntpd</tt> 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. - </dl> - <dd><tt>enable | disable</tt> - <dl> - <dd>Enables or disables the recording function. - </dl> + <dt><tt>none</tt></dt> + <dd>The file set is actually a single plain file.</dd> + <dt><tt>pid</tt></dt> + <dd>One file set member is created for every incarnation of <tt>ntpd</tt>. + The file name suffix is the string .<tt>n</tt>, where <tt>n</tt> is the + process ID of the <tt>ntpd</tt> server process.</dd> + <dt><tt>day</tt></dt> + <dd>One file set member is created per day. A day is defined as the period + between 00:00 and 23:59 UTC. The file name suffix is the string .<tt>yyyymmdd</tt>, + where <tt>yyyy</tt> is the year, <tt>mm</tt> the month of the year and <tt>dd</tt> the + day of the month. Thus, member created on 10 December 1992 would have suffix <tt>.19921210</tt>.</dd> + <dt><tt>week</tt></dt> + <dd>One file set member is created per week. The week is defined as the + day of year modulo 7. The file name suffix is the string .<tt>yyyyWww</tt>, + where <tt>yyyy</tt> is the year, <tt>W</tt> stands for itself and <tt>ww</tt> the + week number starting from 0. For example, The member created on 10 January + 1992 would have suffix <tt>.1992W1</tt>.</dd> + <dt><tt>month</tt></dt> + <dd>One file set member is created per month. The file name suffix is the + string .<tt>yyyymm</tt>, where <tt>yyyy</tt> is the year and <tt>mm</tt> the + month of the year starting from 1. For example, The member created on 10 + January 1992 would have suffix <tt>.199201</tt>.</dd> + <dt><tt>year</tt></dt> + <dd>One file set member is generated per year. The file name suffix is the + string .<tt>yyyy</tt>, where <tt>yyyy</tt> is the year. For example, The + member created on 1 January 1992 would have suffix <tt>.1992</tt>.</dd> + <dt><tt>age</tt></dt> + <dd>One file set member is generated every 24 hours of <tt>ntpd</tt> operation. + The filename suffix is the string <tt>.adddddddd</tt>, where <tt>a</tt> stands + for itself and <tt>dddddddd</tt> is the <tt>ntpd</tt> running time in seconds + at the start of the corresponding 24-hour period.</dd> </dl> - <hr> - <script type="text/javascript" language="javascript" src="scripts/footer.txt"></script> + </dd> + <dt><tt>link | nolink</tt></dt> + <dd>It is convenient to be able to access the current file set members by + file name, but without the suffix. This feature is enabled by <tt>link</tt> and + disabled by <tt>nolink</tt>. If enabled, which is the default, a hard link + from the current file set member to a file without suffix is created. When + there is already a file with this name and the number of links to this file + is one, it is renamed by appending a dot, the letter <tt>C</tt>, and the + pid of the <tt>ntpd</tt> 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.</dd> + <dt><tt>enable | disable</tt></dt> + <dd>Enable or disable the recording function, with default <tt>enable</tt>. + These options are intended for remote configutation commands.</dd> </dl> - </body> - + </dd> + <dt><tt>statsdir <i>directory_path</i></tt></dt> + <dd>Specify the directory path prefix for statistics file names.</dd> +</dl> +<h4 id="types">File Set Types</h4> +<dl> + <dt><tt>clockstats</tt></dt> + <dd>Record reference clock statistics. Each update received from a reference + clock driver appends one line to the <tt>clockstats</tt> file set:</dd> + <dd><tt>49213 525.624 127.127.4.1 93 226 00:08:29.606 D</tt></dd> + <dd> + <table width="100%" border="1" cellspacing="2" cellpadding="2"> + <tr> + <td>Item</td> + <td>Units</td> + <td>Description</td> + </tr> + <tr> + <td><tt>49213</tt></td> + <td>MJD</td> + <td>date</td> + </tr> + <tr> + <td><tt>525.624</tt></td> + <td>s</td> + <td>time past midnight</td> + </tr> + <tr> + <td><tt>127.127.4.1</tt></td> + <td>IP</td> + <td>reference clock address</td> + </tr> + <tr> + <td><tt><i>message</i></tt></td> + <td>text</td> + <td>log message</td> + </tr> + </table> + </dd> + <dd>The <tt><i>message</i></tt> field includes the last timecode received in + decoded ASCII format, where meaningful. In some cases a good deal of additional + information is displayed. See information specific to each reference clock + for further details.</dd> + <dt><tt>cryptostats</tt></dt> + <dd>Record significant events in the Autokey protocol. This option requires + the OpenSSL cryptographic software library. Each event appends one line to + the <tt>cryptostats</tt> file set:</dd> + <dd><tt>49213 525.624 128.4.1.1 <i>message</i></tt></dd> + <dd> + <table width="100%" border="1" cellspacing="2" cellpadding="2"> + <tr> + <td>Item</td> + <td>Units</td> + <td>Description</td> + </tr> + <tr> + <td><tt>49213</tt></td> + <td>MJD</td> + <td>date</td> + </tr> + <tr> + <td><tt>525.624</tt></td> + <td>s</td> + <td>time past midnight</td> + </tr> + <tr> + <td><tt>128.4.1.1</tt></td> + <td>IP</td> + <td>source address (<tt>0.0.0.0</tt> for system)</td> + </tr> + <tr> + <td><tt><i>message</i></tt></td> + <td>text</td> + <td>log message</td> + </tr> + </table> + </dd> + <dd>The <tt><i>message</i></tt> field includes the message type and certain + ancillary information. See the <a href="authopt.html">Authentication Options</a> page + for further information.</dd> + <dt><tt>loopstats</tt></dt> + <dd>Record clock discipline loop statistics. Each system clock update appends + one line to the <tt>loopstats</tt> file set:</dd> + <dd><tt>50935 75440.031 0.000006019 13.778 0.000351733 0.013380 6</tt></dd> + <dd> + <table width="100%" border="1" cellspacing="2" cellpadding="2"> + <tr> + <td>Item</td> + <td>Units</td> + <td>Description</td> + </tr> + <tr> + <td><tt>50935</tt></td> + <td>MJD</td> + <td>date</td> + </tr> + <tr> + <td><tt>75440.031</tt></td> + <td>s</td> + <td>time past midnight</td> + </tr> + <tr> + <td><tt>0.000006019</tt></td> + <td>s</td> + <td>clock offset</td> + </tr> + <tr> + <td><tt>13.778</tt></td> + <td>PPM</td> + <td>frequency offset</td> + </tr> + <tr> + <td><tt>0.000351733</tt></td> + <td>s</td> + <td>RMS jitter</td> + </tr> + <tr> + <td><tt>0.013380</tt></td> + <td>PPM</td> + <td>RMS frequency jitter (aka wander)</td> + </tr> + <tr> + <td><tt>6 </tt></td> + <td>log<sub>2</sub> s</td> + <td>clock discipline loop time constant</td> + </tr> + </table> + </dd> + <dt><tt>peerstats</tt></dt> + <dd>Record peer statistics. Each NTP packet or reference clock update received + appends one line to the <tt>peerstats</tt> file set:</dd> + <dd><tt>48773 10847.650 127.127.4.1 9714 -0.001605376 0.000000000 0.001424877 + 0.000958674</tt></dd> + <dd> + <table width="100%" border="1" cellspacing="2" cellpadding="2"> + <tr> + <td>Item</td> + <td>Units</td> + <td>Description</td> + </tr> + <tr> + <td><tt>48773</tt></td> + <td>MJD</td> + <td>date</td> + </tr> + <tr> + <td><tt>10847.650</tt></td> + <td>s</td> + <td>time past midnight</td> + </tr> + <tr> + <td><tt>127.127.4.1</tt></td> + <td>IP</td> + <td>source address</td> + </tr> + <tr> + <td><tt>9714</tt></td> + <td>hex</td> + <td>status word</td> + </tr> + <tr> + <td><tt>-0.001605376</tt></td> + <td>s</td> + <td>clock offset</td> + </tr> + <tr> + <td><tt>0.000000000 </tt></td> + <td>s</td> + <td>roundtrip delay</td> + </tr> + <tr> + <td><tt>0.001424877</tt></td> + <td>s</td> + <td>dispersion</td> + </tr> + <tr> + <td><tt>0.000958674</tt></td> + <td>s</td> + <td>RMS jitter</td> + </tr> + </table> + </dd> + <dd>The status field is encoded in hex format as described in Appendix B of + the NTP specification RFC 1305.</dd> + <dt><tt>protostats</tt></dt> + <dd>Record significant peer, system and [rptpcp; events. Each significant event + appends one line to the <tt>protostats</tt> file set:</dd> + <dd><tt>49213 525.624 128.4.1.1 963a 8a <i>message</i></tt></dd> + <dd> + <table width="100%" border="1" cellspacing="2" cellpadding="2"> + <tr> + <td>Item</td> + <td>Units</td> + <td>Description</td> + </tr> + <tr> + <td><tt>49213</tt></td> + <td>MJD</td> + <td>date</td> + </tr> + <tr> + <td><tt>525.624</tt></td> + <td>s</td> + <td>time past midnight</td> + </tr> + <tr> + <td><tt>128.4.1.1</tt></td> + <td>IP</td> + <td>source address (<tt>0.0.0.0</tt> for system)</td> + </tr> + <tr> + <td><tt>963a</tt></td> + <td>code</td> + <td>status word</td> + </tr> + <tr> + <td><tt>8a</tt></td> + <td>code</td> + <td>event message code</td> + </tr> + <tr> + <td><tt><i>message</i></tt></td> + <td>text</td> + <td>event message</td> + </tr> + </table> + </dd> + <dd>The event message code and <tt><i>message</i></tt> field are described on + the <a href="decode.html">Event Messages and Status Words</a> page.</dd> + <dt><tt>rawstats</tt></dt> + <dd>Record timestamp statistics. Each NTP packet received appends one line to + the <tt>rawstats</tt> file set:</dd> + <dd><tt>50928 2132.543 128.4.1.1 128.4.1.20 3102453281.584327000 3102453281.58622800031 + 02453332.540806000 3102453332.541458000</tt></dd> + <dd> + <table width="100%" border="1" cellspacing="2" cellpadding="2"> + <tr> + <td>Item</td> + <td>Units</td> + <td>Description</td> + </tr> + <tr> + <td><tt>50928</tt></td> + <td>MJD</td> + <td>date</td> + </tr> + <tr> + <td><tt>2132.543</tt></td> + <td>s</td> + <td>time past midnight</td> + </tr> + <tr> + <td><tt>128.4.1.1</tt></td> + <td>IP</td> + <td>source address</td> + </tr> + <tr> + <td><tt>128.4.1.20</tt></td> + <td>IP</td> + <td>destination address</td> + </tr> + <tr> + <td><tt>3102453281.584327000</tt></td> + <td>NTP s</td> + <td>origin timestamp</td> + </tr> + <tr> + <td><tt>3102453281.586228000</tt></td> + <td>NTP s</td> + <td>receive timestamp</td> + </tr> + <tr> + <td><tt>3102453332.540806000 </tt></td> + <td>NTP s</td> + <td>transmit timestamp</td> + </tr> + <tr> + <td><tt>3102453332.541458000</tt></td> + <td>NTP s</td> + <td>destination timestamp</td> + </tr> + </table> + </dd> + <dt><tt>sysstats</tt></dt> + <dd>Record system statistics. Each hour one line is appended to the <tt>sysstats</tt> file + set in the following format:</dd> + <dd><tt>50928 2132.543 3600 81965 0 9546 56 512 540 10 4 147 1</tt></dd> + <dd> + <table width="100%" border="1" cellspacing="2" cellpadding="2"> + <tr> + <td>Item</td> + <td>Units</td> + <td>Description</td> + </tr> + <tr> + <td><tt>50928</tt></td> + <td>MJD</td> + <td>date</td> + </tr> + <tr> + <td><tt>2132.543</tt></td> + <td>s</td> + <td>time past midnight</td> + </tr> + <tr> + <td><tt>3600</tt></td> + <td>s</td> + <td>time since reset</td> + </tr> + <tr> + <td><tt>81965</tt></td> + <td>#</td> + <td>packets received</td> + </tr> + <tr> + <td><tt>0</tt></td> + <td>#</td> + <td>packets for this host</td> + </tr> + <tr> + <td><tt>9546</tt></td> + <td>#</td> + <td>current versions</td> + </tr> + <tr> + <td><tt>56</tt></td> + <td>#</td> + <td>old version</td> + </tr> + <tr> + <td><tt>512</tt></td> + <td>#</td> + <td>access denied</td> + </tr> + <tr> + <td><tt>540</tt></td> + <td>#</td> + <td>bad length or format</td> + </tr> + <tr> + <td><tt>10</tt></td> + <td>#</td> + <td>bad authentication</td> + </tr> + <tr> + <td><tt>4</tt></td> + <td>#</td> + <td>declined</td> + </tr> + <tr> + <td><tt>147</tt></td> + <td>#</td> + <td>rate exceeded</td> + </tr> + <tr> + <td><tt>1</tt></td> + <td>#</td> + <td>kiss-o'-death packets sent</td> + </tr> + </table> + </dd> + <dt><tt>timingstats</tt></dt> + <dd>(Only available when the deamon is compiled with process time debugging + support (--enable-debug-timing - costs performance). Record processing time + statistics for various selected code paths.</dd> + <dd><tt>53876 36.920 10.0.3.5 1 0.000014592 input processing delay</tt></dd> + <dd> + <table width="100%" border="1" cellspacing="2" cellpadding="2"> + <tr> + <td>Item</td> + <td>Units</td> + <td>Description</td> + </tr> + <tr> + <td><tt>53876</tt></td> + <td>MJD</td> + <td>date</td> + </tr> + <tr> + <td><tt>36.920</tt></td> + <td>s</td> + <td>time past midnight</td> + </tr> + <tr> + <td><tt>10.0.3.5</tt></td> + <td>IP</td> + <td>server address</td> + </tr> + <tr> + <td><tt>1</tt></td> + <td>#</td> + <td>event count</td> + </tr> + <tr> + <td><tt>0.000014592</tt></td> + <td>s</td> + <td>total time</td> + </tr> + <tr> + <td><tt><i>message</i></tt></td> + <td>text</td> + <td>code path description (see source)</td> + </tr> + </table> + </dd> +</dl> +<hr> +<script type="text/javascript" language="javascript" src="scripts/footer.txt"></script> +</body> </html> |