granicus.if.org Git - sysstat/blob - man/sa1.in

   1 .\" sa1 manual page - (C) 1999-2020 Sebastien Godard (sysstat <at> orange.fr)
   2 .TH SA1 8 "NOVEMBER 2020" 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 @SA_LIB_DIR@/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 @SA_DIR@
  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 * * * * @SA_LIB_DIR@/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 * * * @SA_LIB_DIR@/sa1 --rotate
  73
  74 .SH FILES
  75 .I @SA_DIR@/saDD
  76 .br
  77 .I @SA_DIR@/saYYYYMMDD
  78 .RS
  79 The standard system activity daily data files and their default location.
  80 .IR "YYYY " "stands for the current year, " "MM " "for the current month and " "DD"
  81 for the current day.
  82
  83 .SH AUTHOR
  84 Sebastien Godard (sysstat <at> orange.fr)
  85
  86 .SH SEE ALSO
  87 .BR "sar" "(1), " "sadc" "(8), " "sa2" "(8), " "sadf" "(1), " "sysstat" "(5)"
  88 .PP
  89 .I https://github.com/sysstat/sysstat
  90 .br
  91 .I http://pagesperso-orange.fr/sebastien.godard/