ATOPCAT(1)                  General Commands Manual                 ATOPCAT(1)

NAME
       atopcat - concatenate raw log files to stdout

SYNOPSIS
       atopcat [-dv] rawfile [rawfile]...

DESCRIPTION
       The program atopcat can be used to concatenate several raw log files
       into one stream (stdout).  In this way, raw log files can be merged
       into one larger file by redirecting stdout to a file. Alternatively,
       merged data from several raw log files can be transferred directly into
       atop or atopsar via a pipe.

       Options:

       -d   dry-run: read logfile(s) but do not generate output on stdout

       -v   verbose: print one line per sample containing date/time, interval
            length in seconds, compressed length of the system-level
            information and compressed length of the process-level
            information.

EXAMPLES
       Concatenate the raw log files of five contiguous working days, write it
       into a new raw log file for that week and view that week interactively:

         atopcat /var/log/atop/atop_2020021[0-4] > week_2020_7

         atop -r week_2020_7

       Concatenate the raw log files of a week and view that week
       interactively (since atop reads from a pipe, previous intervals can not
       be retrieved while viewing):

         atopcat /var/log/atop/atop_2020021[0-6] | atop -r -

       Concatenate all raw log files of January 2020 and generate parsable
       output about the CPU utilization:

         atopcat /var/log/atop/atop_202001?? | atop -r - -PCPU

       Concatenate the daily raw log files of February 3 and 4, and generate a
       report about memory utilization from 14:00h on the first day till
       11:00h on the second day:

         atopcat /var/log/atop/atop_2020020[34] |
                     atopsar -m -r - -b 202002031400 -e 202002041100

       Repair a raw log file from which the last interval has not been
       completely written (e.g. if you intend to expand the file with new
       samples):

         atopcat /var/log/atop/atop_20200303 > /tmp/repaired

       In the latter case, atopcat reports that the input file is incomplete
       and stops after the last consistent sample.

SEE ALSO
       atop(1), atopsar(1), atophide(1), atopconvert(1)
       https://www.atoptool.nl

AUTHOR
       Gerlof Langeveld (gerlof.langeveld@atoptool.nl)

Linux                            January 2024                       ATOPCAT(1)