نام (NAME)

pmlogger_daily_report - تولید گزارش‌های خلاصه روزانه Performance Co-Pilot

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

$PCP_BINADM_DIR/pmlogger_daily_report [-ApV?] [-a archivefile] [-f outputfile] [-h hostname] [-l logfile] [-o directory] [-t interval]

توضیحات (DESCRIPTION)

دستور pmlogger_daily_report گزارش‌های خلاصه عملکرد روزانه را می‌نویسد، بسیار شبیه به گزارش‌هایی که توسط sadc(1) و ابزار sa2(8) تولید می‌شوند.

تمام آرگومان‌های خط فرمان اختیاری هستند و به گونه‌ای طراحی شده‌اند که خودتوضیح باشند.

به‌طور پیش‌فرض، این گزارش‌ها تولید نمی‌شوند، اما اگر بستهٔ pcp-zeroconf نصب شده باشد (فایل‌هایی در $PCP_VAR_DIR/config/pmlogconf/zeroconf) وجود خواهند داشت، معیارهای لازم در فایل پیکربندی پیش‌فرض pmlogger(1) گنجانده شده و گزارش‌ها تولید خواهند شد.

گزارش‌ها (به‌طور پیش‌فرض) اندکی پس از نیمه‌شب، پس از آن‌که pmlogger_daily(1) ادغام آرشیوهای جزئی را برای ایجاد یک آرشیو از فعالیت‌های دیروز کامل کرد، تولید می‌شوند.

نام هر گزارش خلاصه عملکرد sarXX است (که در آن XX روز ماه برای دیروز است). می‌توان outputfile را با گزینهٔ -f تغییر داد. گزارش به‌طور پیش‌فرض در دایرکتوری $PCP_LOG_DIR/sa نوشته می‌شود، اما می‌توان با استفاده از گزینهٔ -o آن را به یک directory دیگر تغییر داد.

توجه داشته باشید که گزینه‌های خط فرمان به اندازه کافی انعطاف‌پذیر هستند تا pmlogger_daily_report بتواند هر archivefile را خوانده و گزارش را در هر دایرکتوری خروجی بنویسد.

اگر گزینهٔ -a داده نشود، archivefile ورودی پیش‌فرض $PCP_ARCHIVE_DIR/HOSTNAME/YYYYMMDD است، که در آن HOSTNAME به‌طور پیش‌فرض نام میزبان محلی است (مگر اینکه با گزینهٔ -h تغییر کند) و YYYYMMDD نام پایهٔ آرشیو ادغام‌شدهٔ دیروز است، همان‌طور که توسط pmlogger(1) و pmlogger_daily(1) تولید می‌شود. اگر archivefile یک دایرکتوری باشد، pmlogger_daily_report از تمام آرشیوهای PCP یافت‌شده در آن دایرکتوری برای نوشتن گزارش استفاده خواهد کرد (این حالت به عنوان حالت چندآرشیوی شناخته می‌شود و ممکن است به طور قابل توجهی کندتر از تعیین یک آرشیو واحد به عنوان ورودی باشد).

خود گزارش‌ها توسط ابزار pmrep(1) با استفاده از فایل پیکربندی پیش‌فرض آن ایجاد می‌شوند؛ ببینید: pmrep.conf(5). مدخل‌های پیکربندی pmrep(1) که برای نوشتن گزارش‌ها استفاده می‌شوند، در حال حاضر به‌صورت تعبیه‌شده (hardwired) در اسکریپت pmlogger_daily_report قرار دارند.

در نهایت، آرشیوهای ورودی باید شامل معیارهای کافی بر اساس نیاز pmrep(1) برای نوشتن گزارش باشند. در بسترهایی که از آن پشتیبانی می‌کنند، بستهٔ pcp-zeroconf ثبت وقایع PCP را مطابق نیاز برای این منظور پیکربندی می‌کند - از این رو pmlogger_daily_report باید با پیکربندی pmlogger(1) که توسط pcp-zeroconf تنظیم شده است استفاده شود. همان‌طور که از نامش پیداست، pcp-zeroconf پس از نصب نیازی به پیکربندی اضافی برای ثبت آرشیوهای مورد نیاز pmlogger_daily_report ندارد.

گزینه‌ها (OPTIONS)

گزینه‌های موجود در خط فرمان عبارتند از:

-a archive

نام پایه یا مسیر دایرکتوری فایل archive ورودی جایگزین را مشخص می‌کند.

-A

استفاده از زمان‌های شروع و پایان آرشیو ورودی برای گزارش، برخلاف رفتار پیش‌فرض که ۲۴ ساعت از نیمه‌شب دیروز است.

-f filename

یک filename خروجی جایگزین را مشخص می‌کند. -h hostname یک hostname جایگزین را برای استفاده در مسیر پیش‌فرض فایل آرشیو ورودی مشخص می‌کند.

-l file, --logfile=file

برای اطمینان از اینکه هنگام اجرای این اسکریپت از pmlogger_daily(1) هیچ ایمیلی ناخواسته ارسال نمی‌شود، پیام‌های عیب‌یابی همواره به یک file لاگ فرستاده می‌شوند. به‌طور پیش‌فرض، این فایل $PCP_LOG_DIR/pmlogger/pmlogger_daily_report.log است، اما این مقدار را می‌توان با استفاده از گزینهٔ -l تغییر داد. اگر این فایل لاگ هنگام شروع اسکریپت از قبل وجود داشته باشد، پیش از تولید پیام‌های عیب‌یابی در فایل لاگ، پسوند .prev به نام آن افزوده و تغییر نام داده می‌شود (و هر فایل لاگی که پیش‌تر ذخیره شده باشد رونویسی خواهد شد).

-p

اگر این گزینه مشخص شود، وضعیت پردازش روزانه بررسی می‌شود و چنانچه گزارش در ۲۴ ساعت گذشته انجام نشده باشد، اکنون انجام خواهد شد. با این گزینه، در صورتی که پردازش روز قبل از قبل انجام شده باشد، pmlogger_daily_report به‌سادگی خارج می‌شود.

-t interval

بازه زمانی نمونه‌برداری (interval) مورد استفاده در هنگام تولید گزارش را در قالبی که در PCPIntro(1) توصیف شده مشخص می‌کند. پیش‌فرض هر ۱۰ دقیقه یک‌بار است.

-V, --verbose

خروجی حاصل از اجرای اسکریپت را می‌توان با استفاده از این گزینه گسترش داد که امکان ردیابی مفصل و باجزئیات فعالیت‌ها را فراهم می‌کند. به‌طور پیش‌فرض اسکریپت هیچ خروجی لاگی تولید نمی‌کند مگر اینکه با یک وضعیت خطا یا هشدار مواجه شود.

-?, --help

نمایش پیام راهنمای استفاده و خروج.

محیط PCP (PCP ENVIRONMENT)

متغیرهای محیطی با پیشوند PCP_ برای تعیین پارامترهای نام فایل‌ها و دایرکتوری‌های مورد استفاده توسط PCP به کار می‌روند. در هر نصب، فایل /etc/pcp.conf حاوی مقادیر محلی برای این متغیرها است. متغیر $PCP_CONF می‌تواند برای مشخص کردن یک فایل پیکربندی جایگزین استفاده شود، همان‌طور که در pcp.conf(5) شرح داده شده است.

همچنین ببینید (SEE ALSO)

PCPIntro(1), pmlogger_daily(1), pmlogger(1), pmrep(1), sadc(1) و sa2(8).