amplot - visualize the behavior of Amanda


SYNOPSIS

       amplot  [  -c  ]  [  -e  ]  [  -g ] [ -l ] [ -p ] [ -t T ]
       amdump_files


DESCRIPTION

       Amplot reads an amdump output file that  Amanda  generates
       each  run  (e.g.  amdump.1) and translates the information
       into a picture format that may be used  to  determine  how
       your  installation  is doing and if any parameters need to
       be changed.  Amplot also prints out amdump lines  that  it
       either does not understand or knows to be warning or error
       lines and a summary of the start, end and total  time  for
       each backup image.

       Amplot  is  a  shell  script  that executes an awk program
       (amplot.awk) to scan the amdump output file.  It then exe­
       cutes  a gnuplot program (amplot.g) to generate the graph.
       The awk program is written in an enhanced version of  awk,
       such as GNU awk (gawk version 2.15 or later) or nawk.

       During  execution,  amplot generates a few temporary files
       that gnuplot uses.  These files are deleted at the end  of
       execution.

       See  the amanda(8) man page for more details about Amanda.


OPTIONS

       -c     Compress amdump_files after plotting.

       -e     Extend the X (time) axis if needed.

       -g     Direct gnuplot output directly to the  X11  display
              (default).

       -p     Direct postscript output to file YYYYMMDD.ps (oppo­
              site of -g).

       -l     Generate landscape oriented output.

       -t T   Set the right edge of the plot to be T hours.

       The amdump_files may  be  in  various  compressed  formats
       (compress, gzip, pact, compact).


INTERPRETATION

       The figure is divided into a number of regions.  There are
       titles on the top that show important statistical informa­
       tion  about  the  configuration and from this execution of
       amdump.  In the figure, the X axis is time, with  0  being
       the moment amdump was started.  The Y axis is divided into
       5 regions:

              many  are  waiting on space in the holding disk and
              how many  have  been  transferred  successfully  to
              tape.

              %BANDWIDTH: Percentage of allowed network bandwidth
              in use.

              HOLDING DISK: The higher line depicts  space  allo­
              cated  on  the  holding disk to backups in progress
              and completed backups  waiting  to  be  written  to
              tape.   The  lower line depicts the fraction of the
              holding disk containing completed  backups  waiting
              to  be written to tape including the file currently
              being written to tape.  The scale is percentage  of
              the holding disk.

              TAPE: Tape drive usage.

              %DUMPERS: Percentage of active dumpers.

       The idle period at the left of the graph is time amdump is
       asking the machines how much data they are going to  dump.
       This  process  can  take  a  while if hosts are down or it
       takes them a 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 needs to be
       taught about.


SEE ALSO

       amanda(8),  amdump(8),  gawk(1),  nawk(1),  awk(1),   gnu­
       plot(1), sh(1), compress(1), gzip(1)


Man(1) output converted with man2html