نام (NAME)

pmdaapache - کارگزار دامنه معیارهای کارایی (PMDA) برای وب‌سرور Apache2

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

$PCP_PMDAS_DIR/apache/pmdaapache [-D debug] [-d domain] [-l logfile] [-U username] [-S server] [-P port] [-L location]

توضیحات (DESCRIPTION)

pmdaapache یک کارگزار دامنه معیارهای کارایی (PMDA) است که معیارهای کارایی توصیف‌کننده وضعیت وب‌سرور Apache را استخراج می‌کند.

کارگزار apache معیارهایی را صادر می‌کند که نرخ درخواست‌ها، اندازه تجمعی درخواست‌ها، مدت‌زمان بالا بودن سرور (uptime) و وضعیت‌های مختلف اتصال را برای کلاینت‌های فعال اندازه‌گیری می‌کنند.

این اطلاعات با ارسال یک درخواست HTTP به آدرس اینترنتی (URL) وضعیت سرور به دست می‌آید که باید در فایل پیکربندی httpd.conf فعال شده باشد.

ExtendedStatus on
<Location /server-status>
SetHandler server-status
Order deny,allow
Deny from all
Allow from localhost
</Location>

شرح کوتاهی از گزینه‌های خط فرمان pmdaapache در ادامه آمده است:

-d: بسیار حیاتی است که شماره domain (دامنه) معیارهای کارایی که در اینجا مشخص می‌شود، یکتا و سازگار باشد؛ بدین معنا که domain باید برای هر PMDA در یک میزبان متفاوت باشد، و همان شماره domain باید برای همان PMDA در تمام میزبان‌ها استفاده شود.
-l: مکان فایل ثبت وقایع (لاگ). به‌طور پیش‌فرض، هنگام راه‌اندازی pmdaapache، فایل لاگی به نام apache.log در دایرکتوری جاری pmcd(1) نوشته می‌شود، یعنی $PCP_LOG_DIR/pmcd. اگر فایل لاگ ایجاد نشود یا قابل نوشتن نباشد، خروجی در خطای استاندارد نوشته خواهد شد.
-S: پرس‌وجوی اطلاعات وضعیت Apache از server نام‌برده به‌جای میزبان محلی.
-P: پرس‌وجوی اطلاعات وضعیت Apache از port مشخص‌شده به‌جای درگاه پیش‌فرض (80).
-L: مشخص کردن یک location (مکان) جایگزین برای یافتن صفحه server-status.
-U: حساب کاربری که کارگزار تحت آن اجرا می‌شود. پیش‌فرض در نگارش‌های فعلی PCP، حساب غیرممتاز "pcp" است، اما در نگارش‌های قدیمی‌تر حساب کاربر ریشه ("root") به‌طور پیش‌فرض استفاده می‌شد.

نصب (INSTALLATION)

اگر می‌خواهید به نام‌ها، متن راهنما و مقادیر معیارهای کارایی apache دسترسی داشته باشید، دستورهای زیر را با کاربر ریشه (root) انجام دهید:

# cd $PCP_PMDAS_DIR/apache
# ./Install

اگر می‌خواهید نصب را لغو کنید، دستورهای زیر را با کاربر ریشه (root) انجام دهید:

# cd $PCP_PMDAS_DIR/apache
# ./Remove

pmdaapache توسط pmcd(1) راه‌اندازی می‌شود و هرگز نباید به‌طور مستقیم اجرا گردد. اسکریپت‌های Install و Remove به pmcd(1) هنگام نصب یا حذف کارگزار اطلاع می‌دهند.

فایل‌ها (FILES)

$PCP_PMCDCONF_PATH: گزینه‌های خط فرمان مورد استفاده برای راه‌اندازی pmdaapache
$PCP_PMDAS_DIR/apache/help: فایل متن راهنمای پیش‌فرض برای معیارهای apache
$PCP_PMDAS_DIR/apache/Install: اسکریپت نصب برای کارگزار pmdaapache
$PCP_PMDAS_DIR/apache/Remove: اسکریپت لغو نصب برای کارگزار pmdaapache
$PCP_LOG_DIR/pmcd/apache.log: فایل لاگ پیش‌فرض برای پیام‌های خطا و سایر اطلاعات از pmdaapache

محیط PCP (PCP ENVIRONMENT)

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

گزینه‌های اشکال‌زدایی (DEBUGGING OPTIONS)

گزینه -D یا --debug خروجی پیام‌های تشخیصی اضافی را در stderr فعال می‌کند تا به عیب‌یابی و بررسی مشکلات کمک کند، اگرچه اطلاعات گاهی پیچیده بوده و اساساً برای راهنمایی توسعه‌دهندگان در نظر گرفته شده است تا کاربران نهایی. debug فهرستی از گزینه‌های اشکال‌زدایی است که با کاما از هم جدا شده‌اند؛ از pmdbg(1) همراه با گزینه -l برای به‌دست آوردن فهرستی از گزینه‌های اشکال‌زدایی موجود و معانی آن‌ها استفاده کنید.

گزینه‌های اشکال‌زدایی مختص به pmdaapache به شرح زیر است:

گزینه	توضیحات
appl0	ردیابی هر فراخوانی refreshData()
appl1	گزارش اشکالات شناسایی‌شده در refreshData()
appl2	تخلیه داده‌های داخلی پس از هر فراخوانی refreshData()

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

PCPIntro(1)، httpd(8)، pmcd(1)، pcp.conf(5) و pcp.env(5).