Help for http://netmon.physics.carleton.ca/cgi-bin/ping_data.pl
ping_data.pl
is a CGI script that enables one to gather the pingER data for a
user specified time window for user specified remote sites().
It is acccessed via a URL. The default by accessing
http://<monitoring_host>/cgi-bin/ping_data.pl is to display a
form allowing the user to select the time and remote site(s).
It is also available as a program API (using Lynx or wget)
with the user specifying the various parameters
as part of the QUERY_STRING.
The parameters are:
either:
begin_year, begin_month, begin_day, begin_hour, begin_min, begin_sec, begin_offset:
gives the starting time, begin_offset is the offset from UDT.
end_year, end_month, end_day, end_hour, end_min, end_sec, end_offset:
gives the ending time
or:
begin, end: begin and end times as Unix epoch times.
in_form: 1 if no form is to be displayed, undefined otherwise in which case form displayed and exits
begin_point: y|n, include or do not include beginning point (default = no).
end_point: y|n, see above but replace begnning by ending
Input:
The list of remote nodes is obtained from /usr/local/share/pinger/beacons.txt
The raw PingER data is obtained from the directory /usr/local/share/pinger/, /usr/local/share/pinger/data
The raw data format is in text form and is described at
https://confluence.slac.stanford.edu/display/IEPM/PingER+Monitor+node+format
The records within the time window are found using a binary search on
the Unix time stamps in the records
Output:
If successful then data is returned in records of the form:
pinger.slac.stanford.edu 134.79.104.80 www.eldjazair.net.dz 193.194.64.71 100 1301011226 10 10 217.482 217.923 219.169 0 1 2 3 4 5 6 7 8 9 218 217 219 218 218 217 217 217 217 217
If there is no data then 'No data' will appear in the data. This is needed
by getdata.pl which gets the data.
Examples of URL calls:
http://www.slac.stanford.edu/cgi-wrap/ping_data.pl?help=1
http://www.comsats.edu.pk/cgi-bin/ping_data.pl
http://pinger.comsats.edu.pk/cgi-bin/ping_data.pl?in_form=1&begin_hour=00&begin_min=00&begin_sec=00&begin_day=06&begin_month=08&begin_year=2007&begin_offset=&begin_point=y&end_hour=23&end_min=59&end_sec=59&end_day=06&end_month=08&end_year=2007&end_offset=&end_point=y
More generically
http://www.xxx.yyy.zzz/cgi-bin/ping_data.pl?site=a&site=b&site=c&begin=x&end=y&begin_point=n&end_point=n
http://www.xxx.yy.zzz/cgi-bin/ping_data.pl?site=a&site=b&site=c&begin_hour=HH&begin_min=MM&begin_sec=SS&begin_offset=[-]HH&begin_day=DD&begin_month=MM&begin_year=YYYY&end_hour=HH&end_min=MM&end_sec=SS&end_offset=[-]HH&end_day=DD&end_month=MM&end_year=YYYY&begin_point=n&end_point=n
Acknowledgments:
ping_data.pl originally written by David E. Martin of HEP Network Resource Center, Fermilab, Batavia, IL
based on work done by Connie Logg and Les Cottrell at the Stanford Linear Accelerator Center
Heavily modified over the years by Les Cottrell, SLAC and others in particular
Fahad Satti.
Version=4.5 7/27/2018 Les Cottrell