<?xml version="1.0"?>
<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
"http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd" [
<!ENTITY legal SYSTEM "legal.xml">
<!ENTITY appletversion "1.10.2">
<!ENTITY manrevision "2.12">
<!ENTITY date "July 2015">
<!ENTITY applet "System Monitor">
]>
<!--
(Do not remove this comment block.)
Maintained by the MATE Documentation Project
http://wiki.mate-desktop.org/dev-doc:doc-team-guide
Template version: 2.0 beta
Template last modified Apr 11, 2002
-->
<!-- =============Document Header ============================= -->
<article id="index" lang="en">
<!-- please do not change the id; for translations, change lang to -->
<!-- appropriate code -->
<articleinfo>
<title>&applet; Manual</title>
<abstract role="description">
<para>&applet; displays system load information in graphical
format in a panel.</para>
</abstract>
<copyright>
<year>2015</year>
<holder>MATE Documentation Project</holder>
</copyright>
<copyright>
<year>2005</year>
<holder>Davyd Madeley</holder>
</copyright>
<copyright>
<year>2004</year>
<holder>Sun Microsystems</holder>
</copyright>
<copyright>
<year>2003</year>
<year>2004</year>
<holder>Chee Bin HOH</holder>
</copyright>
<!-- translators: uncomment this:
<copyright>
<year>2002</year>
<holder>ME-THE-TRANSLATOR (Latin translation)</holder>
</copyright>
-->
<publisher role="maintainer">
<publishername> MATE Documentation Project </publishername>
</publisher>
<publisher>
<publishername> GNOME Documentation Project </publishername>
</publisher>
&legal;
<!-- This file contains link to license for the documentation (GNU FDL), and
other legal stuff such as "NO WARRANTY" statement. Please do not change
any of this. -->
<authorgroup>
<author>
<firstname>MATE Documentation Team</firstname>
<surname></surname>
<affiliation>
<orgname>MATE Desktop</orgname>
</affiliation>
</author>
<author>
<firstname>Angela</firstname>
<surname>Boyle</surname>
<affiliation><address>
<email>aboyle@aboyle.com</email>
</address></affiliation>
</author>
<author>
<firstname>Chee Bin</firstname>
<surname>HOH</surname>
<affiliation>
<orgname>GNOME Documentation Project</orgname>
<address><email>cbhoh@mimos.my</email></address>
</affiliation>
</author>
<author>
<firstname>Davyd</firstname><surname>Madeley</surname>
<affiliation>
<orgname>GNOME Project</orgname>
<address><email>davyd@madeley.id.au</email></address>
</affiliation>
</author>
<!-- This is appropriate place for other contributors: translators,
maintainers, etc. Commented out by default.
<othercredit role="translator">
<firstname>Latin</firstname>
<surname>Translator 1</surname>
<affiliation>
<orgname>Latin Translation Team</orgname>
<address> <email>translator@gnome.org</email> </address>
</affiliation>
<contrib>Latin translation</contrib>
</othercredit>
-->
</authorgroup>
<releaseinfo revision="1.10.2" role="review"/>
<revhistory>
<revision>
<revnumber>&applet; V&manrevision;</revnumber>
<date>&date;</date>
<revdescription>
<para role="author">MATE Documentation Team</para>
<para role="publisher">MATE Documentation Project</para>
</revdescription>
</revision>
<revision>
<revnumber>Version 2.10</revnumber>
<date>March 2005</date>
<revdescription>
<para role="author">Davyd Madeley</para>
</revdescription>
</revision>
<revision>
<revnumber>Version 2.8</revnumber>
<date>August 2004</date>
<revdescription>
<para role="author">Angela Boyle</para>
<para role="publisher">GNOME Documentation Project</para>
</revdescription>
</revision>
<revision>
<revnumber>System Monitor Applet Manual V2.1</revnumber>
<date>February 2004</date>
<revdescription>
<para role="author">Sun GNOME Documentation Team</para>
<para role="publisher">GNOME Documentation Project</para>
</revdescription>
</revision>
<revision>
<revnumber>System Monitor Applet Manual V2.0</revnumber>
<date>July 2003</date>
<revdescription>
<para role="author">Chee Bin HOH
<email>cbhoh@mimos.my</email>
</para>
<para role="publisher">GNOME Documentation Project</para>
</revdescription>
</revision>
</revhistory>
<releaseinfo> This manual describes version &appletversion; of &applet;.
</releaseinfo>
<legalnotice>
<title>Feedback</title>
<para> To report a bug or make a suggestion regarding the &applet; applet or this
manual, follow the directions in the
<ulink url="help:mate-user-guide/feedback" type="help">MATE Feedback Page</ulink>.
</para>
</legalnotice>
</articleinfo>
<indexterm zone="index">
<primary>&applet; Applet</primary>
</indexterm>
<indexterm zone="index">
<primary>&applet;</primary>
</indexterm>
<!-- ============= Document Body ============================= -->
<!-- ============= Introduction ============================== -->
<sect1 id="multiload-introduction">
<title>Introduction</title>
<!-- ==== Figure ============================================= -->
<figure id="system-monitor-applet-fig">
<title>&applet;</title>
<screenshot>
<mediaobject>
<imageobject><imagedata fileref="figures/system-monitor-applet_window.png"
format="PNG"/>
</imageobject>
<textobject>
<phrase>Shows &applet;. Displays a graph for system CPU load.
</phrase>
</textobject>
</mediaobject>
</screenshot>
</figure>
<!-- ==== End of Figure ======================================= -->
<para>
The <application>&applet;</application> displays
system load information in graphical format in a panel.
You can configure <application>&applet;</application> to display
the following information for your system:
</para>
<itemizedlist>
<listitem>
<para>
Usage of CPU (central processing unit) time
</para>
</listitem>
<listitem>
<para>
Memory usage
</para>
</listitem>
<listitem>
<para>
Network traffic
</para>
</listitem>
<listitem>
<para>
Usage of swap space
</para>
</listitem>
<listitem>
<para>
Average system load
</para>
</listitem>
<listitem><para>Disk load</para></listitem>
</itemizedlist>
<sect2 id="multiload-introduction-add">
<title>To Add &applet; to a Panel</title>
<para>
To add <application>&applet;</application> to a panel, perform the
following steps:
</para>
<orderedlist>
<listitem>
<para>
Right-click on the panel.
</para>
</listitem>
<listitem>
<para>
Choose <guimenuitem>Add to Panel</guimenuitem>.
</para>
</listitem>
<listitem>
<para>
Scroll down the list of items in the <guilabel>Add to Panel</guilabel>
dialog, then select <guilabel>&applet;</guilabel>.
</para>
</listitem>
<listitem>
<para>
Click <guibutton>Add</guibutton>.
</para>
</listitem>
</orderedlist>
<para>
The layout of the <application>&applet;</application> varies
depending on the size and type of panel in which the applet resides.
</para>
</sect2>
</sect1>
<!-- ================ Usage ================================ -->
<!-- Use this section to describe how to use the applet to perform the tasks for
which the applet is designed. -->
<sect1 id="multiload-usage">
<title>Viewing Graphs</title>
<!-- ================ displaying addistional graphics======================== -->
<sect2 id="multiload-usage-graphs">
<title>Displaying Additional Graphs</title>
<para>To configure the <application>&applet;</application> applet, right-click on the applet, then choose <guimenuitem>Preferences</guimenuitem>. Under <guilabel>Monitored Resources</guilabel> you can choose which graphics you want to display:</para>
<itemizedlist>
<listitem>
<para>
<guilabel>Processor</guilabel>
</para>
<para>
Select this option to display the graph for CPU usage.
</para>
</listitem>
<listitem>
<para>
<guilabel>Memory</guilabel>
</para>
<para>
Select this option to display the graph for memory usage.
</para>
</listitem>
<listitem>
<para>
<guilabel>Network</guilabel>
</para>
<para>
Select this option to display the graph for network traffic.
</para>
</listitem>
<listitem>
<para>
<guilabel>Swap Space</guilabel>
</para>
<para>
Select this option to display the graph for swap-space usage.
</para>
</listitem>
<listitem>
<para>
<guilabel>Load</guilabel>
</para>
<para>
Select this option to display the graph for average system load.
</para>
</listitem>
<listitem>
<para><guilabel>Harddisk</guilabel></para>
<para>
Select this option to display the graph for disk usage.
</para>
</listitem>
</itemizedlist>
</sect2>
<!-- ================ displaying current usage of system resources================== -->
<sect2 id="multiload-usage-current">
<title>To Display the Current Usage of a System Resource</title>
<para>
To display the current usage of a system resource,
position the mouse pointer over the corresponding graph in the applet.
A tooltip displays the current usage as a percentage.
</para>
</sect2>
<!-- ================ displaying additional info================== -->
<sect2 id="multiload-usage-extra">
<title>To Display Additional System Monitor Information</title>
<para>
To display additional system monitor information, right-click on the applet,
then choose <guimenuitem>Open System Monitor</guimenuitem> to start the
<application>System Monitor</application> application.
</para>
<para>
The <application>System Monitor</application> application
enables you to monitor system processes and usage of system resources.
You can use the <application>System Monitor</application> application
to modify the behavior of your system.
</para>
</sect2>
</sect1>
<!-- ============= Preferences =========================== -->
<sect1 id="multiload-prefs">
<title>Customizing Appearance</title>
<figure id="system-monitor-prefs-fig">
<title>Preferences Dialog</title>
<screenshot>
<mediaobject>
<imageobject><imagedata fileref="figures/multiload-preferences.png"
format="PNG"/>
</imageobject>
<textobject>
<phrase>Preferences Dialog
</phrase>
</textobject>
</mediaobject>
</screenshot>
</figure>
<sect2 id="multiload-size">
<title>To Change the Width</title>
<para>In the right-click menu, go to <guimenuitem>Preferences</guimenuitem>. Under <guilabel>Options</guilabel>, use the <guilabel>System monitor width</guilabel> spin box to specify the width of each <application>&applet;</application> graph in pixels.</para>
</sect2>
<sect2 id="multiload-update">
<title>To Update at Regular Intervals</title>
<para>In the right-click menu, go to <guimenuitem>Preferences</guimenuitem>. Under <guilabel>Options</guilabel>, use the <guilabel>System monitor update interval</guilabel> spin box to specify the interval at which you want to update the graphs in milliseconds.
</para>
</sect2>
<!-- ================ changing graph colors======================== -->
<sect2 id="multiload-usage-colors">
<title>Changing the Colors in a Graph</title>
<para>
To change the colors in a graph, perform the following steps:
</para>
<orderedlist>
<listitem>
<para>
Right-click on the applet, then choose <guimenuitem>Preferences</guimenuitem>.
</para>
</listitem>
<listitem>
<para>
Select the relevant tab in the <guilabel>Colors</guilabel> area of
the <guilabel>System Monitor Preferences</guilabel> dialog.
</para>
</listitem>
<listitem>
<para>
Click on the relevant color selector button in the selected tabbed section.
</para>
</listitem>
<listitem>
<para>
On the <guilabel>Pick a Color</guilabel> dialog,
use the color wheel or spin boxes to choose the line color
for the selected parameter.
</para>
</listitem>
<listitem>
<para>
Click <guibutton>OK</guibutton>.
</para>
</listitem>
</orderedlist>
<para>
The tabbed section for each resource provides color selection buttons
that you can use to change the color of the parameters for each resource.
</para>
<itemizedlist>
<listitem>
<para>
<guilabel>Processor</guilabel>
</para>
<para>
Select this tab to display the color buttons for the following parameters:
</para>
<informaltable frame="all">
<tgroup cols="2" colsep="1" rowsep="1">
<colspec colname="COLSPEC0" colwidth="50*"/>
<colspec colname="COLSPEC1" colwidth="50*"/>
<thead>
<row valign="top">
<entry colname="COLSPEC0">
<para>Parameter</para></entry>
<entry colname="COLSPEC1">
<para>Description</para></entry>
</row>
</thead>
<tbody>
<row valign="top">
<entry><para><guilabel>User</guilabel></para></entry>
<entry><para>Processor time used by non-kernel activities</para></entry>
</row>
<row valign="top">
<entry><para><guilabel>System</guilabel></para></entry>
<entry><para>Processor time used by kernel activities</para></entry>
</row>
<row valign="top">
<entry><para><guilabel>Nice</guilabel></para></entry>
<entry><para>Processor time used by low-priority processes</para></entry>
</row>
<row valign="top">
<entry><para><guilabel>IOWait</guilabel></para></entry>
<entry>
<para>Processor time used waiting for I/O</para>
</entry>
</row>
<row valign="top">
<entry><para><guilabel>Idle</guilabel></para></entry>
<entry><para>Unused processor capacity</para></entry>
</row>
</tbody>
</tgroup>
</informaltable>
</listitem>
<listitem>
<para>
<guilabel>Memory</guilabel>
</para>
<para>
Select this tab to display the color buttons for the following parameters:
</para>
<informaltable frame="all">
<tgroup cols="2" colsep="1" rowsep="1">
<colspec colname="COLSPEC0" colwidth="50*"/>
<colspec colname="COLSPEC1" colwidth="50*"/>
<thead>
<row valign="top">
<entry colname="COLSPEC0">
<para>Parameter</para></entry>
<entry colname="COLSPEC1">
<para>Description</para></entry>
</row>
</thead>
<tbody>
<row valign="top">
<entry><para><guilabel>User</guilabel></para></entry>
<entry><para>Memory used by non-kernel activities</para></entry>
</row>
<row valign="top">
<entry><para><guilabel>Shared</guilabel></para></entry>
<entry><para>Memory used by more than one application</para></entry>
</row>
<row valign="top">
<entry><para><guilabel>Buffers</guilabel></para></entry>
<entry><para>Memory used to temporarily store sent or received data</para></entry>
</row>
<row valign="top">
<entry><para><guilabel>Cached</guilabel></para></entry>
<entry><para>Memory used to store data for fast access</para></entry>
</row>
<row valign="top">
<entry><para><guilabel>Free</guilabel></para></entry>
<entry><para>Memory not currently in use</para></entry>
</row>
</tbody>
</tgroup>
</informaltable>
</listitem>
<listitem>
<para>
<guilabel>Network</guilabel>
</para>
<para>
Select this tab to display the color buttons for the following parameters:
</para>
<informaltable frame="all">
<tgroup cols="2" colsep="1" rowsep="1">
<colspec colname="COLSPEC0" colwidth="50*"/>
<colspec colname="COLSPEC1" colwidth="50*"/>
<thead>
<row valign="top">
<entry colname="COLSPEC0">
<para>Parameter</para></entry>
<entry colname="COLSPEC1">
<para>Description</para></entry>
</row>
</thead>
<tbody>
<row valign="top">
<entry><para><guilabel>In</guilabel></para></entry>
<entry><para>Incoming traffic</para></entry>
</row>
<row valign="top">
<entry><para><guilabel>Out</guilabel></para></entry>
<entry><para>Outgoing traffic</para></entry>
</row>
<row valign="top">
<entry><para><guilabel>Local</guilabel></para></entry>
<entry><para>Traffic over loopback</para></entry>
</row>
<row valign="top">
<entry><para><guilabel>Background</guilabel></para></entry>
<entry><para>Graph background color</para></entry>
</row>
<row valign="top">
<entry><para><guilabel>Gridline</guilabel></para></entry>
<entry><para>Color of horizontal gridline when scaling graph</para></entry>
</row>
<row valign="top">
<entry><para><guilabel>Indicator</guilabel></para></entry>
<entry><para>Color of indicator showing which threshold was reached</para></entry>
</row>
</tbody>
</tgroup>
</informaltable>
</listitem>
<listitem>
<para>
<guilabel>Swap Space</guilabel>
</para>
<para>
Select this tab to display the color buttons for the following parameters:
</para>
<informaltable frame="all">
<tgroup cols="2" colsep="1" rowsep="1">
<colspec colname="COLSPEC0" colwidth="50*"/>
<colspec colname="COLSPEC1" colwidth="50*"/>
<thead>
<row valign="top">
<entry colname="COLSPEC0">
<para>Parameter</para></entry>
<entry colname="COLSPEC1">
<para>Description</para></entry>
</row>
</thead>
<tbody>
<row valign="top">
<entry><para><guilabel>Used</guilabel></para></entry>
<entry>
<para>Swap space being used by the system</para>
</entry>
</row>
<row valign="top">
<entry><para><guilabel>Free</guilabel></para></entry>
<entry>
<para>Swap space that is free to be used</para>
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</listitem>
<listitem>
<para>
<guilabel>Load</guilabel>
</para>
<para>
Select this tab to display the color buttons for the following parameters:
</para>
<informaltable frame="all">
<tgroup cols="2" colsep="1" rowsep="1">
<colspec colname="COLSPEC0" colwidth="50*"/>
<colspec colname="COLSPEC1" colwidth="50*"/>
<thead>
<row valign="top">
<entry colname="COLSPEC0">
<para>Parameter</para></entry>
<entry colname="COLSPEC1">
<para>Description</para></entry>
</row>
</thead>
<tbody>
<row valign="top">
<entry><para><guilabel>Average</guilabel></para></entry>
<entry><para>System Load</para></entry>
</row>
<row valign="top">
<entry><para><guilabel>Background</guilabel></para></entry>
<entry><para>that is, no load</para></entry>
</row>
<row valign="top">
<entry><para><guilabel>Grid line</guilabel></para></entry>
<entry><para>Color of grid lines</para></entry>
</row>
</tbody>
</tgroup>
</informaltable>
</listitem>
<listitem>
<para>
<guilabel>Harddisk</guilabel>
</para>
<para>
Select this tab to display the color buttons for the following parameters:
</para>
<informaltable frame="all">
<tgroup cols="2" colsep="1" rowsep="1">
<colspec colname="COLSPEC0" colwidth="50*"/>
<colspec colname="COLSPEC1" colwidth="50*"/>
<thead>
<row valign="top">
<entry colname="COLSPEC0">
<para>Parameter</para></entry>
<entry colname="COLSPEC1">
<para>Description</para></entry>
</row>
</thead>
<tbody>
<row valign="top">
<entry><para><guilabel>Read</guilabel></para></entry>
<entry><para>Disk read rate</para></entry>
</row>
<row valign="top">
<entry><para><guilabel>Write</guilabel></para></entry>
<entry><para>Disk write rate</para></entry>
</row>
<row valign="top">
<entry><para><guilabel>Background</guilabel></para></entry>
<entry><para>Idle disk time</para></entry>
</row>
</tbody>
</tgroup>
</informaltable>
</listitem>
</itemizedlist>
</sect2>
<!-- ================ Explaining thresholds======================== -->
<sect2 id="network thresholds">
<title>Network speed thresholds</title>
<para>
Thresholds together with indicator allow network graph to scale and better represent actual workload.
If combined network traffic (in + out + loopback) is below threshold1, no indicator is shown, y-axis
on network graph go from 0 to threshold1. When traffic is more than threshold1, one indicator will be
shown and y-axis now go from 0 to threshold2. When threshold2 is reached, two indicators will be shown
and y-axis go from 0 to threshold3. When threshold3 is reached, three indicators are shown and y-axis
go form 0 to whatever is current maximum in graph.
</para>
<para>
Gridlines are hard to explain, just observe, and they are obvious.
</para>
</sect2>
</sect1>
</article>