STANNIX Community


Manual: atopcat

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,	compressed length of the process-level information, compressed length of the cgroup-
	    level information, and compressed length of the PID list.

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_2024021[0-4] > week_2024_7

	 atop -r week_2024_7

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

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

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

	 atopcat /var/log/atop/atop_202401?? | 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_2024020[34] |
		     atopsar -m -r - -b 202402031400 -e 202402041100

       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_20240303 > /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)