|AMREPORT(8)||System Administration Commands||AMREPORT(8)|
NAME¶amreport - generate a formatted output of statistics for an Amanda run
amreport [-o configoption...]
[(1) command-line options | (2) script options]
[--text=filename] [--xml=filename] [--print=printer]
(2) [-i] [-M address] [-l logfile] [-f outputfile] [-p postscriptfile] [--from-amdump]
DESCRIPTION¶Amreport generates a summary report of an Amanda backup run.
See the amanda(8) man page for more details about Amanda.
Amreport operates in two distinct modes. Command-line mode is intended for use by an administrator from the command line, and uses long command-line options for clarity. Script mode is intended for use from scripts such as amdump, and has a lot of non-obvious default behaviors to suit that need.
Unless a script-mode option is given, amreport defaults to command-line mode. If no options are given, amreport writes a report for the most recent logfile to stdout.
Command-Line Mode Options¶--log=logfile
Valid module provided with amanda are: human, json, json_raw, ps and xml, valid destination are file, mail and print, the DEST-ARG depend on the destination.
The default destination is file.
The default arg for file destination is '-' (stdout).
The default arg for mail destination is the MAILTO configuration option.
The default arg for print destination is the PRINTER configuration option.
--format=human --format=human:mail --format=human:mail:root --format=human:file:/tmp/report.text --format=xml:file:/tmp/report.xml --format=ps:file:/tmp/report.ps --format=ps:print:lp
Same as --format=ps, --format=ps:file:filename
Same as --format=human, --format=human:file:filename
Same as --format=xml, --format=xml:file:filename
Same as --format=ps:print, --format=ps:print:printer
Same as --format=human:mail, --format=human:mail:recipient
Script Mode Options¶-i
TEXT REPORT FORMAT¶Amanda's text report format is divided into several sections. Some of these sections only appear if they are not empty.
Although newer versions of Amanda try to use the term "volume" to refer to a unit of storage, amreport still uses the term "tape", even if backups are done to non-tape devices, to allow scripts which parse amreport's output to continue to function.
Hostname: bkserver Org : DailySet1 Config : Daily Date : February 25, 2009 These dumps were to tape Daily-103. The next tape Amanda expects to use is: Daily-142 FAILURE DUMP SUMMARY: jamon.slikon.local /var lev 0 FAILED [/bin/tar exited with status 2]
The summary section describes the run in broad terms, giving the server hostname, organization (from the org configuration parameter), configuration name, and dump date. This is followed by a description of the volumes and holding disk used, and an rough estimate of the volume(s) Amanda will use on the next run.
Brief notices of any unusual circumstances will also be included here.
STATISTICS: Total Full Incr. -------- -------- -------- Estimate Time (hrs:min) 0:00 Run Time (hrs:min) 0:01 Dump Time (hrs:min) 0:00 0:00 0:00 Output Size (meg) 1.6 0.0 1.6 Original Size (meg) 1.6 0.0 1.6 Avg Compressed Size (%) 100.0 100.0 100.0 (level:#disks ...) Filesystems Dumped 4 1 3 (1:3) Avg Dump Rate (k/s) 1555.1 134.2 1787.3 Tape Time (hrs:min) 0:00 0:00 0:00 Tape Size (meg) 1.6 0.0 1.6 Tape Used (%) 5.5 0.1 5.4 (level:#disks ...) Filesystems Taped 4 1 3 (1:3) (level:#parts ...) Parts Taped 4 1 3 (1:3) Avg Tp Write Rate (k/s) 143966 27624.3 151811 USAGE BY TAPE: Label Time Size % DLEs Parts metals-013 0:00 1650k 5.4 4 4
This section contains aggregate statistics for the entire run. The three columns break down the results into a total for all data handled, only full dumps, and only incremental dumps. In the right margin, amreport indicates the breakdown of dump levels at the dumper and the taper.
The rows have the following meanings:
Avg Compressed Size
Avg Dump Rate
Avg Tp Write Rate
Usage by Tape¶
USAGE BY TAPE: Label Time Size % DLEs Parts Conf-001 0:00 20320k 66.2 1 4 Conf-002 0:00 6470k 21.1 0 2
This short section gives per-volume statistics: time spent writing to the volume; bytes written to the volume; portion of the expected tape length used; number of DLEs started, and total number of split parts written.
NOTES: taper: tape DAILY-37 kb 30720 fm 3 [OK]
This section contains any informational log messages from the run. Most messages are self-explanatory. The taper message shown in the example is always present, and is redundant to the previous section. It indicates that 30720 kb were written to "DAILY-37" in 3 files.
Failure and Strange Details¶
FAILED DUMP DETAILS: /-- jamon.slikon.local /var lev 0 FAILED [/bin/tar exited with status 2] sendbackup: info BACKUP=APPLICATION sendbackup: info APPLICATION=amgtar sendbackup: info RECOVER_CMD=/usr/bin/gzip -dc |amgtar -f... - sendbackup: info COMPRESS_SUFFIX=.gz sendbackup: info end ? /bin/tar: ./gdm: Cannot savedir: Permission denied | Total bytes written: 943831040 (901MiB, 4.9MiB/s) | /bin/tar: Error exit delayed from previous errors sendbackup: error [/bin/tar exited with status 2] sendbackup: size 921710 sendbackup: end \\-------- STRANGE DUMP DETAILS: /-- bsdfw.slikon.local / lev 0 STRANGE sendbackup: info BACKUP=APPLICATION sendbackup: info APPLICATION=amgtar sendbackup: info RECOVER_CMD=/usr/bin/gzip -dc |amgtar -f... - sendbackup: info COMPRESS_SUFFIX=.gz sendbackup: info end | /bin/tar: ./tmp/.X11-unix/X0: socket ignored | Total bytes written: 5530869760 (5.2GiB, 3.0MiB/s) sendbackup: size 5401240 sendbackup: end \\--------
This section expands on failures and strange results indicated in earlier sections. In both cases, the details contain a messages produced by the underlying backup tool - GNU tar, in this example. Failed dumps have actually failed, and the reasons are usually clear. Strange dumps, however, are regarded as successful by Amanda, but contain messages that Amanda did not recognize and which may be of interest to the operator.
DUMP SUMMARY: DUMPER STATS TAPER STATS HOSTNAME DISK L ORIG-kB OUT-kB COMP% MMM:SS KB/s MMM:SS KB/s -------------------------- ------------------------------------- --------------- strontium /etc 1 270 270 -- 0:00 1146.3 0:00 140918.6 strontium -me/elantra 1 10 10 -- 0:00 65.6 0:00 9033.4 strontium /local 0 20 20 -- 0:00 133.9 0:00 27624.3 strontium -ository_13 1 1350 1350 -- 0:01 2568.5 0:00 175006.5
The dump summary table has one row for each DLE processed during the run. The "L" column gives the level of the dump. The remaining colums are divided into dumper stats and taper stats.
The dumper stats give the original (before compression) and output (after compression) size of each dump, as well as a compression ratio, if applicable. The column labeled "MMM:SS" gives the time spent on that dump, and the next column is the calculated dump rate.
The taper stats give the time and speed with which the dump was written to storage. This value is the sum of the times for each part, and as such does not include time spent switching volumes.
LABEL PRINTING¶Amanda can print postscript labels describing the contents of tape(s) written in a run. The labels are designed to be folded and inserted into the tape case along with the tape or hole punched and put in a 3-ring binder. Various label templates are provided to format data for different tape sizes.
The information printed varies slightly between label templates due to size constraints. Labels contain one line for each host/file-system pair and may also contain the file number on the tape, the level of the dump, the original size of the dump and the size of the (possibly compressed) tape file.
Add the lbl-templ parameter to the tapetype definition in amanda.conf to enable labels. If you don't add this line to your tapetype definition, amreport will not print tape labels.
You may use the printer keyword in amanda.conf to print to other than the system default printer.
TEMPLATES¶Amanda provides label templates for the following tape types. These are pretty generic labels and should be easy to customize for other tape types or particular site needs.
* ExaByte 8mm tapes * DAT 4mm tapes * DLT tapes * 3-ring binder
The 3-ring binder type is the most generic. It may be used to make a hardcopy log of the tapes.
EXIT CODE¶The exit code of amreport is the ORed value of:
0 = success 1 = error 2 = a dle give strange message 4 = a dle failed 8 = Don't know the status of a dle (RESULT_MISSING in the report) 16 = tape error or no more tape
SEE ALSO¶amanda(8), amflush(8)
The Amanda Wiki: : http://wiki.zmanda.com/
AUTHOR¶Stefan G. Weichinger <firstname.lastname@example.org>