PMSNAP(1) General Commands Manual PMSNAP(1)

pmsnap - تولید تصاویر فوری خلاصه عملکرد

$PCP_BINADM_DIR/pmsnap [-NV?] [-c configs] [-C dir] [-f format] [-n names] [-o dir]

دستور pmsnap یک شل‌اسکریپت است که معمولاً به صورت دوره‌ای از طریق crontab(1) اجرا می‌شود تا تصاویر گرافیکی از نمودارهای عملکردی pmchart(1) را تولید کند. این تصاویر می‌توانند در هر یک از قالب‌های پشتیبانی‌شده توسط pmchart از جمله png، bmp و jpeg باشند و ممکن است در محتوای ارائه‌شده توسط وب‌سرور محلی گنجانده شوند. به طور پیش‌فرض، pmsnap هیچ خروجی متنی تولید نمی‌کند مگر اینکه با وضعیت خطا یا هشداری مواجه شود.

دستور pmsnap تصاویر را بر اساس فایل کنترلی خود، $PCP_PMSNAPCONTROL_PATH (یا dir/control در صورتی که گزینه -C مشخص شده باشد) تولید می‌کند و از بایگانی‌های ایجاد شده توسط pmlogger(1) یا مجموعه‌های بایگانی PCP ایجاد شده توسط pmafm(1) و pmlogger_check(1) استفاده می‌نماید. پیش از اقدام به پیکربندی pmsnap، اکیداً توصیه می‌شود که pmlogger مطابق با توضیحات موجود در pmlogger_daily(1)، pmlogger_check(1) و pmlogger(1) پیکربندی شود.

پس از اینکه pmlogger پیکربندی شد، لازم است pmsnap به شرح زیر پیکربندی گردد:

1.
فایل کنترل $PCP_PMSNAPCONTROL_PATH را ویرایش کنید. نحو این فایل در یادداشت ابتدای آن شرح داده شده و یک نمونه برای نمودارهای عملکردی «خلاصه» (Summary) یک ساعته و دوازده ساعته برای میزبان محلی ارائه شده است. آرگومان‌های مناسب برای pmchart نیز در یادداشت شرح داده شده‌اند. کاربر باید برای جزئیات بیشتر به pmchart مراجعه کند. توجه داشته باشید هنگامی که pmsnap اجرا می‌شود، در سرتاسر فایل کنترل رشته LOCALHOSTNAME را با نام میزبان محلی جایگزین می‌کند.
2.
پیکربندی را با اجرای دستور زیر آزمایش کنید:
$PCP_BINADM_DIR/pmsnap. بدون هیچ آرگومانی، pmsnap تمام خطوط غیرتوضیحی موجود در $PCP_PMSNAPCONTROL_PATH را پردازش خواهد کرد. تصاویر خروجی در فایل‌هایی قرار می‌گیرند که نام آن‌ها در فیلد اول هر خط از فایل کنترل مشخص شده است و در صورت لزوم، قالب فایل به انتهای آن افزوده می‌شود. اگر این نام‌های فایل با / یا . آغاز نشوند، نسبت به dir (همان‌طور که با گزینه -o مشخص شده است) نسبی در نظر گرفته می‌شوند. مقدار پیش‌فرض dir دایرکتوری جاری است. توجه داشته باشید که اگر pmlogger به تازگی راه‌اندازی شده باشد (طی حدود ۱۵ دقیقه گذشته)، ممکن است تصاویر فوری تولید نشوند و هیچ پیام خطایی نیز صادر نگردد؛ دلیل آن این است که pmchart نمی‌تواند از بایگانی‌های بسیار کوتاه استفاده کند و بنابراین pmsnap نیز نمی‌تواند. برای اهداف عیب‌یابی، باید از پرچم -V استفاده شود.
3.
یک مدخل مناسب برای pmsnap در crontab کاربر root اضافه کنید. یک نمونه در $PCP_VAR_DIR/config/pmlogger/crontab ارائه شده است.
4.
تصاویر pmsnap را در محتوای وب محلی بگنجانید. معمولاً صفحات وب از تصاویری استفاده می‌کنند که نسبت به یک ریشه سند (document root) خاص نسبی هستند، بنابراین اغلب مناسب است که از گزینه خط فرمان -o برای مشخص کردن یک زیردایرکتوری از محتوای وب محلی استفاده شود، و سپس در این دایرکتوری یک صفحه وب ایجاد شود که تصاویر فوری را به همراه متن و سایر محتوای متناسب با محیط محلی نمایش دهد.

یک نمونه صفحه HTML مناسب برای تصویر فوری خلاصه را می‌توان در $PCP_VAR_DIR/config/pmsnap/Summary.html یافت.

اگرچه pmsnap تلاش می‌کند تا پیش از تولید تصاویر فوری، بافرهای خروجی stdio(3) را در فرایندهای مرتبط pmlogger تخلیه (flush) کند، اما این عمل ممکن است به دلایل گوناگون ناموفق باشد و هیچ پیام خطایی نمایش داده نخواهد شد.

دستور pmsnap نباید بلافاصله پس از اینکه pmlogger_daily لاگ‌ها را چرخش داد فراخوانی شود، زیرا بایگانی‌های جدید برای به دست آوردن نتایج معنادار بسیار کوتاه خواهند بود. با این حال توجه داشته باشید که pmsnap خطاهای pmchart مبنی بر عدم توانایی در اجرای گزینه -A روی بایگانی‌های بسیار کوتاه را گزارش نخواهد کرد. در این موارد هیچ خطایی گزارش نشده و هیچ تصویر خروجی تولید نخواهد شد.

گزینه‌های موجود در خط فرمان عبارتند از:

تنها خطوطی از فایل کنترل را پردازش می‌کند که در ستون Config با عبارت باقاعده config-pattern مطابقت داشته باشند.
فایل control به جای مکان پیش‌فرض $PCP_PMSNAPCONTROL_PATH در دایرکتوری dir قرار دارد.
قالب تصویر خروجی را تعیین می‌کند. قالب پیش‌فرض png است.
تنها خطوطی از فایل کنترل را پردازش می‌کند که در ستون Name با عبارت باقاعده name-pattern (رجوع کنید به egrep(1)) مطابقت داشته باشند.
حالت «نمایش عملکرد» (show me) را فعال می‌کند، که در آن اقدامات مانند شیوه «make -n» تنها نمایش داده می‌شوند اما اجرا نمی‌گردند. استفاده از -N همراه با -V قابلیت‌های خطایابی را برای عیب‌یابی به حداکثر می‌رساند.
تصاویر خروجی که نام فایل آن‌ها با / یا . آغاز نمی‌شود، در دایرکتوری‌ای به صورت نسبی نسبت به dir قرار می‌گیرند؛ در غیر این صورت دایرکتوری خروجی نسبت به دایرکتوری جاری در نظر گرفته می‌شود (یعنی مقدار پیش‌فرض برای dir برابر ./ است). توجه داشته باشید که dir باید یک مسیر دایرکتوری قابل نوشتن باشد و می‌تواند روی یک فایل‌سیستم NFS یا CIFS قرار داشته باشد.
حالت پرگو (verbose) را فعال می‌کند.
-?
نمایش پیام راهنمای نحوه استفاده و خروج.

هنگامی که هر یک از گزینه‌های -n یا -c استفاده شوند، pmsnap تنها خطوطی از فایل کنترل را پردازش می‌کند که با تمام الگوهای ارائه‌شده مطابقت داشته باشند. اگر هیچ الگویی ارائه نشود، تمام خطوط پردازش خواهند شد. این آرگومان‌ها امکان تعریف چندین مدخل برای pmsnap را در crontab فراهم می‌کنند تا تصاویر مختلف خلاصه عملکرد بتوانند در زمان‌های متفاوت یا با بسامدهای گوناگون تولید شوند.

$PCP_PMSNAPCONTROL_PATH
فایل کنترل pmsnap
$PCP_VAR_DIR/config/pmsnap/Summary
نمای خلاصه برای pmchart
$PCP_VAR_DIR/config/pmsnap/Summary.html
صفحه نمونه HTML برای تصویر فوری خلاصه
$PCP_LOG_DIR/pmlogger/<hostname>/Latest
مجموعه بایگانی PCP برای میزبان hostname، تولید شده توسط pmlogger_check
$PCP_VAR_DIR/config/pmlogger/crontab
نمونه مدخل crontab

cron(1)، crontab(1)، egrep(1)، pmafm(1)، pmchart(1)، pmlc(1)، pmlogger(1) و pmlogger_daily(1).

Performance Co-Pilot