2001
-
09
-
16
 
16
:
09
:
47
 SMTP connection from [
127
.
0
.
0
.
1
] closed
  by QUIT

   По умолчанию, штампы времени в локальной временной зоне. Есть два способа это изменить:


timezone = UTC

для штампов времени в UTC (который - GMT).


2003
-
04
-
25
 
11
:
17
:
07
 +
0100
 Start queue run: pid=
12762

   Логи могут быть записаны в локальные файлы, или в syslog, или и туда и туда. Однако, нужно отметить, что многие реализации syslog используют в качестве транспорта UDP, и ненадёжны, в смысле, что не гарантируется прибытие сообщений на хост логгирования, и при этом порядок сообщений не обязательно поддерживается. Также сообщалось, что на больших файлах логов (десятки мегабайт), возможно, вам необходимо настроить syslog, для предотвращения синхронизации файла при каждой записи - на linux было замечено, что это вызывало 90% загрузку центрального процессора.
   Назначение для логов exim`a конфигурируется путём установки LOG_FILE_PATH в “ Local/Makefile ”, или путём установки “ log_file_path ” в рабочей конфигурации. Эта, последняя, строка раскрывается, и, таким образом, она может содержать, например, ссылки на имя хоста:


log_file_path = /var/log/$primary_hostname/exim_%slog

   Вообще, желательна установка строки в “ Local/Makefile ”, вместо рабочей конфигурации, поскольку в этом случае установка доступна с самого начала выполнения exim`a. Иначе, если будет нужно залоггировать что-то до чтения конфигурационного файла (например, ошибку в конфигурационном файле), он не сможет использовать путь который вы хотите, и может оказаться не в состоянии залоггировать вообще что бы то нибыло.
   Значение LOG_FILE_PATH или “ log_file_path ” - список разделённый двоеточиями, в настоящее время ограниченный максимум двумя элементами. Это - единственная опция, где не может использоваться средство для изменения разделителя списка. Этот список всегда должен быть разделён двоеточиями. Если элемент в списке - “syslog”, тогда используется syslog; иначе, элемент должен быть абсолютным путём, содержащим “%s” как точку, где должны быть вставлены “main”, “reject”, или “panic”, или быть пустым, подразумевая использование дефолтового пути.
   Когда exim сталкивается с пустым элементом в списке, он ищет список, заданный путём LOG_FILE_PATH, и использует первый найденный элемент, если он не пустой, или не “syslog”. Это означает, что в “ log_file_path ” может использоваться пустой элемент, для обозначения “ использовать путь заданный при сборке ”. Если элемента не существует, лог файлы пишутся в субдиректорию “ log ”, в директории спула. Это эквивалентно установке:


log_file_path = $spool_directory/log/%slog

   Если вы не определили что-то при компиляции или в рабочей конфигурации, логи пишутся по указанному пути.
   Путь к логам может содержать “%D”, если в имени логов используется штамп даты - смотрите секцию 48.3, ниже.
   Вот - некоторые примеры возможных установок:


LOG_FILE_PATH=syslog                     syslog only
LOG_FILE_PATH=:syslog                    syslog and default path
LOG_FILE_PATH=syslog : /usr/log/exim_%s  syslog and specified path
LOG_FILE_PATH=/usr/log/exim_%s           specified path only

   Если в списке более двух путей, используется первый, и логгируется паническая ошибка.



   Некоторые операционные системы предоставляют централизованные и стандартизованные методы для ротации файлов логов. Для тех, которые этого не делают, предоставляется скрипт утилиты с именем “ exicyclog ” (смотрите секцию [url=./?id=1249#49.6]49.6[/url). Он переименовывает и сжимает главный лог, и лог отклонённых при каждом его вызове. Может быть настроено максимальное число оставляемых старых логов. Предполагается, что этот скрипт запускается как ежедневное задание “ cron ”.
   Процесс доставки exim`a открывает главный лог когда ему первый раз необходимо в него записать, и оставляет его открытым в случае, если требуется последующая запись - например, если для одного и того же сообщения производится несколько различных доставок. Однако, удалённые SMTP-доставки могут занять много времени, и это означает, что файл может оставаться открытым после его переименования, если “ exicyclog ”, или что-то подобное используется для переименования файлов логов на регулярной основе (имеется ввиду - постоянно - раз в сутки, например - прим. lissyara). Для гарантии, что переключение лог-файлов будет замечено как можно быстрее, exim вызывает “ stat() ” для имени главных логов, до повторного использования открытых файлов, и если файл не существует, или изменилась его инода, старый файл закрывается, и exim пробует открыть пустой главный лог. Таким образом, старый лог может оставться открытым довольно долго, но никакие процессы exim`a в него не пишут, как только он был переименован.



   Вместо ротации файлов главного лога и лога отклонённых путём их периодического переименовывания, некоторые любят исполльзовать файлы, чьи имена содержат штамп времени, например, “ mainlog-20031225 ”. Штамп времни имеет форму “ yyyymmdd ”. Exim обладает поддержкой для этого способа работы. Он включается путём установки опции “ log_file_path ” в путь, который содержит “%D” в точке где требуется штамп даты. Например:


log_file_path = /var/spool/exim/log/%slog-%D
log_file_path = /var/log/exim-%s-%D.log
log_file_path = /var/spool/exim/log/%D-%slog

   Как и прежде, “%s” заменяется на “main” или “reject”; вот - примеры имён генерируемых этим примером:


/var/spool/exim/log/mainlog-
20021225

/var/log/exim-reject-
20021225
.log
/var/spool/exim/log/
20021225
-mainlog

   Когда задана эта форма логов, exim автоматически переключается на новые файлы по ночам. Он не предпринимает никаких попыток для сжатия старых логов; вам придётся написать свой скрипт, который будет это делать. Вы не должны запускать “ exicyclog ” с этой формой логгинга.
   Местоположение лога паники, также определяется путём “ log_file_path ”, но на него не ставиться штамп даты, поскольку ротация лога паники не имеет смысла. При генерации имени лога паники, “%D” удаляется из строки. Дополнительно, если он идёт немедленно после слэша, следующий не алфавитно-цифровой символ - удаляется; иначе, удаляется предшествующий не алфавитно-цифровой символ. Таким образом, предыдущие три примера, привели бы к таким логам паники:


/var/spool/exim/log/paniclog
/var/log/exim-panic.log
/var/spool/exim/log/paniclog

   Использование syslog не изменяет того, как exim логгирует, или формат его сообщений, исключая одно отношение. Если “ syslog_timestamp ” установлена в ложь, штамп времени в строках лога exim`a пропускается, когда строка посылается в syslog. Кроме того? те же самые строки пишутся в syslog как в файлы логов. Средство (“facility”) syslog установлено в LOG_MAIL, и по умолчанию, программа именуется “exim”, но вы можете изменить это путём опций “ syslog_facility ” и “ syslog_processname ”, соответственно. Если exim скомпилен с SYSLOG_LOG_PID установленным в “ Local/Makefile ” (это, значение по умолчанию, в “ src/EDITME ”), тогда, на системах, которые разрешают это (все, исключая ULTRIX), флаг LOG_PID - установлен так, чтобы вызов “ syslog() ” добавлял pid, также как и время и имя хоста, в каждую строку. Три потока логов распределяются по приоритетам syslog следующим образом:


SYSLOG_LONG_LINES=yes

в “ Local/Makefile ” до сборки exim`a. Это предотвращает разбитие exim`ом длинных строк, но всё ещё разбирает внутренние новые строки во вхождениях лога “ reject ”.
   Для облегчения повторной сборки разбитых строк, каждый компонент разбитого вхождения начинается со строки формы “[<n>/<m>]” или “[<n>\<m>]”, где “<n>” - компонент числа, и “<m>” - полное число компонентов вхождения. Разделитель “/” используется когда строка разбита из-за того, что она слишком длинная; если же она разбита из-за внутренней новой строки, используется разделитель “\”. Например, предположим что ограничение длинны 50 вместо 870, следующий пример был бы результатом типичного отклонения сообщения в “ mainlog ” (LOG_INFO), дополненительно, каждая строка предваряется временем, именем хоста, и pid, добавляемых syslog:


[
1
/
5
] 
2002
-
09
-
16
 
16
:
09
:
43
 16RdAL-0006pc-
00
 rejected from
[
2
/
5
]  [
127
.
0
.
0
.
1
] (ph10): syntax error in 'From' header
[
3
/
5
]  when scanning for sender: missing or malformed lo
[
4
/
5
] cal part in "<>" (envelope sender is <ph10@cam.exa
[
5
/
5
] mple>)

   Та же самая ошибка могла бы привести к следующим строкам записанным в “rejectlog” (LOG_NOTICE):


[
1
/
18
] 
2002
-
09
-
16
 
16
:
09
:
43
 16RdAL-0006pc-
00
 rejected fro
[
2
/
18
] m [
127
.
0
.
0
.
1
] (ph10): syntax error in 'From' head
[
3
/
18
] er when scanning for sender: missing or malformed
[
4
/
18
]  local part in "<>" (envelope sender is <ph10@cam
[5\18] .example>)
[6\18] Recipients: ph10@some.domain.cam.example
[7\18] P Received: from [
127
.
0
.
0
.
1
] (ident=ph10)
[8\18]        by xxxxx.cam.example with smtp (Exim 
4
.
00
)
[9\18]        id 16RdAL-0006pc-
00

[
10
/
18
]        for ph10@cam.example; Mon, 
16
 Sep 
2002
 
16
:
[11\18] 
09
:
43
 +
0100

[12\18] F From: <>
[13\18]   Subject: this is a test header
[18\18]   X-something: this is another header
[
15
/
18
] I Message-Id: <E16RdAL-0006pc-00@xxxxx.cam.examp
[16\18] le>
[17\18] B Bcc:
[
18
/
18
]   Date: Mon, 
16
 Sep 
2002
 
16
:
09
:
43
 +
0100

   Строки логов, которые не слишком длинные, или не содержат символа новой строки, пишутся в syslog без модификации.
   Если используется только syslog, монитор exim`a не может показывать логи, если syslog не направляет “ mainlog ” в файл на локальном хосте, и переемнная окружения EXIMON_LOG_FILE_PATH не указывает монитору, где он находится.



   На каждое пришедшее сообщение, в логи записывается одна строка, и для каждой успешной, неуспешной, и задержанной доставки. Эти строки могут быть выбраны по отличительным двухсимвольным флагам, которые идут сразу за штампом времени. Флаги таковы:


   Формат однострочного вхождения в главном логе, который пишется для каждого полученного сообщения, показан в простом примере, ниже, который разбит на несколько строк, чтобы уместиться на странице:


2002
-
10
-
31
 
08
:
57
:
53
 16ZCW1-0005MB-
00
 <= kryten@dwarf.fict.example
  H=mailer.fict.example [
192
.
168
.
123
.
123
] U=exim
  P=smtp S=
5678
 id=<incoming message id>

   Адрес, немедленно сопровождаемый “<=” - адрес отправителя конверта. Рикошет отображается с адресом отправителя “<>”, и, если он сгенерирован локально, он сопровождается элементом в форме:


R=<message id>

являющимся ссфлкой на сообщение, которое вызвало отсылку рикошета.
   Для сообщений с других хостов, поля “H” и “U” идентифицируют удалённый хост и запись идентификатора RFC1413 пользователя, пославшего сообщение, если оно было принято. Число данное в кадратных скобках - IP адрес, отсылавшего хоста. Если тут единственное, не заключённое в скобки, имя хоста в поле “H”, как выше, значит оно было проверено на соответствие IP адресу (смотрите опцию “ host_lookup ”). Если имя в круглых скобках, то это имя, указанное удалённым хостом в SMTP команде HELO или EHLO, и оно не было проверено. Если проверка приводит к имени отличающемуся от данного в HELO или EHLO, проверенное имя показано первым, сопровождаемое именем HELO или EHLO в круглых скобках.
   Неверно сконфигурированные хосты (и те, кто подделывает почту) иногда помещают IP адрес, с квадратными скобками, или без, в команду HELO или EHLO, приводя к записям в логах, типа этих примеров:


H=(
10
.
21
.
32
.
43
) [
192
.
168
.
8
.
34
]
H=([
10
.
21
.
32
.
43
]) [
192
.
168
.
8
.
34
]

   Это может запутывать. Можно положиться лишь на последний адрес в квадратных скобках.
   Для локально сгенерённых сообщений (т.е. не переданных через TCP/IP), поле “H” - пропущено, и поле “U” содержит логин вызвавшего exim.
   Для всех сообщений, поле “P” определяет протокол, используемый для получения сообщения. Это значение сохраняется в “ $received_protocol ”. В случае входящего SMTP сообщения, значение указывает, использовались ли расширения SMTP (ESMTP), шифрование, или аутентификация. Если сессия SMTP была шифрованная, есть дополнительное поле “X”, в котором записан тип использовавшегося шифрования.
   Протокол устанавливается в “esmptsa” или “esmtpa” для сообщений переданных от хостов которые аутентифицировались, используя команду SMTP AUTH. Первое значение используется когда SMTP соединение шифрованное (“secure”). В этом случае, есть дополнительный пункт “A=”, сопровождаемый именем использовавшегося аутентификатора. Если аутентифицированная идентификация была установлена аутентифкационной опцией “ server_set_id ”, она также логируется, отделяемая двоеточием от имени аутентификатора.
   Поле “id” записывает существующий идентификатор сообщения, если он есть. Размер принятого сообщения даётся в поле “S”. Когда сообщение доставляется, заголовки могут быть удалены или добавлены, таким образом, размер доставленных копий сообщений может не соответствовать этому значению (и в действительности могут отличаться друг от друга).
   Опция “ log_selector ” может использоваться для запроса логгинга дополнительных данных, при получении сообщения. Смотрите раздел 48.15.



   Формат однострочного вхождения в главном логе, который пишется для каждой доставки показан в одном из примеров ниже, для локальной и удалённой доставки соответсвенно. Каждый пример был разбит на две строки, чтобы вписаться в страницу:


2002
-
10
-
31
 
08
:
59
:
13
 16ZCW1-0005MB-
00
 => marv
  <marv@hitch.fict.example> R=localuser T=local_delivery

2002
-
10
-
31
 
09
:
00
:
10
 16ZCW1-0005MB-
00
 =>
  monk@holistic.fict.example R=dnslookup T=remote_smtp
  H=holistic.fict.example [
192
.
168
.
234
.
234
]

   Для обычных локальных доставок, оригинальный адрес даётся в угловых скобках после финального адреса доставки, который может быть трубой или файлом. Если между оргтнальным и финальным адресом существует промежуточный, последний даётся в круглых скобках после заключительного адреса. Поля “R” и “T” записывают роутер и транспорт которые использовались при обработке адреса.
   Если после успешной локальной доставки запускается теневой транспорт, к концу строки о успешной доставке добавляется элемент, в форме:


ST=<shadow transport name>

   Если теневой транспорт был неуспешен, сообщение о ошибке помещается в конце, в круглых скобках.
   Когда в одной доставке включён более чем один адрес (например, две команды SMTP RCPT в одной транзакции), второй и последующие адреса помечаются флагами с “->” вместо “=>”. Когда два и более сообщения отправляются по одному SMTP соединению, для второго и последующих сообщений в строках логов за IP адресом вставляется звёздочка.
   Генерация сообщения с ответом, путём файла фильтра, логгируется как “доставка” на адрес, которому предшествует “>”.
   Опция “ log_selector ” может использоваться для запроса логгинга дополнительных данных, при получении сообщения. Смотрите раздел 48.15.



   Когда от сообщения отказались, как разультат команды “seen finish” появившейся в файле фильтра, который не генерит никаких доставок, в логи записывается вхождение такой формы:


2002
-
12
-
10
 
00
:
50
:
49
 16auJc-0001UB-
00
 => discarded
  <low.club@bridge.example> R=userforward

для указаний, почему не залоггированы никакие доставки. Когда от сообщения отказываются по причине что альяс привёл к “:blackhole:” (чёрная дыра - /dev/null - прим. lissyara), строка логов будет такой:


1999
-
03
-
02
 
09
:
44
:
33
 10HmaX-0005vi-
00
 => :blackhole:
  <hole@nowhere.example> R=blackhole_router

   Когда сообщение задержано, логгируется строка следующей формы:


2002
-
12
-
19
 
16
:
20
:
23
 16aiQz-0002Q5-
00
 == marvin@endrest.example
  R=dnslookup T=smtp defer (
146
): Connection refused

   В случае удалённых доставок, ошибка - то, что давалось для последнего пробовавшегося IP адреса. Детали индивидуальной SMTP ошибки также пишутся в лог, таким образом, вышеупомянутой строке предшествовало  бы что-то вроде этого:


2002
-
12
-
19
 
16
:
20
:
23
 16aiQz-0002Q5-
00
 Failed to connect to
  mail1.endrest.example [
192
.
168
.
239
.
239
]: Connection refused

   Когда задержанный адрес пропускается, поскольку не наступило его времяя повтора, в лог записывается сообщение, но это может быть подавлено путём установки соответствующего значения в “ log_selector ”.



   Если доставка неуспешна по причине невозможности сроутить адрес, логгируется строка такой формы:


1995
-
12
-
19
 
16
:
20
:
23
 0tRiQz-0002Q5-
00
 ** jim@trek99.example
  <jim@trek99.example>: unknown mail domain

   Если доставка неудачна в транспортное время, показываются роутер и транспорт, и включается ответ удалённого хоста, как в этом примере:


2002
-
07
-
11
 
07
:
14
:
17
 17SXDU-
000189
-
00
 ** ace400@pb.example
  R=dnslookup T=remote_smtp: SMTP error from remote mailer
  after pipelined RCPT TO:<ace400@pb.example>: host
  pbmail3.py.example [
192
.
168
.
63
.
111
]: 
553
 
5
.
3
.
0

  <ace400@pb.example>...Addressee unknown

   Слово “pipelined” указывает, что было использовано расширение SMTP PIPELINING. Смотрите “ hosts_avoid_esmtp ” в транспорте “ smtp ” для способа отключения PIPELINING. Строки логов для всех форм неудачной доставки помечаются флагом “**”.



   Если доставка, фактически, не имела места, поскольку для её подавления использовалась опция “ -N ”, в лог пишется обычная строка доставки, исключая, что “=>” заменяется на “*>”.



   Строка в форме


2002
-
10
-
31
 
09
:
00
:
11
 16ZCW1-0005MB-
00
 Completed

пишется в главный лог когда сообщение должно быть удалено из спула, в конце его обработки.



   Краткое изложение идентификаторов полей, которые используются в строках логов, показано в следующей таблице:


   Различные иные типы записей время от времени пишутся в логи. Большинство из них - очевидны. Чаще всего:


errors_to = <>

неудачна. От доставки отказываются.



   Путём установки глобальной опции “ log_selector ”, вы можете отключить некоторое дефолтовое логгирование exim`a, или вы можете запросить дополнительный логгинг. Значение “ log_selector ” составлено из имён, с предшествующем символом плюса или минуса. Например:


log_selector = +arguments -retry_defer

   Список опциональных элементов лога, указаны в следующей таблице, с дефолтовым значением отмеченным звёздочкой:


   Дополнительные детали для каждого из этих элементов таковы:


   В дополнение к главному файлу логов, exim пишет лог-файл для каждого сообщения, которое он обрабатывает. Имена этих персональных логов для сообщений - идентификаторы сообщений, и они хранятся в субдиректории “ msglog ” директории спула. Каждый лог сообщения содержит копии строк логов, которые касаются сообщения. Это облегчает выяснение статуса индивидуального сообщения без необходимости поиска по главному логу. Лог сообщения удаляется после завершения обработки сообщения, если не задана “ preserve_message_logs ”, но она должна использоваться с большой осторожностью, поскольку логи могут очень быстро заполнить ваш диск.
   На сильно загруженных системах, может быть желательным отключить использование персональных логов сообщений, для уменьшения дискового ввода-вывода. Это может быть сделано путём установки опции “ message_logs ” в ложь.




=============
Автор перевода: lissyara, оригинал: http://www.lissyara.su/?id=1200