PMDABPFTRACE(1)             General Commands Manual            PMDABPFTRACE(1)

نام (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).


Performance Co-Pilot                  PCP                      PMDABPFTRACE(1)