PMDADB2(1) General Commands Manual PMDADB2(1)

pmdadb2 - عامل دامنه معیارهای کارایی (PMDA) برای پایگاه داده IBM Db2

دستور pmdadb2 یک عامل دامنه معیارهای کارایی (PMDA) برای Performance Co-Pilot (PCP) است که داده‌های زنده کارایی را از یک کارساز پایگاه داده IBM Db2 در حال اجرا با استفاده از توابع جدول پایش Db2 (MON_GET_*) استخراج می‌کند.

معیارها در گروه‌های زیر سازماندهی شده‌اند:

معیارهای هویتی در سطح نمونه (instance) از ENV_GET_INSTANCE_INFO، شامل نام نمونه، رشته کامل سطح سرویس (نسخه) و پلتفرم اجرایی. این‌ها معیارهای PM_SEM_DISCRETE هستند: آن‌ها تنها یک‌بار در شروع ضبط و پس از آن فقط در صورت تغییر ثبت می‌شوند.
شمارنده‌های تجمیعی در سطح کل پایگاه داده از MON_GET_DATABASE، شامل تراکنش‌ها، عملیات سطرها، فعالیت‌های مرتب‌سازی، قفل‌گذاری، کارایی حافظه موقت بسته (package cache) و I/O مستقیم. دامنه نمونه شامل یک مدخل به ازای هر نام پایگاه داده پایش‌شده است.
شمارنده‌های مربوط به هر استخر بافر (buffer pool) از MON_GET_BUFFERPOOL، شامل خواندن‌ها و نوشتن‌های منطقی و فیزیکی برای صفحات داده، شاخص و سازمان‌یافته ستونی، همراه با زمان‌های خواندن/نوشتن استخر و صفحات پیش‌واکشی‌شده (prefetch) خوانده‌نشده. نام‌های نمونه به صورت dbname::bpname هستند.
شمارنده‌های مربوط به هر جدول از MON_GET_TABLE، شامل عملیات سطر، فعالیت‌های قفل، دسترسی‌های سرریز (overflow) و پویش‌های کامل جدول (full-table scan). جدول‌های سیستمی (با پیشوند طرحواره SYS) نادیده گرفته می‌شوند. نام‌های نمونه به صورت dbname::tabschema.tabname هستند.
شمارنده‌های مربوط به هر بار کاری (workload) از MON_GET_WORKLOAD، شامل عملیات سطر، زمان CPU و تعداد تراکنش‌ها. نام‌های نمونه به صورت dbname::workload_name هستند.
شمارنده‌های I/O مربوط به هر فضای جدول (tablespace) از MON_GET_TABLESPACE، شامل عملیات و زمان‌های خواندن/نوشتن در استخر بافر و مستقیم. نام‌های نمونه به صورت dbname::tablespace_name هستند.
شمارنده‌های مربوط به هر اتصال از MON_GET_CONNECTION، شامل زمان CPU، عملیات سطر، فعالیت‌های قفل و تعداد تراکنش‌ها. نام‌های نمونه به صورت dbname::appname::handle هستند.
آمار انتظار طولانی‌مدت به ازای هر نوع چفت (latch) از MON_GET_LATCH، شامل زمان انتظار تجمعی و تعداد رویدادها. تنها انواع چفتی که حداقل یک رویداد انتظار طولانی‌مدت داشته‌اند در دامنه نمونه ظاهر می‌شوند. نام‌های نمونه به صورت dbname::latch_name هستند.
شمارنده‌های I/O گزارش تراکنش‌ها (transaction log) از MON_GET_TRANSACTION_LOG، شامل عملیات نوشتن و خواندن گزارش، تعداد I/O فیزیکی، رویدادهای پر شدن بافر، و فضای مصرف‌شده و در دسترس جاری گزارش. دامنه نمونه شامل یک مدخل به ازای هر نام پایگاه داده پایش‌شده است.
شمارنده‌های تجمیعی حافظه موقت بسته از MON_GET_PKG_CACHE_STMT، که کل حافظه موقت دستورات را بدون نیاز به یک دامنه نمونه به ازای هر دستور خلاصه می‌کند: تعداد دستورات درون حافظه موقت، کل اجراها، زمان CPU، سطرهای خوانده‌شده، عملیات مرتب‌سازی و سرریزهای مرتب‌سازی. دامنه نمونه شامل یک مدخل به ازای هر نام پایگاه داده پایش‌شده است.

در وهله اول، pmdadb2 نیازمند نصب بسته پایتون ibm_db است که راه‌انداز IBM Db2 را برای پایتون فراهم می‌کند.

pmdadb2 یک فایل پیکربندی الزامی در قالب ini را می‌خواند:

$PCP_SYSCONF_DIR/db2/db2.conf

این فایل دارای بخش‌های زیر است:

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

نام میزبان یا نشانی IP نمونه Db2.
شماره درگاه TCP شنونده نمونه Db2.
مهلت زمانی اتصال بر حسب ثانیه.

[databases] مشخص می‌کند که کدام پایگاه‌های داده در نمونه باید پایش شوند:

فهرستی جداشده با فاصله از نام پایگاه‌های داده Db2 برای پایش. تمام پایگاه‌های داده باید با استفاده از مشخصات کاربری یکسان در نام میزبان و درگاه پیکربندی‌شده قابل دسترسی باشند. نام پایگاه داده به عنوان نام نمونه برای معیارهای db2.database.*، db2.log.* و db2.pkg_cache.* و همچنین به عنوان پیشوند dbname:: در تمامی دامنه‌های نمونه به ازای هر شیء (استخرهای بافر، جدول‌ها، فضاهای جدول، بارهای کاری، اتصال‌ها، چفت‌ها) ظاهر می‌شود.

[authentication] مشخصات اعتبارسنجی کاربر Db2 را تعیین می‌کند:

نام کاربری Db2 جهت احراز هویت. کاربر باید دارای امتیاز EXECUTE روی توابع جدول MON_GET_* و مجوز DATAACCESS یا اختیارات مناسب MON_* روی پایگاه داده هدف باشد.
گذرواژه برای نام کاربری بالا.

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

# cd $PCP_PMDAS_DIR/db2
# ./Install

برای حذف نصب، دستورهای زیر باید به عنوان کاربر ریشه اجرا شوند:

# cd $PCP_PMDAS_DIR/db2
# ./Remove

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

در صورت قطع شدن ارتباط، pmdadb2 به طور خودکار برای اتصال مجدد به کارساز Db2 تلاش خواهد کرد.

$PCP_SYSCONF_DIR/db2/db2.conf
فایل پیکربندی برای عامل pmdadb2
$PCP_PMDAS_DIR/db2/Install
اسکریپت نصب برای عامل pmdadb2
$PCP_PMDAS_DIR/db2/Remove
اسکریپت بازگردانی نصب (حذف) برای عامل pmdadb2
$PCP_LOG_DIR/pmcd/db2.log
فایل گزارش پیش‌فرض برای پیام‌های عامل pmdadb2

توجه داشته باشید که مقدار معمول/پیش‌فرض برای $PCP_SYSCONF_DIR برابر /etc/pcp است، پیش‌فرض برای $PCP_PMDAS_DIR برابر /var/lib/pcp/pmdas و پیش‌فرض برای $PCP_LOG_DIR برابر /var/log/pcp است، اما این تنظیمات وابسته به پلتفرم هستند.

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

PCPIntro(1)، pmcd(1)، pmdamssql(1) و pmdapostgresql(1).

PCP Performance Co-Pilot