logformat

TAG: logformat

Использование: logformat <name> <format specification>

Этот тэг определяет формат записи для журнала доступа(access.log)

<format specification> это строка со специальными символами

Специальные символы определяют некоторую базовую структуру записи данных в журнал. Выходная строка будет автоматически сформирована из данных определенных специальными символами.

% ["|[|'|#] [-] [[0]width] [{argument}] formatcode

" выходные данные заключить в кавычки
[ выходные данные в формате используемом для log_mime_hdrs
# выходные данные в URL формате
' выходные данные как есть(as-is)

- выравнивание по левому краю
width поля width. Если начинается с 0, то выходные данные будут сдвинуты на 0 относительно левого края
{arg} аргумента. Например, название заголовка(Header) и т.п.

Специальные символы:

>a

Client source IP address (Клиентский IP адрес)

>A

Client FQDN (Клиентский FQDN)

>p

Client source port (Клиентский порт)

<A

Server IP address or peer name (IP адрес сервера или имя пира)

la

Local IP address (http_port) (Локальный IP адрес)

lp

Local port number (http_port) (Локальный порт)

ts

Seconds since epoch (Прошло секунд с начала эпохи)

tu

subsecond time (milliseconds) (Время в миллисекундах)

tl

Local time. Optional strftime format argument (Локальное время). Формат по умолчанию %d/%b/%Y:%H:%M:%S %z

tg

GMT time. Optional strftime format argument (GMT время). Формат по умолчанию %d/%b/%Y:%H:%M:%S %z

tr

Response time (milliseconds) (Время ответа в мс)

>h

Request header. Optional header name argument (Заголовок запроса). Опционально можно задать имя заголовка header[:[separator]element]

<h

Reply header. Optional header name argument (Заголовок ответа)

un

User name (Имя пользователя)

ul

User name from authentication (Имя авторизованного пользователя)

ui

User name from ident (Имя пользователя от ident)

us

User name from SSL (Имя пользователя от SSL)

ue User name from external acl helper (Имя пользователя от внешней программы авторизации)

Hs

HTTP status code (Код ответа HTTP)

Ss

Squid request status (TCP_MISS etc) (Ответ Squid на запрос)

Sh

Squid hierarchy status (DEFAULT_PARENT etc) (Уровень этого Squid в иерархии нескольких прокси)

mt

MIME content type (MIME тип)

rm

Request method (GET/POST etc) (Метод запроса)

ru

URL запроса

rv

Протокол запроса, версия

ea

Лог строка возвращаемая от внешнего ACL

<st

Размер ответа включая HTTP заголовки

>st

Размер запроса включая HTTP заголовки

st

Общий размер Запрос + Ответ включая HTTP заголовки

%

знак %

Форматы по умолчанию:

logformat squid %ts.%03tu %6tr %>a %Ss/%03Hs %<st %rm %ru %un %Sh/%<A %mt
logformat squidmime %ts.%03tu %6tr %>a %Ss/%03Hs %<st %rm %ru %un %Sh/%<A %mt [%>h] [%<h]
logformat common %>a %ui %un [%tl] "%rm %ru HTTP/%rv" %Hs %<st %Ss:%Sh
logformat combined %>a %ui %un [%tl] "%rm %ru HTTP/%rv" %Hs %<st "%{Referer}>h" "%{User-Agent}>h" %Ss:%Sh


По умолчанию:

none

Примечание: При задании формата, вы указываете его имя. Оно понадобится в соответствующих директивах. Например, первая строчка форматов по умолчанию задаёт некоторый формат с именем squid. Это значит, что затем в директивах типа access_log, вам не нужно прописывать формат записи в журнал, а следует просто указать имя squid вместо <logformat name>.