PMDAMYSQL(1) General Commands Manual PMDAMYSQL(1)

pmdamysql - واسط PMDA برای پایگاه‌های داده MySQL و MariaDB

pmdamysql یک PMDA در Performance Co-Pilot است که داده‌های زنده کارایی را از یک پایگاه داده در حال اجرای MySQL یا MariaDB استخراج می‌کند.

pmdamysql از یک فایل پیکربندی (به این ترتیب اولویت) استفاده می‌کند:

  • /etc/pcpdbi.conf
  • $PCP_PMDAS_DIR/mysql/mysql.conf

این فایل می‌تواند حاوی مقادیر بازنویسی‌شده (کد Perl) برای تنظیمات فهرست‌شده در ابتدای pmdamysql.pl باشد، از جمله:

  • نام پایگاه داده (برای جزئیات به DBI(3) مراجعه کنید، پیش‌فرض "DBI:mysql:mysql" است)
  • نام کاربری پایگاه داده (پیش‌فرض "dbmonitor" است)
  • رمز عبور پایگاه داده (پیش‌فرض "dbmonitor" است)
  • حساب کاربری ورود (پیش‌فرض "pcp" است)

در برخی نگارش‌های MariaDB (+10) طرح‌واره کارایی (performance schema) به صورت پیش‌فرض غیرفعال است و برای عملکرد PMDA باید فعال گردد. این امر با افزودن رشته "performance_schema" به بخش "[mysqld]" فایل پیکربندی MariaDB (یا my.cnf یا my.ini) حاصل می‌شود. عبارت SQL با عنوان "SHOW ENGINES" پشتیبانی از طرح‌واره کارایی را نمایش می‌دهد.

پس از تکمیل این اقدامات اولیه راه‌اندازی، می‌توانید با انجام اقدامات زیر با دسترسی کاربر ریشه (root)، به نام‌ها و مقادیر معیارهای کارایی mysql دسترسی پیدا کنید:

# cd $PCP_PMDAS_DIR/mysql
# ./Install

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

# cd $PCP_PMDAS_DIR/mysql
# ./Remove

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

برخی از مقادیر وضعیت به صورت YES/NO یا ON/OFF هستند.

از آنجا که این مقادیر توسط ابزارهایی مانند pmie(1) قابل تفسیر نیستند، با یک پسوند _num و مقادیر 1 (YES/ON) یا 0 (NO/OFF) تکرار شده‌اند.

  • mysql.slave_status.slave_io_running
  • mysql.slave_status.slave_io_running_num

/etc/pcpdbi.conf
فایل پیکربندی برای تمامی ناظرهای پایگاه داده PCP
$PCP_PMDAS_DIR/mysql/mysql.conf
فایل پیکربندی برای pmdamysql
$PCP_PMDAS_DIR/mysql/Install
اسکریپت نصب برای عامل pmdamysql
$PCP_PMDAS_DIR/mysql/Remove
اسکریپت حذف نصب برای عامل pmdamysql
$PCP_LOG_DIR/pmcd/mysql.log
فایل گزارش پیش‌فرض برای پیام‌های خطای pmdamysql

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

PCPIntro(1)، pmcd(1)، pmdadbping(1)، pmie(1) و DBI(3).

PCP Performance Co-Pilot