ATOP-DAILY(1)

πŸ“¦ version 7.2.2, in arch rolling, fedora 43, fedora 44, ubuntu stonking

πŸ’– atop-daily(1) β€” the daily glow-up your PCP archives deserve πŸ’–

okay bestie, welcome to the General Commands Manual section of the vibes, where atop-daily lives. she's a shell script, she's booked and busy, and she handles the daily maintenance of your pcp-atop(1) PCP archives. no cap. πŸŽ€


✨ SYNOPSIS ✨

$PCP_BINADM_DIR/atop-daily [--compress-only] [--help] [LOGPATH]

🌸 DESCRIPTION 🌸

so like, atop-daily does the daily maintenance of pcp-atop(1) PCP archives. she's not out here freelancing β€” she's normally called from systemd(1) via the atop-daily.timer unit, or she gets summoned automatically by pcp-atop(1) itself at startup. she's that girl who shows up when the timer goes off, periodt. β°πŸ’…

when you run her with no options at all, she:

  1. creates the archive directory if it's not there yet (manifesting it into existence ✨)
  2. compresses prior-day archives β€” xz(1) for the metadata, zstd(1) for the data volumes (different tools for different jobs, we love a specialist πŸ’œ)
  3. culls archives that are older than LOGGENERATIONS days (default 28) β€” old archives, you're done here, thank u next πŸ™ˆ

and here's the iconic part: compression is non-blocking. files get atomically renamed and then compressed by background processes, so the caller and pcp-atop(1) can just keep it moving immediately. nobody's waiting around in this group chat. πŸ’«


πŸ’… OPTIONS πŸ’…

  • --compress-only β€” compress prior-day archives and that's IT, she will not cull old archives. this is the mode used when pcp-atop(1) itself calls her at startup. culling? not today. πŸš«πŸ—‘οΈ
  • --help β€” prints a usage message and dips. short, sweet, iconic. 🫢

πŸ¦‹ CONFIGURATION πŸ¦‹

you can set these environment variables in the pcp-atop(1) sysconfig file, which lives at /etc/sysconfig/atop or /etc/default/atop (whichever one your system is serving πŸ“):

  • LOGPATH β€” the archive directory. default: /var/log/atop. you can ALSO pass this as a command line argument instead, so flexible of her. 🌈
  • LOGGENERATIONS β€” how many days of archives to keep around. default: 28. and listen: a value of 0 disables culling entirely. zero means never let go, i guess πŸ˜­πŸ’€

πŸŽ€ FILES πŸŽ€

  • /var/log/atop β€” the default directory where pcp-atop(1) archive files hang out. it's giving home base. πŸ‘‘

⭐ SEE ALSO ⭐

pcp-atop(1), pcp-atopsar(1), PCPIntro(1), systemd(1), xz(1), zstd(1), pcp.conf(5) and pcp.env(5).

go read those too, bestie, knowledge is the moment. πŸ“šβœ¨


and that's the whole page, no crumbs left πŸ’– this little writeup came to you from Performance Co-Pilot (that's the source) over at PCP, and the page itself is ATOP-DAILY(1) β€” stay compressed, stay culled, stay iconic, mwah πŸ˜˜πŸ’…

πŸ“¦ where this page comes from