PMDAHAPROXY(1)              General Commands Manual             PMDAHAPROXY(1)

نام (NAME)
       pmdahaproxy - عامل دامنه معیارهای کارایی (PMDA) برای HAProxy

توضیحات (DESCRIPTION)
       دستور pmdahaproxy یک عامل دامنه معیارهای کارایی (PMDA) است که داده‌های
       زنده کارایی را از سوکت یا نشانی URL آمار HAProxy استخراج می‌کند.

       به‌طور پیش‌فرض، سوکت آمار HAProxy برای بازیابی معیارها استفاده می‌شود، اما
       اگر گزینه اختیاری URL تنظیم شده باشد (پایین‌تر را ببینید)، به جای آن از
       نشانی URL مربوط به HAProxy استفاده می‌شود.

       برای توضیحات دقیق درباره هر یک از معیارها، مستندات HAProxy را ببینید.

نصب (INSTALLATION)
       دستور pmdahaproxy یک فایل پیکربندی اختیاری با ساختار ini را می‌خواند:

           • $PCP_PMDAS_DIR/haproxy/haproxy.conf

       این فایل می‌تواند در بخش [pmda] خود شامل مقادیر جایگزین برای گزینه‌های
       PMDA زیر باشد:

           • user
           • socket

       به‌طور پیش‌فرض، به ترتیب root و /var/lib/haproxy/stats به‌عنوان مقادیر این
       گزینه‌ها استفاده می‌شوند.

       این بخش همچنین می‌تواند شامل پارامترهای زیر باشد:

           • url
           • auth
           • pass

       هنگامی که گزینه url تعریف شده باشد، اتصال URL به HAProxy استفاده می‌شود.
       pmdahaproxy انتظار دریافت داده‌های CSV را از نشانی URL مربوط به HAProxy
       دارد؛ نمونه‌ای از یک URL سازگار http://127.0.0.1:9000/?stats;csv است.

       توجه داشته باشید که سوکت آمار و/یا نشانی URL مربوط به HAProxy باید
       به‌طور جداگانه در فایل پیکربندی HAProxy فعال شده باشند؛ لطفاً برای جزئیات
       به مستندات پیکربندی HAProxy مراجعه کنید. بسته به پیکربندی سیستم و
       HAProxy، استفاده از کاربر غیر ریشه (non-root) نیز ممکن است امکان‌پذیر
       باشد، به‌ویژه در اتصالات مبتنی بر URL.

       پس از آماده‌سازی تنظیمات مورد نیاز، می‌توانید اتصال را آزمایش کرده و PMDA
       را نصب نمایید تا دسترسی به نام‌ها و مقادیر معیارهای کارایی HAProxy فعال
       گردد.  برای نصب، دستورات زیر را با دسترسی ریشه (root) اجرا کنید:

           # cd $PCP_PMDAS_DIR/haproxy
           # ./connect
           # ./Install

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

           # cd $PCP_PMDAS_DIR/haproxy
           # ./Remove

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

فایل‌ها (FILES)
       $PCP_PMDAS_DIR/haproxy/haproxy.conf
              فایل پیکربندی برای عامل pmdahaproxy

       $PCP_PMDAS_DIR/haproxy/connect
              ابزار کمکی آزمایش اتصال با استفاده از پیکربندی عامل pmdahaproxy

       $PCP_PMDAS_DIR/haproxy/Install
              اسکریپت نصب برای عامل pmdahaproxy

       $PCP_PMDAS_DIR/haproxy/Remove
              اسکریپت لغو نصب برای عامل pmdahaproxy

       $PCP_LOG_DIR/pmcd/haproxy.log
              فایل گزارش وقایع (لاگ) پیش‌فرض برای پیام‌های دریافتی از عامل
              pmdahaproxy

محیط PCP (PCP ENVIRONMENT)
       متغیرهای محیطی با پیشوند PCP_ برای پارامتریک‌سازی نام فایل‌ها و
       دایرکتوری‌های مورد استفاده توسط PCP به کار می‌روند. در هر نصب، فایل
       /etc/pcp.conf حاوی مقادیر محلی برای این متغیرها است. از متغیر $PCP_CONF
       می‌توان برای مشخص کردن یک فایل پیکربندی جایگزین استفاده کرد، همان‌طور که
       در pcp.conf(5) توضیح داده شده است.

همچنین ببینید (SEE ALSO)
       PCPIntro(1)، haproxy(1) و pmcd(1).


Performance Co-Pilot                  PCP                       PMDAHAPROXY(1)