The sendmail program provides the ability to gather information
that can be used to produce valuable statistics. As you will see,
the StatusFile
(S
) option
(see Section 34.8.66, StatusFile (S)) is used to specify a file into which delivery agent
statistics can be saved. The mailstats(1) program
(see Section 26.2.2, "Viewing Statistics: mailstats") prints a summary of those statistics.
The sendmail program can maintain
an ongoing record of
the total number and total sizes of all outgoing
and incoming mail messages handled by each delivery agent.
This ability is enabled by using the StatusFile
(S
) option
(see Section 34.8.66):
OS/path
prior to V8.7 O StatusFile=/path
beginning with V8.7
The /path
is the full pathname of the file into which
statistics are saved. Most vendors provide configuration files
that specify /path
as
/etc/sendmail.st
Just declaring the StatusFile
(S
) option
is not enough, however,
for if the file does not exist (or if it is unwritable), sendmail
silently ignores that option and does not save
statistics.
You must also create the empty file
%touch /etc/sendmail.st
Note that the gathering of statistics can later be turned off merely by renaming or removing the file.
If the StatusFile
(S
) option has not already been declared,
you need to declare it and then kill and restart the sendmail daemon
for that declaration to take effect.
The mailstats program is supplied with sendmail to provide a convenient way to print the contents of the sendmail.st file. The output of the mailstats program varies depending on the version of sendmail installed. For V8.8 sendmail the output looks like this:
Statistics from Fri May 10 11:23:55 1996 M msgsfr bytes_from msgsto bytes_to Mailer 1 0 0K 43 5913K *file* 3 26 546K 96 639K local 4 421 2996K 3271 78233K smtp ======================================== T 447 3542K 3410 84785K
The first line shows the time
the statistics file was begun.
The lines that follow show the number of messages
and the total size in kilobytes of those messages both received
(msgsfr
) and
sent (msgsto
) for each delivery agent.
The M
column shows the index into the internal array of
delivery agents, and the Mailer
shows the symbolic name.
The last line shows totals. Note that if a delivery agent handled no traffic,
it is excluded from the report.
The mailstats program prints the contents of the sendmail.st file, but it does not zero the counters in that file. To clear (zero) that file, you need to truncate it. One easy way to truncate the sendmail.st file is
%cp /dev/null /etc/sendmail.st
When sendmail discovers an empty sendmail.st file, it begins gathering statistics all over again. One use for truncation is to collect daily reports from mailstats. Consider the following simple shell script:
#!/bin/sh ST=/etc/sendmail.st MS=/usr/ucb/mailstats if [ -s $ST -a -f $MS ]; then $MS | mail -s "Daily mail stats" postmaster cp /dev/null $ST fi exit 0
When run, this script checks to see whether a nonempty sendmail.st file
and program mailstats exist. If they do,
mailstats is run, printing the statistics, which are then mailed
to postmaster
. The sendmail.st file is
then truncated to a size of zero.
Such a script could be run once per night using the cron(8)
facility with a crontab(5) entry like this:
0 0 * * * sh /usr/ucb/mailstats.script >/dev/null 2>&1
Here, mailstats.script
is the name given to the
above shell script, and the 0 0
causes that script
to be executed once per day at midnight.
Some versions of mailstats allow you to specify a different location for the statistics file. The form of that specification varies with the version of sendmail being run (see mailstats(8)). Yours may look like one of the following:
%mailstats /var/log/statlog
%mailstats -f /var/log/statlog
V8 uses this form
If your version of mailstats allows a different location
(and name) for the statistics file, you can
move that file to the new location by revising the
StatusFile
(S
) option
in the sendmail program's configuration file:
OS/var/log/statlog
Note that V8 mailstats(8) automatically parses the configuration file to find the location of its statistics file.
Moving and renaming the statistics file allows one to automatically collect daily copies of that file. Consider the following variation on the previous shell script:
#!/bin/sh DIR=/var/log ST=statlog MS=/usr/ucb/mailstats if [ -d $DIR ]; then cd $DIR if [ -s $ST -a -f $MS ]; then test -f ${ST}.5 && mv ${ST}.5 ${ST}.6 test -f ${ST}.4 && mv ${ST}.4 ${ST}.5 test -f ${ST}.3 && mv ${ST}.3 ${ST}.4 test -f ${ST}.2 && mv ${ST}.2 ${ST}.3 test -f ${ST}.1 && mv ${ST}.1 ${ST}.2 test -f ${ST}.0 && mv ${ST}.0 ${ST}.1 test -f ${ST} && mv ${ST} ${ST}.0 touch ${ST} $MS -f $DIR/${ST}.0 | mail -s "Daily mail stats" postmaster fi fi exit 0
As before, the statistics are mailed to postmaster
. But
instead of being truncated, the sendmail.st file is renamed
sendmail.st.0. A series of renames (mv(1)) are used to maintain
a week's worth of copies.
These copies allow the ambitious
administrator to create a program for gathering weekly summaries
from seven archived daily copies.