'\"macro stdmacro
.\"
.\" Copyright (c) 2011 Aconex.  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 PMDARSYSLOG 1 "PCP" "Performance Co-Pilot"
.SH "نام (NAME)"
\f3pmdarsyslog\f1 \- عامل PMDA برای rsyslog (سیستم لاگ قابل‌اعتماد و گسترش‌یافته)
.SH "توضیحات (DESCRIPTION)"
\f3pmdarsyslog\f1 یک عامل دامنه معیارهای کارایی (\s-1PMDA\s0) است
که مقادیر معیارها را از کارساز \fBrsyslogd\fR\|(8) صادر می‌کند.
.PP
جزئیات بیشتر دربارهٔ rsyslog را می‌توان در
.BR http://www.rsyslog.com
یافت.
.SH "نصب (INSTALLATION)"
اگر می‌خواهید به نام‌ها و مقادیر معیارهای کارایی rsyslog دسترسی داشته باشید،
مراحل زیر را با دسترسی ریشه (root) انجام دهید:
.sp 1
.RS +4
.ft B
.nf
# cd $PCP_PMDAS_DIR/rsyslog
# ./Install
.fi
.ft P
.RE
.sp 1
.PP
برای حذف نصب، مراحل زیر را با دسترسی ریشه (root) انجام دهید:
.sp 1
.RS +4
.ft B
.nf
# cd $PCP_PMDAS_DIR/rsyslog
# ./Remove
.fi
.ft P
.RE
.sp 1
\fBpmdarsyslog\fR توسط \fBpmcd\fR(1) راه‌اندازی می‌شود و هرگز نباید مستقیماً
اجرا شود. اسکریپت‌های Install و Remove در زمان نصب یا حذف شدن عامل،
به \fBpmcd\fR(1) اطلاع می‌دهند.
.PP
برای استفاده از این عامل، جمع‌آوری آمار در rsyslog باید فعال باشد.
این کار با افزودن خطوط زیر:
.sp 1
.RS +4
.ft B
.nf
module(load="impstats" interval="10" severity="7")
if $syslogtag contains 'rsyslogd-pstats' then {
    action(
        name="pstats-for-pcp"
        type="ompipe"
        template="RSYSLOG_FileFormat"
        pipe="/var/log/pcp/rsyslog/stats"
    )
    stop
}
.fi
.ft P
.RE
.sp 1
به فایل پیکربندی \fIrsyslog.conf\fR\|(5) خود پس از نصب \s-1PMDA\s0 انجام می‌پذیرد.
.SH "فایل‌ها (FILES)"
.IP "\fB$PCP_LOG_DIR/rsyslog/stats\fR" 4
پایپ نام‌گذاری‌شده (named pipe) حاوی آمارهای صادرشده از rsyslog، که معمولاً
توسط اسکریپت Install عامل \s-1PMDA\s0 ایجاد می‌شود.
.IP "\fB$PCP_PMDAS_DIR/rsyslog/rsyslog.conf\fR" 4
فایل پیکربندی اختیاری برای \fBpmdarsyslog\fR
.IP "\fB$PCP_PMDAS_DIR/rsyslog/Install\fR" 4
اسکریپت نصب برای عامل \fBpmdarsyslog\fR
.IP "\fB$PCP_PMDAS_DIR/rsyslog/Remove\fR" 4
اسکریپت حذف نصب برای عامل \fBpmdarsyslog\fR
.IP "\fB$PCP_LOG_DIR/pmcd/rsyslog.log\fR" 4
فایل لاگ پیش‌فرض برای پیام‌های خطای \fBpmdarsyslog\fR
.SH "محیط PCP (PCP ENVIRONMENT)"
متغیرهای محیطی با پیشوند \fBPCP_\fR برای مقداردهی نام فایل‌ها و پوشه‌های مورد استفاده
توسط \fBPCP\fR به کار می‌روند. در هر بار نصب، فایل \fB/etc/pcp.conf\fR شامل مقادیر
محلی برای این متغیرها است. همان‌طور که در \fIpcp.conf\fR(5) شرح داده شده است، از
متغیر \fB$PCP_CONF\fR می‌توان برای مشخص کردن فایل پیکربندی جایگزین استفاده کرد.
.SH "همچنین ببینید (SEE ALSO)"
.BR PCPIntro (1)،
.BR pmcd (1)
و
.BR rsyslogd (1).

.\" control lines for scripts/man-spell
.\" +ok+ RSYSLOG_FileFormat pmdarsyslog syslogtag impstats rsyslogd rsyslog
.\" +ok+ ompipe pstats