2024-09-29 13:54:37 +00:00
|
|
|
.\" Man page generated from reStructuredText.
|
|
|
|
.
|
|
|
|
.
|
|
|
|
.nr rst2man-indent-level 0
|
|
|
|
.
|
|
|
|
.de1 rstReportMargin
|
|
|
|
\\$1 \\n[an-margin]
|
|
|
|
level \\n[rst2man-indent-level]
|
|
|
|
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
|
|
|
|
-
|
|
|
|
\\n[rst2man-indent0]
|
|
|
|
\\n[rst2man-indent1]
|
|
|
|
\\n[rst2man-indent2]
|
|
|
|
..
|
|
|
|
.de1 INDENT
|
|
|
|
.\" .rstReportMargin pre:
|
|
|
|
. RS \\$1
|
|
|
|
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
|
|
|
|
. nr rst2man-indent-level +1
|
|
|
|
.\" .rstReportMargin post:
|
|
|
|
..
|
|
|
|
.de UNINDENT
|
|
|
|
. RE
|
|
|
|
.\" indent \\n[an-margin]
|
|
|
|
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
|
|
|
|
.nr rst2man-indent-level -1
|
|
|
|
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
|
|
|
|
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
|
|
|
|
..
|
2024-10-31 19:50:06 +00:00
|
|
|
.TH "BORG-ANALYZE" 1 "2024-10-31" "" "borg backup tool"
|
2024-09-29 13:54:37 +00:00
|
|
|
.SH NAME
|
|
|
|
borg-analyze \- Analyze archives
|
|
|
|
.SH SYNOPSIS
|
|
|
|
.sp
|
|
|
|
borg [common options] analyze [options]
|
|
|
|
.SH DESCRIPTION
|
|
|
|
.sp
|
|
|
|
Analyze archives to find \(dqhot spots\(dq.
|
|
|
|
.sp
|
|
|
|
Borg analyze relies on the usual archive matching options to select the
|
|
|
|
archives that should be considered for analysis (e.g. \fB\-a series_name\fP).
|
|
|
|
Then it iterates over all matching archives, over all contained files and
|
|
|
|
collects information about chunks stored in all directories it encountered.
|
|
|
|
.sp
|
|
|
|
It considers chunk IDs and their plaintext sizes (we don\(aqt have the compressed
|
|
|
|
size in the repository easily available) and adds up added/removed chunks\(aq
|
|
|
|
sizes per direct parent directory and outputs a list of \(dqdirectory: size\(dq.
|
|
|
|
.sp
|
|
|
|
You can use that list to find directories with a lot of \(dqactivity\(dq \- maybe
|
|
|
|
some of these are temporary or cache directories you did forget to exclude.
|
|
|
|
.sp
|
|
|
|
To not have these unwanted directories in your backups, you could carefully
|
|
|
|
exclude these in \fBborg create\fP (for future backups) or use \fBborg recreate\fP
|
|
|
|
to re\-create existing archives without these.
|
|
|
|
.SH OPTIONS
|
|
|
|
.sp
|
|
|
|
See \fIborg\-common(1)\fP for common options of Borg commands.
|
|
|
|
.SS Archive filters
|
|
|
|
.INDENT 0.0
|
|
|
|
.TP
|
|
|
|
.BI \-a \ PATTERN\fR,\fB \ \-\-match\-archives \ PATTERN
|
|
|
|
only consider archives matching all patterns. see \(dqborg help match\-archives\(dq.
|
|
|
|
.TP
|
|
|
|
.BI \-\-sort\-by \ KEYS
|
|
|
|
Comma\-separated list of sorting keys; valid keys are: timestamp, archive, name, id, tags, host, user; default is: timestamp
|
|
|
|
.TP
|
|
|
|
.BI \-\-first \ N
|
|
|
|
consider first N archives after other filters were applied
|
|
|
|
.TP
|
|
|
|
.BI \-\-last \ N
|
|
|
|
consider last N archives after other filters were applied
|
|
|
|
.TP
|
|
|
|
.BI \-\-oldest \ TIMESPAN
|
|
|
|
consider archives between the oldest archive\(aqs timestamp and (oldest + TIMESPAN), e.g. 7d or 12m.
|
|
|
|
.TP
|
|
|
|
.BI \-\-newest \ TIMESPAN
|
|
|
|
consider archives between the newest archive\(aqs timestamp and (newest \- TIMESPAN), e.g. 7d or 12m.
|
|
|
|
.TP
|
|
|
|
.BI \-\-older \ TIMESPAN
|
|
|
|
consider archives older than (now \- TIMESPAN), e.g. 7d or 12m.
|
|
|
|
.TP
|
|
|
|
.BI \-\-newer \ TIMESPAN
|
|
|
|
consider archives newer than (now \- TIMESPAN), e.g. 7d or 12m.
|
|
|
|
.UNINDENT
|
|
|
|
.SH SEE ALSO
|
|
|
|
.sp
|
|
|
|
\fIborg\-common(1)\fP
|
|
|
|
.SH AUTHOR
|
|
|
|
The Borg Collective
|
|
|
|
.\" Generated by docutils manpage writer.
|
|
|
|
.
|