نام (NAME)

logwatch - تحلیل‌گر و گزارش‌دهنده گزارش‌های سیستمی (لاگ‌ها)

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

logwatch [--detail level ] [--logfile log-file-group ] [--service service-name ] [--mailto address ] [--noarchives] [--range range ] [--debug level ] [--filename file-name ] [--logdir directory ] [--hostlimit hosts ] [--hostname hostname ] [--html_wrap number of characters ] [--hostformat host based options ] [--output output-type ] [--format report format ] [--subject email subject ] [--encode encoding to use ] [--numeric] [--version] [--help|--usage]

توضیحات (DESCRIPTION)

ابزار Logwatch یک سامانه پایش وقایع و گزارش‌ها (لاگ‌ها) با قابلیت سفارشی‌سازی و افزونه‌پذیری است. این برنامه لاگ‌های شما را در بازه زمانی مشخص بررسی کرده و در بخش‌ها و با جزئیات مورد نظر شما گزارش تهیه می‌کند. Logwatch در لینوکس و انواع مختلف یونیکس به کار می‌رود.

گزینه‌ها (OPTIONS)

--detail level

سطح جزئیات گزارش. level می‌تواند یک عدد صحیح مثبت یا یکی از مقادیر high، med، low باشد که به ترتیب معادل اعداد ۱۰، ۵ و ۰ هستند.

--logfile log-file-group

برنامه Logwatch را وادار می‌کند تا تنها مجموعه‌ای از فایل‌های گزارش مشخص‌شده توسط log-file-group (مانند messages، xferlog و...) را پردازش کند. بنابراین Logwatch تمام سرویس‌هایی را که از این فایل‌ها استفاده می‌کنند پردازش خواهد کرد. این گزینه می‌تواند بیش از یک بار برای تعیین چند گروه فایل لاگ تکرار شود.

--service service-name

برنامه Logwatch را وادار می‌کند تا تنها سرویس مشخص‌شده در service-name (مانند login، pam، identd و...) را پردازش کند. بنابراین Logwatch هر گروه فایل لاگ لازم برای پردازش این سرویس‌ها را نیز بررسی می‌کند. این گزینه می‌تواند بیش از یک بار برای تعیین چندین سرویس جهت پردازش تکرار شود. یک مقدار مفید برای service-name گزینه All است که تمام سرویس‌ها (و گروه‌های فایل لاگ) را که فیلتر آن‌ها نصب شده است پردازش می‌کند.

--mailto address

ارسال نتایج به نشانی ایمیل یا کاربر مشخص‌شده در address.

--range range

تعیین بازه تاریخی برای پردازش. بازه‌های رایج عبارتند از Yesterday، Today، All و Help. گزینه‌های بیشتر هنگام اجرای دستور با پارامتر Help فهرست می‌شوند.

--noarchives

هر گروه فایل لاگ شامل فایل‌های لاگ پایه (مانند /var/log/messages) و فایل‌های آرشیو (مانند /var/log/messages.? یا /var/log/messages.?.gz) است. به طور پیش‌فرض، Logwatch علاوه بر فایل‌های لاگ معمولی، در آرشیوها نیز جستجو می‌کند. برای مقادیر --range به جز "all"، برنامه Logwatch لاگ‌های آرشیوشده مربوطه را جستجو می‌کند. اگر "--noarchives" مشخص شود، Logwatch برای هیچ مقداری از "--range" در لاگ‌های آرشیوشده جستجو نخواهد کرد.

--debug level

برای اهداف اشکال‌زدایی. level معمولاً مقداری بین ۰ تا ۱۰۰ دارد. این گزینه خروجی را با جزئیات فراوان شلوغ می‌کند، بنابراین احتمالاً تنها هنگام اشکال‌زدایی مایل به استفاده از آن هستید. مقادیر ۱۰۰ یا بیشتر، فایل‌های موقت را نگه می‌دارند (به طور پیش‌فرض زیر مسیر /var/cache/logwatch ایجاد می‌شوند، مگر اینکه به عنوان tmpdir در فایل logwatch.conf مشخص شده باشد).

--filename file-name

ذخیره خروجی در file-name به جای نمایش در خروجی استاندارد یا ارسال ایمیل.

--logdir directory

جستجوی پوشه‌های فرعی یا فایل‌های لاگ در directory پیش از بررسی پوشه‌های پیش‌فرض.

--hostlimit host1,host2

محدود کردن گزارش به نام میزبان‌های مشخص‌شده - host1, host2.

--hostname hostname

استفاده از hostname برای گزارش‌ها به جای نام میزبان این سیستم. افزون بر این، اگر HostLimit در فایل پیکربندی logwatch.conf تنظیم شده باشد (بخش اطلاعات بیشتر در زیر را ببینید)، تنها لاگ‌های مربوط به این نام میزبان پردازش خواهند شد (در صورت کاربرد).

--html_wrap num-characters

تعداد کاراکترهایی که خروجی html باید به آن سطرشکنی (wrap) شود. پیش‌فرض ۸۰ است.

--hostformat split

استفاده از رویکرد split هنگام قالب‌بندی گزارش برای چند میزبان - none [پیش‌فرض]، split، splitmail.

--output output-type

گزارش‌گیری با استفاده از output-type - stdout [پیش‌فرض]، mail، file.

--format format

قالب‌بندی گزارش با format - text [پیش‌فرض]، html.

--subject email-subject

سفارشی‌سازی موضوع ایمیل ارسالی توسط Logwatch. گزینه --output باید روی mail تنظیم شده باشد.

--encode encoding

کدگذاری گزارش با استفاده از encoding - none [پیش‌فرض]، base64، 7bit، 8bit [مشابه 'none'].

--numeric

جلوگیری از وضوح‌یابی نام‌ها و نمایش عددی نشانی‌های IP.

--usage

نمایش اطلاعات نحوه استفاده

--help

مشابه --usage.

فایل‌ها (FILES)

/usr/share/logwatch/

/etc/logwatch

مثال‌ها (EXAMPLES)

logwatch --service ftpd-xferlog --range all --detail high

اطلاعات بیشتر (MORE INFORMATION)

پوشه /usr/share/doc/logwatch-* شامل چندین فایل حاوی مستندات تکمیلی است:
HOWTO-Customize-LogWatch

نویسنده (AUTHOR)

Kirk Bauer <kirk@kaybee.org>
http://sourceforge.net/projects/logwatch