نام (NAME)

pmdabpf - عامل دامنه معیارهای عملکرد eBPF

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

$PCP_PMDAS_DIR/bpf/pmdabpf [-D debug]

توضیحات (DESCRIPTION)

دستور pmdabpf یک عامل دامنه معیارهای عملکرد (PMDA) در Performance Co-Pilot (PCP) است که داده‌های زنده مربوط به کارایی را با بهره‌گیری از BPF CO-RE (شامل libbpf و BTF) از برنامه‌های eBPF استخراج می‌کند.

دستور pmdabpf هر تعداد از ماژول‌های مجزا و پیکربندی‌شدهٔ bpf PMDA را بارگذاری کرده و به عنوان یک پل ارتباطی برای آن‌ها عمل می‌کند. باید بتوان با صرف تلاشی معقول، ابزارهای موجود libbpf را به همراه ماژول‌های bpf PMDA به کار گرفت.

برای توضیحات تفصیلی، به مستندات eBPF، libbpf و BPF CO-RE مراجعه کنید.

پیکربندی (CONFIGURATION)

دستور pmdabpf یک فایل پیکربندی الزامی در قالب ini را می‌خواند:

$PCP_PMDAS_DIR/bpf/bpf.conf

هر بخش از فایل به یک ماژول bpf PMDA اختصاص دارد. گزینه‌های سراسری زیر برای هر ماژول در دسترس هستند (مقادیر پیش‌فرض آن‌ها در پرانتز نشان داده شده است):

enabled (unset)

یک مقدار بولی برای تعیین این که آیا این ماژول bpf PMDA باید آغاز به کار کند یا خیر.

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

نصب (INSTALLATION)

برای نصب، دستورات زیر باید با دسترسی ریشه (root) انجام شوند:

# cd $PCP_PMDAS_DIR/bpf
# ./Install

برای حذف نصب، دستورات زیر باید با دسترسی ریشه (root) انجام شوند:

# cd $PCP_PMDAS_DIR/bpf
# ./Remove

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

برخی ماژول‌ها تنها پس از جمع‌آوری داده‌ها از فعالیت‌های مربوطه در سیستم، شروع به ارائه مقادیر می‌کنند.

فایل‌ها (FILES)

$PCP_PMDAS_DIR/bpf/bpf.conf

فایل پیکربندی برای عامل pmdabpf

$PCP_PMDAS_DIR/bpf/modules/*.{o,so}

ماژول‌های bpf PMDA در دسترس برای عامل pmdabpf

$PCP_PMDAS_DIR/bpf/Install

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

$PCP_PMDAS_DIR/bpf/Remove

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

$PCP_LOG_DIR/pmcd/bpf.log

فایل لاگ پیش‌فرض برای پیام‌های ارسالی از سوی عامل pmdabpf

توجه داشته باشید که مقدار معمول/پیش‌فرض برای $PCP_PMDAS_DIR مسیر /var/lib/pcp/pmdas و مقدار پیش‌فرض برای $PCP_LOG_DIR مسیر /var/log/pcp می‌باشد، اما این تنظیمات به پلتفرم وابسته هستند.

محیط PCP (PCP ENVIRONMENT)

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

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

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

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

PCPIntro(1)، bpf(1) و pmcd(1).