Previous | Next | Contents | Index |
This section points out some message logging and tracking techniques.
Snapshots of message traffic, and information on TCP/IP connections handled by the PMDF Service Dispatcher, are also available.
30.4.3.1 Logging Messages Passing through PMDF
The logging
channel keyword causes PMDF write a log file
entry for each pass of a message through a PMDF channel; see
Section 2.3.4.85 for details. The LOG_CONNECTION
PMDF option
can be used to cause PMDF to log TCP/IP connections, such as SMTP, POP,
and IMAP connections; such connection entries can either be included in
the regular PMDF message log file, or written to a separate file. See
Section 7.3.6 for discussion of the LOG_CONNECTION
and
SEPARATE_CONNECTION_LOG
options. Note that with logging
turned on, the cumulative mail.log
file in the PMDF log
directory will continue to grow and grow; PMDF itself never does
anything with this log file and it is up to you to periodically write
it to backup and delete it, or truncate it, or whatever your site
prefers; the same is true for the connection.log
file if
TCP/IP connections are logged separately. Section 33.1.1 has a further
discussion of managing the PMDF log files.
In addition to the base set of data logged when the
logging
keyword is used, there are options to cause the
log output to include additional details, as discussed in
Section 30.4.3.1.1 below.
30.4.3.1.1 Extra Logging Detail
In addition to the base set of logging enabled via the
logging
channel keyword, PMDF has options that cause
additional information to be included in the entries written to the
mail.log*
files. Note that logging such additional
information tends to incur additional overhead.
In particular, setting LOG_MESSAGE_ID=1
,
LOG_CONNECTION=7
, and LOG_FILENAME=1
in your
PMDF option file can be of interest on a PMDF e-mail firewall. Logging
the message ID makes it easier to find entries in the log file
corresponding to a particular message, or to correlate different
entries in the log file corresponding to a single message. Logging the
SMTP client connection information can be useful to show just what
system really sent the message to your PMDF firewall. Logging the
process id also logs the thread id in the case of multithreaded
channels; while the process ids themselves normally will be rather
monotonous on a PMDF firewall system, being that of a Dispatcher Worker
Process (for SMTP messages received) or a PMDF Process Symbiont process
(for SMTP messages sent), having the process id and thread id logged is
quite useful for correlating message entries with connection entries.
Logging the filename can be useful if you want to correlate log file
entries with actual message files currently in the PMDF queue area.
Setting LOG_HEADER=1
can be of interest if you want to
save certain message headers to the mail.log*
files.
Additionally, setting LOG_USERNAME=1
on a PMDF firewall
system ought generally to result in fairly monotonous extra information
being logged, as the username would normally just be the username of
the user who last started the PMDF Service Dispatcher. Enable this
options if you want to confirm that the username of processes enqueuing
messages are as expected.
See Section 7.3.6 for more details on such logging options.
30.4.3.2 Snapshots of Message Traffic through PMDF
PMDF maintains channel counters based on the Mail Monitoring MIB, RFC
1566. These counters can provide "snapshots" of the state of
the PMDF queues and a feel for the volume of messages passing through
PMDF. See Chapter 33 for details.
30.4.3.3 Monitoring TCP/IP Connections to the Dispatcher
The PMDF Service Dispatcher maintains statistics on connections it
handles, e.g., the number of recent SMTP connections and the
hosts from which the connections were made. See Section 11.7 for
details.
Previous | Next | Contents | Index |