| 1 |
.\" sa1 manual page - (C) 1999-2020 Sebastien Godard (sysstat <at> orange.fr) |
| 2 |
.TH SA1 8 "AUGUST 2023" Linux "Linux User's Manual" -*- nroff -*- |
| 3 |
.SH NAME |
| 4 |
sa1 \- Collect and store binary data in the system activity daily data file. |
| 5 |
|
| 6 |
.SH SYNOPSIS |
| 7 |
.B /usr/libexec/sysstat/sa1 [ \-\-boot | \-\-rotate [ iso ] | \-\-sleep | |
| 8 |
.I interval count |
| 9 |
.B ] |
| 10 |
|
| 11 |
.SH DESCRIPTION |
| 12 |
.RB "The " "sa1" |
| 13 |
.RB "command is a shell procedure variant of the " "sadc" |
| 14 |
command and handles all of the flags and parameters of that command. The |
| 15 |
.B sa1 |
| 16 |
command collects and stores binary data in the current standard |
| 17 |
system activity daily data file. |
| 18 |
.PP |
| 19 |
The standard system activity daily data file is named |
| 20 |
.IR "saDD " "unless" |
| 21 |
.BR "sadc" "'s option " "\-D " "is used, in which case its name is" |
| 22 |
.IR "saYYYYMMDD" "," |
| 23 |
.RI "where " "YYYY " "stands for the current year, " "MM " "for the current month and " "DD" |
| 24 |
for the current day. By default it is located in the |
| 25 |
.I /var/log/sysstat |
| 26 |
directory. |
| 27 |
.PP |
| 28 |
.RI "The " "interval " "and " "count" |
| 29 |
parameters specify that the record should be written |
| 30 |
.IR "count " "times at " "interval" |
| 31 |
seconds. If no arguments are given to |
| 32 |
.B sa1 |
| 33 |
then a single record is written. |
| 34 |
|
| 35 |
The |
| 36 |
.B sa1 |
| 37 |
command is designed to be started automatically by the |
| 38 |
.BR "cron " "command." |
| 39 |
|
| 40 |
.SH OPTIONS |
| 41 |
.TP |
| 42 |
.B \-\-boot |
| 43 |
This option tells |
| 44 |
.BR "sa1 " "that the " "sadc" |
| 45 |
command should be called without specifying the |
| 46 |
.IR "interval " "and " "count" |
| 47 |
parameters in order to insert a dummy record, marking the time when the counters |
| 48 |
restart from 0. |
| 49 |
.TP |
| 50 |
.B \-\-rotate [ iso ] |
| 51 |
.RB "Use this option to tell " "sa1 " "to insert a record of statistics to the standard" |
| 52 |
.IR "saDD" " system activity daily data file of the previous day." |
| 53 |
This should be done shortly after midnight (on day DD+1) in order to make sure that the |
| 54 |
data file covers the whole day, including the last interval of time just before midnight. |
| 55 |
.RB "Adding the " "iso" " keyword tells " "sa1" " to use |
| 56 |
.IR "saYYYYMMDD" " instead of " "saDD" " as the standard system activity daily data file name." |
| 57 |
.TP |
| 58 |
.B \-\-sleep |
| 59 |
.RB "This option tells " "sa1 " "that the " "sadc" |
| 60 |
command should insert a comment indicating that the system is entering or leaving |
| 61 |
sleep mode (i.e. system suspend or hibernation). |
| 62 |
|
| 63 |
.SH EXAMPLE |
| 64 |
To collect data (including those from disks) every 10 minutes, |
| 65 |
place the following entry in your root crontab file: |
| 66 |
|
| 67 |
.B 0,10,20,30,40,50 * * * * /usr/libexec/sysstat/sa1 1 1 \-S DISK |
| 68 |
|
| 69 |
To rotate current system activity daily data file, ensuring it is complete, |
| 70 |
place the following entry in your root crontab file: |
| 71 |
|
| 72 |
.B 0 0 * * * /usr/libexec/sysstat/sa1 \-\-rotate |
| 73 |
|
| 74 |
.SS Debian note |
| 75 |
The Debian sysstat package has already placed such an entry in your system crontab. |
| 76 |
Please refer to the |
| 77 |
.I /usr/share/doc/sysstat/README.Debian |
| 78 |
file for details. |
| 79 |
|
| 80 |
.SH FILES |
| 81 |
.I /var/log/sysstat/saDD |
| 82 |
.br |
| 83 |
.I /var/log/sysstat/saYYYYMMDD |
| 84 |
.RS |
| 85 |
The standard system activity daily data files and their default location. |
| 86 |
.IR "YYYY " "stands for the current year, " "MM " "for the current month and " "DD" |
| 87 |
for the current day. |
| 88 |
|
| 89 |
.SH AUTHOR |
| 90 |
Sebastien Godard (sysstat <at> orange.fr) |
| 91 |
|
| 92 |
.SH SEE ALSO |
| 93 |
.BR "sar" "(1), " "sadc" "(8), " "sa2" "(8), " "sadf" "(1), " "sysstat" "(5)" |
| 94 |
.PP |
| 95 |
.I https://github.com/sysstat/sysstat |
| 96 |
.br |
| 97 |
.I https://sysstat.github.io/ |