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)