'\"macro stdmacro
.\"
.\" Copyright (c) 2018 Red Hat.  All Rights Reserved.
.\" Copyright (c) 2009 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 PMDAPOSTGRESQL 1 "PCP" "Performance Co-Pilot"
.SH "نام (NAME)"
pmdapostgresql \- عامل دامنه معیارهای کارایی (PMDA) برای پایگاه‌داده PostgreSQL
.SH "توضیحات (DESCRIPTION)"
دستور
.B pmdapostgresql
یک عامل دامنه معیارهای کارایی (PMDA) برای
Performance Co-Pilot (PCP)
است که داده‌های کارایی زنده را از یک کارساز در حال اجرای پایگاه‌داده
PostgreSQL
استخراج می‌کند.
.PP
بسیاری از آمارهای ارائه‌شده از کارساز
PostgreSQL
ممکن است به‌صورت پیش‌فرض فعال نباشند.
به مستندات برخط
.B https://postgresql.org/docs/current/static/monitoring-stats.html
مراجعه کنید که هر یک از پارامترهای موجود مربوط به جمع‌آوری آمار و نحوه فعال‌سازی آن‌ها را توضیح می‌دهد.
.SH "پیکربندی (CONFIGURATION)"
برنامه
.B pmdapostgresql
یک فایل پیکربندی الزامی به سبک ini را می‌خواند:
.IP
.PD 0
.IP
.I \f(CR$PCP_PMDAS_DIR\fP/postgresql/postgresql.conf
.PD
.PP
این فایل در حال حاضر تنها شامل یک بخش است:
.B [authentication]
که مقادیر تنظیمات زیر را مشخص می‌کند
(مقادیر پیش‌فرض آن‌ها درون پرانتز نشان داده شده است):
.TP 15
.B host \fR(\fP\fIlocal\fP\fR)\fP
نام میزبان برای اتصال.
.TP
.B port \fR(\fP\fI5432\fP\fR)\fP
شماره پورت برای استفاده.
.TP
.B dbname \fR(\fP\fIpostgres\fP\fR)\fP
نام پایگاه‌داده.
.TP
.B username \fR(\fP\fIpostgres\fP\fR)\fP
نام کاربری برای اجرا و اتصال به پایگاه‌داده.
.TP
.B password \fR(\fP\fIpassword\fP\fR)\fP
گذرواژه برای اتصال به پایگاه‌داده.
.TP
.B osuser \fR(تنظیم‌نشده)\fP
کاربر سیستم‌عامل که PMDA تحت آن اجرا می‌شود.
.PP
مقادیر پیش‌فرض (همان‌طور که در بالا آمده است) باعث می‌شوند PMDA با کاربر جاری اجرا شود و از اتصال سوکت دامنه یونیکس (UNIX domain socket) به کارساز PostgreSQL روی میزبان محلی (localhost) استفاده کند.
.PP
اگر
.B osuser
در فایل پیکربندی مشخص نشده باشد، PMDA با کاربر جاری اجرا خواهد شد.
تعیین میزبان به‌صورت
.I local
از سوکت دامنه یونیکس استفاده خواهد کرد که از احراز هویت همتا (peer authentication) بهره می‌برد؛ به توضیحات درون فایل
.B pg_hba.conf
مراجعه کنید.
در این حالت، تنظیم
.B osuser
احتمالاً باید روی
.B postgres
قرار داده شود.
.PP
به‌طور کلی برای پایش نمونه محلی کارساز PostgreSQL با پیکربندی پیش‌فرض کارساز، نیازی به تغییر فایل پیکربندی پیش‌فرض نیست.
توجه داشته باشید که شماره پورت حتی برای اتصال دامنه یونیکس نیز لازم است، زیرا کارساز از آن به‌عنوان نام فایل سوکت استفاده می‌کند.
.SH "نصب (INSTALLATION)"
برای نصب، مراحل زیر باید با دسترسی ریشه (root) انجام شوند:
.sp 1
.RS +4
.ft B
.nf
# cd $PCP_PMDAS_DIR/postgresql
# ./Install
.fi
.ft P
.RE
.sp 1
برای حذف، مراحل زیر باید با دسترسی ریشه (root) انجام شوند:
.sp 1
.RS +4
.ft B
.nf
# cd $PCP_PMDAS_DIR/postgresql
# ./Remove
.fi
.ft P
.RE
.sp 1
برنامه
.B pmdapostgresql
توسط
.BR pmcd (1)
راه‌اندازی می‌شود و هرگز نباید مستقیماً اجرا شود.
اسکریپت‌های
.B Install
و
.B Remove
هنگام نصب یا حذف عامل، به
.BR pmcd (1)
اطلاع می‌دهند.
.PP
در صورت قطع اتصال، مثلاً در صورتی که سرویس PostgreSQL راه‌اندازی مجدد شود،
.B pmdapostgresql
به‌طور خودکار برای برقراری مجدد اتصال به کارساز PostgreSQL تلاش خواهد کرد.
.SH "نسخه‌های پشتیبانی‌شده (SUPPORTED VERSIONS)"
این نسخه از
.B pmdapostgresql
با کارساز PostgreSQL نسخه
.B 10.2
و نسخه‌های پیش از آن آزمایش و تأیید شده است.
نسخه‌های جدیدتر نیز احتمالاً به‌درستی کار خواهند کرد زیرا PMDA هنگام راه‌اندازی، جدول‌های مختلف کارایی را برای تعیین ترتیب ستون‌ها بررسی می‌کند.
این عامل همچنین در برابر جدول‌ها یا ستون‌های ناموجود یا تغییرنام‌یافته مقاوم است.
.SH "فایل‌ها (FILES)"
.TP 5
.I \f(CR$PCP_PMDAS_DIR\fP/postgresql/pmdapostgresql.conf
فایل پیکربندی برای عامل
.B pmdapostgresql
.TP
.I \f(CR$PCP_PMDAS_DIR\fP/postgresql/Install
اسکریپت نصب برای عامل
.B pmdapostgresql
.TP
.I \f(CR$PCP_PMDAS_DIR\fP/postgresql/Remove
اسکریپت حذف نصب برای عامل
.B pmdapostgresql
.TP
.I \f(CR$PCP_LOG_DIR\fP/pmcd/postgresql.log
فایل لاگ پیش‌فرض برای پیام‌های عامل
.B pmdapostgresql
.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 https://postgresql.org/docs/current/static/monitoring-stats.html .

.\" control lines for scripts/man-spell
.\" +ok+ pmdapostgresql postgresql postgres dbname pg_hba osuser