نام (NAME)

pmdamssql - عامل دامنه معیارهای عملکرد (PMDA) برای پایگاه‌داده Microsoft SQL Server

توضیحات (DESCRIPTION)

pmdamssql یک عامل دامنه معیارهای عملکرد (PMDA) در Performance Co-Pilot (PCP) است که داده‌های عملکرد زنده را از یک کارساز پایگاه‌داده Microsoft SQL Server در حال اجرا استخراج می‌کند.

پیکربندی (CONFIGURATION)

در وهله نخست، pmdamssql نیازمند نصب این بسته‌های پشتیبان است:

mssql-server: بسته اصلی پایگاه‌داده Microsoft SQL Server.
msodbcsql18، msodbcsql17 یا msodbcsql: اتصالات ODBC مایکروسافت SQL Server.
pyodbc: ماژول عمومی ODBC پایتون به همراه فعال بودن پشتیبانی از Microsoft SQL Server.

سپس، pmdamssql یک فایل پیکربندی اختیاری به سبک ini را می‌خواند:


: $PCP_PMDAS_DIR/mssql/mssql.conf

این فایل در حال حاضر شامل دو بخش است؛ یکی برای پیکربندی کتابخانه‌ای که به SQL Server متصل می‌شود، و دیگری برای احراز هویت در SQL Server.

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

driver ({ODBC Driver 17 for SQL Server}): رشته درایور ODBC.
server (tcp:localhost): رشته اتصال سوکت SQL Server.
timeout (2): تنظیم مهلت زمانی (timeout) اتصال، بر حسب ثانیه.

بخش [authentication] مقادیر مربوط به دو حالت پشتیبانی‌شده احراز هویت با SQL Server را مشخص می‌کند.

حالت پیش‌فرض، استفاده از احراز هویت SQL Server است که مستلزم ارائه نام کاربری و گذرواژه می‌باشد. تنظیمات پیکربندی مربوطه به شرح زیر هستند (مقادیر پیش‌فرض آن‌ها درون پرانتز نشان داده شده است):

username (pcp): نام کاربری برای اتصال به پایگاه‌داده.
password (خالی): گذرواژه برای اتصال به پایگاه‌داده.

توجه داشته باشید که اگر یک فایل پیکربندی SQL Server Assessments API در مسیر /var/opt/mssql/secrets/assessment یافت شود، آن‌گاه pmdamssql نام کاربری و گذرواژه را با اولویت از آن فایل می‌خواند. قالب آن صرفاً یک فایل متنی دو خطی است که خط اول شامل نام کاربری و خط دوم شامل گذرواژه است.

گزینه دوم حالت احراز هویت Windows است، که در آن شناسه‌های ورودی در SQL Server ایجاد می‌شوند که بر پایه حساب‌های کاربری سیستم‌عامل نیستند.

trusted (false): برای استفاده از احراز هویت Windows هنگام اتصال به پایگاه‌داده، این مقدار را روی true تنظیم کنید.

این یک اتصال از نوع Kerberos است و اعتبارنامه‌ها باید پیش از راه‌اندازی PMDA در دسترس باشند (برای جزئیات بیشتر kinit(1) را ببینید).

نصب (INSTALLATION)

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

# cd $PCP_PMDAS_DIR/mssql
# ./Install

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

# cd $PCP_PMDAS_DIR/mssql
# ./Remove

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

در صورتی که اتصال pmdamssql قطع شود – برای نمونه اگر سرویس SQL Server بازراه‌اندازی شود – این عامل به طور خودکار برای برقراری مجدد اتصال به SQL Server تلاش خواهد کرد.

فایل‌ها (FILES)

$PCP_PMDAS_DIR/mssql/mssql.conf: فایل پیکربندی برای عامل pmdamssql
$PCP_PMDAS_DIR/mssql/Install: اسکریپت نصب برای عامل pmdamssql
$PCP_PMDAS_DIR/mssql/Remove: اسکریپت حذف نصب برای عامل pmdamssql
$PCP_LOG_DIR/pmcd/mssql.log: فایل لاگ پیش‌فرض برای پیام‌های عامل pmdamssql

توجه داشته باشید که مقدار معمول/پیش‌فرض برای $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)، kinit(1) و pmcd(1).