'\"macro stdmacro
.\"
.\" Copyright (c) 2019 Red Hat.  All Rights Reserved.
.\"
.\" 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.
.\"
.\"
.TH PMDABPFTRACE 1 "PCP" "Performance Co-Pilot"
.SH "نام (NAME)"
pmdabpftrace \- عامل دامنه معیارهای کارایی bpftrace در PCP
.SH "توضیحات (DESCRIPTION)"
.B pmdabpftrace
یک عامل دامنه معیارهای کارایی (PMDA) در Performance Co-Pilot (PCP) است که معیارها را از اسکریپت‌های
.BR bpftrace (8)
صادر می‌کند.
.SH "پیکربندی (CONFIGURATION)"
دستور
.B pmdabpftrace
یک فایل پیکربندی اختیاری به سبک ini را می‌خواند:
.IP
.PD 0
.IP
.I \f(CR$PCP_PMDAS_DIR\fP/bpftrace/bpftrace.conf
.PD
.PP
این فایل می‌تواند شامل بخش‌های
.B [bpftrace]
و
.B [dynamic_scripts]
باشد.
اگر قابلیت
.B dynamic scripts
(اسکریپت‌های پویا) را فعال می‌کنید، لطفاً برای چگونگی راه‌اندازی احراز هویت به
.B https://pcp.io/docs/lab.auth.html
مراجعه کنید. این کار
.B شدیداً توصیه می‌شود\fR،
چرا که در غیر این صورت هر کسی می‌تواند هر اسکریپت
.BR bpftrace (8)
را به عنوان کاربر
.B root
اجرا کند.
.PP
بخش
.B [bpftrace]
مقادیر تنظیمات زیر را مشخص می‌کند
(مقادیر پیش‌فرض آن‌ها داخل پرانتز نشان داده شده است):
.TP 15
.B bpftrace_path \fR(\fP\fIbpftrace\fP\fR)\fP
مسیر فایل اجرایی
.BR bpftrace (8).
.TP
.B script_expiry_time \fR(\fP\fI60\fP\fR)\fP
اسکریپت‌های بدون نام پس از گذشت این مدت زمان (به ثانیه)، در صورتی که درخواستی برای مقادیر آن‌ها وجود نداشته باشد، حذف می‌شوند.
.TP
.B max_throughput \fR(\fP\fI2097152\fP\fR)\fP
حداکثر توان عملیاتی اسکریپت‌های bpftrace به بایت.
.PP
بخش
.B [dynamic_scripts]
مقادیر تنظیمات زیر را مشخص می‌کند
(مقادیر پیش‌فرض آن‌ها داخل پرانتز نشان داده شده است):
.TP 15
.B enabled \fR(\fP\fIfalse\fP\fR)\fP
یک مقدار بولی برای مشخص کردن این که آیا اسکریپت باید بنا به تقاضا، با اجرای
.BR pmStore (3)
روی
.B bpftrace.control.register
شروع شود یا خیر.
این ویژگی باید برای منبع داده PCP bpftrace در grafana-pcp فعال شود.
.TP
.B auth_enabled \fR(\fP\fItrue\fP\fR)\fP
یک مقدار بولی برای تعیین این که آیا احراز هویت الزامی است یا خیر.
لطفاً یادداشت بالا را درباره راه‌اندازی احراز هویت مشاهده کنید.
.TP
.B allowed_users \fR(\fP\fIroot\fP\fR)\fP
فهرستی از نام‌های کاربری جداشده با کاما که مجاز به ثبت اسکریپت‌های
.BR bpftrace (8)
هستند.
.SH "نصب (INSTALLATION)"
برای نصب، مراحل زیر باید با دسترسی کاربر root انجام شوند:
.sp 1
.RS +4
.ft B
.nf
# cd $PCP_PMDAS_DIR/bpftrace
# ./Install
.fi
.ft P
.RE
.sp 1
برای لغو نصب، مراحل زیر باید با دسترسی کاربر root انجام شوند:
.sp 1
.RS +4
.ft B
.nf
# cd $PCP_PMDAS_DIR/bpftrace
# ./Remove
.fi
.ft P
.RE
.sp 1
عامل
.B pmdabpftrace
توسط
.BR pmcd (1)
راه‌اندازی می‌شود و هرگز نباید مستقیماً اجرا گردد.
اسکریپت‌های
.B Install
و
.B Remove
هنگام نصب یا حذف عامل، به
.BR pmcd (1)
اطلاع‌رسانی می‌کنند.
.SH "فایل‌ها (FILES)"
.TP 5
.I \f(CR$PCP_PMDAS_DIR\fP/bpftrace/bpftrace.conf
فایل پیکربندی برای عامل
.B pmdabpftrace
.TP
.I \f(CR$PCP_PMDAS_DIR\fP/bpftrace/Install
اسکریپت نصب برای عامل
.B pmdabpftrace
.TP
.I \f(CR$PCP_PMDAS_DIR\fP/bpftrace/Remove
اسکریپت لغو نصب برای عامل
.B pmdabpftrace
.TP
.I \f(CR$PCP_LOG_DIR\fP/pmcd/bpftrace.log
فایل گزارش پیش‌فرض برای پیام‌های عامل
.B pmdabpftrace
.PP
توجه داشته باشید که مقدار معمول/پیش‌فرض برای
.B $PCP_PMDAS_DIR
برابر است با
.B /var/lib/pcp/pmdas
و پیش‌فرض برای
.B $PCP_LOG_DIR
برابر است با
.B /var/log/pcp
اما این تنظیمات وابسته به پلتفرم هستند.
.SH "محیط PCP (PCP ENVIRONMENT)"
متغیرهای محیطی با پیشوند
.B PCP_
برای مقداردهی و مشخص کردن نام فایل‌ها و دایرکتوری‌های استفاده‌شده توسط PCP به کار می‌روند.
در هر نصب، فایل
.I /etc/pcp.conf
حاوی مقادیر محلی برای این متغیرها است.
متغیر
.B $PCP_CONF
ممکن است برای تعیین یک فایل پیکربندی جایگزین استفاده شود، همان‌طور که در
.BR pcp.conf (5)
توضیح داده شده است.
.SH "همچنین ببینید (SEE ALSO)"
.BR PCPIntro (1)،
.BR pmcd (1)
و
.BR bpftrace (8).

.\" control lines for scripts/man-spell
.\" +ok+ script_expiry_time dynamic_scripts max_throughput allowed_users
.\" +ok+ bpftrace_path auth_enabled datasource bpftrace grafana
.\" +ok+ auth {from https://pcp.io/docs/lab.auth.html}