borg-analyze - Analyze archives

       The Borg Collective

                                                   2025-01-03                                    BORG-ANALYZE(1)

       Analyze archives to find "hot spots".

       Borg  analyze  relies  on  the  usual  archive  matching  options  to  select the archives that should be
       considered for analysis (e.g. -aseries_name).  Then it iterates over all  matching  archives,  over  all
       contained files and collects information about chunks stored in all directories it encountered.

       It  considers  chunk  IDs  and their plaintext sizes (we don't have the compressed size in the repository
       easily available) and adds up added/removed chunks' sizes per direct parent directory and outputs a  list
       of "directory: size".

       You can use that list to find directories with a lot of "activity" - maybe some of these are temporary or
       cache directories you did forget to exclude.

       To  not have these unwanted directories in your backups, you could carefully exclude these in borgcreate
       (for future backups) or use borgrecreate to re-create existing archives without these.

       borg-analyze - Analyze archives

       See borg-common(1) for common options of Borg commands.

   Archivefilters-aPATTERN, --match-archivesPATTERN
              only consider archives matching all patterns. see "borg help match-archives".

       --sort-byKEYS
              Comma-separated list of sorting keys; valid keys are: timestamp, archive, name,  id,  tags,  host,
              user; default is: timestamp

       --firstN
              consider first N archives after other filters were applied

       --lastN
              consider last N archives after other filters were applied

       --oldestTIMESPAN
              consider archives between the oldest archive's timestamp and (oldest + TIMESPAN), e.g. 7d or 12m.

       --newestTIMESPAN
              consider archives between the newest archive's timestamp and (newest - TIMESPAN), e.g. 7d or 12m.

       --olderTIMESPAN
              consider archives older than (now - TIMESPAN), e.g. 7d or 12m.

       --newerTIMESPAN
              consider archives newer than (now - TIMESPAN), e.g. 7d or 12m.

borg-common(1)

       borg [common options] analyze [options]