نام (NAME)

pmdabpftrace - عامل دامنه معیارهای کارایی bpftrace در PCP

توضیحات (DESCRIPTION)

pmdabpftrace یک عامل دامنه معیارهای کارایی (PMDA) در Performance Co-Pilot (PCP) است که معیارها را از اسکریپت‌های bpftrace(8) صادر می‌کند.

پیکربندی (CONFIGURATION)

دستور pmdabpftrace یک فایل پیکربندی اختیاری به سبک ini را می‌خواند:


: $PCP_PMDAS_DIR/bpftrace/bpftrace.conf

این فایل می‌تواند شامل بخش‌های [bpftrace] و [dynamic_scripts] باشد. اگر قابلیت dynamic scripts (اسکریپت‌های پویا) را فعال می‌کنید، لطفاً برای چگونگی راه‌اندازی احراز هویت به https://pcp.io/docs/lab.auth.html مراجعه کنید. این کار شدیداً توصیه می‌شود، چرا که در غیر این صورت هر کسی می‌تواند هر اسکریپت bpftrace(8) را به عنوان کاربر root اجرا کند.

بخش [bpftrace] مقادیر تنظیمات زیر را مشخص می‌کند (مقادیر پیش‌فرض آن‌ها داخل پرانتز نشان داده شده است):

bpftrace_path (bpftrace): مسیر فایل اجرایی bpftrace(8).
script_expiry_time (60): اسکریپت‌های بدون نام پس از گذشت این مدت زمان (به ثانیه)، در صورتی که درخواستی برای مقادیر آن‌ها وجود نداشته باشد، حذف می‌شوند.
max_throughput (2097152): حداکثر توان عملیاتی اسکریپت‌های bpftrace به بایت.

بخش [dynamic_scripts] مقادیر تنظیمات زیر را مشخص می‌کند (مقادیر پیش‌فرض آن‌ها داخل پرانتز نشان داده شده است):

enabled (false): یک مقدار بولی برای مشخص کردن این که آیا اسکریپت باید بنا به تقاضا، با اجرای pmStore(3) روی bpftrace.control.register شروع شود یا خیر. این ویژگی باید برای منبع داده PCP bpftrace در grafana-pcp فعال شود.
auth_enabled (true): یک مقدار بولی برای تعیین این که آیا احراز هویت الزامی است یا خیر. لطفاً یادداشت بالا را درباره راه‌اندازی احراز هویت مشاهده کنید.
allowed_users (root): فهرستی از نام‌های کاربری جداشده با کاما که مجاز به ثبت اسکریپت‌های bpftrace(8) هستند.

نصب (INSTALLATION)

برای نصب، مراحل زیر باید با دسترسی کاربر root انجام شوند:

# cd $PCP_PMDAS_DIR/bpftrace
# ./Install

برای لغو نصب، مراحل زیر باید با دسترسی کاربر root انجام شوند:

# cd $PCP_PMDAS_DIR/bpftrace
# ./Remove

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

فایل‌ها (FILES)

$PCP_PMDAS_DIR/bpftrace/bpftrace.conf: فایل پیکربندی برای عامل pmdabpftrace
$PCP_PMDAS_DIR/bpftrace/Install: اسکریپت نصب برای عامل pmdabpftrace
$PCP_PMDAS_DIR/bpftrace/Remove: اسکریپت لغو نصب برای عامل pmdabpftrace
$PCP_LOG_DIR/pmcd/bpftrace.log: فایل گزارش پیش‌فرض برای پیام‌های عامل pmdabpftrace

توجه داشته باشید که مقدار معمول/پیش‌فرض برای $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) توضیح داده شده است.

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

PCPIntro(1)، pmcd(1) و bpftrace(8).