نام (NAME)

logconv.py - تحلیل و استخراج آمار از لاگ‌های دسترسی سرور دایرکتوری 389

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

logconv.py [-h] [-v] [-V] [-s SIZE_LIMIT] [-d ROOT_DN] [-B BIND_DN] [-X EXCLUDE_IP] [-S START_TIME] [-E END_TIME] [-m SEC_STATS_FILENAME] [-M MIN_STATS_FILENAME] [ access log(s)]

توضیحات (DESCRIPTION)

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

گزینه‌ها (OPTIONS)

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

کاربرد (USAGE)

مثال‌ها:

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

نویسندگان (AUTHORS)

برنامه logconv.py توسط پروژه 389 نوشته شده است.

گزارش باگ‌ها (REPORTING BUGS)

گزارش باگ‌ها به https://github.com/389ds/389-ds-base/issues/new

حق نشر (COPYRIGHT)

حق نشر © 2001 متعلق به Sun Microsystems, Inc. با کسب اجازه استفاده شده است.
حق نشر © 2025 متعلق به Red Hat, Inc.
این صفحه راهنما توسط Michele Baldessari <michele@pupazzo.org> برای پروژه دبیان نوشته شده است (اما ممکن است توسط دیگران نیز استفاده شود).
این یک نرم‌افزار آزاد است. شما می‌توانید نسخه‌های آن را تحت شرایط مجوز سرور دایرکتوری موجود در پرونده LICENSE این توزیع نرم‌افزاری بازتوزیع کنید. این مجوز اساساً مجوز عمومی همگانی گنو نسخه ۲ (GNU General Public License version 2) به همراه یک استثنا برای توزیع افزونه‌ها (plug-in) است.