نام (NAME)

pmdadocker - عامل دامنه معیارهای عملکرد (PMDA) داکر (docker)

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

$PCP_PMDAS_DIR/docker/pmdadocker [-D debug] [-d domain] [-l logfile]

توضیحات (DESCRIPTION)

pmdadocker یک عامل دامنه معیارهای عملکرد (PMDA) برای docker است که معیارهای عملکرد گزارش‌شده از Docker Remote API را ارائه می‌دهد.

توضیح مختصری از گزینه‌های خط فرمان pmdadocker در ادامه آمده است:

-d

بسیار حیاتی است که شماره domain معیارهای عملکرد مشخص‌شده در اینجا یکتا و سازگار باشد. به این معنی که domain باید برای هر PMDA روی یک میزبان متفاوت باشد، و همان شماره domain باید برای همان PMDA روی تمام میزبان‌ها استفاده شود.

-l

محل فایل گزارش (log). به‌طور پیش‌فرض، یک فایل گزارش با نام docker.log در دایرکتوری جاری pmcd(1) هنگام شروع pmdadocker نوشته می‌شود، یعنی $PCP_LOG_DIR/pmcd. اگر فایل گزارش نتواند ایجاد شود یا قابل نوشتن نباشد، خروجی به‌جای آن به خطای استاندارد (stderr) ارسال می‌شود.

درخواست‌های معیارهای Remote API به‌طور خودکار فعال شده و بر اساس یک زمان‌سنج (timer) واکشی می‌شوند. این زمان‌سنج توسط pmdadocker از طریق docker.control.timing نمایش داده می‌شود. به‌طور پیش‌فرض، pmdadocker روی بازه زمانی ۱ ثانیه برای واکشی تنظیم شده است.

برنامه pmdadocker روی سه فراخوانی مختلف API راه دور docker پیمایش خواهد کرد:

/containers/$ID/json

معیارهای کانتینر مربوط به وضعیت جاری کانتینر، مانند PID، نام، یا در حال اجرا بودن کانتینر.

/version

معیارهای پایه نسخه در مورد دیمن داکر در حال استفاده.

/containers/$ID/stats?stream=0

معیارهای دقیق‌تر حافظه و پردازنده کانتینر.

نصب (INSTALLATION)

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

# cd $PCP_PMDAS_DIR/docker
# ./Install

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

# cd $PCP_PMDAS_DIR/docker
# ./Remove

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

فایل‌ها (FILES)

$PCP_PMCDCONF_PATH

گزینه‌های خط فرمان مورد استفاده برای راه‌اندازی pmdadocker

$PCP_PMDAS_DIR/docker/help

فایل متنی راهنمای پیش‌فرض برای معیارهای docker

$PCP_PMDAS_DIR/docker/Install

اسکریپت نصب برای عامل pmdadocker

$PCP_PMDAS_DIR/docker/Remove

اسکریپت لغو نصب برای عامل pmdadocker

$PCP_LOG_DIR/pmcd/docker.log

فایل گزارش پیش‌فرض برای پیام‌های خطا و سایر اطلاعات از pmdadocker

محیط PCP (PCP ENVIRONMENT)

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

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

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

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

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

PCPIntro(1), pmcd(1), pcp.conf(5), pcp.env(5) و docker(1).