.TH AMAVIS-LOGWATCH 1
.ad
.fi
.SH "نام (NAME)"
amavis-logwatch
\-
ابزاری برای تجزیه لاگ و تحلیل Amavisd-new
.SH "خلاصه دستور (SYNOPSIS)"
.na
.nf
.fi
\fBamavis-logwatch\fR [\fIoptions\fR] [\fIlogfile ...\fR]
.SH "توضیحات (DESCRIPTION)"
.ad
.fi
ابزار \fBamavis-logwatch\fR(1) یک تجزیه‌کنندهٔ لاگ Amavisd-new است
که خلاصه‌ها، جزئیات و آمارهای مربوط به عملکرد Amavisd-new
(که از این پس به سادگی Amavis نامیده می‌شود) را تولید می‌کند.
.PP
این ابزار می‌تواند به عنوان یک برنامهٔ مستقل، یا به عنوان یک
ماژول فیلتر Logwatch برای ایجاد گزارش‌های خلاصه و تفصیلی
Amavisd-new از داخل Logwatch به کار رود.
.PP
\fBAmavis-logwatch\fR قادر است طیف گسترده‌ای از گزارش‌ها را
با داده‌هایی که تا حد امکان گروه‌بندی و مرتب‌سازی شده‌اند
تولید کند تا نویز کاهش یابد و الگوها برجسته شوند.
گزارش‌های خلاصهٔ کوتاه، نمای کلی و سریعی از عملیات عمومی
Amavis و تحویل پیام‌ها ارائه داده و هشدارهایی را که ممکن است
نیازمند توجه باشند مشخص می‌کنند. گزارش‌های تفصیلی اطلاعاتی منظم
و با ساختار سلسله‌مراتبی ارائه می‌دهند که بررسی سریع آن‌ها آسان است
و می‌توانند به میزان دلخواه دارای جزئیات کم یا زیاد باشند.
.PP
بخش عمده‌ای از داده‌های کاربردی زمانی در دسترس است که
$log_level در Amavis حداقل روی ۲ تنظیم شده باشد.
بخش \fBAmavis Log Level\fR را در ادامه ببینید.
.PP
\fBAmavis-logwatch\fR دو بخش اصلی را در خروجی تولید می‌کند: یک بخش \fBSummary\fR (خلاصه)
و یک بخش \fBDetailed\fR (تفصیلی).
برای خوانایی و بررسی سریع، تعداد دفعات رخداد تمام رویدادها در ستون سمت چپ نمایش داده می‌شود،
سپس توضیح کوتاهی از نوع رویداد می‌آید، و در نهایت آمار اضافی یا نمایش‌های
شمارشی ممکن است در ستون سمت راست ظاهر شوند.

بخش زیر از یک نمونه گزارش خلاصه (Summary) این ساختار را نشان می‌دهد:
.RS 4
.nf

****** Summary ********************************************

       9   Miscellaneous warnings

   20313   Total messages scanned ----------------  100.00%
1008.534M  Total bytes scanned                1,057,524,252
========   ================================================

    1190   Blocked -------------------------------    5.86%
      18     Malware blocked                          0.09%
       4     Banned name blocked                      0.02%
     416     Spam blocked                             2.05%
     752     Spam discarded (no quarantine)           3.70%

   19123   Passed --------------------------------   94.14%
      47     Bad header passed                        0.23%
   19076     Clean passed                            93.91%
========   ================================================

      18   Malware -------------------------------    0.09%
      18     Malware blocked                          0.09%

       4   Banned --------------------------------    0.02%
       4     Banned file blocked                      0.02%

    1168   Spam ----------------------------------    5.75%
     416     Spam blocked                             2.05%
     752     Spam discarded (no quarantine)           3.70%

   19123   Ham -----------------------------------   94.14%
      47     Bad header passed                        0.23%
   19076     Clean passed                            93.91%
========   ================================================

    1982   SpamAssassin bypassed
      32   Released from quarantine
       2   DSN notification (debug supplemental)
       2   Bounce unverifiable
    2369   Whitelisted
       2   Blacklisted
      12   MIME error
      58   Bad header (debug supplemental)
      40   Extra code modules loaded at runtime

.fi
.RE 0
این گزارش نشان می‌دهد که ۹ هشدار عمومی وجود داشته است و
\fBAmavis\fR در مجموع ۲۰۳۱۳ پیام را با حجم کلی
۱۰۰۸.۵۳ مگابایت یا ۱,۰۵۷,۵۲۴,۲۵۲ بایت پویش کرده است.
گروه خلاصه بعدی نمای کلی Blocked / Passed (مسدود شده / عبور داده شده) را نشان می‌دهد،
با ۱۱۹۰ پیام مسدود شده (تفکیک‌شده به صورت ۱۸ پیام مسدود شده به عنوان بدافزار،
۴ پیام با نام‌های ممنوعه، ۴۱۶ پیام هرزنامه، و ۷۵۲ پیام دور ریخته شده)،
و ۱۹۱۲۳ پیام عبور داده شده (۴۷ پیام با سرایند نامعتبر و ۱۹۰۷۶ پیام پاک).

گروه‌بندی خلاصه‌ای بعدی (اختیاری)، وضعیت نهایی پیام‌ها را بر اساس دسته‌بندی محتوا نشان می‌دهد.
۱۸ پیام بدافزار و ۴ پیام فایل ممنوعه وجود داشته است (که همگی مسدود شده‌اند)،
۱۱۶۸ پیام هرزنامه که ۴۱۶ مورد از آن‌ها مسدود (قرنطینه) شده و ۷۵۲ مورد دور ریخته شده‌اند.
در نهایت، ۱۹۱۲۳ پیام به عنوان Ham (پیام سالم، یعنی غیر هرزنامه) در نظر گرفته شده‌اند که
۴۷ مورد از آن‌ها حاوی سرایندهای نامعتبر بوده‌اند.

خلاصه‌های شمارشی دیگری نیز برای انواع رویدادها فهرست شده‌اند.
.PP
ده‌ها زیربخش مختلف در گزارش \fBDetailed\fR در دسترس است که
خروجی هر کدام را می‌توان به روش‌های گوناگونی کنترل کرد.
هر زیربخش تلاش می‌کند پرمعناترین داده‌ها را در سطوح بالاتر گروه‌بندی کرده و نمایش دهد،
در حالی که داده‌های کم‌فایده‌تر یا \fInoisy\fR (دارای نویز و داده‌های زائد) را به سطوح پایین‌تر سوق می‌دهد.
هدف این است که بیشترین بهره از گروه‌بندی هوشمندانهٔ داده‌ها فراهم شود تا
بررسی سریع‌تر گزارش، شناسایی الگوها و عیب‌یابی تسهیل گردد.
داده‌ها همواره به ترتیب نزولی بر اساس تعداد دفعات، و سپس بر حسب مورد به صورت عددی
بر اساس آدرس IP یا به ترتیب الفبایی مرتب می‌شوند.
.PP
بخش مسدودسازی هرزنامه (Spam blocked) زیر از یک نمونه گزارش \fBDetailed\fR،
ساختار سطح‌بندی سلسله‌مراتبی پایه‌ای \fBamavis-logwatch\fR را نشان می‌دهد:
.RS 4
.nf

****** Detailed *******************************************

   19346   Spam blocked -----------------------------------
     756      from@example.com
      12         10.0.0.2
      12            <>
      12         192.168.2.2
      12            <>
       5         192.168.2.1
     ...

.fi
.RE 0
.PP
ابزار \fBamavis-logwatch\fR از ورودی استاندارد (STDIN) یا از
\fIlogfile\fR مشخص‌شدهٔ Amavis می‌خواند.
می‌توان چندین آرگومان \fIlogfile\fR را مشخص کرد که هر کدام
به ترتیب پردازش می‌شوند.
کاربری که \fBamavis-logwatch\fR را اجرا می‌کند باید دسترسی خواندن
روی هر یک از فایل‌های لاگ مشخص‌شده را داشته باشد.
.PP.SS "گزینه‌ها (Options)"
گزینه‌های فهرست‌شده در زیر بر عملکرد \fBamavis-logwatch\fR تأثیر می‌گذارند.
گزینه‌هایی که جلوتر در خط فرمان مشخص می‌شوند بر گزینه‌های پیشین اولویت دارند.
هر گزینه‌ای را می‌توان تا اندازه‌ای که ابهامی ایجاد نکند خلاصه کرد.

.IP "\fB--[no]autolearn\fR"
.PD 0
.IP "\fB--show_autolearn \fIboolean\fR"
.PD
خروجی گزارش یادگیری خودکار (autolearn) را فعال (غیرفعال) می‌کند.
این گزارش تنها زمانی در دسترس است که \fB$log_templ\fR پیش‌فرض Amavis برای ارائه نتایج یادگیری خودکار در گزارش‌ها تغییر یافته باشد.
این کار را می‌توان با خارج کردن دو خط از حالت کامنت در خود برنامه Amavis (جایی که الگوهای گزارش پیش‌فرض قرار دارند)، یا با افزودن صحیح متغیر \fB$log_templ\fR به فایل \fBamavisd.conf\fR انجام داد.
فایل \fBREADME.customize\fR مربوط به Amavis را ببینید و نزدیکی انتهای برنامه Amavisd را برای «autolearn» جستجو کنید.
.IP "\fB--[no]by_ccat_summary\fR"
.PD 0
.IP "\fB--show_by_ccat_summary \fIboolean\fR"
.PD
خلاصه بر اساس دسته‌بندی محتوا را در بخش \fBSummary\fR فعال (غیرفعال) می‌کند.
پیش‌فرض: فعال.
.IP "\fB-f \fIconfig_file\fR"
.PD 0
.IP "\fB--config_file \fIconfig_file\fR"
.PD
استفاده از فایل پیکربندی جایگزین \fIconfig_file\fR به جای حالت پیش‌فرض.
این گزینه می‌تواند بیش از یک بار استفاده شود.
چندین فایل پیکربندی به ترتیبی که در خط فرمان ارائه شده‌اند پردازش خواهند شد.
بخش \fBCONFIGURATION FILE\fR را در زیر ببینید.
.IP "\fB--debug \fIkeywords\fR"
نمایش اطلاعات اشکال‌زدایی حین اجرای \fBamavis-logwatch\fR.
پارامتر \fIkeywords\fR شامل یک یا چند کلمه کلیدی است که با کاما یا فاصله از هم جدا شده‌اند.
برای دریافت فهرست کلمات کلیدی معتبر، از --debug xxx استفاده کنید که در آن xxx هر کلمه کلیدی نامعتبری است.
.IP "\fB--detail \fIlevel\fR"
حداکثر سطح جزئیات را برای \fBamavis-logwatch\fR روی \fIlevel\fR تنظیم می‌کند.
این گزینه سراسری بوده و بر سایر محدودکننده‌های خروجی شرح‌داده‌شده در زیر اولویت دارد.

ابزار \fBamavis-logwatch\fR یک بخش \fBSummary\fR، یک بخش \fBDetailed\fR و بخش‌های گزارش تکمیلی تولید می‌کند.
با مقدار \fIlevel\fR کمتر از ۵، \fBamavis-logwatch\fR تنها بخش \fBSummary\fR را تولید خواهد کرد.
در \fIlevel\fR برابر ۵ و بالاتر، بخش \fBDetailed\fR و هر یک از بخش‌های گزارش تکمیلی واجد شرایط خروجی خواهند بود.
هر افزایش گامی در \fIlevel\fR، یک زیرسطح سلسله‌مراتبی دیگر از خروجی را در بخش \fBDetailed\fR گزارش تولید می‌کند.
در \fIlevel\fR برابر ۱۰، تمامی سطوح در خروجی نمایش داده می‌شوند.
خطوطی که از حداکثر عرض گزارش (مشخص‌شده با \fBmax_report_width\fR) فراتر روند بریده خواهند شد.
تنظیم \fIlevel\fR روی ۱۱ از بریده شدن خطوط در گزارش جلوگیری می‌کند (همچنین \fB--line_style\fR را ببینید).
.IP "\fB--[no]first_recip_only\fR"
.PD 0
.IP "\fB--show_first_recip_only \fIboolean\fR"
.PD
مشخص می‌کند که هنگام اسکن پیام‌های دارای چند گیرنده، مرتب‌سازی و نمایش تنها بر اساس اولین گیرنده انجام شود یا خیر.
.IP "\fB--help\fR"
چاپ اطلاعات نحوه استفاده و توضیح مختصری درباره گزینه‌های خط فرمان.
.IP "\fB--ipaddr_width \fIwidth\fR"
مشخص می‌کند که آدرس‌های IP در جفت‌های نشانی/نام میزبان، با پهنای فیلدِ \fIwidth\fR نویسه چاپ شوند.
افزایش مقدار پیش‌فرض ممکن است برای سیستم‌هایی که از آدرس‌های طولانی IPv6 استفاده می‌کنند مفید باشد.
.IP "\fB-l limiter=levelspec\fR"
.PD 0
.IP "\fB--limit limiter=levelspec\fR"
.PD
محدودکننده سطح \fIlimiter\fR را با مشخصه \fIlevelspec\fR تنظیم می‌کند.
.IP "\fB--line_style \fIstyle\fR"
نحوه مدیریت خطوط طولانی گزارش را مشخص می‌کند.
سه سبک در دسترس است: \fBfull\fR، \fBtruncate\fR و \fBwrap\fR.
تنظیم \fIstyle\fR روی \fBfull\fR مانع از برش خطوط به اندازه \fBmax_report_width\fR می‌شود؛
این همان رفتاری است که در صورت تنظیم \fBdetail\fR روی ۱۱ یا بالاتر رخ می‌دهد.
هنگامی که \fIstyle\fR برابر با \fBtruncate\fR (پیش‌فرض) باشد، خطوط طولانی بر اساس \fBmax_report_width\fR کوتاه می‌شوند.
تنظیم \fIstyle\fR روی \fBwrap\fR خطوط طولانی‌تر از \fBmax_report_width\fR را به گونه‌ای می‌شکند که شمارنده‌های رخداد در ستون چپ پوشانده نشوند.
این گزینه بر سبک خط تحمیل‌شده توسط سطح \fBdetail\fR اولویت دارد.
گزینه‌های \fB--full\fR، \fB--truncate\fR و \fB--wrap\fR هم‌معنی هستند.

.IP "\fB--nodetail\fR"
بخش \fBDetailed\fR گزارش و تمام گزارش‌های تکمیلی را غیرفعال می‌کند.
این گزینه سازوکار مناسبی برای غیرفعال‌سازی سریع تمام بخش‌های زیرمجموعه گزارش \fBDetailed\fR فراهم می‌کند، به طوری که گزینه‌های بعدی در خط فرمان می‌توانند یک یا چند بخش را برای ایجاد گزارش‌های خاص دوباره فعال کنند.

.PD 0
.IP "\fB--sarules \fR\`\fIS,H\fR\'"
.IP "\fB--sarules default"
.PD
گزارش مطابقت با قوانین SpamAssassin (SpamAssassin Rules Hit) را فعال می‌کند.
آرگومان‌های جداشده با کامای \fIS\fR و \fIH\fR به ترتیب مقادیر N تای برتر برای گزارش‌های Spam و Ham هستند و می‌توانند هر عدد صحیح بزرگ‌تر یا مساوی ۰ یا کلیدواژه \fBall\fR باشند.
کلیدواژه \fBdefault\fR از مقادیر پیش‌فرض توکار استفاده می‌کند.
.IP "\fB--nosarules\fR"
گزارش مطابقت با قوانین SpamAssassin را غیرفعال می‌کند.

.PD 0
.IP "\fB--sa_timings \fR\fInrows\fR"
گزارش صدک‌های زمان‌بندی SpamAssassin را فعال می‌کند.
این گزارش را می‌توان با آرگومان \fInrows\fR به N سطر برتر محدود کرد.
این گزارش به Amavis نسخه 2.6+ و SpamAssassin نسخه 3.3+ نیاز دارد.
.PD
.IP "\fB--sa_timings_percentiles \fR\`\fIP1 [P2 ...]\fR\'"
صدک‌های نمایش‌داده‌شده در گزارش زمان‌بندی‌های SpamAssassin را مشخص می‌کند.
آرگومان‌های \fIP1 ...\fR اعدادی صحیح شامل ۰ تا ۱۰۰ هستند.
ترتیب آن‌ها در گزارش حفظ خواهد شد.
.IP "\fB--nosa_timings\fR"
گزارش زمان‌بندی‌های SpamAssassin را غیرفعال می‌کند.
.IP "\fB--version\fR"
چاپ اطلاعات نسخه \fBamavis-logwatch\fR.

.PD 0
.IP "\fB--score_frequencies \fR\`\fIB1 [B2 ...]\fR\'"
.IP "\fB--score_frequencies default"
.PD
گزارش توزیع فراوانی امتیاز هرزنامه (Spam Score Frequency) را فعال می‌کند.
آرگومان‌های \fIB1 ...\fR دسته‌های توزیع فراوانی هستند و می‌توانند هر عدد حقیقی باشند.
ترتیب آن‌ها در گزارش حفظ خواهد شد.
کلیدواژه \fBdefault\fR از مقادیر پیش‌فرض توکار استفاده می‌کند.
.IP "\fB--noscore_frequencies\fR"
گزارش Spam Score Frequency را غیرفعال می‌کند.

.PD 0
.IP "\fB--score_percentiles \fR\`\fIP1 [P2 ...]\fR\'"
.IP "\fB--score_percentiles default"
.PD
گزارش صدک‌های امتیاز هرزنامه (Spam Score Percentiles) را فعال می‌کند.
آرگومان‌های \fIP1 ...\fR صدک‌های نمایش‌داده‌شده در گزارش را مشخص می‌کنند و اعدادی صحیح از ۰ تا ۱۰۰ هستند.
کلیدواژه \fBdefault\fR از مقادیر پیش‌فرض توکار استفاده می‌کند.
.IP "\fB--noscore_percentiles\fR"
گزارش Spam Score Percentiles را غیرفعال می‌کند.

.IP "\fB--[no]sect_vars\fR"
.PD 0
.IP "\fB--show_sect_vars \fIboolean\fR"
.PD
افزودن نام محدودکننده سطح هر بخش به عنوان آن در بخش \fBDetailed\fR را فعال (غیرفعال) می‌کند.
نام نمایش‌داده‌شده، همان گزینه خط فرمان (یا متغیر فایل پیکربندی) است که برای محدود کردن خروجی آن بخش استفاده شده است.
.
با توجه به تعداد زیاد محدودکننده‌های سطح موجود در \fBamavis-logwatch\fR، این روش سازوکار مناسبی برای تعیین دقیق محدودکننده‌ای است که بر یک بخش اثر می‌گذارد.
.IP "\fB--[no]startinfo\fR"
.PD 0
.IP "\fB--show_startinfo \fIboolean\fR"
.PD
گزارش راه‌اندازی Amavis را فعال (غیرفعال) می‌کند که جزئیات جدیدترین راه‌اندازی Amavis را نمایش می‌دهد.
.IP "\fB--[no]summary\fR"
.IP "\fB--show_summary\fR"
نمایش بخش \fBSummary\fR گزارش را فعال (غیرفعال) می‌کند.
متغیر Amavis_Show_Summary در فایل پیکربندی استفاده می‌شود.
.IP "\fB--syslog_name \fInamepat\fR"
نام سرویس syslog را که \fBamavis-logwatch\fR برای تطبیق خطوط syslog استفاده می‌کند مشخص می‌سازد.
تنها خطوط گزارشی که نام سرویس آن‌ها با عبارت منظم پرل \fInamepat\fR مطابقت داشته باشد توسط \fBamavis-logwatch\fR استفاده خواهند شد؛ تمام خطوط غیرمنطبق نادیده گرفته می‌شوند.
این قابلیت زمانی سودمند است که بسته Amavis از پیش نصب‌شده از نامی به غیر از نام پیش‌فرض (\fBamavis\fR) استفاده کند.

\fBنکته:\fR اگر در عبارت منظم خود از پرانتز استفاده می‌کنید، مطمئن شوید که غیرگیرنده (non-capturing) هستند: به جای \fB(\fIpattern\fB)\fR از \fB(?:\fIpattern\fB)\fR استفاده کنید.

.PD 0
.IP "\fB--timings \fR\fIpercent\fR"
گزارش صدک‌های زمان‌بندی اسکن Amavis را فعال می‌کند.
این گزارش را می‌توان با آرگومان \fIpercent\fR به N درصد برتر محدود کرد.
.PD
.IP "\fB--timings_percentiles \fR\`\fIP1 [P2 ...]\fR\'"
صدک‌های نمایش‌داده‌شده در گزارش زمان‌بندی‌های اسکن را مشخص می‌کند.
آرگومان‌های \fIP1 ...\fR اعدادی صحیح شامل ۰ تا ۱۰۰ هستند.
ترتیب آن‌ها در گزارش حفظ خواهد شد.
.IP "\fB--notimings\fR"
گزارش زمان‌بندی‌های اسکن Amavis را غیرفعال می‌کند..IP "\fB--version\fR"
نمایش اطلاعات نگارش \fBamavis-logwatch\fR.

.SS محدودکننده‌های سطح (Level Limiters)
.PP
خروجی هر بخش در گزارش \fBDetailed\fR توسط یک محدودکننده سطح کنترل می‌شود.
نام متغیر محدودکننده سطح در صورت تنظیم گزینه \fBsect_vars\fR نمایش داده خواهد شد.
محدودکننده‌های سطح یا از طریق خط فرمان در حالت مستقل با گزینه \fB--limit \fIlimiter\fB=\fIlevelspec\fR،
یا از طریق متغیر فایل پیکربندی \fB$amavis_\fIlimiter\fB=\fIlevelspec\fR تنظیم می‌شوند.
هر محدودکننده نیازمند یک آرگومان \fIlevelspec\fR است که در ادامه در \fBLEVEL CONTROL\fR شرح داده شده است.

فهرست محدودکننده‌های سطح در زیر آورده شده است.

.de TQ
.  br
.  ns
.  TP \\$1
..

.PD 0
.PP
بخش‌های دسته‌بندی محتوای اصلی Amavis (ccatmajor)، به ترتیب اولویت:
VIRUS, BANNED, UNCHECKED, SPAM, SPAMMY, BADH, OVERSIZED, MTA, CLEAN.

.IP "\fBMalwareBlocked"
.IP "\fBMalwarePassed"
پیام‌های مسدودشده یا عبورداده‌شده که حاوی بدافزار هستند (ccatmajor: VIRUS).

.IP "\fBBannedNameBlocked"
.IP "\fBBannedNamePassed"
پیام‌های مسدودشده یا عبورداده‌شده که حاوی نام‌های ممنوع در بخش‌های MIME هستند (ccatmajor: BANNED).

.IP "\fBUncheckedBlocked"
.IP "\fBUncheckedPassed"
پیام‌های مسدودشده یا عبورداده‌شده که توسط یک اسکنر ویروس یا SpamAssassin بررسی نشده‌اند (Amavis ccatmajor: UNCHECKED).

.IP "\fBSpamBlocked"
.IP "\fBSpamPassed"
پیام‌های مسدودشده یا عبورداده‌شده که هرزنامه در نظر گرفته شده و به سطح حذف رسیده‌اند (Amavis ccatmajor: SPAM).

.IP "\fBSpammyBlocked"
.IP "\fBSpammyPassed"
پیام‌های مسدودشده یا عبورداده‌شده که هرزنامه در نظر گرفته شده‌اند، اما به سطح حذف نرسیده‌اند (Amavis ccatmajor: SPAMMY).

.IP "\fBBadHeaderBlocked"
.IP "\fBBadHeaderPassed"
پیام‌های مسدودشده یا عبورداده‌شده که حاوی سرایندهای نامعتبر ایمیل هستند (ccatmajor: BAD-HEADER).

.IP "\fBOversizedBlocked"
.IP "\fBOversizedPassed"
پیام‌های مسدودشده یا عبورداده‌شده که بیش از حد بزرگ در نظر گرفته شده‌اند (Amavis ccatmajor: OVERSIZED).

.IP "\fBMtaBlocked"
.IP "\fBMtaPassed"
پیام‌های مسدودشده یا عبورداده‌شده به دلیل شکست در تزریق مجدد به MTA (Amavis ccatmajor: MTA-BLOCKED).
وقوع این رویداد نشان‌دهنده یک مشکل در پیکربندی است.
[یادداشت: تصور نمی‌شود mtapassed رخ دهد، اما جهت کامل بودن ذکر شده است.]

.IP "\fBOtherBlocked"
.IP "\fBOtherPassed"
پیام‌های مسدودشده یا عبورداده‌شده که در هیچ‌یک از دسته‌بندی‌های محتوای اصلی دیگر قرار نمی‌گیرند (Amavis ccatmajor: OTHER).

.IP "\fBTempFailBlocked"
.IP "\fBTempfailPassed"
پیام‌های مسدودشده یا عبورداده‌شده که با یک شکست موقت مواجه شده‌اند (Amavis ccatmajor: TEMPFAIL).

.IP "\fBCleanBlocked"
.IP "\fBCleanPassed "
پیام‌های مسدودشده یا عبورداده‌شده که پاک در نظر گرفته شده‌اند (Amavis ccatmajor: CLEAN؛ یعنی غیرهرزنامه، غیرویروسی).

.PP
سایر بخش‌ها، به ترتیب الفبا:

.IP "\fBAvConnectFailure"
مشکلات اتصال به اسکنر(های) ضدویروس.

.IP "\fBAvTimeout"
پایان مهلت زمانی در انتظار پاسخ از اسکنر(های) ضدویروس.

.IP "\fBArchiveExtract"
مشکلات استخراج آرشیو.

.IP "\fBBadHeaderSupp"
اطلاعات تکمیلی اشکال‌زدایی درباره پیام‌های حاوی سرایندهای نامعتبر ایمیل.

.IP "\fBBayes"
بسامد پیام‌ها بر اساس بخش‌های احتمالاتی بیزی (Bayesian).

.IP "\fBBadAddress"
نحو نامعتبر نشانی ایمیل.

.IP "\fBBlacklisted"
پیام‌هایی که در فهرست سیاه (نرم) قرار گرفته‌اند. همچنین Whitelisted را در ادامه ببینید.

.IP "\fBBounceKilled"
.IP "\fBBounceRescued"
.IP "\fBBounceUnverifiable"
وضعیت رسیدگی به پیام‌های برگشتی (DSN) دریافتی.

.IP "\fBContentType"
تفکیک پیوست‌های MIME بر اساس نوع/زیرنوع.

.IP "\fBDccError"
خطاهای رخ‌داده با DCC یا بازگردانده‌شده از آن.

.IP "\fBDefangError"
خطاهای رخ‌داده در طول فرایند بی‌خطرسازی (defang).

.IP "\fBDefanged"
پیام‌های بی‌خطرسازی‌شده (بی‌ضرر شده).

.IP "\fBDsnNotification"
خطاهای رخ‌داده هنگام تلاش برای ارسال اعلان وضعیت تحویل.

.IP "\fBDsnSuppressed"
اعلان وضعیت تحویل (DSN) که به‌طور عمدی فرونشانی شده است.

.IP "\fBExtraModules"
ماژول‌های کد اضافی که Amavis در زمان اجرا بارگذاری کرده است.

.IP "\fBFakeSender"
نشانی‌های فرستنده جعلی، بر اساس تشخیص Amavis.

.IP "\fBFatal"
رویدادهای مهلک. این موارد در بالای گزارش نمایش داده می‌شوند، زیرا ممکن است نیازمند توجه باشند.

.IP "\fBLocalDeliverySkipped"
شکست‌ها در تحویل به یک نشانی محلی.

.IP "\fBMalwareByScanner"
تفکیک بدافزار بر اساس اسکنر(هایی) که بدافزار را شناسایی کرده‌اند.

.IP "\fBMimeError"
خطاهای رخ‌داده در حین استخراج MIME.

.IP "\fBPanic"
رویدادهای سراسیمگی (Panic). این موارد در بالای گزارش نمایش داده می‌شوند، زیرا ممکن است نیازمند توجه باشند.

.IP "\fBp0f"
تطابق‌های اثرانگشت غیرفعال (p0f)، گروه‌بندی‌شده بر اساس نوع محتوای ایمیل (ویروس، بررسی‌نشده، ممنوع، هرزنامه، سالم)،
سپس بر اساس رده سیستم‌عامل، و در نهایت بر اساس نشانی IP.
نکته: سیستم‌های Windows بر اساس نگارش سیستم‌عامل ویندوز تفکیک می‌شوند، در حالی که نگارش‌های سایر سیستم‌عامل‌ها
به‌صورت کلی گروه‌بندی می‌گردند.

.IP "\fBReleased"
پیام‌هایی که از قرنطینه Amavis آزاد شده‌اند.

.IP "\fBSADiags"
اطلاعات تشخیصی گزارش‌شده از سوی SpamAssassin.

.IP "\fBSmtpResponse"
پاسخ‌های SMTP دریافت شده در طول گفتگو با MTA. این ورودی‌های لاگ اساساً مربوط به اشکال‌زدایی هستند.

.IP "\fBTmpPreserved"
دایرکتوری‌های موقتی حفظ‌شده توسط Amavis در هنگامی که مؤلفه‌ای با مشکل یا شکست مواجه می‌شود.
دایرکتوری‌های فهرست‌شده و ورودی‌های گزارش متناظر آن‌ها باید برای بررسی مشکلات ارزیابی شوند.

.IP "\fBVirusScanSkipped"
پیام‌هایی که اسکن آن‌ها توسط یک اسکنر ویروس ممکن نبوده است.

.IP "\fBWarning"
رویدادهای هشدار که در هشدارهای خاص زیر دسته‌بندی نشده‌اند.
این موارد در بالای گزارش نمایش داده می‌شوند، زیرا ممکن است نیازمند توجه باشند.

.IP "\fBWarningAddressModified"
نشانی‌های ایمیل ناقص که به منظور ایمنی توسط Amavis اصلاح شده‌اند.

.IP "\fBWarningNoQuarantineId"
تلاش‌ها برای آزادسازی یک پیام قرنطینه‌شده که فاقد سرایند X-Quarantine-ID بوده است.

.IP "\fBWarningSecurity \fIlevelspec\fR"
پیکربندی یا ابزار ناامن استفاده‌شده توسط Amavis.

.IP "\fBWarningSmtpShutdown"
شکست‌ها در طول مکالمه SMTP با MTA.

.IP "\fBWarningSql"
شکست در برقراری ارتباط با، یا پاسخ‌های خطای دریافتی از، سرویس SQL..IP "\fBWhitelisted"
پیام‌هایی که (به‌صورت نرم) در فهرست سفید قرار گرفته‌اند. همچنین Blacklisted در بالا را ببینید.

.PD
.SH "کنترل سطح (LEVEL CONTROL)"
.ad
.fi
بخش \fBDetailed\fR گزارش از چندین زیربخش تشکیل شده است که هر یک از آن‌ها هم به‌صورت سراسری و هم مستقل کنترل می‌شوند.
دو تنظیم بر خروجی ارائه‌شده در گزارش \fBDetailed\fR تأثیر می‌گذارند:
یک سطح جزئیات سراسری (مشخص‌شده با \fB--detail\fR) که کنترل نهایی و قاطع (چکش بزرگ) را در محدودسازی خروجی بخش \fBDetailed\fR دارد،
و تنظیمات جزئیات مختص هر زیربخش (چکش کوچک) که امکان محدودسازی بیشتر خروجی را برای یک زیربخش فراهم می‌کند.
هر زیربخش می‌تواند تا سطح عمق مشخصی محدود شود، و هر زیرسطح می‌تواند با حدود N مورد برتر یا مقادیر آستانه محدود گردد.
آرگومان \fIlevelspec\fR برای هر یک از محدودکننده‌های سطح ذکرشده در بالا جهت دستیابی به این هدف استفاده می‌شود.

شاید بهتر باشد توضیح محدودسازی زیرسطوح را با ساختار سلسله‌مراتبی شناخته‌شده زیر و چند مثال پایه ادامه دهیم:
.nf

    level 0
       level 1
          level 2
             level 3
                level 4
                level 4
          level 2
             level 3
                level 4
                level 4
                level 4
             level 3
                level 4
             level 3
       level 1
          level 2
             level 3
                level 4
.fi
.PP
ساده‌ترین شکل محدودسازی خروجی، تمامی خروجی‌های پایین‌تر از یک سطح مشخص را سرکوب (حذف) می‌کند.
به‌عنوان مثال، یک \fIlevelspec\fR که روی "2" تنظیم شده باشد، تنها داده‌های سطوح 0 تا 2 را نشان می‌دهد.
می‌توانید این را مانند جمع کردن هر مورد در زیرسطح 2 در نظر بگیرید، که در نتیجه تمام سطوح پایین‌تر (3، 4، ...) پنهان می‌شوند، تا ساختار زیر حاصل شود:
.nf

    level 0
       level 1
          level 2
          level 2
       level 1
          level 2
.fi
.PP
گاهی اوقات حجم خروجی در یک بخش بسیار زیاد است و سرکوب داده‌هایی که از یک مقدار آستانه مشخص فراتر نمی‌روند، مفید خواهد بود.
یک حمله اسپم فرهنگ‌لغتی (dictionary spam attack) را در نظر بگیرید که فهرست‌های بسیار طویلی از نشانی‌های ایمیل یا IP دریافت‌کننده با یک‌بار تکرار تولید می‌کند.
هر زیرسطح در این سلسله‌مراتب را می‌توان با تنظیم مناسب \fIlevelspec\fR به یک آستانه محدود کرد.
تنظیم \fIlevelspec\fR روی مقدار "2::5" هر داده‌ای را در سطح 2 که تعداد دفعات تکرار آن از 5 بیشتر نباشد، حذف می‌کند.
.PP
شاید ایجاد فهرستی از N مورد برتر، مانند 10 فرستنده برتر، مطلوب باشد.
مقدار "3:10:" برای \fIlevelspec\fR، داده‌های سطح 3 را تنها به 10 مورد با بیشترین تکرار محدود می‌کند.
.PP
پس از گذر از این مثال‌های ساده، یک \fIlevelspec\fR به‌صورت فهرستی از یک یا چند مورد زیر تعریف می‌شود که با فاصله یا ویرگول از هم جدا شده‌اند:
.IP "\fIl\fR"
حداکثر سطحی را که قرار است برای این زیربخش در خروجی نمایش داده شود، در بازه 0 تا 10 مشخص می‌کند.
اگر \fIl\fR برابر با 0 باشد، هیچ سطحی نمایش داده نمی‌شود که عملاً باعث غیرفعال شدن این زیربخش می‌گردد
(داده‌های سطح 0 پیش‌تر در گزارش Summary ارائه شده‌اند، بنابراین سطح 1 اولین سطح مفید در گزارش \fBDetailed\fR در نظر گرفته می‌شود).
مقادیر بالاتر، خروجی را تا سطح مشخص‌شده و شامل خود آن سطح تولید می‌کنند.
.IP "\fIl\fB.\fIn\fR"
مشابه مورد بالا، با این افزونه که \fIn\fR خروجی سطح 1 این بخش را به \fIn\fR مورد برتر محدود می‌کند.
مقدار \fIn\fR می‌تواند هر عدد صحیح بزرگ‌تر از 1 باشد.
(این شکل از محدودسازی کاربرد کمتری نسبت به نحو نشان‌داده‌شده در زیر دارد. این مورد برای سازگاری با نسخه‌های پیشین ارائه شده است؛ به کاربران توصیه می‌شود از نحو زیر استفاده کنند).
.IP "\fIl\fB:\fIn\fB:\fIt\fR"
این سه‌تایی سطح \fIl\fR، تعداد \fIn\fR مورد برتر و حداقل آستانه \fIt\fR را مشخص می‌کند.
هر یک از این مقادیر اعدادی صحیح هستند که در آن \fIl\fR محدودکننده سطح همان‌طور که در بالا توضیح داده شد، \fIn\fR محدودکننده \fIn\fR مورد برتر برای سطح \fIl\fR، و \fIt\fR محدودکننده آستانه برای سطح \fIl\fR است.
هنگامی که هم \fIn\fR و هم \fIt\fR مشخص شده باشند، \fIn\fR اولویت دارد که امکان ایجاد فهرست‌های \fIn\fR مورد برتر را (صرف‌نظر از مقدار آستانه) فراهم می‌کند.
اگر مقدار \fIl\fR قید نشود، مقادیر مشخص‌شده برای \fIn\fR و/یا \fIt\fR برای تمام سطوح موجود در زیربخش اعمال می‌شوند.
این امر شکل ساده‌ای از الگوهای عمومی (wildcarding) را مجاز می‌سازد (مثلاً قرار دادن محدودیت‌های حداقل آستانه روی تمام سطوح).
با این حال، محدودکننده‌های خاص همواره بر محدودکننده‌های عام ارجحیت دارند.
نخستین شکل از محدودکننده سطح می‌تواند فارغ از اینکه چه تعداد سه‌تایی وجود دارد، در \fIlevelspec\fR برای محدود کردن خروجی گنجانده شود.
.PP
هر سه شکل از محدودکننده‌ها تنها زمانی مؤثر هستند که سطح جزئیات \fBamavis-logwatch\fR برابر با 5 یا بیشتر باشد
(بخش \fBDetailed\fR تا زمانی که سطح جزئیات حداقل 5 نباشد فعال نمی‌شود).
.PP
برای سناریوهای کاربردی، بخش \fBمثال‌ها (EXAMPLES)\fR را ببینید..SH "فایل پیکربندی (CONFIGURATION FILE)"
.ad
برنامهٔ \fBAmavis-logwatch\fR می‌تواند تنظیمات پیکربندی را از یک فایل پیکربندی بخواند.
در اصل، هر گزینهٔ خط فرمان را می‌توان در یک فایل پیکربندی قرار داد، و
این تنظیمات هنگام راه‌اندازی خوانده می‌شوند.

از آن‌جا که \fBamavis-logwatch\fR می‌تواند هم به‌صورت مستقل یا درون Logwatch اجرا شود،
برای به حداقل رساندن سردرگمی، \fBamavis-logwatch\fR قواعد و نیازمندی‌های نحوی
فایل پیکربندی Logwatch را به ارث می‌برد.
این موارد عبارتند از:
.IP \(bu 4'.
خطوط خالی نادیده گرفته می‌شوند.
.IP \(bu 4'.
خطوطی که با \fB#\fR آغاز می‌شوند نادیده گرفته می‌شوند.
.IP \(bu 4'.
تنظیمات به این شکل هستند:
.nf

        \fIoption\fB = \fIvalue\fR

.fi
.IP \(bu 4'.
فاصله‌ها یا تب‌های موجود در دو طرف نویسهٔ \fB=\fR نادیده گرفته می‌شوند.
.IP \(bu 4'.
هر \fIvalue\fR محافظت‌شده در نقل‌قول جفت (دوتایی)، بزرگی و کوچکی حروف آن حفظ خواهد شد.
.IP \(bu 4'.
بقیهٔ محتوا به حروف کوچک تبدیل می‌شود (عدم حفظ حالت، غیرحساس به بزرگی و کوچکی حروف).
.IP \(bu 4'.
تمام تنظیمات پیکربندی \fBamavis-logwatch\fR باید پیشوند «\fB$amavis_\fR» داشته باشند، در غیر این صورت
\fBamavis-logwatch\fR آن‌ها را نادیده می‌گیرد.
.IP \(bu 4'.
هنگام اجرا تحت Logwatch، هر مقداری که پیشوند «\fB$amavis_\fR» نداشته باشد،
توسط Logwatch مصرف می‌شود؛ این برنامه تنها تنظیماتی را (از طریق متغیر محیطی) به \fBamavis-logwatch\fR منتقل می‌کند
که آن‌ها را معتبر بداند.
.IP \(bu 4'.
مقادیر \fBTrue\fR و \fBYes\fR به ۱، و مقادیر \fBFalse\fR و \fBNo\fR به ۰ تبدیل می‌شوند.
.IP \(bu 4'.
ترتیب تنظیمات در یک فایل پیکربندی حفظ نمی‌شود (زیرا تنظیمات توسط Logwatch از طریق
متغیرهای محیطی ارسال می‌شوند که هیچ ترتیب تعریف‌شده‌ای ندارند).
.PP
برای گنجاندن یک گزینهٔ خط فرمان در فایل پیکربندی،
پیشوند «\fB$amavis_\fR» را به نام گزینهٔ خط فرمان اضافه کنید.
تنظیمات فایل پیکربندی و گزینهٔ خط فرمان زیر معادل یکدیگرند:
.nf

        \fB$amavis_Line_Style = Truncate\fR

        \fB--line_style Truncate\fR

.fi
محدودکننده‌های سطح (Level limiters) نیز با \fB$amavis_\fR پیشوندگذاری می‌شوند، اما در خط فرمان با گزینهٔ \fB--limit\fR مشخص می‌گردند:
.nf

        \fB$amavis_SpamBlocked = 2\fR

        \fB--limit SpamBlocked=2\fR

.fi


ترتیب پردازش گزینه‌های خط فرمان و فایل پیکربندی به صورت زیر رخ می‌دهد:
1) فایل پیکربندی پیش‌فرض در صورت وجود و مشخص نشدن \fB--config_file\fR در خط فرمان، خوانده می‌شود.
2) فایل‌های پیکربندی به ترتیبی که در خط فرمان یافت می‌شوند، خوانده و پردازش می‌گردند.
3) گزینه‌های خط فرمان بر هر گزینه‌ای که از قبل چه از طریق خط فرمان و چه از هر فایل پیکربندی تنظیم شده باشد، اولویت دارند و آن را بازنویسی می‌کنند.

گزینه‌های خط فرمان هنگام مواجهه در خط فرمان تفسیر می‌شوند، و گزینه‌های بعدی گزینه‌های قبلاً تنظیم‌شده را بازنویسی خواهند کرد.


.SH "وضعیت خروج (EXIT STATUS)"
.na
.nf
.ad
.fi
ابزار \fBamavis-logwatch\fR با کد وضعیت ۰ خارج می‌شود، مگر این‌که خطایی رخ داده باشد
که در این صورت وضعیت خروج غیرصفر بازگردانده می‌شود.
.SH "مثال‌ها (EXAMPLES)"
.na
.nf
.ad
.fi.SS "اجرای مستقل (Running Standalone)"
\fBنکته:\fR \fBamavis-logwatch\fR داده‌های لاگ خود را از یک یا چند فایل لاگ مشخص‌شده Amavis یا از STDIN می‌خواند.
برای اختصار، در صورت نیاز، در مثال‌های زیر از کلمهٔ \fIfile\fR به عنوان آرگومان خط فرمان به معنای \fI/path/to/amavis.log\fR استفاده شده است.
بدیهی است که باید \fIfile\fR را با مسیر مناسب جایگزین کنید.
.nf
.PP
برای اجرای \fBamavis-logwatch\fR در حالت مستقل، کافی است دستور زیر را اجرا کنید:
.nf
.RS 4
.PP
\fBamavis-logwatch \fIfile\fR
.RE 0
.nf
.PP
فهرست کاملی از گزینه‌ها و نحوهٔ استفادهٔ مقدماتی از طریق دستور زیر در دسترس است:
.nf
.RS 4
.PP
\fBamavis-logwatch --help\fR
.RE 0
.nf
.PP
برای چاپ گزارشی که تنها شامل خلاصهٔ داده‌های لاگ Amavis باشد:
.nf
.RS 4
.PP
\fBamavis-logwatch --detail 1 \fIfile\fR
.RE 0
.fi
.PP
برای تولید یک گزارش خلاصه و یک گزارش جزئیات تک‌سطحی برای ۲۵ مه:
.nf
.RS 4
.PP
\fBgrep 'May 25' \fIfile\fB | amavis-logwatch --detail 5\fR
.RE 0
.fi
.PP
برای تولید تنها یک فهرست ۱۰تایی برتر از دامنه‌های ایمیل Sent، گزارش خلاصه و گزارش‌های تفصیلی ابتدا غیرفعال می‌شوند. از آنجا که گزینه‌های خط فرمان از چپ به راست خوانده و فعال می‌شوند، بخش Sent با یک محدودکنندهٔ ۱۰تایی برتر در سطح ۱، مجدداً در سطح ۱ فعال می‌شود:
.nf
.RS 4
.PP
\fBamavis-logwatch --nosummary --nodetail \\
   --limit spamblocked '1 1:10:' \fIfile\fR
.RE 0
.fi
.PP
دستور زیر و خروجی نمونهٔ آن، مثال پیچیده‌تری از محدودکنندهٔ سطح را نشان می‌دهد.
این دستور ۴ گیرندهٔ برتر مسدودشده به عنوان هرزنامه (سطح ۱)، و در زیر هر گیرنده ۲ آدرس IP ارسال‌کنندهٔ برتر (سطح ۲)، و سرانجام زیر آن تنها نشانی‌های envelope from (سطح ۳) با تعداد رخداد بیشتر از ۶ را ارائه می‌دهد.
علامت‌های سه‌نقطه نشان‌دهندهٔ داده‌های Nتای برتر یا محدودشده با آستانه هستند:
.nf
.RS 4
.PP
\fBamavis-logwatch --nosummary --nodetail \\
        --limit spamblocked '1:4: 2:2: 3::6' \fIfile\fR
.nf

19346   Spam blocked -----------------------------------
  756      joe@example.com
   12         10.0.0.1
   12            <>
   12         10.99.99.99
   12            <>
	     ...
  640      fred@example.com
    8         10.0.0.1
    8            <>
    8         192.168.3.19
    8            <>
	     ...
  595      peter@sample.net
    8         10.0.0.1
    8            <>
    7         192.168.3.3
    7            <>
	     ...
  547      paul@example.us
    8         192.168.3.19
    8            <>
    7         10.0.0.1
    7            <>
 	      ...
	   ...
.fi
.RE 0
.fi.SS "اجرا درون Logwatch"
\fBنکته:\fR نسخه‌های Logwatch پیش از 7.3.6، مگر اینکه طور دیگری پیکربندی شده باشند، به گزینه \fB--print\fR برای چاپ در STDOUT به‌جای ارسال گزارش‌ها از طریق ایمیل نیاز داشتند.
از نسخه 7.3.6 به بعد، STDOUT مقصد پیش‌فرض خروجی است و گزینه \fB--print\fR با \fB--output stdout\fR جایگزین شده است.
پیکربندی خود را بررسی کنید تا مشخص شود خروجی گزارش به کجا هدایت می‌شود، و گزینه مناسب را به دستورهای زیر اضافه کنید.
.PP
برای چاپ یک گزارش خلاصه از داده‌های لاگ امروز Amavis:
.nf
.RS 4
.PP
\fBlogwatch --service amavis --range today --detail 1\fR
.RE 0
.nf
.PP
برای چاپ یک گزارش از داده‌های لاگ امروز Amavis، با یک سطح
از جزئیات در بخش \fBDetailed\fR:
.nf
.RS 4
.PP
\fBlogwatch --service amavis --range today --detail 5\fR
.RE 0
.fi
.PP
برای چاپ یک گزارش برای دیروز، با دو سطح از جزئیات در بخش \fBDetailed\fR:
.nf
.RS 4
.PP
\fBlogwatch --service amavis --range yesterday --detail 6\fR
.RE 0
.fi
.PP
برای چاپ یک گزارش از ۱۲ دسامبر تا ۱۴ دسامبر، با چهار سطح از جزئیات در بخش \fBDetailed\fR:
.nf
.RS 4
.PP
\fBlogwatch --service amavis --range \\
        'between 12/12 and 12/14' --detail 8\fR
.RE 0
.PP
برای چاپ یک گزارش برای امروز، با تمام سطوح جزئیات:
.nf
.RS 4
.PP
\fBlogwatch --service amavis --range today --detail 10\fR
.RE 0
.PP
مشابه بالا، اما خطوط طولانی را بدون برش رها می‌کند:
.nf
.RS 4
.PP
\fBlogwatch --service amavis --range today --detail 11\fR
.RE 0
.SS "سطح لاگ Amavis"
.PP
هنگامی که مقدار متغیر \fB$log_level\fR فراتر از مقدار پیش‌فرض 0 افزایش یابد، Amavis اطلاعات لاگ بیشتری ارائه می‌دهد.
این اطلاعات توسط ابزار \fBamavis-logwatch\fR برای ارائه گزارش‌های اضافی استفاده می‌شود
که با مقدار پیش‌فرض \fB$log_level\fR=0 در دسترس نیستند.
مقدار 2 برای \fB$log_level\fR پیشنهاد می‌شود.
.PP
اگر ترجیح می‌دهید حجم پیام‌های زائد (noise) را در لاگ‌های اصلی ایمیل یا لاگ‌های Amavis خود افزایش ندهید،
می‌توانید syslog را به‌گونه‌ای پیکربندی کنید که خروجی Amavis را در چندین فایل لاگ ثبت کند؛
به‌طوری که ورودی‌های پایه به لاگ(های) اصلی ایمیل شما و ورودی‌های دارای جزئیات بیشتر
به یک فایل لاگ اختصاصی Amavis جهت تغذیه ابزار \fBamavis-logwatch\fR هدایت شوند.
.PP
یک راه مناسب برای انجام این کار، تغییر متغیرهای پیکربندی Amavis
در فایل \fBamavisd.conf\fR به صورت زیر است:
.nf

    amavisd.conf:
        $log_level = 2;
        $syslog_facility = 'local5';
        $syslog_priority = 'debug';

.fi
.PP
این کار \fB$log_level\fR را به 2 افزایش داده و ورودی‌های لاگ Amavis را به
یک facility جایگزین در syslog (مانند \fBlocal5\fR،‏ user) ارسال می‌کند، که سپس می‌تواند
به یک یا چند فایل لاگ، از جمله فایل لاگ اصلی ایمیل شما هدایت شود:
.nf

    syslog.conf:
        #mail.info                         -/var/log/maillog
        mail.info;local5.notice            -/var/log/maillog

        local5.info                        -/var/log/amavisd-info.log

.fi
.PP
پیام‌های معمول \fBAmavis\fR با \fB$log_level\fR برابر 0 هم به maillog و هم
به فایل \fBamavisd-info.log\fR هدایت خواهند شد، اما پیام‌های با \fB$log_level\fR بالاتر
فقط به فایل \fBamavisd-info.log\fR فرستاده می‌شوند.
برای اطلاعات بیشتر درباره لاگ‌گیری در Amavis، فایل \fBRELEASE_NOTES\fR
را در توزیع Amavis برای عبارت زیر جستجو کنید:
.nf

    "syslog priorities are now dynamically derived"

.fi.SH "محیط (ENVIRONMENT)"
.na
.nf
.ad
.fi
برنامه \fBamavis-logwatch\fR هنگام اجرا تحت Logwatch از متغیرهای محیطی زیر (که به‌طور خودکار تنظیم می‌شوند) استفاده می‌کند:
.IP \fBLOGWATCH_DETAIL_LEVEL\fR
این مقدار، سطح جزئیات مشخص‌شده با آرگومان خط فرمان \fB--detail\fR در Logwatch یا تنظیم \fBDetail\fR در فایل پیکربندی ...conf/services/amavis.conf است.
.IP \fBLOGWATCH_DEBUG\fR
این مقدار، سطح اشکال‌زدایی مشخص‌شده با آرگومان خط فرمان \fB--debug\fR در Logwatch است.
.IP \fBamavis_\fIxxx\fR
برنامه Logwatch تمام تنظیمات \fBamavis_\fIxxx\fR موجود در فایل پیکربندی ...conf/services/amavis.conf را از طریق متغیر محیطی به فیلتر \fBamavis\fR (که در واقع .../scripts/services/amavis نام دارد) ارسال می‌کند.
.SH "فایل‌ها (FILES)"
.na
.nf
.SS "حالت مستقل (Standalone mode)"
.IP "/usr/local/bin/amavis-logwatch"
برنامه \fBamavis-logwatch\fR
.IP "/usr/local/etc/amavis-logwatch.conf"
فایل پیکربندی \fBamavis-logwatch\fR در حالت مستقل
.SS "حالت Logwatch (Logwatch mode)"
.IP "/etc/logwatch/scripts/services/amavis"
فیلتر \fBamavis\fR در Logwatch
.IP "/etc/logwatch/conf/services/amavis.conf"
فایل پیکربندی فیلتر \fBamavis\fR در Logwatch
.SH "همچنین ببینید (SEE ALSO)"
.na
.nf
logwatch(8)، تحلیل‌گر و گزارش‌دهنده لاگ‌های سیستم
.SH "فایل‌های README (README FILES)"
.na
.ad
.nf
README، نمای کلی از \fBamavis-logwatch\fR
Changes، تاریخچه فهرست تغییرات نسخه
Bugs، فهرستی از باگ‌های فعلی یا سایر کاستی‌ها
Makefile، نصب‌کننده اولیه
LICENSE، شرایط مجوز استفاده و بازتوزیع
.SH "مجوز (LICENSE)"
.na
.nf
.ad
تحت پوشش مجوز گنجانده‌شدهٔ MIT/X-Consortium:
http://www.opensource.org/licenses/mit-license.php

.SH "نویسندگان (AUTHORS)"
.na
.nf
Mike Cappella

.fi
فیلتر اولیه Logwatch برای \fBamavis\fR توسط Jim O'Halloran نوشته شده و در طول سال‌ها مشارکت‌کنندگان بسیاری داشته است. از زمانی که نویسنده فعلی کد منبع را تغییر داده است، آن‌ها مطلقا هیچ مسئولیتی در قبال خطاها، مشکلات یا خرابی‌های احتمالی ندارند.