Provided by: atsar_1.7-2_i386 bug

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/atsadate +%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)