The scripts described in this chapter are used to retrieve the probe data from the MySQL data base. They return the filname(s) that are created with the data.
These all have the same arguments, except as noted below, and defaults are provided.
"-o" is the directory where the output is written, and /tmp is the default
"-n" is the aliasname of the desired node. If not provided the probe data for all the nodes is provided.
"-s" is the starttime, either in epoch seconds or standard date format ("10/6/2006 12:00:00")
"-e" is the endtime, either in epoch seconds or standard date format
"-h" is the monitoring host alias name and defaults to the host the code is executed on. (not required)
If "-e" and "-s" are not provided, the data for the last 24 hours is returned.
Note that the title line for the columns is prefixed with a '#' sign. These column names are significant, are they are used byt the analysis and plotting scripts. The analysis and plotting scripts call these scripts to get the data they need to work on.
fetch-bw-data [-n aliasname] [-o output_directory ] [-s starttime -e endtime] -T probetype
"fetch-bw-data" returns the data for the given probetype (-T) for the period indicated. "-T" probetypes are currently (iperf, miperf, tlaytcp, pathload, and pathchirp). The name of the file where the data is written is returned.
fetch-owping-data [-n aliasname] [-o output_directory ] [-s starttime -e endtime]
"fetch-owping-data" fetches the owamp data for the indicated node and time period. The name of the file is returned.
fetch-ping-data [-n aliasname] [-o output_directory ] [-s starttime -e endtime]
fetch-ping-data returns the name of the file where it writes the data.
fetch-trace-data [-n aliasname] [-o output_diretory ] [-s starttime -e endtime] [-a [0 | 1]]
"fetch-trace-data" returns the name of the file where the output is stored. The raw traceroute data is also fetched currently, and is stored also in the "-o" directory. Note the -a parameter. The tracelogs are anonomized if -a is not provided or is 1. Default for -a is 1. For the raw tracelogs -a 0 must be specified. The text of the traceroute output in in the file ending with ".tracelog". This returns the names of the two files where the data is written.
fetch-routeno-data [-n aliasname] [-o output_diretory ]
"fetch-routeno-data" creates a blank separated file of the route numbers and paths for the specified host and target nodes. The file name is returned. Start time and endtime are not applicable here.