Changeset eb2cf83a
- Timestamp:
- 05/07/2005 10:41:02 AM (19 years ago)
- Branches:
- 10.0, 10.1, 11.0, 11.1, 11.2, 11.3, 12.0, 12.1, 6.1, 6.2, 6.2.0, 6.2.0-rc1, 6.2.0-rc2, 6.3, 6.3-rc1, 6.3-rc2, 6.3-rc3, 7.10, 7.4, 7.5, 7.6, 7.6-blfs, 7.6-systemd, 7.7, 7.8, 7.9, 8.0, 8.1, 8.2, 8.3, 8.4, 9.0, 9.1, basic, bdubbs/svn, elogind, gnome, kde5-13430, kde5-14269, kde5-14686, kea, ken/TL2024, ken/inkscape-core-mods, ken/tuningfonts, krejzi/svn, lazarus, lxqt, nosym, perl-modules, plabs/newcss, plabs/python-mods, python3.11, qt5new, rahul/power-profiles-daemon, renodr/vulkan-addition, systemd-11177, systemd-13485, trunk, upgradedb, xry111/intltool, xry111/llvm18, xry111/soup3, xry111/test-20220226, xry111/xf86-video-removal
- Children:
- 25959fa
- Parents:
- 4b95c5d
- File:
-
- 1 edited
Legend:
- Unmodified
- Added
- Removed
-
general/sysutils/sysstat.xml
r4b95c5d reb2cf83a 14 14 15 15 <sect1 id="sysstat" xreflabel="Sysstat-&sysstat-version;"> 16 <sect1info> 17 <othername>$LastChangedBy$</othername> 18 <date>$Date$</date> 19 </sect1info> 20 <?dbhtml filename="sysstat.html"?> 21 <title>Sysstat-&sysstat-version;</title> 22 <indexterm zone="sysstat"> 23 <primary sortas="a-Sysstat">Sysstat</primary></indexterm> 24 25 <sect2> 26 <title>Introduction to <application>Sysstat</application></title> 27 28 <para>The <application>Sysstat</application> package contains utilities to 29 monitor system performance and usage activity. 30 <application>Sysstat</application> contains the <command>sar</command> utility, 31 common to many commercial Unixes, and tools you can schedule via cron to 32 collect and historize performance and activity data.</para> 33 34 <sect3><title>Package information</title> 35 <itemizedlist spacing='compact'> 36 <listitem><para>Download (HTTP): 37 <ulink url="&sysstat-download-http;"/></para></listitem> 38 <listitem><para>Download (FTP): 39 <ulink url="&sysstat-download-ftp;"/></para></listitem> 40 <listitem><para>Download MD5 sum: 41 &sysstat-md5sum;</para></listitem> 42 <listitem><para>Download size: 43 &sysstat-size;</para></listitem> 44 <listitem><para>Estimated disk space required: 45 &sysstat-buildsize;</para></listitem> 46 <listitem><para>Estimated build time: 47 &sysstat-time;</para></listitem></itemizedlist> 48 </sect3> 49 50 <sect3><title><application>Sysstat</application> dependencies</title> 51 <sect4><title>Recommended</title> 52 <para><xref linkend="fcron"/></para></sect4> 53 </sect3> 54 55 </sect2> 56 57 <sect2> 58 <title>Installation of <application>Sysstat</application></title> 59 60 <para>Install <application>Sysstat</application> by running the 61 following commands:</para> 62 63 <screen><userinput><command>make config && 64 make</command></userinput></screen> 65 66 <para>Now, as the root user:</para> 67 68 <screen><userinput role='root'><command>make install</command></userinput></screen> 69 70 </sect2> 71 72 <sect2> 73 <title>Command explanations</title> 74 75 <para><command>make config</command>: Runs the interactive configuration 76 process. The first question prompts you for an 77 <quote><computeroutput>Installation directory</computeroutput></quote>. Reply 78 with <filename class="directory">/usr</filename>, as 79 this is equivalent to <application>Autoconf</application>'s 80 <parameter>--prefix=/usr</parameter> parameter to 81 <command>configure</command>. For all other prompts, you may 82 press <command>Enter</command> to accept the (very sane) defaults. When 83 prompted for <quote><computeroutput>Number of daily data files to keep: 84 [7]</computeroutput></quote>, you may wish to keep a larger number of files. 85 However, don't exceed 25 because <application>Sysstat</application> will 86 resuse existing files the next month, leading to erroneous daily 87 reports.</para> 88 89 </sect2> 90 91 <sect2> 92 <title>Configuring <application>Sysstat</application></title> 93 94 <sect3><title>Cron information</title> 95 96 <para>To begin gathering <application>Sysstat</application> history 97 information, you must add to, or create a privileged user's crontab. The 98 default history data location is 99 <filename class="directory">/var/log/sa</filename>. The user running 100 <application>Sysstat</application> utilities via cron must have write 101 access to this location.</para> 102 103 <para>Below is an example of what to install in the crontab. Adjust the 104 parameters to suit your needs. Use <command>man sa1</command> and 105 <command>man sa2</command> for information about the commands.</para> 106 107 <screen><userinput># 8am-7pm activity reports every 10 minutes during weekdays 16 <?dbhtml filename="sysstat.html"?> 17 18 <sect1info> 19 <othername>$LastChangedBy$</othername> 20 <date>$Date$</date> 21 </sect1info> 22 23 <title>Sysstat-&sysstat-version;</title> 24 25 <indexterm zone="sysstat"> 26 <primary sortas="a-Sysstat">Sysstat</primary> 27 </indexterm> 28 29 <sect2 role="package"> 30 <title>Introduction to Sysstat</title> 31 32 <para>The <application>Sysstat</application> package contains utilities 33 to monitor system performance and usage activity. 34 <application>Sysstat</application> contains the <command>sar</command> 35 utility, common to many commercial Unixes, and tools you can schedule via 36 cron to collect and historize performance and activity data.</para> 37 38 <bridgehead renderas="sect3">Package Information</bridgehead> 39 <itemizedlist spacing="compact"> 40 <listitem> 41 <para>Download (HTTP): <ulink url="&sysstat-download-http;"/></para> 42 </listitem> 43 <listitem> 44 <para>Download (FTP): <ulink url="&sysstat-download-ftp;"/></para> 45 </listitem> 46 <listitem> 47 <para>Download MD5 sum: &sysstat-md5sum;</para> 48 </listitem> 49 <listitem> 50 <para>Download size: &sysstat-size;</para> 51 </listitem> 52 <listitem> 53 <para>Estimated disk space required: &sysstat-buildsize;</para> 54 </listitem> 55 <listitem> 56 <para>Estimated build time: &sysstat-time;</para> 57 </listitem> 58 </itemizedlist> 59 60 <bridgehead renderas="sect3">Sysstat Dependencies</bridgehead> 61 62 <bridgehead renderas="sect4">Recommended</bridgehead> 63 <para><xref linkend="fcron"/></para> 64 65 </sect2> 66 67 <sect2 role="installation"> 68 <title>Installation of Sysstat</title> 69 70 <para>Install <application>Sysstat</application> by running the 71 following commands:</para> 72 73 <screen><userinput>make config && 74 make</userinput></screen> 75 76 <para>Now, as the <systemitem class="username">root</systemitem> user:</para> 77 78 <screen role="root"><userinput>make install</userinput></screen> 79 80 </sect2> 81 82 <sect2 role="commands"> 83 <title>Command Explanations</title> 84 85 <para><command>make config</command>: Runs the interactive configuration 86 process. The first question prompts you for an 87 <quote><computeroutput>Installation directory</computeroutput></quote>. 88 Reply with <filename class="directory">/usr</filename>, as this is equivalent to 89 <application>Autoconf</application>'s <option>--prefix=/usr</option> parameter 90 to <command>configure</command>. For all other prompts, you may 91 press <keycap>Enter</keycap> to accept the (very sane) defaults. When 92 prompted for <quote><computeroutput>Number of daily data files to keep: 93 [7]</computeroutput></quote>, you may wish to keep a larger number of files. 94 However, don't exceed 25 because <application>Sysstat</application> will 95 resuse existing files the next month, leading to erroneous daily reports.</para> 96 97 </sect2> 98 99 <sect2 role="configuration"> 100 <title>Configuring Sysstat</title> 101 102 <sect3> 103 <title>Cron Information</title> 104 105 <para>To begin gathering <application>Sysstat</application> history 106 information, you must add to, or create a privileged user's crontab. The 107 default history data location is 108 <filename class="directory">/var/log/sa</filename>. The user running 109 <application>Sysstat</application> utilities via cron must have write 110 access to this location.</para> 111 112 <para>Below is an example of what to install in the crontab. Adjust the 113 parameters to suit your needs. Use <command>man sa1</command> and 114 <command>man sa2</command> for information about the commands.</para> 115 116 <screen><literal># 8am-7pm activity reports every 10 minutes during weekdays 108 117 0 8-18 * * 1-5 /usr/lib/sa/sa1 600 6 & 109 118 … … 115 124 116 125 # Daily summary prepared at 19:05 117 5 19 * * * /usr/lib/sa/sa2 -A &</userinput></screen> 118 119 <para>Ensure you submit the revised crontab to the cron daemon.</para> 120 </sect3> 121 122 <sect3 id="sysstat-init"><title>System startup information</title> 123 <indexterm zone="sysstat sysstat-init"> 124 <primary sortas="f-sysstat">sysstat</primary></indexterm> 125 126 <para>At system startup, a LINUX RESTART message must be inserted in the daily 127 data file to reinitialize the kernel counters. This can be automated by 128 installing the <filename>/etc/rc.d/init.d/sysstat</filename> init script 129 included in the <xref linkend="intro-important-bootscripts"/> package using 130 the following command:</para> 131 132 <screen><userinput role='root'><command>make install-sysstat</command></userinput></screen> 133 </sect3> 134 135 </sect2> 136 137 <sect2> 138 <title>Contents</title> 139 140 <segmentedlist> 141 <segtitle>Installed Programs</segtitle> 142 <segtitle>Installed Libraries</segtitle> 143 <segtitle>Installed Directories</segtitle> 144 145 <seglistitem> 146 <seg>iostat, mpstat, sar, sa1, sa2 and sadc</seg> 147 <seg>None</seg> 148 <seg>/usr/lib/sa and /var/log/sa</seg> 149 </seglistitem> 150 </segmentedlist> 151 152 <variablelist> 153 <bridgehead renderas="sect3">Short Descriptions</bridgehead> 154 <?dbfo list-presentation="list"?> 155 156 <varlistentry id="iostat"> 157 <term><command>iostat</command></term> 158 <listitem><para>reports <acronym>CPU</acronym> statistics and input/output 159 statistics for devices and partitions.</para> 160 <indexterm zone="sysstat iostat"> 161 <primary sortas="b-iostat">iostat</primary> 162 </indexterm></listitem> 163 </varlistentry> 164 165 <varlistentry id="mpstat"> 166 <term><command>mpstat</command></term> 167 <listitem><para>reports individual or combined processor related 168 statistics.</para> 169 <indexterm zone="sysstat mpstat"> 170 <primary sortas="b-mpstat">mpstat</primary> 171 </indexterm></listitem> 172 </varlistentry> 173 174 <varlistentry id="sar"> 175 <term><command>sar</command></term> 176 <listitem><para> collects, reports and saves system activity 177 information.</para> 178 <indexterm zone="sysstat sar"> 179 <primary sortas="b-sar">sar</primary> 180 </indexterm></listitem> 181 </varlistentry> 182 183 <varlistentry id="sa1"> 184 <term><command>sa1</command></term> 185 <listitem><para>collects and stores binary data in the system activity daily 186 data file. It is a front end to <filename>sadc</filename> designed to be run 187 from cron.</para> 188 <indexterm zone="sysstat sa1"> 189 <primary sortas="b-sa1">sa1</primary> 190 </indexterm></listitem> 191 </varlistentry> 192 193 <varlistentry id="sa2"> 194 <term><command>sa2</command></term> 195 <listitem><para>writes a summarized daily activity report. It is a front end 196 to <command>sar</command> designed to be run from cron.</para> 197 <indexterm zone="sysstat sa2"> 198 <primary sortas="b-sa2">sa2</primary> 199 </indexterm></listitem> 200 </varlistentry> 201 202 <varlistentry id="sadc"> 203 <term><command>sadc</command></term> 204 <listitem><para>is the system activity data collector, used as a backend for 205 <command>sar</command>.</para> 206 <indexterm zone="sysstat sadc"> 207 <primary sortas="b-sadc">sadc</primary> 208 </indexterm></listitem> 209 </varlistentry> 210 </variablelist> 211 212 </sect2> 126 5 19 * * * /usr/lib/sa/sa2 -A &</literal></screen> 127 128 <para>Ensure you submit the revised crontab to the cron daemon.</para> 129 130 </sect3> 131 132 <sect3 id="sysstat-init"> 133 <title>System Startup Information</title> 134 135 <indexterm zone="sysstat sysstat-init"> 136 <primary sortas="f-sysstat">sysstat</primary> 137 </indexterm> 138 139 <para>At system startup, a LINUX RESTART message must be inserted in the daily 140 data file to reinitialize the kernel counters. This can be automated by 141 installing the <filename>/etc/rc.d/init.d/sysstat</filename> init script 142 included in the <xref linkend="intro-important-bootscripts"/> package using 143 the following command:</para> 144 145 <screen role="root"><userinput>make install-sysstat</userinput></screen> 146 147 </sect3> 148 149 </sect2> 150 151 <sect2 role="content"> 152 <title>Contents</title> 153 154 <segmentedlist> 155 <segtitle>Installed Programs</segtitle> 156 <segtitle>Installed Libraries</segtitle> 157 <segtitle>Installed Directories</segtitle> 158 159 <seglistitem> 160 <seg>iostat, mpstat, sar, sa1, sa2, and sadc</seg> 161 <seg>None</seg> 162 <seg>/usr/lib/sa and /var/log/sa</seg> 163 </seglistitem> 164 </segmentedlist> 165 166 <variablelist> 167 <bridgehead renderas="sect3">Short Descriptions</bridgehead> 168 <?dbfo list-presentation="list"?> 169 <?dbhtml list-presentation="table"?> 170 171 <varlistentry id="iostat"> 172 <term><command>iostat</command></term> 173 <listitem> 174 <para>reports <acronym>CPU</acronym> statistics and input/output 175 statistics for devices and partitions.</para> 176 <indexterm zone="sysstat iostat"> 177 <primary sortas="b-iostat">iostat</primary> 178 </indexterm> 179 </listitem> 180 </varlistentry> 181 182 <varlistentry id="mpstat"> 183 <term><command>mpstat</command></term> 184 <listitem> 185 <para>reports individual or combined processor related statistics.</para> 186 <indexterm zone="sysstat mpstat"> 187 <primary sortas="b-mpstat">mpstat</primary> 188 </indexterm> 189 </listitem> 190 </varlistentry> 191 192 <varlistentry id="sar"> 193 <term><command>sar</command></term> 194 <listitem> 195 <para> collects, reports and saves system activity information.</para> 196 <indexterm zone="sysstat sar"> 197 <primary sortas="b-sar">sar</primary> 198 </indexterm> 199 </listitem> 200 </varlistentry> 201 202 <varlistentry id="sa1"> 203 <term><command>sa1</command></term> 204 <listitem> 205 <para>collects and stores binary data in the system activity daily 206 data file. It is a front end to <filename>sadc</filename> designed to be run 207 from cron.</para> 208 <indexterm zone="sysstat sa1"> 209 <primary sortas="b-sa1">sa1</primary> 210 </indexterm> 211 </listitem> 212 </varlistentry> 213 214 <varlistentry id="sa2"> 215 <term><command>sa2</command></term> 216 <listitem> 217 <para>writes a summarized daily activity report. It is a front end 218 to <command>sar</command> designed to be run from cron.</para> 219 <indexterm zone="sysstat sa2"> 220 <primary sortas="b-sa2">sa2</primary> 221 </indexterm> 222 </listitem> 223 </varlistentry> 224 225 <varlistentry id="sadc"> 226 <term><command>sadc</command></term> 227 <listitem> 228 <para>is the system activity data collector, used as a backend for 229 <command>sar</command>.</para> 230 <indexterm zone="sysstat sadc"> 231 <primary sortas="b-sadc">sadc</primary> 232 </indexterm> 233 </listitem> 234 </varlistentry> 235 236 </variablelist> 237 238 </sect2> 213 239 214 240 </sect1>
Note:
See TracChangeset
for help on using the changeset viewer.