{ "content": [ { "type": "text", "text": "# sa1 (info)\n\n## NAME\n\nsa1 - Collect and store binary data in the system activity daily data file.\n\n## SYNOPSIS\n\n/usr/lib/sysstat/sa1 [ --boot | --rotate [ iso ] | --sleep | interval\ncount ]\n\n## DESCRIPTION\n\nThe sa1 command is a shell procedure variant of the sadc command and\nhandles all of the flags and parameters of that command. The sa1 com-\nmand collects and stores binary data in the current standard system ac-\ntivity daily data file.\n\n## Sections\n\n- **NAME**\n- **SYNOPSIS**\n- **DESCRIPTION**\n- **OPTIONS** (2 subsections)\n- **EXAMPLE**\n- **FILES**\n- **AUTHOR**\n- **SEE ALSO**\n\nUse structuredContent.sections for detailed options, examples, and full documentation.\n" } ], "structuredContent": { "command": "sa1", "section": "", "mode": "info", "summary": "sa1 - Collect and store binary data in the system activity daily data file.", "synopsis": "/usr/lib/sysstat/sa1 [ --boot | --rotate [ iso ] | --sleep | interval\ncount ]", "tldr_summary": null, "tldr_examples": [], "tldr_source": null, "flags": [ { "flag": "", "long": "--rotate", "arg": null, "description": "Use this option to tell sa1 to insert a record of statistics to the standard saDD system activity daily data file of the previ- ous 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 com- ment 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 com-", "plete, place the following entry in your root crontab file:", "0 0 * * * /usr/lib/sysstat/sa1 --rotate", "Debian note", "The Debian sysstat package has already placed such an entry in your", "system crontab. Please refer to the /usr/share/doc/sysstat/README.De-", "bian 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" } ], "section_outline": [ { "name": "NAME", "lines": 3, "subsections": [] }, { "name": "SYNOPSIS", "lines": 3, "subsections": [] }, { "name": "DESCRIPTION", "lines": 18, "subsections": [] }, { "name": "OPTIONS", "lines": 5, "subsections": [ { "name": "--rotate [ iso ]", "lines": 8, "long": "--rotate" }, { "name": "--sleep", "lines": 4, "long": "--sleep" } ] }, { "name": "EXAMPLE", "lines": 15, "subsections": [] }, { "name": "FILES", "lines": 6, "subsections": [] }, { "name": "AUTHOR", "lines": 2, "subsections": [] }, { "name": "SEE ALSO", "lines": 6, "subsections": [] } ], "sections": { "NAME": { "content": "sa1 - Collect and store binary data in the system activity daily data\nfile.\n", "subsections": [] }, "SYNOPSIS": { "content": "/usr/lib/sysstat/sa1 [ --boot | --rotate [ iso ] | --sleep | interval\ncount ]\n", "subsections": [] }, "DESCRIPTION": { "content": "The sa1 command is a shell procedure variant of the sadc command and\nhandles all of the flags and parameters of that command. The sa1 com-\nmand collects and stores binary data in the current standard system ac-\ntivity daily data file.\n\nThe standard system activity daily data file is named saDD unless\nsadc's option -D is used, in which case its name is saYYYYMMDD, where\nYYYY stands for the current year, MM for the current month and DD for\nthe 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\nwritten count times at interval seconds. If no arguments are given to\nsa1 then a single record is written.\n\nThe sa1 command is designed to be started automatically by the cron\ncommand.\n", "subsections": [] }, "OPTIONS": { "content": "--boot This option tells sa1 that the sadc command should be called\nwithout specifying the interval and count parameters in order to\ninsert a dummy record, marking the time when the counters\nrestart from 0.\n", "subsections": [ { "name": "--rotate [ iso ]", "content": "Use this option to tell sa1 to insert a record of statistics to\nthe standard saDD system activity daily data file of the previ-\nous day. This should be done shortly after midnight (on day\nDD+1) in order to make sure that the data file covers the whole\nday, including the last interval of time just before midnight.\nAdding the iso keyword tells sa1 to use saYYYYMMDD instead of\nsaDD as the standard system activity daily data file name.\n", "long": "--rotate" }, { "name": "--sleep", "content": "This option tells sa1 that the sadc command should insert a com-\nment indicating that the system is entering or leaving sleep\nmode (i.e. system suspend or hibernation).\n", "long": "--sleep" } ] }, "EXAMPLE": { "content": "To collect data (including those from disks) every 10 minutes, place\nthe following entry in your 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 com-\nplete, place the following entry in your root crontab file:\n\n0 0 * * * /usr/lib/sysstat/sa1 --rotate\n\nDebian note\nThe Debian sysstat package has already placed such an entry in your\nsystem crontab. Please refer to the /usr/share/doc/sysstat/README.De-\nbian file for details.\n", "subsections": [] }, "FILES": { "content": "/var/log/sysstat/saDD\n/var/log/sysstat/saYYYYMMDD\nThe standard system activity daily data files and their default\nlocation. YYYY stands for the current year, MM for the current\nmonth and DD for the current day.\n", "subsections": [] }, "AUTHOR": { "content": "Sebastien Godard (sysstat orange.fr)\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\nLinux NOVEMBER 2020 SA1(8)", "subsections": [] } } } }