...
PingER SmokePing Integration aims at using Smokepings's rrd tool to visually display pingER's data in the form of graphs.
...
{
Background
| Note |
|---|
Need some background as to what the format of the pinger files are, and where they are located |
...
| Note |
|---|
you need to mention that the the pinger data is to be converted into rrds. this section needs to determing the mapping between the pinger logs and the rrd data form. indepth description of the rrd creation and data structure needs to be mentioned here. also what are the benefits and disadvantages of the rrd structure. |
Package Description
...
SelectSrcDest.pm
...
This is the Perl module that acts as a daemon process and runs as a cron every night, to call the main conversion module, which is the PingERtoSmokeping.pm. As it traverses the PingER data and converts it into SmokePing format .rrd files using the PingERtoSmokeping.pm, it also enters information into the srcdest.txt file of the data converted. This information includes the name of monitoring sites and under the name of each monitoring site is listed the identification keys corresponding each monitoring site. The identification key consists of the following information with an underscore between each piece of information:
- The monitoring site host name
- The remote site host name
- Number of bytes per ping
- Number of pings sent to remote host
An example of information contained in the srcdest.txt file is:
| Code Block |
|---|
monitor.niit.edu.pk
monitor.niit.edu.pk_monalisa.niit.edu.pk_1000_10
monitor.niit.edu.pk_monalisa.niit.edu.pk_100_10
monitor.niit.edu.pk_www.niit.edu.pk_1000_10
****
|
| Code Block |
|---|
The four stars separate the information of one
monitoring site from the other. The benefit of this srcdest.txt file is that a
list of keys against which the converted data is available, is formed so that
when a user clicks on one item in the list the graph.cgi can plot the converted
data against the key. Conversely if the file was not there, and the user
entered his choice of monitoring site, remote site, ping packet site, number of
ping packets hoping that the data for this combination is present, he might be
wrong. It's easy for the user to select what exists, then to let him guess by
allowing him to make the selection.
PingERtoSmokeping.pm
This is the main conversion code, which is
called by the daemon process SrcDest.pm daily to convert the data for the last 120 days from that date. After an RRD file has been formed for a single source
and destination pair (and number of bytes per ping and pings per remote site),
then next day only one day's data will be appended at the end of the file and
the data for the first day removed. In this way there will always be data in
the file for the "last" 120 days. It is necessary to mention that PingER files
within a particular folder consist of all the data for a source (one folder for
each source is there).
CGI Modules
Form.cgi
Displays the data in srcdest.txt file to the user, so that the user can make his selection
graph.cgi
Generates graphs using the rrd graph method.
saveimage.cgi
It is called from graph.cgi and displays the contents of the image to the user.
Modules | Function |
|---|---|
SelectConvSrcDest1.pm | This program is to be setup as a cron job to run every 24 hours (after installing on a server with a PingER data source) |
PingERtoSmokeping.pm | PingERtoSmokeping.pm is a tool to convert PingER data files into Smokeping data files. |
Configuration files | Function |
srcdest.txt | The file that stores unique SourceSite_DestinationSite_PacketsSize_NumberOfPings(maximum) combinations found in PingER data. |
CGIs | Function |
form.cgi | Displays the SourceSite_DestinationSite_PacketsSize_NumberOfPings(maximum) RRDs(data) available for the monitoring site or node slected from pingtable.pl by user. |
graph.cgi | Generates graphs from the rrd files on the fly and display them to the user and then deletes the graph from cache |
saveimage.cgi | Displays the contents of the image to the user |
...
The image is created in /tmp/ directory
Form.cgi
Displays the SourceSite_DestinationSite_PacketsSize_NumberOfPings(maximum) RRDs(data) available for the monitoring site or node slected from pingtable.pl by user.
...