'\"macro stdmacro
.\"
.\" Copyright (c) 2026 Red Hat.  All Rights Reserved.
.\"
.\" This program is free software; you can redistribute it and/or modify it
.\" under the terms of the GNU General Public License as published by the
.\" Free Software Foundation; either version 2 of the License, or (at your
.\" option) any later version.
.\"
.\" This program is distributed in the hope that it will be useful, but
.\" WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
.\" or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
.\" for more details.
.\"
.\"
.TH PMDADB2 1 "PCP" "Performance Co-Pilot"
.SH "نام (NAME)"
pmdadb2 \- عامل دامنه معیارهای کارایی (PMDA) برای پایگاه داده IBM Db2
.SH "توضیحات (DESCRIPTION)"
دستور \fBpmdadb2\fP یک عامل دامنه معیارهای کارایی (PMDA) برای Performance Co-Pilot (PCP) است که داده‌های زنده کارایی را از یک کارساز پایگاه داده IBM Db2 در حال اجرا با استفاده از توابع جدول پایش Db2
(\fBMON_GET_*\fP)
استخراج می‌کند.
.PP
معیارها در گروه‌های زیر سازماندهی شده‌اند:
.TP 5
.B db2.instance
معیارهای هویتی در سطح نمونه (instance) از
.BR ENV_GET_INSTANCE_INFO ،
شامل نام نمونه، رشته کامل سطح سرویس (نسخه) و پلتفرم اجرایی.
این‌ها معیارهای
.B PM_SEM_DISCRETE
هستند: آن‌ها تنها یک‌بار در شروع ضبط و پس از آن فقط در صورت تغییر ثبت می‌شوند.
.TP
.B db2.database
شمارنده‌های تجمیعی در سطح کل پایگاه داده از
.BR MON_GET_DATABASE ،
شامل تراکنش‌ها، عملیات سطرها، فعالیت‌های مرتب‌سازی، قفل‌گذاری، کارایی حافظه موقت بسته (package cache) و I/O مستقیم.
دامنه نمونه شامل یک مدخل به ازای هر نام پایگاه داده پایش‌شده است.
.TP
.B db2.bufferpool
شمارنده‌های مربوط به هر استخر بافر (buffer pool) از
.BR MON_GET_BUFFERPOOL ،
شامل خواندن‌ها و نوشتن‌های منطقی و فیزیکی برای صفحات داده، شاخص و سازمان‌یافته ستونی، همراه با زمان‌های خواندن/نوشتن استخر و صفحات پیش‌واکشی‌شده (prefetch) خوانده‌نشده.
نام‌های نمونه به صورت \fIdbname\fP::\fIbpname\fP هستند.
.TP
.B db2.table
شمارنده‌های مربوط به هر جدول از
.BR MON_GET_TABLE ،
شامل عملیات سطر، فعالیت‌های قفل، دسترسی‌های سرریز (overflow) و پویش‌های کامل جدول (full-table scan).
جدول‌های سیستمی (با پیشوند طرحواره \fBSYS\fP) نادیده گرفته می‌شوند.
نام‌های نمونه به صورت \fIdbname\fP::\fItabschema.tabname\fP هستند.
.TP
.B db2.workload
شمارنده‌های مربوط به هر بار کاری (workload) از
.BR MON_GET_WORKLOAD ،
شامل عملیات سطر، زمان CPU و تعداد تراکنش‌ها.
نام‌های نمونه به صورت \fIdbname\fP::\fIworkload_name\fP هستند.
.TP
.B db2.tablespace
شمارنده‌های I/O مربوط به هر فضای جدول (tablespace) از
.BR MON_GET_TABLESPACE ،
شامل عملیات و زمان‌های خواندن/نوشتن در استخر بافر و مستقیم.
نام‌های نمونه به صورت \fIdbname\fP::\fItablespace_name\fP هستند.
.TP
.B db2.connection
شمارنده‌های مربوط به هر اتصال از
.BR MON_GET_CONNECTION ،
شامل زمان CPU، عملیات سطر، فعالیت‌های قفل و تعداد تراکنش‌ها.
نام‌های نمونه به صورت \fIdbname\fP::\fIappname\fP::\fIhandle\fP هستند.
.TP
.B db2.latch
آمار انتظار طولانی‌مدت به ازای هر نوع چفت (latch) از
.BR MON_GET_LATCH ،
شامل زمان انتظار تجمعی و تعداد رویدادها.
تنها انواع چفتی که حداقل یک رویداد انتظار طولانی‌مدت داشته‌اند در دامنه نمونه ظاهر می‌شوند.
نام‌های نمونه به صورت \fIdbname\fP::\fIlatch_name\fP هستند.
.TP
.B db2.log
شمارنده‌های I/O گزارش تراکنش‌ها (transaction log) از
.BR MON_GET_TRANSACTION_LOG ،
شامل عملیات نوشتن و خواندن گزارش، تعداد I/O فیزیکی، رویدادهای پر شدن بافر، و فضای مصرف‌شده و در دسترس جاری گزارش.
دامنه نمونه شامل یک مدخل به ازای هر نام پایگاه داده پایش‌شده است.
.TP
.B db2.pkg_cache
شمارنده‌های تجمیعی حافظه موقت بسته از
.BR MON_GET_PKG_CACHE_STMT ،
که کل حافظه موقت دستورات را بدون نیاز به یک دامنه نمونه به ازای هر دستور خلاصه می‌کند: تعداد دستورات درون حافظه موقت، کل اجراها، زمان CPU، سطرهای خوانده‌شده، عملیات مرتب‌سازی و سرریزهای مرتب‌سازی.
دامنه نمونه شامل یک مدخل به ازای هر نام پایگاه داده پایش‌شده است.
.SH "پیکربندی (CONFIGURATION)"
در وهله اول، \f3pmdadb2\f1 نیازمند نصب بسته پایتون
.B ibm_db
است که راه‌انداز IBM Db2 را برای پایتون فراهم می‌کند.
.PP
\fBpmdadb2\fP یک فایل پیکربندی الزامی در قالب ini را می‌خواند:
.IP
.PD 0
.IP
.I \f(CR$PCP_SYSCONF_DIR\fP/db2/db2.conf
.PD
.PP
این فایل دارای بخش‌های زیر است:
.PP
.B [connection]
نحوه دسترسی به کارساز Db2 را مشخص می‌کند
(مقدارهای پیش‌فرض درون پرانتز نشان داده شده‌اند):
.TP 15
.B hostname \fR(\fP\fIlocalhost\fP\fR)\fP
نام میزبان یا نشانی IP نمونه Db2.
.TP
.B port \fR(\fP\fI50000\fP\fR)\fP
شماره درگاه TCP شنونده نمونه Db2.
.TP
.B timeout \fR(\fP\fI5\fP\fR)\fP
مهلت زمانی اتصال بر حسب ثانیه.
.PP
.B [databases]
مشخص می‌کند که کدام پایگاه‌های داده در نمونه باید پایش شوند:
.TP 15
.B names
فهرستی جداشده با فاصله از نام پایگاه‌های داده Db2 برای پایش.
تمام پایگاه‌های داده باید با استفاده از مشخصات کاربری یکسان در نام میزبان و درگاه پیکربندی‌شده قابل دسترسی باشند.
نام پایگاه داده به عنوان نام نمونه برای معیارهای
.BR db2.database.* ،
.BR db2.log.*
و
.BR db2.pkg_cache.*
و همچنین به عنوان پیشوند
.I dbname::
در تمامی دامنه‌های نمونه به ازای هر شیء
(استخرهای بافر، جدول‌ها، فضاهای جدول، بارهای کاری، اتصال‌ها، چفت‌ها) ظاهر می‌شود.
.PP
.B [authentication]
مشخصات اعتبارسنجی کاربر Db2 را تعیین می‌کند:
.TP 15
.B username
نام کاربری Db2 جهت احراز هویت.
کاربر باید دارای امتیاز
.B EXECUTE
روی توابع جدول
.B MON_GET_*
و مجوز
.B DATAACCESS
یا اختیارات مناسب
.B MON_*
روی پایگاه داده هدف باشد.
.TP
.B password
گذرواژه برای نام کاربری بالا.
.SH "نصب (INSTALLATION)"
برای نصب، دستورهای زیر باید به عنوان کاربر ریشه (root) اجرا شوند:
.sp 1
.RS +4
.ft B
.nf
# cd $PCP_PMDAS_DIR/db2
# ./Install
.fi
.ft P
.RE
.sp 1
برای حذف نصب، دستورهای زیر باید به عنوان کاربر ریشه اجرا شوند:
.sp 1
.RS +4
.ft B
.nf
# cd $PCP_PMDAS_DIR/db2
# ./Remove
.fi
.ft P
.RE
.sp 1
\fBpmdadb2\fP توسط \fBpmcd\fP(1) راه‌اندازی می‌شود و هرگز نباید مستقیماً اجرا گردد.
اسکریپت‌های \fBInstall\fP و \fBRemove\fP هنگام نصب یا حذف عامل، به \fBpmcd\fP(1) اطلاع می‌دهند.
.PP
در صورت قطع شدن ارتباط، \fBpmdadb2\fR به طور خودکار برای اتصال مجدد به کارساز Db2 تلاش خواهد کرد.
.SH "فایل‌ها (FILES)"
.TP 5
.I \f(CR$PCP_SYSCONF_DIR\fP/db2/db2.conf
فایل پیکربندی برای عامل \fBpmdadb2\fR
.TP
.I \f(CR$PCP_PMDAS_DIR\fP/db2/Install
اسکریپت نصب برای عامل \fBpmdadb2\fR
.TP
.I \f(CR$PCP_PMDAS_DIR\fP/db2/Remove
اسکریپت بازگردانی نصب (حذف) برای عامل \fBpmdadb2\fR
.TP
.I \f(CR$PCP_LOG_DIR\fP/pmcd/db2.log
فایل گزارش پیش‌فرض برای پیام‌های عامل \fBpmdadb2\fR
.PP
توجه داشته باشید که مقدار معمول/پیش‌فرض برای \fB$PCP_SYSCONF_DIR\fP برابر
.B /etc/pcp
است، پیش‌فرض برای \fB$PCP_PMDAS_DIR\fP برابر
.B /var/lib/pcp/pmdas
و پیش‌فرض برای \fB$PCP_LOG_DIR\fP برابر
.B /var/log/pcp
است، اما این تنظیمات وابسته به پلتفرم هستند.
.SH "محیط PCP (PCP ENVIRONMENT)"
متغیرهای محیطی با پیشوند \fBPCP_\fR برای پارامتربندی نام فایل‌ها و دایرکتوری‌های مورداستفاده PCP به کار می‌روند.
در هر نصب، فایل \fI/etc/pcp.conf\fR حاوی مقدارهای محلی این متغیرها است.
از متغیر \fB$PCP_CONF\fR می‌توان برای تعیین یک فایل پیکربندی جایگزین استفاده کرد، همان‌طور که در \fBpcp.conf\fR(5) شرح داده شده است.
.SH "همچنین ببینید (SEE ALSO)"
.BR PCPIntro (1)،
.BR pmcd (1)،
.BR pmdamssql (1)
و
.BR pmdapostgresql (1).

.\" control lines for scripts/man-spell
.\" +ok+ pmdadb2 ibm_db Db2 db2 TCPIP MON_GET tabschema tabname appname DATAACCESS PCP_SYSCONF_DIR dbname bpname ENV_GET_INSTANCE_INFO
.\" +ok+ MON_GET_DATABASE MON_GET_BUFFERPOOL MON_GET_TABLE MON_GET_WORKLOAD
.\" +ok+ MON_GET_TABLESPACE MON_GET_CONNECTION MON_GET_TRANSACTION_LOG