نام (NAME)

lr_log2report - تولید گزارش از یک فایل لاگ

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

lr_log2report [options] dlf_converter [ logfile ] [ output_file ]

lr_log2report --version

lr_log2report --help [dlf-converters|output-formats|report-templates]

گزینه‌ها (OPTIONS)

--help [section]

اگر هیچ آرگومانی داده نشود، اطلاعات نحوهٔ استفاده را چاپ کرده و خارج می‌شود. آرگومان می‌تواند یکی از موارد زیر باشد:

--version

نسخهٔ Lire را چاپ کرده و خارج می‌شود.

--output-format|-o output format

قالب خروجی مورد نظر برای تولید گزارش را انتخاب می‌کند.

--template|-t name

از پیکربندی گزارشی با نام name برای تولید گزارش استفاده می‌کند.

توضیحات (DESCRIPTION)

دستور lr_log2report یک فایل لاگ را از STDIN یا آرگومان مشخص‌شده خوانده و گزارش قالب‌بندی‌شدهٔ Lire را در STDOUT یا در آرگومان output_file خروجی می‌دهد. قالب فایل لاگ با استفاده از آرگومان dlf_converter تعیین می‌شود. برای دریافت فهرستی از تمام مبدل‌های DLF موجود، از گزینهٔ --help dlf-converters استفاده کنید.

در صورتی که فایل لاگ در یک قالب فشرده ارسال شود، با استفاده از gzip(1) به‌صورت درجا (on the fly) از حالت فشرده خارج می‌شود.

هشدار: این دستور برای تمام قالب‌های خروجی به جز txt و xml، داده‌های باینری را در ترمینال چاپ می‌کند. هنگام استفاده از آن قالب‌های خروجی، باید stdout را به یک فایل تغییر مسیر (redirect) دهید.

در حالتی که output format برابر با html باشد، آرگومان output_file به عنوان نام یک دایرکتوری در نظر گرفته خواهد شد. این دایرکتوری در صورت نیاز ایجاد می‌شود و فایل‌های گوناگون html را در بر می‌گیرد. در صورتی که این آرگومان حذف شود، یک فایل tar(1) باید در STDOUT خروجی داده شود (اما بخش باگ‌ها را ببینید).

هشدار: اجرای این دستور روی فایل‌های لاگ حجیم عموماً بدین معناست که به فضای خالی دیسک زیادی نیاز خواهید داشت. برای جزئیات به Lire::LrCommand(3pm) مراجعه کنید.

مثال‌ها (EXAMPLES)

برای پردازش یک لاگ Postfix و نمایش گزارش به صورت متن:

$ lr_log2report postfix /var/log/mail.log

برای پردازش یک لاگ Postfix و ایجاد گزارش HTML درون یک دایرکتوری:

$ lr_log2report -o html postfix /var/log/mail.log postfix-report

گزارش باگ‌ها (BUGS)

اگر

--output html

مشخص شده باشد، هم logfile و هم output_file باید مشخص شوند. تعیین "-" (یا "/dev/stdin") به عنوان logfile پشتیبانی می‌شود. بنابراین دستور زیر

$ tai64nfrac < /var/log/qmail-send/current | \
   lr_log2report qmail --output html - /tmp/report

کار خواهد کرد.

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

lr_log2mail(1), lr_xml2report(1), lr_xml2mail(1), lire(1), lire(7), Lire::LrCommand(3pm), مستندات راهنمای کاربری Lire

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

Joost van Baal <joostvb@logreport.org>
Francis J. Lacoste <flacoste@logreport.org>

نسخه (VERSION)

$Id: lr_log2report.in,v 1.100 2006/10/04 10:19:17 vanbaal Exp $

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

Copyright (C) 2000-2004 Stichting LogReport Foundation LogReport@LogReport.org

این برنامه بخشی از Lire است.

برنامه Lire یک نرم‌افزار آزاد است؛ شما می‌توانید آن را تحت شرایط مجوز عمومی همگانی گنو (GNU GPL) که توسط بنیاد نرم‌افزارهای آزاد منتشر شده است، چه نسخهٔ ۲ مجوز و چه (به انتخاب خودتان) هر نسخهٔ بالاتر دیگری، بازتوزیع کرده یا تغییر دهید.

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

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