'\"macro stdmacro
.\"
.\" Copyright (c) 2018-2019 Red Hat.
.\"
.\" This program is free software; you can redistribute it and/or modify it
.\" under the terms of the GNU General Public License as published by the
.\" Free Software Foundation; either version 2 of the License, or (at your
.\" option) any later version.
.\"
.\" This program is distributed in the hope that it will be useful, but
.\" WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
.\" or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
.\" for more details.
.\"
.TH PMLOGGER_DAILY_REPORT 1 "PCP" "Performance Co-Pilot"
.SH "نام (NAME)"
\f3pmlogger_daily_report\f1 \- تولید گزارش‌های خلاصه روزانه Performance Co-Pilot
.SH "خلاصه دستور (SYNOPSIS)"
.B $PCP_BINADM_DIR/pmlogger_daily_report
[\f3\-ApV?\f1]
[\f3\-a\f1 \f2archivefile\f1]
[\f3\-f\f1 \f2outputfile\f1]
[\f3\-h\f1 \f2hostname\f1]
[\f3\-l\f1 \f2logfile\f1]
[\f3\-o\f1 \f2directory\f1]
[\f3\-t\f1 \f2interval\f1]
.SH "توضیحات (DESCRIPTION)"
دستور
.B pmlogger_daily_report
گزارش‌های خلاصه عملکرد روزانه را می‌نویسد، بسیار شبیه به گزارش‌هایی که توسط
.BR sadc (1)
و ابزار
.BR sa2 (8)
تولید می‌شوند.
.PP
تمام آرگومان‌های خط فرمان اختیاری هستند و به گونه‌ای طراحی شده‌اند که خودتوضیح باشند.
.PP
به‌طور پیش‌فرض، این گزارش‌ها تولید نمی‌شوند، اما اگر بستهٔ
.I pcp-zeroconf
نصب شده باشد (فایل‌هایی در
.BR $PCP_VAR_DIR/config/pmlogconf/zeroconf )
وجود خواهند داشت، معیارهای لازم در فایل پیکربندی پیش‌فرض
.BR pmlogger (1)
گنجانده شده و گزارش‌ها تولید خواهند شد.
.PP
گزارش‌ها (به‌طور پیش‌فرض) اندکی پس از نیمه‌شب، پس از آن‌که
.BR pmlogger_daily (1)
ادغام آرشیوهای جزئی را برای ایجاد یک آرشیو از فعالیت‌های دیروز کامل کرد، تولید می‌شوند.
.PP
نام هر گزارش خلاصه عملکرد
.BI sar XX
است (که در آن
.I XX
روز ماه برای دیروز است).
می‌توان
.I outputfile
را با گزینهٔ
.B \-f
تغییر داد.
گزارش به‌طور پیش‌فرض در دایرکتوری
.I $PCP_LOG_DIR/sa
نوشته می‌شود، اما می‌توان با استفاده از گزینهٔ
.B \-o
آن را به یک
.IR directory
دیگر تغییر داد.
.PP
توجه داشته باشید که گزینه‌های خط فرمان به اندازه کافی انعطاف‌پذیر هستند تا
.B pmlogger_daily_report
بتواند هر
.I archivefile
را خوانده و گزارش را در هر دایرکتوری خروجی بنویسد.
.PP
اگر گزینهٔ
.B \-a
داده نشود،
.I archivefile
ورودی پیش‌فرض
.IR $PCP_ARCHIVE_DIR/HOSTNAME/YYYYMMDD
است، که در آن
.I HOSTNAME
به‌طور پیش‌فرض نام میزبان محلی است (مگر اینکه با گزینهٔ
.B \-h
تغییر کند) و
.I YYYYMMDD
نام پایهٔ آرشیو ادغام‌شدهٔ دیروز است، همان‌طور که توسط
.BR pmlogger (1)
و
.BR pmlogger_daily (1)
تولید می‌شود.
اگر
.I archivefile
یک دایرکتوری باشد،
.B pmlogger_daily_report
از تمام آرشیوهای PCP یافت‌شده در آن دایرکتوری برای نوشتن گزارش استفاده خواهد کرد (این حالت به عنوان حالت چندآرشیوی شناخته می‌شود و ممکن است به طور قابل توجهی کندتر از تعیین یک آرشیو واحد به عنوان ورودی باشد).
.PP
خود گزارش‌ها توسط ابزار
.BR pmrep (1)
با استفاده از فایل پیکربندی پیش‌فرض آن ایجاد می‌شوند؛ ببینید:
.BR pmrep.conf (5).
مدخل‌های پیکربندی
.BR pmrep (1)
که برای نوشتن گزارش‌ها استفاده می‌شوند، در حال حاضر به‌صورت تعبیه‌شده (hardwired) در اسکریپت
.B pmlogger_daily_report
قرار دارند.
.PP
در نهایت، آرشیوهای ورودی باید شامل معیارهای کافی بر اساس نیاز
.BR pmrep (1)
برای نوشتن گزارش باشند.
در بسترهایی که از آن پشتیبانی می‌کنند، بستهٔ
.I pcp-zeroconf
ثبت وقایع PCP را مطابق نیاز برای این منظور پیکربندی می‌کند \- از این رو
.B pmlogger_daily_report
باید با پیکربندی
.BR pmlogger (1)
که توسط
.BR pcp-zeroconf
تنظیم شده است استفاده شود.
همان‌طور که از نامش پیداست،
.BR pcp-zeroconf
پس از نصب نیازی به پیکربندی اضافی برای ثبت آرشیوهای مورد نیاز
.BR pmlogger_daily_report
ندارد.
.SH "گزینه‌ها (OPTIONS)"
گزینه‌های موجود در خط فرمان عبارتند از:
.TP 5
\fB\-a\fR \fIarchive\fR
نام پایه یا مسیر دایرکتوری فایل
.I archive
ورودی جایگزین را مشخص می‌کند.
.TP
\fB\-A\fR
استفاده از زمان‌های شروع و پایان آرشیو ورودی برای گزارش، برخلاف رفتار پیش‌فرض که ۲۴ ساعت از نیمه‌شب دیروز است.
.TP
\fB\-f\fR \fIfilename\fR
یک
.IR filename
خروجی جایگزین را مشخص می‌کند.
\fB\-h\fR \fIhostname\fR
یک
.I hostname
جایگزین را برای استفاده در مسیر پیش‌فرض فایل آرشیو ورودی مشخص می‌کند.
.TP
\fB\-l\fR \fIfile\fR, \fB\-\-logfile\fR=\fIfile\fR
برای اطمینان از اینکه هنگام اجرای این اسکریپت از
.BR pmlogger_daily (1)
هیچ ایمیلی ناخواسته ارسال نمی‌شود، پیام‌های عیب‌یابی همواره به یک
.IR file
لاگ فرستاده می‌شوند.
به‌طور پیش‌فرض، این فایل
.I $PCP_LOG_DIR/pmlogger/pmlogger_daily_report.log
است، اما این مقدار را می‌توان با استفاده از گزینهٔ
.B \-l
تغییر داد.
اگر این فایل لاگ هنگام شروع اسکریپت از قبل وجود داشته باشد، پیش از تولید پیام‌های عیب‌یابی در فایل لاگ، پسوند
.I .prev
به نام آن افزوده و تغییر نام داده می‌شود (و هر فایل لاگی که پیش‌تر ذخیره شده باشد رونویسی خواهد شد).
.TP
\fB\-p\fR
اگر این گزینه مشخص شود، وضعیت پردازش روزانه بررسی می‌شود و چنانچه گزارش در ۲۴ ساعت گذشته انجام نشده باشد، اکنون انجام خواهد شد.
با این گزینه، در صورتی که پردازش روز قبل از قبل انجام شده باشد،
.B pmlogger_daily_report
به‌سادگی خارج می‌شود.
.RS
.PP
این گزینه دیگر مورد نیاز نیست چرا که بررسی دوره‌ای
.BR pmlogger_daily (1)
از تولید گزارش اطمینان حاصل خواهد کرد، با این حال این گزینه برای سازگاری با گذشته حفظ شده است.
.RE
.TP
\fB\-t\fR \fIinterval\fR
بازه زمانی نمونه‌برداری
.RI ( interval )
مورد استفاده در هنگام تولید گزارش را در قالبی که در
.BR PCPIntro (1)
توصیف شده مشخص می‌کند.
پیش‌فرض هر ۱۰ دقیقه یک‌بار است.
.TP
\fB\-V\fR, \fB\-\-verbose\fR
خروجی حاصل از اجرای اسکریپت را می‌توان با استفاده از این گزینه گسترش داد که امکان ردیابی مفصل و باجزئیات فعالیت‌ها را فراهم می‌کند.
به‌طور پیش‌فرض اسکریپت هیچ خروجی لاگی تولید نمی‌کند مگر اینکه با یک وضعیت خطا یا هشدار مواجه شود.
.TP
\fB\-?\fR, \fB\-\-help\fR
نمایش پیام راهنمای استفاده و خروج.
.SH "محیط PCP (PCP ENVIRONMENT)"
متغیرهای محیطی با پیشوند \fBPCP_\fP برای تعیین پارامترهای نام فایل‌ها و دایرکتوری‌های مورد استفاده توسط PCP به کار می‌روند.
در هر نصب، فایل \fI/etc/pcp.conf\fP حاوی مقادیر محلی برای این متغیرها است.
متغیر \fB$PCP_CONF\fP می‌تواند برای مشخص کردن یک فایل پیکربندی جایگزین استفاده شود، همان‌طور که در \fBpcp.conf\fP(5) شرح داده شده است.
.SH "همچنین ببینید (SEE ALSO)"
.BR PCPIntro (1),
.BR pmlogger_daily (1),
.BR pmlogger (1),
.BR pmrep (1),
.BR sadc (1)
و
.BR sa2 (8).

.\" control lines for scripts/man-spell
.\" +ok+ YYYYMMDD prev {from .prev suffix} sa sadc zeroconf