Beyond Linux® From Scratch - Version 7.4

Chapter 12. System Utilities

Sysstat-10.1.7

Introduction to Sysstat

The Sysstat package contains utilities to monitor system performance and usage activity. Sysstat contains the sar utility, common to many commercial Unixes, and tools you can schedule via cron to collect and historize performance and activity data.

This package is known to build and work properly using an LFS-7.4 platform.

Package Information

Sysstat Dependencies

There are no build-time requirements for this package; however, it is designed to be controlled by a cron daemon such as Fcron-3.1.2.

User Notes: http://wiki.linuxfromscratch.org/blfs/wiki/sysstat

Installation of Sysstat

Install Sysstat by running the following commands: 

sa_lib_dir=/usr/lib/sa    \
sa_dir=/var/log/sa        \
conf_dir=/etc/sysconfig   \
./configure --prefix=/usr \
            --disable-man-group &&
make

This package does not come with a test suite.

Now, as the root user: 

make install

Command Explanations

sa_lib_dir: This environment variable specifies the location of the package-specific library directory.

sa_dir: This environment variable specifies the location of the directory containing the data files.

conf_dir: This environment variable specifies the location of the system configuration directory.

--disable-man-group: This parameter causes the installation to ignore the man group variable resulting in the man files having root:root ownership.

Run ./configure --help to see other influential environment variables you can pass to configure. You may want to use the history and compressafter variables to customize the amount of data files kept on the system.

Configuring Sysstat

Cron Information

To begin gathering Sysstat history information, you must add to, or create a privileged user's crontab. The history data location is /var/log/sa. The user running Sysstat utilities via cron must have write access to this location.

Below is an example of what to install in the crontab. Adjust the parameters to suit your needs. Use man sa1 and man sa2 for information about the commands. 

# 8am-7pm activity reports every 10 minutes during weekdays
0 8-18 * * 1-5 /usr/lib/sa/sa1 600 6 &

# 7pm-8am activity reports every hour during weekdays
0 19-7 * * 1-5 /usr/lib/sa/sa1 &

# Activity reports every hour on Saturday and Sunday
0 * * * 0,6 /usr/lib/sa/sa1 &

# Daily summary prepared at 19:05
5 19 * * * /usr/lib/sa/sa2 -A &

Ensure you submit the revised crontab to the cron daemon.

System Startup Information

At system startup, a LINUX RESTART message must be inserted in the daily data file to reinitialize the kernel counters. This can be automated by installing the /etc/rc.d/init.d/sysstat init script included in the blfs-bootscripts-20130908 package using the following command as the root user: 

make install-sysstat

Contents

Installed Programs: cifsiostat, iostat, mpstat, nsfiostat, pidstat, sadf, and sar
Installed Libraries: None
Installed Directories: /usr/lib/sa, /usr/share/doc/sysstat-10.1.7 and, /var/log/sa

Short Descriptions

cifsiostat

displays statistics about read and write operations on CIFS filesystems.

iostat

reports CPU statistics and input/output statistics for devices and partitions.

mpstat

writes activities for each available processor.

nfsiostat

displays statistics about read and write operations on NFS filesystems.

pidstat

is used for monitoring individual tasks currently being managed by the Linux kernel.

sadf

is used for displaying the contents of data files created by the sar command. But unlike sar, sadf can write its data in many different formats.

sar

is used for displaying the contents of elected cumulative activity counters in the operating system.

Last updated on 2013-09-13 12:50:39 -0700