'\" t
.\"     Title: sarg
.\"    Author: Frédéric Marchal <fmarchal@users.sourceforge.net>
.\" Generator: DocBook XSL Stylesheets v1.78.1 <http://docbook.sf.net>
.\"      Date: 12 Nov 2015
.\"    Manual: SARG
.\"    Source: sarg
.\"  Language: English
.\"
.TH "SARG" "1" "12 Nov 2015" "sarg" "SARG"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "نام (NAME)"
sarg \- تولید‌کننده گزارش‌های تحلیل و بررسی اسکوئید (Squid)
.SH "خلاصه دستور (SYNOPSIS)"
.HP \w'\fBsarg\fR\ 'u
\fBsarg\fR [options] [logfile...]
.SH "توضیحات (DESCRIPTION)"
.PP
\fBsarg\fR
یک تجزیه‌کننده و تحلیل‌گر فایل لاگ برای
\m[blue]\fBSquid Web Proxy Cache\fR\m[]\&\s-2\u[1]\d\s+2\& است. این ابزار به شما امکان می‌دهد بررسی کنید که کاربران شما در اینترنت به «کجا» می‌روند\&.
.PP
\fBsarg\fR
گزارش‌هایی در قالب HTML با فیلدهایی از جمله کاربران، نشانی‌های IP، بایت‌ها، سایت‌ها و زمان‌ها تولید می‌کند\&. این فایل‌های HTML می‌توانند در دایرکتوری وب‌سرور شما قرار گیرند تا توسط کاربران یا مدیران سیستم مرور شوند\&. همچنین می‌توانید تنظیم کنید که
\fBsarg\fR
گزارش‌ها را برای مدیر کش اسکوئید (Squid Cache) ایمیل کند\&.
.PP
\fBsarg\fR
می‌تواند لاگ‌های دسترسی
squid
یا
Microsoft ISA
را بخواند\&. این ابزار همچنین می‌تواند گزارش‌ها را با لاگ فیلتر یا هدایت‌کننده‌های اسکوئید مانند
\m[blue]\fBsquidGuard\fR\m[]\&\s-2\u[2]\d\s+2\& تکمیل کند\&.
.SH "گزینه‌ها (OPTIONS)"
.PP
خلاصه‌ای از گزینه‌ها در زیر آمده است\&.
.PP
\fB\-h\fR \fB\-\-help\fR
.RS 4
نمایش خلاصه گزینه‌ها\&.
.RE
.PP
\fB\-a hostname|ip address\fR
.RS 4
محدود کردن گزارش به رکوردهایی که حاوی نام میزبان یا نشانی IP مشخص‌شده هستند\&.
.RE
.PP
\fB\-b \fR\fB\fIfilename\fR\fR
.RS 4
فعال‌سازی لاگ UserAgent و نوشتن آن در
\fIfilename\fR\&.
.RE
.PP
\fB\-c \fR\fB\fIfilename\fR\fR
.RS 4
خواندن
\fIfilename\fR
برای دریافت فهرستی از میزبان‌های وب که باید از گزارش مستثنی شوند\&. بخش
«فایل استثنای میزبان‌ها (HOST EXCLUSION FILE)»
را ببینید\&.
.RE
.PP
\fB\-\-convert\fR
.RS 4
تبدیل فیلد تاریخ/زمان فایل لاگ
squid
به قالبی قابل خواندن برای انسان\&. تمام فایل‌های لاگ خوانده شده و به صورت یک متن یکپارچه در خروجی استاندارد چاپ می‌شوند\&.
.RE
.PP
\fB\-\-css\fR
.RS 4
چاپ CSS داخلی که
\fBsarg\fR
درون گزارش‌ها قرار می‌دهد در خروجی استاندارد\&. می‌توانید خروجی را به فایل دلخواه هدایت کرده و آن را ویرایش کنید\&. سپس می‌توانید با استفاده از
\fIexternal_css_file\fR
در
sarg\&.conf
CSS داخلی را بازنویسی کنید\&.
.sp
استفاده از CSS خارجی می‌تواند حجم فایل گزارش را کاهش دهد\&. اگر با کمبود فضای دیسک مواجه هستید، می‌توانید برون‌ریزی CSS را طبق توضیحات بالا مد نظر قرار دهید\&.
.RE
.PP
\fB\-d \fR\fB\fIdate\fR\fR
.RS 4
استفاده از
\fIdate\fR
برای محدود کردن گزارش به بازه تاریخی مشخص در حین پردازش فایل لاگ\&. قالب
\fIdate\fR
به صورت
\fBdd/mm/yyyy\-dd/mm/yyyy\fR
یا یک تاریخ منفرد
\fBdd/mm/yyyy\fR
است\&. بازه‌های تاریخی را می‌توان به صورت
\fIday\-\fR\fI\fBn\fR\fR،
\fIweek\-\fR\fI\fBn\fR\fR یا
\fImonth\-\fR\fI\fBn\fR\fR
نیز مشخص کرد که در آن
\fBn\fR
تعداد روزها، هفته‌ها یا ماه‌ها برای بازگشت به عقب است\&. توجه داشته باشید که در اطراف خط تیره فاصله‌ای وجود ندارد\&.
.RE
.PP
\fB\-e \fR\fB\fIemail\fR\fR
.RS 4
ارسال گزارش به
\fIemail\fR
(stdout برای کنسول)\&.
.RE
.PP
\fB\-f \fR\fB\fIfilename\fR\fR
.RS 4
خواندن پیکربندی از
\fIfilename\fR\&.
.RE
.PP
\fB\-g e|u\fR
.RS 4
تنظیم قالب تاریخ در گزارش‌های تولیدشده\&.
.RS 4
e = Europe \-> dd/mm/yy
.RE
.RS 4
u = USA    \-> mm/dd/yy
.RE
.RE
.PP
\fB\-i\fR
.RS 4
تولید گزارش بر اساس کاربر و نشانی IP\&.
.if n \{\
.sp
.\}
.RS 4
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
\fBنکته\fR
.ps -1
.br
این گزینه نیازمند آن است که گزینه
\fIreport_type\fR
در فایل پیکربندی حاوی "users_sites" باشد\&.
.sp .5v
.RE
.RE
.PP
\fB\-\-keeplogs\fR
.RS 4
عدم حذف گزارش‌های قدیمی\&. این گزینه معادل تنظیم
\fB\-\-lastlog 0\fR
است، اما برای راحتی بیشتر ارائه شده است\&.
.RE
.PP
\fB\-l \fR\fB\fIfilename\fR\fR
.RS 4
استفاده از
\fIfilename\fR
به عنوان لاگ ورودی\&. این گزینه می‌تواند تا ۲۵۵ بار برای خواندن چندین فایل تکرار شود\&. اگر فایل‌ها با پسوند
\&.gz،
\&.bz2
یا
\&.Z
خاتمه یابند، از حالت فشرده خارج می‌شوند\&. اگر نام فایل فقط
\fI\-\fR
باشد، فایل لاگ از ورودی استاندارد خوانده می‌شود\&. در این حالت، فایل نمی‌تواند فشرده باشد\&.
.sp
این گزینه برای سازگاری با نسخه‌های قدیمی‌تر sarg حفظ شده است؛ اما از نسخه
sarg 2\&.3
به بعد، فایل‌های لاگ می‌توانند بدون گزینه
\fB\-l\fR
در خط فرمان مشخص شوند\&. این ویژگی امکان استفاده از کاراکترهای عام (wildcards) را در خط فرمان فراهم می‌کند\&. اطمینان حاصل کنید که از محدودیت ۲۵۵ فایل فراتر نروید\&.
.RE
.PP
\fB\-\-lastlog \fR\fB\fIn\fR\fR
.RS 4
محدود کردن تعداد لاگ‌های نگهداری‌شده در دایرکتوری خروجی به
\fIn\fR\&. هر گزارش مازاد بر این تعداد، با شروع از قدیمی‌ترین گزارش حذف می‌شود\&. مقدار
\fIn\fR
باید مثبت یا صفر باشد\&. مقدار صفر یعنی هیچ گزارشی حذف نشود\&.
.RE
.PP
\fB\-L \fR\fB\fIfilename\fR\fR
.RS 4
خواندن فایل لاگ هدایت‌کننده پراکسی مانند فایل ایجادشده توسط
squidGuard
یا
Rejik\&. اگر از این گزینه استفاده می‌کنید، ممکن است بخواهید
\fIredirector_log_format\fR
را در
sarg\&.conf
طوری تنظیم کنید که با قالب خروجی برنامه فیلتر محتوای وب شما مطابقت داشته باشد\&. این گزینه می‌تواند تا ۶۴ بار برای خواندن چندین فایل تکرار شود\&.
.RE
.PP
\fB\-n\fR
.RS 4
فعال‌سازی تفکیک نشانی‌های IP (DNS resolution)\&.
.RE
.PP
\fB\-o \fR\fB\fIdir\fR\fR
.RS 4
نوشتن گزارش در
\fIdir\fR\&.
.RE
.PP
\fB\-p\fR
.RS 4
تولید گزارش با استفاده از نشانی IP به جای userid\&.
.RE
.PP
\fB\-P \fR\fB\fIprefix\fR\fR \fB\-\-splitprefix \fR\fB\fIprefix\fR\fR
.RS 4
این گزینه باید همراه با
\fB\-\-split\fR
استفاده شود\&. در صورت ارائه، لاگ ورودی میان چندین فایل که هر کدام شامل یک روز است تقسیم می‌شود\&. نام فایل‌های خروجی از
\fIprefix\fR
و تاریخ با قالب
\-YYYY\-MM\-DD
ساخته می‌شود\&.
.sp
فایل‌های خروجی در دایرکتوری خروجی مشخص‌شده با
\fB\-o\fR
یا در دایرکتوری جاری نوشته می‌شوند\&.
.RE
.PP
\fB\-r\fR
.RS 4
چاپ گزارش بی‌درنگ (realtime) در خروجی استاندارد و خروج\&.
.RE
.PP
\fB\-s \fR\fB\fIstring\fR\fR
.RS 4
محدود کردن گزارش به سایت مشخص‌شده توسط
\fIstring\fR
[مثلاً www\&.debian\&.org]\&.
.RE
.PP
\fB\-\-split\fR
.RS 4
تقسیم فایل لاگ squid و چاپ متنی آن در خروجی استاندارد با حذف تاریخ‌های خارج از بازه مشخص‌شده توسط پارامتر
\fB\-d\fR\&.
در صورت ترکیب با
\fB\-\-convert\fR
تاریخ‌ها نیز به قالبی قابل خواندن برای انسان تبدیل می‌شوند\&.
.sp
در ترکیب با
\fB\-P\fR،
لاگ در چندین فایل ذخیره می‌شود که هر کدام حاوی یک روز از لاگ اصلی است\&.
.RE
.PP
\fB\-\-statistics\fR
.RS 4
نوشتن آمارهایی درباره زمان اجرا\&. این آمار شامل کل زمان اجرا، تعداد رکوردهای خوانده‌شده از فایل‌های لاگ ورودی و زمان صرف‌شده برای خواندن آن‌ها، تعداد رکوردها و کاربران پردازش‌شده و زمان صرف‌شده برای پردازش آن‌ها است\&.
.RE
.PP
\fB\-t \fR\fB\fIstring\fR\fR
.RS 4
محدود کردن رکوردهای موجود در گزارش بر اساس زمان روز\&. قالب
\fIstring\fR
به صورت
\fBHH:MM\fR
یا
\fBHH:MM\-HH:MM\fR
است\&. حالت اول فقط زمان خواسته‌شده را گزارش می‌کند\&. حالت دوم هر ورودی قرارگرفته در بازه درخواستی را گزارش می‌دهد\&. این محدودیت مکمل محدودیت اعمال‌شده توسط گزینه
\fB\-d\fR
است\&.
.RE
.PP
\fB\-u \fR\fB\fIuser\fR\fR
.RS 4
محدود کردن گزارش‌ها به فعالیت‌های
\fIuser\fR\&.
.RE
.PP
\fB\-v\fR
.RS 4
چاپ نسخه sarg و خروج\&.
.RE
.PP
\fB\-w \fR\fB\fIdir\fR\fR
.RS 4
ذخیره فایل‌های موقت در
\fIdir\fR\&.
در واقع،
\fBsarg\fR
فایل‌های موقت خود را در زیردایرکتوری
sarg
از مسیر
\fIdir\fR
ذخیره می‌کند\&. حتماً دایرکتوری خروجی HTML را در مکانی خارج از دایرکتوری موقت تنظیم کنید؛ در غیر این صورت ممکن است sarg با خطا مواجه شود یا پس از تکمیل وظیفه خود، گزارش را حذف کند\&.
.RE
.PP
\fB\-x\fR
.RS 4
نوشتن پیام‌های اشکال‌زدایی در
stdout
.RE
.PP
\fB\-z\fR
.RS 4
نوشتن پیام‌های فرآیند در
stdout\&.
.RE
.SH "فایل استثنای میزبان‌ها (HOST EXCLUSION FILE)"
.PP
می‌توان به Sarg اعلام کرد که میزبان‌های بازدیدشده را با ارائه فایلی که در هر خط شامل یک میزبان برای استثنا کردن است، از گزارش حذف کند\&. «میزبان» ممکن است یکی از موارد زیر باشد:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
یک نام میزبان کامل،
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
یک نام میزبان که با کاراکتر عام (*) شروع می‌شود تا با هر پیشوندی مطابقت داشته باشد،
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
یک نشانی IP منفرد،
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
یک زیرشبکه با قالب a\&.b\&.c\&.d/e\&.
.RE
.PP
\fBمثال\ \&1.\ \&نمونه‌ای از یک فایل استثنای میزبان‌ها\fR
.RS 4
*\&.google\&.com
.RE
.RS 4
10\&.0\&.0\&.0/8
.RE
.PP
Sarg در حال حاضر نمی‌تواند نشانی‌های IPv6 را مستثنی کند\&.
.SH "همچنین ببینید (SEE ALSO)"
.PP
squid(8)
.SH "نویسندگان (AUTHORS)"
.PP
این صفحه راهنما توسط
Luigi Gangitano<gangitano@lugroma3\&.org>، برای سیستم
Debian GNU/Linux
نوشته شده است (اما ممکن است توسط دیگران نیز استفاده شود)\&. بازبینی توسط
Billy Newsom\&.
.PP
در حال حاضر توسط
Frédéric Marchal<fmarchal@users\&.sourceforge\&.net>
نگهداری می‌شود\&.
.SH "نویسندگان (AUTHORS)"
.PP
\fBFrédéric Marchal\fR <\&fmarchal@users\&.sourceforge\&.net\&>
.RS 4
نسخه Docbook صفحه راهنما
.RE
.PP
\fBBilly Newsom\fR
.RS 4
بازبینی صفحه راهنما
.RE
.PP
\fBLuigi Gangitano\fR <\&gangitano@lugroma3\&.org\&>
.RS 4
نویسنده اولین نسخه صفحه راهنما
.RE
.SH "حق نشر (COPYRIGHT)"
.br
Copyright \(co 2012 Frédéric Marchal
.br
.SH "نکات (NOTES)"
.IP " 1." 4
Squid Web Proxy Cache
.RS 4
\%http://www.squid-cache.org
.RE
.IP " 2." 4
squidGuard
.RS 4
\%http://www.squidguard.org
.RE