.TH LOGCONV.PY 1 "22 ژانویه 2025"
.SH "نام (NAME)"
logconv.py \- تحلیل و استخراج آمار از لاگ‌های دسترسی سرور دایرکتوری 389

.SH "خلاصه دستور (SYNOPSIS)"
.B logconv.py
[\fI\-h\fR] [\fI\-v\fR] [\fI\-V\fR] [\fI\-s SIZE_LIMIT\fR] [\fI\-d ROOT_DN\fR] [\fI\-B BIND_DN\fR]
[\fI\-X EXCLUDE_IP\fR] [\fI\-S START_TIME\fR] [\fI\-E END_TIME\fR]
[\fI\-m SEC_STATS_FILENAME\fR] [\fI\-M MIN_STATS_FILENAME\fR] [\fI access log(s)\fR]
.PP

.SH "توضیحات (DESCRIPTION)"
تحلیل فایل‌های لاگ دسترسی سرور دایرکتوری (Directory Server) برای اطلاعات خاصی که در خط فرمان مشخص شده است.

.SH "گزینه‌ها (OPTIONS)"
.TP
.B \fB\-h, \-\-help\fR
راهنما و نحوه استفاده.
.TP
.B \fB\-v, \-\-version\fR
نمایش نسخه تحلیل‌گر لاگ.
.TP
.B \fB\-V, \-\-verbose\fR
فعال‌سازی حالت پرحرف (verbose) برای پردازش دقیق‌تر آمارها.
.TP
.B \fB\-s, \-\-sizeLimit\fR SIZE_LIMIT
تعداد نتایج بازگردانده‌شده در هر دسته‌بندی.
.br
پیش‌فرض: 20
.TP
.B \fB\-d, \-\-rootDN\fR ROOT_DN
شناسه متمایز (DN) مدیران دایرکتوری.
.br
پیش‌فرض: "cn=Directory Manager"
.TP
.B \fB\-B, \-\-bind\fR BIND_DN
تولید گزارش فعالیت بر اساس Bind DN مشخص‌شده.
.br
گزینه‌ها: <ALL | ANONYMOUS | "Actual bind DN">
.TP
.B \fB\-X, \-\-excludeIP\fR EXCLUDE_IP
آدرس IP برای مستثنی کردن از تحلیل؛ می‌تواند برای نادیده گرفتن متعادل‌کننده‌های بار (Load Balancers) استفاده شود.
.br
برای مشخص کردن چندین آدرس IP می‌توانید استفاده کنید: \-X 192.168.1.1 \-X 10.1.2.1
.TP
.B \fB\-S, \-\-startTime\fR START_TIME
زمان شروع تحلیل فایل لاگ.
.br
یک برچسب زمانی (timestamp) را از لاگ‌های دسترسی کپی و جای‌گذاری کنید:
.br
"[04/Jun/2024:10:31:20.014629085 +0200]"
.br
       یا
.br
استفاده از قالب متداول لاگ:
.br
"[04/Jun/2024:10:31:20 +0200]"
.TP
.B \fB\-E, \-\-endTime\fR END_TIME
زمان توقف تحلیل فایل لاگ.
.br
یک برچسب زمانی را از لاگ‌های دسترسی کپی و جای‌گذاری کنید:
.br
"[04/Jun/2024:11:30:05.435779416 +0200]"
.br
       یا
.br
استفاده از قالب متداول لاگ:
.br
"[04/Jun/2024:11:30:05 +0200]"
.TP
.B \fB\-m, \-\-reportFileSecs\fR SEC_STATS_FILENAME
ثبت آمار عملیات در بازه‌های ثانیه‌ای و نوشتن در فایل csv.
.TP
.B \fB\-M, \-\-reportFileMins\fR MIN_STATS_FILENAME
ثبت آمار عملیات در بازه‌های دقیقه‌ای و نوشتن در فایل csv.
.TP
.B \fB\-j, \-\-recommends\fR
ارائه برخی توصیه‌های عملکردی پس از پایان تحلیل.

.SH "کاربرد (USAGE)"
مثال‌ها:
.IP
تحلیل لاگ‌ها در حالت پرحرف (verbose)
.br
logconv.py \fB\-V\fR /var/log/dirsrv/slapd-host/access*
.IP
محدود کردن نتایج به ۱۰ مورد در هر دسته‌بندی
.br
logconv.py \-\-sizeLimit 10 /var/log/dirsrv/slapd-host/access*
.IP
مشخص کردن یک root DN سفارشی
.br
logconv.py \fB\-\-rootDN\fR "cn=custom manager" /var/log/dirsrv/slapd-host/access*
.IP
تولید گزارش برای bindهای ناشناس (anonymous)
.br
logconv.py \fB\-B\fR ANONYMOUS /var/log/dirsrv/slapd-host/access*
.IP
مستثنی کردن آدرس(های) IP خاص از تحلیل لاگ
.br
logconv.py \fB\-X\fR 192.168.1.1 \fB\-\-exclude_ip\fR 11.22.33.44 /var/log/dirsrv/slapd-host/access*
.IP
تحلیل لاگ‌ها در یک بازه زمانی مشخص
.br
logconv.py \fB\-S\fR "[04/Jun/2024:10:31:20.014629085 +0200]" \fB\-\-endTime\fR "[04/Jun/2024:11:30:05 +0200]" /var/log/dirsrv/slapd-host/access*
.IP
تولید آمار عملکرد در بازه‌های ثانیه‌ای
.br
logconv.py \fB\-m\fR log-second-stats.csv /var/log/dirsrv/slapd-host/access*
.IP
تولید آمار عملکرد در بازه‌های دقیقه‌ای
.br
logconv.py \fB\-M\fR log-minute-stats.csv  /var/log/dirsrv/slapd-host/access*
.IP
نمایش توصیه‌ها پس از تحلیل لاگ
.br
logconv.py \fB\-j\fR /var/log/dirsrv/slapd-host/access*

.SH "نویسندگان (AUTHORS)"
برنامه logconv.py توسط پروژه 389 نوشته شده است.
.SH "گزارش باگ‌ها (REPORTING BUGS)"
گزارش باگ‌ها به https://github.com/389ds/389-ds-base/issues/new
.SH "حق نشر (COPYRIGHT)"
حق نشر \(co 2001 متعلق به Sun Microsystems, Inc. با کسب اجازه استفاده شده است.
.br
حق نشر \(co 2025 متعلق به Red Hat, Inc.
.br
این صفحه راهنما توسط Michele Baldessari <michele@pupazzo.org> برای پروژه دبیان نوشته شده است (اما ممکن است توسط دیگران نیز استفاده شود).
.br
این یک نرم‌افزار آزاد است. شما می‌توانید نسخه‌های آن را تحت شرایط مجوز سرور دایرکتوری موجود در پرونده LICENSE این توزیع نرم‌افزاری بازتوزیع کنید. این مجوز اساساً مجوز عمومی همگانی گنو نسخه ۲ (GNU General Public License version 2) به همراه یک استثنا برای توزیع افزونه‌ها (plug-in) است.