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)

AT Computing                                        July 2004                                          ATSADC(1)