dwww Home | Manual pages | Find package

SA1(8)                        Linux User's Manual                        SA1(8)

NAME
       sa1  -  Collect  and store binary data in the system activity daily data
       file.

SYNOPSIS
       /usr/libexec/sysstat/sa1 [ --boot | --rotate [ iso ] | --sleep |  inter-
       val count ]

DESCRIPTION
       The  sa1  command  is  a shell procedure variant of the sadc command and
       handles all of the flags and parameters of that command. The sa1 command
       collects and stores binary data in the current standard system  activity
       daily data file.

       The standard system activity daily data file is named saDD unless sadc's
       option  -D  is  used,  in  which case its name is saYYYYMMDD, where YYYY
       stands for the current year, MM for the current month  and  DD  for  the
       current day. By default it is located in the /var/log/sysstat directory.

       The  interval  and  count  parameters  specify that the record should be
       written count times at interval seconds. If no arguments  are  given  to
       sa1 then a single record is written.

       The sa1 command is designed to be started automatically by the cron com-
       mand.

OPTIONS
       --boot This  option  tells  sa1  that  the sadc command should be called
              without specifying the interval and count parameters in order  to
              insert a dummy record, marking the time when the counters restart
              from 0.

       --rotate [ iso ]
              Use  this  option to tell sa1 to insert a record of statistics to
              the standard saDD system activity daily data file of the previous
              day.  This should be done shortly after midnight (on day DD+1) in
              order to make sure that the data file covers the whole  day,  in-
              cluding  the  last interval of time just before midnight.  Adding
              the iso keyword tells sa1 to use saYYYYMMDD instead  of  saDD  as
              the standard system activity daily data file name.

       --sleep
              This  option tells sa1 that the sadc command should insert a com-
              ment indicating that the system is entering or leaving sleep mode
              (i.e. system suspend or hibernation).

EXAMPLE
       To collect data (including those from disks) every 10 minutes, place the
       following entry in your root crontab file:

       0,10,20,30,40,50 * * * * /usr/libexec/sysstat/sa1 1 1 -S DISK

       To rotate current system activity daily data file, ensuring it  is  com-
       plete, place the following entry in your root crontab file:

       0 0 * * * /usr/libexec/sysstat/sa1 --rotate

   Debian note
       The Debian sysstat package has already placed such an entry in your sys-
       tem  crontab.   Please refer to the /usr/share/doc/sysstat/README.Debian
       file for details.

FILES
       /var/log/sysstat/saDD
       /var/log/sysstat/saYYYYMMDD
              The standard system activity daily data files and  their  default
              location.   YYYY  stands for the current year, MM for the current
              month and DD for the current day.

AUTHOR
       Sebastien Godard (sysstat <at> orange.fr)

SEE ALSO
       sar(1), sadc(8), sa2(8), sadf(1), sysstat(5)

       https://github.com/sysstat/sysstat
       https://sysstat.github.io/

Linux                             AUGUST 2023                            SA1(8)

Generated by dwww version 1.16 on Sat Oct 3 05:39:16 CEST 2026.