git.gag.com Git - debian/amanda/blob - man/amplot.8

   1 .\"Generated by db2man.xsl. Don't modify this, modify the source.
   2 .de Sh \" Subsection
   3 .br
   4 .if t .Sp
   5 .ne 5
   6 .PP
   7 \fB\\$1\fR
   8 .PP
   9 ..
  10 .de Sp \" Vertical space (when we can't use .PP)
  11 .if t .sp .5v
  12 .if n .sp
  13 ..
  14 .de Ip \" List item
  15 .br
  16 .ie \\n(.$>=3 .ne \\$3
  17 .el .ne 3
  18 .IP "\\$1" \\$2
  19 ..
  20 .TH "AMPLOT" 8 "" "" ""
  21 .SH NAME
  22 amplot \- visualize the behavior of Amanda
  23 .SH "SYNOPSIS"
  24 .ad l
  25 .hy 0
  26 .HP 7
  27 \fBamplot\fR [\-b] [\-c] [\-e] [\-g] [\-l] [\-p] [\-t\ \fIT\fR] \fIamdump_files\fR
  28 .br
  29
  30 .ad
  31 .hy
  32
  33 .SH "DESCRIPTION"
  34
  35 .PP
  36 \fBAmplot\fR reads an \fBamdump\fR output file that \fBAmanda\fR generates each run (e\&.g\&. \fBamdump\&.1\fR) 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\&. \fBAmplot\fR also prints out \fBamdump\fR 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\&.
  37
  38 .PP
  39 \fBAmplot\fR is a shell script that executes an \fBawk\fR program \fB\fR(\fBamplot\&.awk\fR) to scan the \fBamdump\fR output file\&. It then executes a \fBgnuplot\fR program \fB\fR(\fBamplot\&.g\fR) to generate the graph\&. The \fBawk\fR program is written in an enhanced version of awk, such as GNU awk \fB\fR(\fBgawk\fR version 2\&.15 or later) or \fBnawk\fR\&.
  40
  41 .PP
  42 During execution, \fBamplot\fR generates a few temporary files that \fBgnuplot\fR uses\&. These files are deleted at the end of execution\&.
  43
  44 .PP
  45 See the \fBamanda\fR(8) man page for more details about \fBAmanda\fR\&.
  46
  47 .SH "OPTIONS"
  48
  49 .TP
  50 \fB\-b\fR
  51 Generate b/w postscript file (need \fB\-p\fR)\&.
  52
  53 .TP
  54 \fB\-c\fR
  55 Compress \fBamdump_files\fR after plotting\&.
  56
  57 .TP
  58 \fB\-e\fR
  59 Extend the X (time) axis if needed\&.
  60
  61 .TP
  62 \fB\-g\fR
  63 Direct \fBgnuplot\fR output directly to the X11 display (default)\&.
  64
  65 .TP
  66 \fB\-p\fR
  67 Direct postscript output to file \fB\fR\fBYYYYMMDD\fR\fB\&.ps\fR (opposite of \fB\-g\fR)\&.
  68
  69 .TP
  70 \fB\-l\fR
  71 Generate landscape oriented output (needs \fB\-p\fR)\&.
  72
  73 .TP
  74 \fB\-t \fR\fBT\fR
  75 Set the right edge of the plot to be \fBT\fR hours\&.
  76
  77 .PP
  78 The \fBamdump_files\fR may be in various compressed formats \fB\fR(\fBcompress\fR, \fBgzip\fR, \fBpact\fR, \fBcompact\fR)\&.
  79
  80 .SH "INTERPRETATION"
  81
  82 .PP
  83 The figure is divided into a number of regions\&. There are titles on the top that show important statistical information about the configuration and from this execution of \fBamdump\fR\&. In the figure, the X axis is time, with 0 being the moment \fBamdump\fR was started\&. The Y axis is divided into 5 regions:
  84
  85 .PP
  86 \fBQUEUES:\fR How many backups have not been started, how many are waiting on space in the holding disk and how many have been transferred successfully to tape\&.
  87
  88 .PP
  89 \fB%BANDWIDTH:\fR Percentage of allowed network bandwidth in use\&.
  90
  91 .PP
  92 \fBHOLDING DISK:\fR The higher line depicts space allocated 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\&.
  93
  94 .PP
  95 \fBTAPE:\fR Tape drive usage\&.
  96
  97 .PP
  98 \fB%DUMPERS:\fR Percentage of active dumpers\&.
  99
 100 .PP
 101 The idle period at the left of the graph is time \fBamdump\fR 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\&.
 102
 103 .SH "AUTHOR"
 104
 105 .PP
 106 Olafur Gudmundsson <ogud@tis\&.com>, Trusted Information Systems, formerly at University of Maryland, College Park: Original text
 107
 108 .PP
 109 Stefan G\&. Weichinger, <sgw@amanda\&.org>, maintainer of the \fBAmanda\fR\-documentation: XML\-conversion
 110
 111 .SH "BUGS"
 112
 113 .PP
 114 Reports lines it does not recognize, mainly error cases but some are legitimate lines the program needs to be taught about\&.
 115
 116 .SH "SEE ALSO"
 117
 118 .PP
 119 \fBamanda\fR(8), \fBamdump\fR(8), \fBgawk\fR(1), \fBnawk\fR(1), \fBawk\fR(1), \fBgnuplot\fR(1), \fBsh\fR(1), \fBcompress\fR(1), \fBgzip\fR(1)
 120