LOGWATCH(8)                  راهنمای کاربری لینوکس                 LOGWATCH(8)

نام (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/
              این دایرکتوری شامل تمام برنامه‌های اجرایی پرل و فایل‌های پیکربندی
              ارائه‌شده همراه با توزیع logwatch است.

       /etc/logwatch
              این دایرکتوری شامل فایل‌های پیکربندی محلی است که پیکربندی پیش‌فرض
              را بازنویسی می‌کنند. برای جزئیات بیشتر بخش اطلاعات بیشتر (MORE
              INFORMATION) در زیر را ببینید.

مثال‌ها (EXAMPLES)
       logwatch --service ftpd-xferlog --range all --detail high
              تمام انتقالات FTP ذخیره‌شده در کلیه xferlogهای جاری و آرشیوشده را
              چاپ می‌کند.
       logwatch --service pam_pwdb --range yesterday --detail high
              اطلاعات ورود به سیستم برای روز گذشته را چاپ می‌کند...

اطلاعات بیشتر (MORE INFORMATION)
       پوشه /usr/share/doc/logwatch-* شامل چندین فایل حاوی مستندات تکمیلی است:
       HOWTO-Customize-LogWatch
              ساختار پوشه‌های پیکربندی و فایل‌های اجرایی Logwatch را مستند کرده
              و نحوه سفارشی‌سازی Logwatch را با بازنویسی این فایل‌های پیش‌فرض شرح
              می‌دهد.
       LICENSE
              مجوزی را که Logwatch تحت آن توزیع شده است شرح می‌دهد. بندهای
              تکمیلی ممکن است در فایل‌های جداگانه مشخص شده باشند.
       README
              نحوه نصب، محل دریافت، لیست‌های پستی و سایر اطلاعات مفید را شرح
              می‌دهد.

نویسنده (AUTHOR)
       Kirk Bauer <kirk@kaybee.org>
       <http://sourceforge.net/projects/logwatch>

Linux                              May 2012                        LOGWATCH(8)