{
    "mode": "man",
    "parameter": "sa1",
    "section": "8",
    "url": "https://www.chedong.com/phpMan.php/man/sa1/8/json",
    "generated": "2026-05-30T06:05:45Z",
    "synopsis": "/usr/lib/sysstat/sa1 [ --boot | --rotate [ iso ] | --sleep | interval count ]",
    "sections": {
        "NAME": {
            "content": "sa1 - Collect and store binary data in the system activity daily data file.\n\n",
            "subsections": []
        },
        "SYNOPSIS": {
            "content": "/usr/lib/sysstat/sa1 [ --boot | --rotate [ iso ] | --sleep | interval count ]\n\n",
            "subsections": []
        },
        "DESCRIPTION": {
            "content": "The sa1 command is a shell procedure variant of the sadc command and handles all of the flags\nand parameters of that command. The sa1 command collects and stores binary data in  the  cur‐\nrent standard system activity daily data file.\n\nThe  standard  system activity daily data file is named saDD unless sadc's option -D is used,\nin which case its name is saYYYYMMDD, where YYYY stands for the current year, MM for the cur‐\nrent  month  and DD for the current day. By default it is located in the /var/log/sysstat di‐\nrectory.\n\nThe interval and count parameters specify that the record should be written  count  times  at\ninterval seconds. If no arguments are given to sa1 then a single record is written.\n\nThe sa1 command is designed to be started automatically by the cron command.\n\n",
            "subsections": []
        },
        "OPTIONS": {
            "content": "--boot This  option  tells  sa1 that the sadc command should be called without specifying the\ninterval and count parameters in order to insert a dummy record, marking the time when\nthe counters restart from 0.\n",
            "subsections": [
                {
                    "name": "--rotate [ iso ]",
                    "content": "Use this option to tell sa1 to insert a record of statistics to the standard saDD sys‐\ntem activity daily data file of the previous day.  This should be done  shortly  after\nmidnight  (on day DD+1) in order to make sure that the data file covers the whole day,\nincluding the last interval of time just before  midnight.   Adding  the  iso  keyword\ntells sa1 to use saYYYYMMDD instead of saDD as the standard system activity daily data\nfile name.\n",
                    "long": "--rotate"
                },
                {
                    "name": "--sleep",
                    "content": "This option tells sa1 that the sadc command should insert a  comment  indicating  that\nthe system is entering or leaving sleep mode (i.e. system suspend or hibernation).\n\n",
                    "long": "--sleep"
                }
            ]
        },
        "EXAMPLE": {
            "content": "To  collect  data (including those from disks) every 10 minutes, place the following entry in\nyour root crontab file:\n\n0,10,20,30,40,50 * * * * /usr/lib/sysstat/sa1 1 1 -S DISK\n\nTo rotate current system activity daily data file, ensuring it is complete, place the follow‐\ning entry in your root crontab file:\n\n0 0 * * * /usr/lib/sysstat/sa1 --rotate\n\n",
            "subsections": [
                {
                    "name": "Debian note",
                    "content": "The  Debian  sysstat package has already placed such an entry in your system crontab.  Please\nrefer to the /usr/share/doc/sysstat/README.Debian file for details.\n\n"
                }
            ]
        },
        "FILES": {
            "content": "/var/log/sysstat/saDD\n/var/log/sysstat/saYYYYMMDD\nThe standard system activity daily data files and their default location.  YYYY stands\nfor the current year, MM for the current month and DD for the current day.\n\n",
            "subsections": []
        },
        "AUTHOR": {
            "content": "Sebastien Godard (sysstat <at> orange.fr)\n\n",
            "subsections": []
        },
        "SEE ALSO": {
            "content": "sar(1), sadc(8), sa2(8), sadf(1), sysstat(5)\n\nhttps://github.com/sysstat/sysstat\nhttp://pagesperso-orange.fr/sebastien.godard/\n\n\n\nLinux                                       NOVEMBER 2020                                     SA1(8)",
            "subsections": []
        }
    },
    "summary": "sa1 - Collect and store binary data in the system activity daily data file.",
    "flags": [
        {
            "flag": "",
            "long": "--rotate",
            "arg": null,
            "description": "Use this option to tell sa1 to insert a record of statistics to the standard saDD sys‐ tem 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, including 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."
        },
        {
            "flag": "",
            "long": "--sleep",
            "arg": null,
            "description": "This option tells sa1 that the sadc command should insert a comment indicating that the system is entering or leaving sleep mode (i.e. system suspend or hibernation)."
        }
    ],
    "examples": [
        "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/lib/sysstat/sa1 1 1 -S DISK",
        "To rotate current system activity daily data file, ensuring it is complete, place the follow‐",
        "ing entry in your root crontab file:",
        "0 0 * * * /usr/lib/sysstat/sa1 --rotate",
        "The  Debian  sysstat package has already placed such an entry in your system crontab.  Please",
        "refer to the /usr/share/doc/sysstat/README.Debian file for details."
    ],
    "see_also": [
        {
            "name": "sar",
            "section": "1",
            "url": "https://www.chedong.com/phpMan.php/man/sar/1/json"
        },
        {
            "name": "sadc",
            "section": "8",
            "url": "https://www.chedong.com/phpMan.php/man/sadc/8/json"
        },
        {
            "name": "sa2",
            "section": "8",
            "url": "https://www.chedong.com/phpMan.php/man/sa2/8/json"
        },
        {
            "name": "sadf",
            "section": "1",
            "url": "https://www.chedong.com/phpMan.php/man/sadf/1/json"
        },
        {
            "name": "sysstat",
            "section": "5",
            "url": "https://www.chedong.com/phpMan.php/man/sysstat/5/json"
        }
    ]
}