نام (NAME)

pmdapostgresql - عامل دامنه معیارهای کارایی (PMDA) برای پایگاه‌داده PostgreSQL

توضیحات (DESCRIPTION)

دستور pmdapostgresql یک عامل دامنه معیارهای کارایی (PMDA) برای Performance Co-Pilot (PCP) است که داده‌های کارایی زنده را از یک کارساز در حال اجرای پایگاه‌داده PostgreSQL استخراج می‌کند.

بسیاری از آمارهای ارائه‌شده از کارساز PostgreSQL ممکن است به‌صورت پیش‌فرض فعال نباشند. به مستندات برخط https://postgresql.org/docs/current/static/monitoring-stats.html مراجعه کنید که هر یک از پارامترهای موجود مربوط به جمع‌آوری آمار و نحوه فعال‌سازی آن‌ها را توضیح می‌دهد.

پیکربندی (CONFIGURATION)

برنامه pmdapostgresql یک فایل پیکربندی الزامی به سبک ini را می‌خواند:


: $PCP_PMDAS_DIR/postgresql/postgresql.conf

این فایل در حال حاضر تنها شامل یک بخش است: [authentication] که مقادیر تنظیمات زیر را مشخص می‌کند (مقادیر پیش‌فرض آن‌ها درون پرانتز نشان داده شده است):

host (local): نام میزبان برای اتصال.
port (5432): شماره پورت برای استفاده.
dbname (postgres): نام پایگاه‌داده.
username (postgres): نام کاربری برای اجرا و اتصال به پایگاه‌داده.
password (password): گذرواژه برای اتصال به پایگاه‌داده.
osuser (تنظیم‌نشده): کاربر سیستم‌عامل که PMDA تحت آن اجرا می‌شود.

مقادیر پیش‌فرض (همان‌طور که در بالا آمده است) باعث می‌شوند PMDA با کاربر جاری اجرا شود و از اتصال سوکت دامنه یونیکس (UNIX domain socket) به کارساز PostgreSQL روی میزبان محلی (localhost) استفاده کند.

اگر osuser در فایل پیکربندی مشخص نشده باشد، PMDA با کاربر جاری اجرا خواهد شد. تعیین میزبان به‌صورت local از سوکت دامنه یونیکس استفاده خواهد کرد که از احراز هویت همتا (peer authentication) بهره می‌برد؛ به توضیحات درون فایل pg_hba.conf مراجعه کنید. در این حالت، تنظیم osuser احتمالاً باید روی postgres قرار داده شود.

به‌طور کلی برای پایش نمونه محلی کارساز PostgreSQL با پیکربندی پیش‌فرض کارساز، نیازی به تغییر فایل پیکربندی پیش‌فرض نیست. توجه داشته باشید که شماره پورت حتی برای اتصال دامنه یونیکس نیز لازم است، زیرا کارساز از آن به‌عنوان نام فایل سوکت استفاده می‌کند.

نصب (INSTALLATION)

برای نصب، مراحل زیر باید با دسترسی ریشه (root) انجام شوند:

# cd $PCP_PMDAS_DIR/postgresql
# ./Install

برای حذف، مراحل زیر باید با دسترسی ریشه (root) انجام شوند:

# cd $PCP_PMDAS_DIR/postgresql
# ./Remove

برنامه pmdapostgresql توسط pmcd(1) راه‌اندازی می‌شود و هرگز نباید مستقیماً اجرا شود. اسکریپت‌های Install و Remove هنگام نصب یا حذف عامل، به pmcd(1) اطلاع می‌دهند.

در صورت قطع اتصال، مثلاً در صورتی که سرویس PostgreSQL راه‌اندازی مجدد شود، pmdapostgresql به‌طور خودکار برای برقراری مجدد اتصال به کارساز PostgreSQL تلاش خواهد کرد.

نسخه‌های پشتیبانی‌شده (SUPPORTED VERSIONS)

این نسخه از pmdapostgresql با کارساز PostgreSQL نسخه 10.2 و نسخه‌های پیش از آن آزمایش و تأیید شده است. نسخه‌های جدیدتر نیز احتمالاً به‌درستی کار خواهند کرد زیرا PMDA هنگام راه‌اندازی، جدول‌های مختلف کارایی را برای تعیین ترتیب ستون‌ها بررسی می‌کند. این عامل همچنین در برابر جدول‌ها یا ستون‌های ناموجود یا تغییرنام‌یافته مقاوم است.

فایل‌ها (FILES)

$PCP_PMDAS_DIR/postgresql/pmdapostgresql.conf: فایل پیکربندی برای عامل pmdapostgresql
$PCP_PMDAS_DIR/postgresql/Install: اسکریپت نصب برای عامل pmdapostgresql
$PCP_PMDAS_DIR/postgresql/Remove: اسکریپت حذف نصب برای عامل pmdapostgresql
$PCP_LOG_DIR/pmcd/postgresql.log: فایل لاگ پیش‌فرض برای پیام‌های عامل pmdapostgresql

توجه داشته باشید که مقدار معمول/پیش‌فرض برای $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) و https://postgresql.org/docs/current/static/monitoring-stats.html.