NAME

       atsadc, atsa1, atsaftp, atsahttp — counter-collection

SYNOPSIS

       atsadc [ t n ] [ ofile ]

       atsa1 [ t n ]

       atsaftp

       atsahttp

DESCRIPTION

       System  activity-data  can  be  gathered  on  special request of a user [see atsar(1) ] or
       automatically, on a routine  basis,  as  described  here.  Usually  the  kernel  maintains
       statistical  counters  that are incremented as various system actions occur. These include
       counters for CPU utilization, disk utilization, memory  utilization  and  various  network
       statistics.

       The program atsadc and the shell-script atsa1 are used to collect, save, and process these
       counters.

       The program atsadc (the data collector) samples system data n times with an interval of  t
       seconds  between  samples,  and  writes in binary format to ofile or (default) to standard
       output. The sampling interval t should be greater than 1 second. If t and n are omitted, a
       special  reset-record  is  written.   This  facility  is used when booting to a multi-user
       state, to mark the time at which the counters restart from zero. For example,  the  reset-
       mark can be added to the daily data by the command:

       /usr/local/bin/atsadc /var/log/atsar/atsa`date +%d`

       Note that this entry is written to the /etc/rc.d/init.d/atsar file.

       The   shell-script   atsa1  is  used  to  collect  and  store  data  in  the  binary  file
       /var/log/atsar/atsadd where dd is the current day of the month.  The  arguments  t  and  n
       cause  records  to  be  written  n  times at an interval of t seconds, or once if omitted.
       Furthermore this script takes care that log-files older than a week  are  removed  once  a
       day.

       A  file  containing  following  entries  should  be  added to the /etc/cron.d directory to
       produce records every 20 minutes during working hours and hourly otherwise:

       0     *    * * 0-6 root /usr/local/bin/atsa1

       20,40 8-17 * * 1-5 root /usr/local/bin/atsa1

       See crontab(1) for details.

       The shell-script atsaftp counts the new transfers registered in the  FTP-logfile(s)  since
       the  previous  time  this  script  was  activated;  the  new  counters  are  stored in the
       /var/log/atsar/ftpstat file in ASCII-format.  The names of the FTP-logfiles to be  watched
       are specified in the /etc/atsar.conf configuration-file.

       The shell-script atsahttp counts the new transfers registered in the HTTP-logfile(s) since
       the previous time  this  script  was  activated;  the  new  counters  are  stored  in  the
       /var/log/atsar/httpstat  file  in  ASCII-format.   The  names  of  the HTTP-logfiles to be
       watched are specified in the /etc/atsar.conf configuration-file.

       Both scripts must be activated just before the  program  atsadc  is  started,  which  also
       collects these counters.

FILES

       /var/log/atsar/atsadd

       Daily data file, where dd are digits representing the day of the month.

SEE ALSO

       atsar(1), crontab(1)

AUTHOR

       Gerlof Langeveld, AT Computing (gerlof@ATComputing.nl)