AMPLOT(8)

NAME
amplot - program to visualize the behavior of Amanda

SYNOPSIS
amplot [-c] [-e] [-g] [-l] [-p] [-t HOURS] <amdump_files>
     -c Compress the input amdump files after plotting
     -e Extends X (time) axes if needed
     -g Directs gnuplot output directly to screen
            [Default on]
     -l Landscape mode suitable for printing
     -p Postscript output
     -t T Set the right edge of the plot to be T hours amdump_files can be in various compressed formats, (compress, gzip, pact, compact).

DESCRIPTION
Amplot reads an amdump file that Amanda generates each night and translates the information in it into a nice picture format that can be used to determine how your installation is doing and if any parameters need to be changed. Amplot also prints out the amdump lines that it either does not understand or knows to be warning/error lines. Amplot is a shell script that executes an AWK program (amplot.awk) to scan the amdump file and then executes a GNUPLOT program (amplot.g) to generate the graph. The AWK program is written in the enhanced version of awk, this program has been run with gawk (version 2.15 and nawk) This tool was developed to examine how well Amanda was doing and to assist in the search of problems, and it has helped in finding many of them. Unless the -g flag is supplied Amplot generates a Postscript output file from named date.ps Example: 19930128.ps
During it's execution amplot generates a few temporary files that gnuplot uses, these files are deleted at the end of execution. If the files supplied to amdump are not compressed they are compressed after all the graphs have been generated, unless the -n flag is supplied.

INTERPRETATION
The figure is divided into number of regions. On the top there are titles that shows important statistical information about the configuration and statistics from this execution of Amanda In the figure X axis is time, 0 is the moment Amanda was started.
The Y axes is divided into 5 regions:

Active Dumpers: This shows percentage of dumpers that are dumping disks.

Tape Status: This shows when the tape drive is in use.

Holding Disk Allocation: The "higher" line depicts the space allocated on the holding disk to dumps in progress and completed dumps waiting to be written to the tape. The "lower" line depicts the fraction of holding disk containing completed dumps waiting to be written to tape including the file currently being written to tape. The scale is percentage of the holding disk.

Bandwidth allocation: Percentage of allowed network bandwidth that is allocated.

Queues: Amanda Driver maintains few queues and this region shows how many dumps have not been started, how many waiting on the holding disk, and how many have been transferred successfully to tape. The idle period in the beginning of the graph is while Amanda is asking the machines how much data they are going to dump. This process can take a while if any host is down, or it takes hosts long time to generate estimates.

AUTHOR
Olafur Gudmundsson ogud@tis.com
Trusted Information Systems, formerly at University of Maryland, College Park

BUGS
Reports lines it does not recognize, mainly error cases but some are legitimate lines the program does not recognize.

SEE ALSO
    gawk(1), nawk(1), awk(1), gnuplot(1), sh(1), compress(1), gzip(1)