|
Packit |
667938 |
=head1 NAME
|
|
Packit |
667938 |
|
|
Packit |
667938 |
mrtg-logfile - description of the mrtg-2 logfile format
|
|
Packit |
667938 |
|
|
Packit |
667938 |
=head1 SYNOPSIS
|
|
Packit |
667938 |
|
|
Packit |
667938 |
This document provides a description of the contents of
|
|
Packit |
667938 |
the mrtg-2 logfile.
|
|
Packit |
667938 |
|
|
Packit |
667938 |
=head1 OVERVIEW
|
|
Packit |
667938 |
|
|
Packit |
667938 |
The logfile consists of two main sections.
|
|
Packit |
667938 |
|
|
Packit |
667938 |
=over
|
|
Packit |
667938 |
|
|
Packit |
667938 |
=item The first Line
|
|
Packit |
667938 |
|
|
Packit |
667938 |
It stores the traffic counters from the most recent run of mrtg.
|
|
Packit |
667938 |
|
|
Packit |
667938 |
=item The rest of the File
|
|
Packit |
667938 |
|
|
Packit |
667938 |
Stores past traffic rate averates and maxima at increassing
|
|
Packit |
667938 |
intervals.
|
|
Packit |
667938 |
|
|
Packit |
667938 |
=back
|
|
Packit |
667938 |
|
|
Packit |
667938 |
The first number on each line is a unix time stamp. It represents
|
|
Packit |
667938 |
the number of seconds since 1970.
|
|
Packit |
667938 |
|
|
Packit |
667938 |
=head1 DETAILS
|
|
Packit |
667938 |
|
|
Packit |
667938 |
=head2 The first Line
|
|
Packit |
667938 |
|
|
Packit |
667938 |
The first line has 3 numbers which are:
|
|
Packit |
667938 |
|
|
Packit |
667938 |
=over
|
|
Packit |
667938 |
|
|
Packit |
667938 |
=item A (1st column)
|
|
Packit |
667938 |
|
|
Packit |
667938 |
A timestamp of when MRTG last ran for this interface. The timestamp is the
|
|
Packit |
667938 |
number of non-skip seconds passed since the standard UNIX "epoch" of midnight
|
|
Packit |
667938 |
on 1st of January 1970 GMT.
|
|
Packit |
667938 |
|
|
Packit |
667938 |
=item B (2nd column)
|
|
Packit |
667938 |
|
|
Packit |
667938 |
The "incoming bytes counter" value.
|
|
Packit |
667938 |
|
|
Packit |
667938 |
=item C (3rd column)
|
|
Packit |
667938 |
|
|
Packit |
667938 |
The "outgoing bytes counter" value.
|
|
Packit |
667938 |
|
|
Packit |
667938 |
=back
|
|
Packit |
667938 |
|
|
Packit |
667938 |
=head2 The rest of the File
|
|
Packit |
667938 |
|
|
Packit |
667938 |
The second and remaining lines of the file contains 5 numbers
|
|
Packit |
667938 |
which are:
|
|
Packit |
667938 |
|
|
Packit |
667938 |
=over
|
|
Packit |
667938 |
|
|
Packit |
667938 |
=item A (1st column)
|
|
Packit |
667938 |
|
|
Packit |
667938 |
The Unix timestamp for the point in time the data on this line is relevant.
|
|
Packit |
667938 |
Note that the interval between timestamps increases as you progress through the
|
|
Packit |
667938 |
file. At first it is 5 minutes and at the end it is one day between two lines.
|
|
Packit |
667938 |
|
|
Packit |
667938 |
This timestamp may be converted in OpenOffice Calc or MS Excel by using the
|
|
Packit |
667938 |
following formula
|
|
Packit |
667938 |
|
|
Packit |
667938 |
=(x+y)/86400+DATE(1970;1;1)
|
|
Packit |
667938 |
|
|
Packit |
667938 |
(instead of ";" it may be that you have to use "," this depends on the context and your locale settings)
|
|
Packit |
667938 |
|
|
Packit |
667938 |
you can also ask perl to help by typing
|
|
Packit |
667938 |
|
|
Packit |
667938 |
perl -e 'print scalar localtime(x),"\n"'
|
|
Packit |
667938 |
|
|
Packit |
667938 |
B<x> is the unix timestamp and B<y> is the offset in seconds
|
|
Packit |
667938 |
from UTC. (Perl knows B<y>).
|
|
Packit |
667938 |
|
|
Packit |
667938 |
|
|
Packit |
667938 |
=item B (2nd column)
|
|
Packit |
667938 |
|
|
Packit |
667938 |
The average incoming transfer rate in bytes per second. This is valid
|
|
Packit |
667938 |
for the time between the A value of the current line and the A value of the
|
|
Packit |
667938 |
previous line.
|
|
Packit |
667938 |
|
|
Packit |
667938 |
=item C (3rd column)
|
|
Packit |
667938 |
|
|
Packit |
667938 |
The average outgoing transfer rate in bytes per second since the previous
|
|
Packit |
667938 |
measurement.
|
|
Packit |
667938 |
|
|
Packit |
667938 |
=item D (4th column)
|
|
Packit |
667938 |
|
|
Packit |
667938 |
The maximum incoming transfer rate in bytes per second for the current
|
|
Packit |
667938 |
interval. This is calculated from all the updates which have occured in the
|
|
Packit |
667938 |
current interval. If the current interval is 1 hour, and updates have
|
|
Packit |
667938 |
occured every 5 minutes, it will be the biggest 5 minute transfer rate seen
|
|
Packit |
667938 |
during the hour.
|
|
Packit |
667938 |
|
|
Packit |
667938 |
=item E (5th column)
|
|
Packit |
667938 |
|
|
Packit |
667938 |
The maximum outgoing transfer rate in bytes per second for the current interval.
|
|
Packit |
667938 |
|
|
Packit |
667938 |
=back
|
|
Packit |
667938 |
|
|
Packit |
667938 |
=head1 AUTHOR
|
|
Packit |
667938 |
|
|
Packit |
667938 |
Butch Kemper E<lt>kemper@bihs.netE<gt> and
|
|
Packit |
667938 |
Tobias Oetiker E<lt>tobi@oetiker.chE<gt>
|