Информационный портал «SoftTime-INFO»
|
Формат журнальных файлов ApacheВ �татье приведен �пи�ок параметров, которые и�пользуют�� при �оздании журнальных файлов web-�ервера Apache. Данные параметры и�пользуют�� в директивах LogFormat и CustomLog.
�втор: Голышев С.В. glsv@yandex.ru
Дл� определени� формата запи�ываемых в журнал данных (формат журнала) и�пользует�� директива LogFormat.
Синтак�и� директивы LogFormatLogFormat формат|п�евдоним [п�евдоним]
Можно �оздать не�колько вариантов форматов, назначив каждому из них п�евдоним, а затем и�пользовать, �озданные п�евдонимы в директивах CustomLog.
ПримерLogFormat "%h %l %u %t \"%r\" %>s %b" common
LogFormat "%h %t %>s" short
CustomLog logs/access.log common
CustomLog logs/short.log short
Е�ли директива LogFormat определ�ет формат журнала без �оздани� п�евдонима, то �озданный формат примен�ет�� к директиве TransferLog. Дл� запи�и журналов директива TransferLog и�пользует формат, опи�анный в по�ледней директиве LogFormat, либо формат по умолчанию (е�ли ни одной директивы LogFormat не найдено).
ПримерLogFormat "%h %l %u %t \"%r\" %>s %b"
TransferLog logs/access.log
Формат журнала определ�ет�� �трокой в которой перечи�л�ют�� различные параметры запро�а, такие как удаленный IP-адре�, врем� обращени�, ответ �ервера и т.п. Полный �пи�ок возможных параметров приведен в таблице.
| Ïàðàìåòð |
Îïèñàíèå |
| %a |
IP-àäðåñ
óäàëåííîãî õîñòà |
| %A |
IP-àäðåñ
ëîêàëüíîãî õîñòà |
| %B |
Ðàçìåð îòâåòà ñåðâåðà â áàéòàõ, èñêëþ÷àÿ HTTP-çàãîëîâêè |
| %b |
Ðàçìåð îòâåòà ñåðâåðà â áàéòàõ, èñêëþ÷àÿ HTTP-çàãîëîâêè. Âûâîä
çàïèñûâàåòñÿ â ôîðìàòå CLF, ò.å. åñëè îòâåò ñåðâåðà ðàâíÿëñÿ 0 áàéòîâ, òî
âìåñòî 0 çàïèñûâàåòñÿ ïðî÷åðê -. |
| %{my_cookie}C |
Çíà÷åíèå cookies ñ èìåíåì
my_cookie |
| %D |
Âðåìÿ â ìèëëèñåêóíäàõ, ïîòðà÷åííîå ñåðâåðîì íà îáñëóæèâàíèå
çàïðîñà. |
| %{env}e |
Çíà÷åíèå ïåðåìåííîé îêðóæåíèÿ ñ èìåíåì env |
| %f |
Èìÿ ôàéëà, óêàçàííîå â çàïðîñå |
| %h |
Óäàëåííûé õîñò |
| %H |
Ïðîòîêîë çàïðîñà, íàïðèìåð HTTP/1.1 |
| %{header}i |
Çíà÷åíèå çàãîëîâêà ñ èìåíåì header â çàïðîñå. Íàïðèìåð, ÷òîáû
ïîëó÷èòü çíà÷åíèå çàãîëîâêà User-Agent íóæíî çàïèñàòü: %{ User-Agent}i |
| %l |
Èäåíòèôèêàòîð êëèåíòà. Çàïèñûâàåòñÿ åñëè âêëþ÷åíà äèðåêòèâà
IndentyCheck è êëèåíò ïðåäîñòàâèë äàííûå äëÿ èäåíòèôèêàöèè, â ïðîòèâíîì
ñëó÷àå çàïèñûâàåòñÿ ïðî÷åðê. |
| %m |
Ìåòîä çàïðîñà: GET, POST, PUT è ò.ä. |
| %{ModuleNote}n |
Çíà÷åíèå ïðèìå÷àíèÿ ñ èìåíåì ModuleNote èç äðóãîãî ìîäóëÿ. |
| %{header}o |
Çíà÷åíèå çàãîëîâêà ñ èìåíåì header â îòâåòå ñåðâåðà. |
| %p |
Ïîðò ñåðâåðà, êîòîðûé îáñëóæèâàåò çàïðîñ |
| %P |
Èäåíòèôèêàòîð äî÷åðíåãî ïðîöåññà Apache, êîòîðûé îáñëóæèâàåò
çàïðîñ. |
| %{format}P |
Èäåíòèôèêàòîð ïðîöåññà, ëèáî èäåíòèôèêàòîð íèòè äî÷åðíåãî
ïðîöåññà Apache, îáñëóæèâàþùåãî çàïðîñ.  êà÷åñòâå ôîðìàòà ìîãóò áûòü óêàçàíû
pid èëè tid. Äîñòóïíî äëÿ èñïîëüçîâàíèÿ, íà÷èíàÿ ñ Apache 2.0.46. Ïðèìåð:
%{pid}P |
| %q |
Ïàðàìåòðû ñòðîêè çàïðîñà, óêàçàííûå ïîñëå ñèìâîëà ?. Åñëè
ïàðàìåòðîâ íå íàéäåíî, òî çàïèñûâàåòñÿ -. |
| %r |
Ïåðâàÿ ñòðîêà çàïðîñà. |
| %s |
Ñòàòóñ îòâåòà ñåðâåðà: 200, 401, 403, 404 è ò.ï. |
| %>s |
Ïîñëåäíèé ñòàòóñ îòâåòà ñåðâåðà, åñëè èìåëè ìåñòî âíóòðåííèå
ïåðåíàïðàâëåíèÿ çàïðîñà. |
| %t |
Âðåìÿ, â êîòîðîé ñåðâåð çàôèêñèðîâàë çàïðîñ. |
| %{format}t |
Âðåìÿ, îòôîðìàòèðîâàííîå â ñîîòâåòñòâèè ñ ïàðàìåòðîì format.
Ñèíòàêñèñ ïàðàìåòðà format íà man-ñòðàíèöå äëÿ strftime â ñèñòåìàõ unix, à
òàêæå â îïèñàíèè ôóíêöèè strftime â ñïðàâî÷íèêå ôóíêöèé PHP. |
| %T |
Âðåìÿ â ñåêóíäàõ, çàòðà÷åííîå íà îáñëóæèâàíèå çàïðîñà |
| %u |
Èìÿ óäàëåííîãî ïîëüçîâàòåëÿ, åñëè çàïðîñ òðåáîâàë àóòåíòèôèêàöèè
HTTP. |
| %U |
Çàïðîøåííûé URL,èñêëþ÷àÿ ïàðàìåòðû, óêàçàííûå ïîñëå ñèìâîëà ? |
| %v |
Êàíîíî÷åñêîå èìÿ ñåðâåðà, îáñëóæèâàþùåãî çàïðîñ |
| %V |
Èìÿ ñåðâåðà, çàïèñàííîå â ôîðìàòå, îïðåäåëåííûì äèðåêòèâîé UseCanonicalName |
| %X |
Ñòàòóñ ñîåäèíåíèÿ, ïîñëå îòïðàâêè îòâåòà ñåðâåðà. |
| X = ñîåäèíåíèå áûëî ïðåðâàíî ïåðåä îòïðàâêîé îòâåòà |
| + = ñîåäèíåíèå áûëî ñîõðàíåíî ïîñëå
îòïðàâêè îòâåòà |
| - =
ñîåäèíåíèå áûëî çàêðûòî ïîñëå îòïðàâêè îòâåòà |
| %I |
Ïîëó÷åííûå áàéòû, âêëþ÷àÿ ñàì çàïðîñ è çàãîëîâêè. Äëÿ
èñïîëüçîâàíèÿ ýòîãî ïàðàìåòðà íåîáõîäèìî ïîäêëþ÷èòü ìîäóëü mod_logio. |
| %O |
Îòïðàâëåííûå áàéòû, âêëþ÷àÿ çàãîëîâêè. Äëÿ èñïîëüçîâàíèÿ ýòîãî
ïàðàìåòðà íåîáõîäèìî ïîäêëþ÷èòü ìîäóëü mod_logio. |
| |
|
|