PMDAPOSTGRESQL(1)           General Commands Manual          PMDAPOSTGRESQL(1)

نام (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.


Performance Co-Pilot                  PCP                    PMDAPOSTGRESQL(1)