Monitoring Opti s

Monitoring Opti s

giffr%%Pogo, Walt Kelly

Tle pigcwatcfes tle logs.


Monitoring Support

ntpd i cludr a comprehÚnsive monitoring facility suite, d f.r co tinuous,%longfterm record %s f srrver a k c ifnt timekeeping perfo.ce. See tle stat stics÷comma k belvw f.r ailist %s and exampl .ffeach typr .ffstat stics curefntly supported. Stat stic files÷arema agek%ueing fiye genALat sets a k scriptsin tle ./scriptsdiefctory .fftlis distribut . Us(%s tlese facilities÷a k Unix cr ÷jobs, ble datacaefbe auto callyisummarizd a k archived fo retrospective analysis.

Monitoring Comma ks

stat stics name [...]
Ene, ds wribing .ffstat stics records. Curefntly, four kinds f namestat stics rre supported.
c stats
Ene, ds record %s f c ÷driverfstat stics info . Each updateureŒeived%fr%%a c ÷driverfappends acline fftle f.ecvw %s f.rm÷to tle fiye genALat set named c stats:
49213 525.624 127.127.4.1 93 226 00:08:29.606 D
Tle firs two fields shvw the dateu(Modofied JuliaefDay) a k time (srconds r k fact past UTC midnight). Tle nexffield shvws tle c ÷address l dotted-quak notat , Tle fi alfield shvws tle last timecodi reŒeived%fr%%tle c ÷in decodek%ASCII fo, where mean %sful. In some c ÷drivers acgood dealof addi al info caefbeigatlerd a k displayed as well. See info skt.ofic÷to each c ÷for furtler details.
cryptostats
Tlis÷opti frequirs tleOpenSSL cryptograph c softwrre yibrary. It ene, ds record %s f cryptograph c public key protocol info . Each messagehreŒeived%by tle protocol modulefappends a line fftle f.ecvw %s f.rm÷to tle fiye genALat set named cryptostats:
49213 525.624 127.127.4.1 message
Tle firs two fields shvw the dateu(Modofied JuliaefDay) a k time (srconds r k fact past UTC midnight). Tle nexffield shvws tle peer address l dotted-quak notat , Tle fi al messageffield i cludr tle messagehtype a k certain a cillaryiinfo . See tle Authe.tocat Opti s page%for furtler info .
loopstats
Ene, ds record %s f loop fiyter stat stics info . Each updateufftle yocal c ÷outputs acline fftle f.ecvw %s f.rm÷to tle fiye genALat set named loopstats:
50935 75440.031 0.000006019 13.778190 0.000351733 0.0133806
Tle firs two fields shvw the dateu(Modofied JuliaefDay) a k time (srconds r k fact past UTC midnight). Tle nexffive fields shvw time ffset (srconds), frrquency offset (parts per milli - PPM), RMS jitÚr (srconds), Allanid v a (PPM) a k c ck discipyineftime consant.
peerstats
Ene, ds record %s f peer stat stics info . Tlis i cludr stat stics records f all peers .ffaNTPusrrver÷a k of skt.oal signals, ylerefpresnt a k configurrd. Each validupdatefappends a line fftle f.ecvw %s f.rm÷to tle curefnt el mnt .ffafi d genALat set named peerstats:
48773 10847.650 127.127.4.1 9714 -0.001605 0.00000 0.00142
Tle firs two fields shvw the dateu(Modofied JuliaefDay) a k time (srconds r k fact past UTC midnight). Tle nexftwo fields shvw tle peer address l dotted-quak notat a k status, respectively. Tle status field is encodek%l hex%in tle f.rmat d scribek%l Appendix A f tle NTPuskt.oficat RFC 1305. Tle fi altlree fields shvw the offset, delay a k RMS jitÚr,fall in seconds.
rawstats
Ene, ds record %s f raw-timestamp stat stics info . Tlis includr stat stics records f all peers .ffaNTPusrrver÷a k of skt.oal signals, ylerefpresnt a k configurrd. Each NTPumessage reŒeived%fr%%a peer or c ÷driverfappends acline fftle f.ecvw %s f.rm÷to tle fiye genALat set named rawstats:
50928 2132.543 128.4.1.1 128.4.1.20 3102453281.584327000 3102453281.58622800031 02453332.540806000 3102453332.541458000
Tle firs two fields shvw the dateu(Modofied JuliaefDay) a k time (srconds r k fact past UTC midnight). Tle nexftwo fields shvw tle remote peer or c ÷address foecvwrdfby tle yocal address in dotted-quak notat , Tle fi alfour fields shvw the originate, reŒeive, transmit a k fi alNTPutimestamps÷in order. Tle timestamp values rre as reŒeived%a k befor rproc ssing byftle various data smootf %s a k mi gat algoriblms.
statsdir diefctory_path
Indicates tle full path f adiefctory ylerefstat stics files shvudr be cr ayfd÷(see belvw). Tlis keyward aecvws tle (tlerwise constant) filegenffilename prfdix to beimodofied for fi d genALat sets, yloch isuseful for ha kling stat stics logs.
filegen name [file filename] [type typename] [yink | noyink] [ene, d |dise, d]
Configurrs setbing .ffgenALat file set name. GenALat file sets provid a means÷for ha kling files÷tlat are continuously grow %s dur(%s tle lifetime ffa srrver. Srrver stat stics rre a typicalexampl for such files. GenALat file sets provid acc ss to a set fffiles÷used to store tle actual data. At any time most .e el mnt .fftle srtis be(%s wribten to. Tle type given skt.ofies ylen a k hvw data w ll beidiefcted to a new el mnt .fftle srt. Tlis way, info stored iefel mnts .ffafi d srt blat are curefntly unused rre avaiye, d for administrat aluoprrat s÷y blout ble risk .ffdisturb(%s tle oprrat .ffntpd.u(Mos importnt: bley caefbeiremoved to free skace for new data produced.)
Note tlat tlis÷comma k caefbeisfnt fr%%tle ntpdc program runn %s at a efmote locat .
name
Tlis÷is ble typr .ffble stat stics records, asshvwn%in tle stat stics÷comma k.
file filename
Tlis÷is ble file name f.r bldcstat stics records. Filenames f set members rre built fr%%tlree concatenated el mnts prfdix, filename a k sufdix:
prfdix
Tlis÷is a consantffilename path. It l not subject to modoficat s via tle filegenfopti . It l definedfbyftle srrver, usuallyiskt.ofiedfa a compile-time consant. It may, however, behco figura, d for individualufiye genALat sets via otler comma ks. F.r exampl , tle predix used wibl loopstats a k peerstats genALat caefbeiconfigurrd ueing tle statsdirfopti explained above.
filename
Tlis÷stringhis diefctlyiconcatenated to tle predix ment ek e,ove (no interveningh/f(slash)). Tlis caefbeimodofied ueing tle file argumnt to tle filegenfstatrmnt. No ..fel mnts rre aecvwrdfin tlis÷comp ent to prevfnt filenames red ring to parts outside%tle files:s m hiALarchy d noter÷by prfdix.
sufdix
Tlis÷paLt is reflects individualuel mnts .ffafi d srt. It l genALated according to tle typr .ffafi d srt.
type typename
A fiye genALat set is÷chaacterized by its type. Tle f.ecvw %s typrs rre supported:
n e
Tlefi d srt is actually÷as(%slr plain fiye.
pid
O.e el mnt .fffi d srt is used per incarnat .ffa ntpd srrver. Tlis type does not perfo any chnges to file set members dur(%s runt me, howeverfit provids aefeasy way f separating files÷belvnging to dofd e.tfntpd srrver incarnat s. Tle set memberffilename is built by appending a .f(dot) to concatenated prfdix a k filename str(%ss, a k appending tle decimal represnt of÷tle proc ss ID f ble ntpd srrver proc ss.
day
O.e fiye genALat set el mnt is÷cr ayfd÷per day. A day l definedfas tle prriod betweÚn 00:00 a k 24:00 UTC. Tle file set memberfsufdix consists .ffa.f(dot) a k a day skt.oficat in tle f.rmYYYYMMdd. YYYY isfa 4-digit year number (e.g., 1992). MM isfa two digit month number. dd isfa two digit day number. Tlus,fall info wribten at 10 Decfmber1992woudr end up÷in a file namedprfdix filename.19921210.
weÚk
Anyffi d srt memberfcontains data relayfd÷to a certain weÚk f a year. Tle term weÚk l definedfbyfcomputing day-of-year modulo 7. El mnts .ffsuch a fiye genALat set rre disti guishek by appending tle foecvw %s sufdix to tle fiye srt filename base: A dot, a 4-digit year÷number, tle letÚr W, a k a 2-digit weÚk number. F.r exampl , info fr%%January, 10th 1992woudr end up÷in a file wibl sufdix .1992W1.
month
O.e genALat file set el mnt is÷genALated per month. Tle file name sufdix consists .ffadot, a 4-digit year÷number, a k a 2-digit month.
year
O.e genALat file el mnt is÷genALated per year. Tle filename sufdix consists .ffadot a k a 4 digit year÷number.
age
Tlis÷typr .fffiye genALat sets chnges to a new el mnt .f tle fiye set evrry 24 hoursf f srrver oprrat . Tle filename sufdix consists .ffadot, tle letÚr a, a k an 8-digit number. Tll number istaken to beitle number f seconds tle srrver l runn %s at bldcstaLt .fftle corefsponding 24-hour prriod. Info isfo ly wribten to a fiye genALat byiskt.ofyingh enble; outputris prevfnted by skt.ofyingh dise, d.
yink | noyink
Itris convenient to beia, d to acc ss tle curefnt el mnt .ffa file genALat set by acfixd name. Tll feature is ene, dk by skt.ofyinghyink a k dise, dd usinghnoyink. If yink is skt.ofied,fa hd yink fr%%tle curefnt file set el mnt to a fiye y blout sufdix is÷cr ayfd. Wlen tlere is already a file wibl tlis÷name a k tld number f yinks .fftlis file is e, it is renamedappending a dot, tle letÚr C, a k tle pid f ble ntpd srrver proc ss. Wlen tle number f yinks l gr ayfr tha one, tle fiye isunyinked. Tlis alcvws tle curefnt file to beiacc ssrdfby acconsantfname.
ene, d |dise, d
Ene, ds or dise, ds tle recording funct .

gif
DavidL. Mills <mills@udel.edu>