نام (NAME)

common2dlf - تبدیل فایل‌های لاگ وب‌سرور Common Log Format به www DLF

خلاصه دستور (SYNOPSIS)

common2dlf file

توضیحات (DESCRIPTION)

دستور common2dlf فایل‌های لاگ وب‌سرور در ساختار Common Log Format را به www DLF تبدیل می‌کند. ساختار Common Log Format یک قالب لاگ استاندارد است که در ابتدا در وب‌سرور CERN httpd پیاده‌سازی شده بود، اما امروزه توسط بیشتر وب‌سرورها پشتیبانی می‌شود. می‌توان Apache، IIS، Boa و PureFTPD را به گونه‌ای پیکربندی کرد که رویدادها را در این قالب ثبت کنند.

اگر آرگومان file مشخص نشده باشد، STDIN تجزیه خواهد شد. خروجی DLF در STDOUT چاپ خواهد شد.

قالب لاگ متداول (COMMON LOG FORMAT)

قالب Common Log Format دارای ساختار زیر است:

remotehost rfc931 authuser [date] "request" status bytes

که در آن هر فیلد مفهوم زیر را دارد:

remotehost: میزبانی که درخواست را ارسال کرده است. می‌تواند یک IP یا نام میزبان (hostname) باشد.
rfc931: نتیجه جستجوی ident روی میزبان. این فیلد معمولاً استفاده نمی‌شود.
authuser: نام کاربری احرازهویت‌شده.
date: برچسب زمانی (timestamp) ثبت درخواست.
request: خط اول درخواست؛ معمولاً در قالب "method request-uri http-version".
همچنین بخش 5.1 از سند RFC 2616 را ببینید.
status: کد وضعیت پاسخ به درخواست؛ مانند 200، 301، 404، 500.
bytes: حجم داده ارسال‌شده به کلاینت.

نمونه لاگ:

127.0.01 - - [11/03/2001 12:12:01 -0400] "GET / HTTP/1.0" 200 513
dsl1.myprovider.com - francis [11/03/2001 12:14:01 -0400] "GET /secret/ HTTP/1.0" 200 1256

مثال‌ها (EXAMPLES)

برای پردازش لاگی که در قالب common logformat تولید شده است:

$ lr_run common2dlf < common.log

ابزار common2dlf به‌ندرت به صورت مستقل استفاده می‌شود؛ بلکه اغلب توسط lr_log2report فراخوانی می‌گردد:

$ lr_log2report common < /var/log/httpd/common.log

همچنین ببینید (SEE ALSO)

combined(2), modgzip2dlf(1), referer2dlf(1)

نویسندگان (AUTHORS)

Joost van Baal <joostvb@logreport.org>، Francis J. Lacoste <flacoste@logreport.org> و Egon Willighagen <egonw@logreport.org>، بر پایه ایده‌ای از Edwin Groothuis

نسخه (VERSION)

$Id: common2dlf.in,v 1.15 2006/07/23 13:16:36 vanbaal Exp $

کپی‌رایت و تکثیر (COPYRIGHT)

این برنامه یک نرم‌افزار آزاد است؛ شما می‌توانید آن را تحت شرایط مجوز عمومی همگانی گنو (GNU General Public License) که توسط بنیاد نرم‌افزارهای آزاد (Free Software Foundation) منتشر شده است — چه نسخه ۲ مجوز و چه (به انتخاب خودتان) هر نسخه پس از آن — بازتوزیع کرده و/یا تغییر دهید.

این برنامه با این امید توزیع شده است که مفید واقع شود، اما بدون هرگونه ضمانت؛ حتی بدون ضمانت ضمنی قابل فروش بودن یا مناسب بودن برای یک هدف خاص. برای جزئیات بیشتر به متن پروانه عمومی همگانی گنو مراجعه کنید.

شما باید به همراه این برنامه نسخه‌ای از GNU General Public License را دریافت کرده باشید (فایل COPYING را ببینید)؛ در غیر این صورت به نشانی http://www.gnu.org/copyleft/gpl.html مراجعه کنید.