'\" t
.\"
.\" Copyright (c) 2014 Red Hat.
.\" Copyright (c) 2000 Silicon Graphics, Inc.  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 PMDASYSTEMD 1 "PCP" "Performance Co-Pilot"
.SH "نام (NAME)"
pmdasystemd \- عامل دامنه معیارهای کارایی systemd (PMDA)
.SH "خلاصه دستور (SYNOPSIS)"
\f3$PCP_PMDAS_DIR/systemd/pmdasystemd\f1
[\f3\-f\f1]
[\f3\-D\f1 \f2debug\f1]
[\f3\-d\f1 \f2domain\f1]
[\f3\-l\f1 \f2logfile\f1]
[\f3\-m\f1 \f2memory\f1]
[\f3\-s\f1 \f2interval\f1]
[\f3\-U\f1 \f2username\f1]
.SH "توضیحات (DESCRIPTION)"
.B pmdasystemd
یک عامل دامنه معیارهای کارایی (PMDA) برای پایش فایل لاگ systemd است.
این ابزار را می‌توان مشابه با گزینهٔ
.B \-f
در دستور
.BR journalctl (1)
دانست و هر خط جدید لاگ را به یک رویداد کارایی تبدیل می‌کند که برای استفاده توسط ابزارهای کلاینت
.BR PMAPI (3)
مانند
.BR pmevent (1)
مناسب است.
.PP
عامل
.B systemd
هم معیارهای مبتنی بر رویداد (شامل رکوردهای رویداد زمان‌دار برای پیام‌های ثبت‌شده در لاگ‌های سیستم) و هم معیارهای متداول‌تر نمونه‌برداری مانند تعداد پیام‌ها و مقادیر اندازه توان‌عملیاتی را ارائه می‌دهد.
.PP
توضیح مختصری از گزینه‌های خط فرمان
.B pmdasystemd
در ادامه آمده است:
.TP 5
.B \-d
بسیار حیاتی است که شماره
.I domain
(دامنه) معیارهای کارایی مشخص‌شده در اینجا یکتا و سازگار باشد.
به این معنی که
.I domain
باید برای هر PMDA روی یک میزبان متفاوت باشد، و همان شماره
.I domain
باید برای یک PMDA یکسان روی تمام میزبان‌ها استفاده شود.
.TP
.B \-f
فیلتر کردن رکوردها بر اساس uid/gid را غیرفعال می‌کند.
به‌طور پیش‌فرض، اعتبارنامه‌های کاربر و گروه برای فیلتر کردن رکوردهای لاگ ارائه‌شده به ابزار کلاینت استفاده می‌شوند تا از افشای اطلاعات به کاربران غیرمجاز جلوگیری شود.
این گزینه این سازوکار را غیرفعال می‌کند، بنابراین فقط با احتیاط بسیار زیاد از آن استفاده کنید.
.TP
.B \-l
محل فایل لاگ. به‌طور پیش‌فرض، هنگام راه‌اندازی
.B pmdasystemd
یک فایل لاگ به نام
.I systemd.log
در دایرکتوری جاری
.BR pmcd (1)
نوشته می‌شود، یعنی
.BR $PCP_LOG_DIR/pmcd .
اگر ایجاد فایل لاگ ممکن نباشد یا قابل نوشتن نباشد، خروجی به خطای استاندارد فرستاده می‌شود.
.TP
.B \-m
حافظه فیزیکی مورد استفاده توسط PMDA برای بافر کردن رکوردهای رویداد را به
.I maxsize
بایت محدود می‌کند.
هنگام رسیدن رویدادهای لاگ به PMDA، آن‌ها باید در بافر ذخیره شوند تا زمانی که ابزارهای کلاینت درخواست دریافت دسته بعدی رویدادها را پس از دسته قبلی ارسال کنند.
حداکثر مقدار پیش‌فرض ۲ مگابایت است.
.TP
.B \-s
بازه زمانی وارسی (polling interval) را برای شناسایی خطوط تازه ثبت‌شده لاگ تعیین می‌کند.
عملکرد این گزینه مشابه گزینه هم‌نام در دستور
.BR tail (1)
است.
.TP
.B \-U
حساب کاربری که عامل تحت آن اجرا می‌شود.
پیش‌فرض، حساب کاربری "adm" است.
.SH "نصب (INSTALLATION)"
اگر دسترسی به نام‌ها، متن راهنما و مقادیر معیارهای کارایی systemd را می‌خواهید، دستورات زیر را به عنوان کاربر ریشه انجام دهید:
.PP
.ft CR
.nf
.in +0.5i
# cd $PCP_PMDAS_DIR/systemd
# ./Install
.in
.fi
.ft 1
.PP
اگر می‌خواهید فرآیند نصب را لغو کنید، دستورات زیر را به عنوان کاربر ریشه انجام دهید:
.PP
.ft CR
.nf
.in +0.5i
# cd $PCP_PMDAS_DIR/systemd
# ./Remove
.in
.fi
.ft 1
.PP
.B pmdasystemd
توسط
.BR pmcd (1)
راه‌اندازی می‌شود و هرگز نباید به صورت مستقیم اجرا گردد.
اسکریپت‌های Install و Remove هنگام نصب یا حذف عامل، به
.BR pmcd (1)
اطلاع‌رسانی می‌کنند.
.SH "فایل‌ها (FILES)"
.PD 0
.TP 10
.B $PCP_PMCDCONF_PATH
گزینه‌های خط فرمان مورد استفاده برای راه‌اندازی
.B pmdasystemd
.TP 10
.B $PCP_PMDAS_DIR/systemd/help
فایل متنی راهنمای پیش‌فرض برای معیارهای systemd
.TP 10
.B $PCP_PMDAS_DIR/systemd/Install
اسکریپت نصب برای عامل
.B pmdasystemd
.TP 10
.B $PCP_PMDAS_DIR/systemd/Remove
اسکریپت لغو نصب برای عامل
.B pmdasystemd
.TP 10
.B $PCP_LOG_DIR/pmcd/systemd.log
فایل لاگ پیش‌فرض برای پیام‌های خطا و سایر اطلاعات از
.B pmdasystemd
.PD
.SH "محیط PCP (PCP ENVIRONMENT)"
متغیرهای محیطی با پیشوند
.B PCP_
برای پارامتریک کردن نام فایل‌ها و دایرکتوری‌های مورد استفاده PCP به کار می‌روند.
در هر نصب، فایل
.I /etc/pcp.conf
حاوی مقادیر محلی برای این متغیرها است.
متغیر
.B $PCP_CONF
می‌تواند برای مشخص کردن یک فایل پیکربندی جایگزین استفاده شود، همان‌طور که در
.BR pcp.conf (5)
شرح داده شده است.
.SH "گزینه‌های اشکال‌زدایی (DEBUGGING OPTIONS)"
گزینه
.B \-D
یا
.B \-\-debug
خروجی عیب‌یابی تکمیلی را در
.I stderr
فعال می‌کند تا به تفکیک و حل مشکلات کمک نماید، هرچند این اطلاعات گاهی مبهم بوده و عمدتاً برای راهنمایی توسعه‌دهندگان در نظر گرفته شده تا کاربران نهایی.
.I debug
یک فهرست جدا شده با کاما از گزینه‌های اشکال‌زدایی است؛ از
.BR pmdbg (1)
همراه با گزینه
.B \-l
استفاده کنید تا فهرستی از گزینه‌های اشکال‌زدایی موجود و معانی آن‌ها به دست آید.
.PP
گزینه‌های اشکال‌زدایی مختص
.B pmdasystemd
به شرح زیر است:
.TS
box;
lf(B) | lf(B)
lf(B) | lxf(R) .
گزینه	توضیحات
_
appl0	T{
.ad l
فیلتر کردن رکوردهای ژورنال، کنترل دسترسی و تعاملات با
.BR pmcd (1)
T}
_
appl2	T{
.ad l
ردیابی فراخوانی‌های \fBselect\fP(2)
T}
.TE
.SH "همچنین ببینید (SEE ALSO)"
.BR PCPIntro (1),
.BR pmcd (1),
.BR pmevent (1),
.BR journalctl (1),
.BR tail (1),
.BR PMAPI (3),
.BR pcp.conf (5)
و
.BR pcp.env (5).

.\" control lines for scripts/man-spell
.\" +ok+ pmdasystemd journalctl maxsize adm