'\" t
.\"
.\" Copyright (c) 2017 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.
.\"
.\"
.ds ia docker
.ds IA DOCKER
.ds Ia Docker
.TH PMDADOCKER 1 "PCP" "Performance Co-Pilot"
.SH "نام (NAME)"
\f3pmdadocker\f1 \- عامل دامنه معیارهای عملکرد (PMDA) داکر (\*(ia)
.SH "خلاصه دستور (SYNOPSIS)"
\f3$PCP_PMDAS_DIR/\*(ia/pmda\*(ia\f1
[\f3\-D\f1 \f2debug\f1]
[\f3\-d\f1 \f2domain\f1]
[\f3\-l\f1 \f2logfile\f1]
.SH "توضیحات (DESCRIPTION)"
.B pmda\*(ia
یک عامل دامنه معیارهای عملکرد (PMDA) برای \*(ia است که
معیارهای عملکرد گزارش‌شده از Docker Remote API را ارائه می‌دهد.
.PP
توضیح مختصری از گزینه‌های خط فرمان
.B pmda\*(ia
در ادامه آمده است:
.TP 5
.B \-d
بسیار حیاتی است که شماره
.I domain
معیارهای عملکرد مشخص‌شده در اینجا یکتا و سازگار باشد.
به این معنی که
.I domain
باید برای هر PMDA روی یک میزبان متفاوت باشد، و همان شماره
.I domain
باید برای همان PMDA روی تمام میزبان‌ها استفاده شود.
.TP
.B \-l
محل فایل گزارش (log). به‌طور پیش‌فرض، یک فایل گزارش با نام
.I \*(ia.log
در دایرکتوری جاری
.BR pmcd (1)
هنگام شروع
.B pmda\*(ia
نوشته می‌شود، یعنی
.BR $PCP_LOG_DIR/pmcd .
اگر فایل گزارش نتواند ایجاد شود یا قابل نوشتن نباشد، خروجی به‌جای آن به خطای استاندارد (stderr) ارسال می‌شود.
.P
درخواست‌های معیارهای Remote API به‌طور خودکار فعال شده و بر اساس یک زمان‌سنج (timer) واکشی می‌شوند.
این زمان‌سنج توسط
.B pmda\*(ia
از طریق
.B docker.control.timing
نمایش داده می‌شود.
به‌طور پیش‌فرض،
.B pmda\*(ia
روی بازه زمانی ۱ ثانیه برای واکشی تنظیم شده است.
.PP
برنامه
.B pmda\*(ia
روی سه فراخوانی مختلف API راه دور
.B \*(ia
پیمایش خواهد کرد:
.TP
.B /containers/$ID/json
معیارهای کانتینر مربوط به وضعیت جاری کانتینر، مانند PID، نام، یا در حال اجرا بودن کانتینر.
.TP
.B /version
معیارهای پایه نسخه در مورد دیمن داکر در حال استفاده.
.TP
.B /containers/$ID/stats?stream=0
معیارهای دقیق‌تر حافظه و پردازنده کانتینر.
.SH "نصب (INSTALLATION)"
اگر می‌خواهید به نام‌ها، متن راهنما و مقادیر معیارهای عملکرد \*(ia دسترسی داشته باشید،
دستورات زیر را با دسترسی root اجرا کنید:
.PP
.ft CR
.nf
.in +0.5i
# cd $PCP_PMDAS_DIR/\*(ia
# ./Install
.in
.fi
.ft 1
.PP
اگر می‌خواهید نصب را لغو کنید (و هر دو PMDA را حذف کنید)،
دستورات زیر را با دسترسی root اجرا کنید:
.PP
.ft CR
.nf
.in +0.5i
# cd $PCP_PMDAS_DIR/\*(ia
# ./Remove
.in
.fi
.ft 1
.PP
عامل
.B pmda\*(ia
توسط
.BR pmcd (1)
راه‌اندازی می‌شود و هرگز نباید مستقیماً اجرا شود.
اسکریپت‌های Install و Remove هنگام نصب یا حذف عامل به
.BR pmcd (1)
اطلاع‌رسانی می‌کنند.
.SH "فایل‌ها (FILES)"
.PD 0
.TP 10
.B $PCP_PMCDCONF_PATH
گزینه‌های خط فرمان مورد استفاده برای راه‌اندازی
.B pmda\*(ia
.TP 10
.B $PCP_PMDAS_DIR/\*(ia/help
فایل متنی راهنمای پیش‌فرض برای معیارهای \*(ia
.TP 10
.B $PCP_PMDAS_DIR/\*(ia/Install
اسکریپت نصب برای عامل
.B pmda\*(ia
.TP 10
.B $PCP_PMDAS_DIR/\*(ia/Remove
اسکریپت لغو نصب برای عامل
.B pmda\*(ia
.TP 10
.B $PCP_LOG_DIR/pmcd/docker.log
فایل گزارش پیش‌فرض برای پیام‌های خطا و سایر اطلاعات از
.B pmda\*(ia
.PD
.SH "محیط PCP (PCP ENVIRONMENT)"
متغیرهای محیطی با پیشوند
.B PCP_
برای پارامتریک‌سازی نام فایل‌ها و دایرکتوری‌های مورد استفاده توسط PCP به کار می‌روند.
در هر نصب، فایل
.B /etc/pcp.conf
شامل مقادیر محلی برای این متغیرها است.
متغیر
.B $PCP_CONF
می‌تواند برای تعیین یک فایل پیکربندی جایگزین استفاده شود،
همان‌طور که در
.BR pcp.conf (5)
شرح داده شده است.
.SH "گزینه‌های اشکال‌زدایی (DEBUGGING OPTIONS)"
گزینه
.B \-D
یا
.B \-\-debug
خروجی پیام‌های تشخیصی اضافی را روی
.I stderr
برای کمک به عیب‌یابی مشکلات فعال می‌کند، اگرچه اطلاعات گاهی مبهم بوده و
در درجه اول برای راهنمایی توسعه‌دهندگان در نظر گرفته شده است تا کاربران نهایی.
.I debug
یک فهرست جداشده با کاما از گزینه‌های اشکال‌زدایی است؛ از
.BR pmdbg (1)
همراه با گزینه
.B \-l
برای دریافت فهرستی از گزینه‌های اشکال‌زدایی موجود و معانی آن‌ها استفاده کنید.
.PP
گزینه‌های اشکال‌زدایی مخصوص به
.B pmdadocker
به شرح زیر است:
.TS
box;
lf(B) | lf(B)
lf(B) | lf(R) .
Option	Description
_
appl1	report failure to fetch stats via http
.TE
.SH "همچنین ببینید (SEE ALSO)"
.BR PCPIntro (1),
.BR pmcd (1),
.BR pcp.conf (5),
.BR pcp.env (5)
و
.BR docker (1).