نام (NAME)

sar2pcp - وارد کردن داده‌های sar و ساخت یک بایگانی PCP

خلاصه دستور (SYNOPSIS)

sar2pcp infile outfile

توضیحات (DESCRIPTION)

ابزار sar2pcp برای خواندن یک فایل داده باینری گزارش‌گیری فعالیت سامانه (sar) که توسط sadc(1) ایجاد شده است (infile) و تبدیل آن به یک بایگانی Performance Co-Pilot (PCP) با نام پایه outfile طراحی شده است.

با این حال، اگر infile دارای پسوند «‎.xml» باشد، در نظر گرفته می‌شود که از پیش در قالب XML است و sar2pcp مستقیماً روی آن عملیات انجام می‌دهد.

بایگانی PCP حاصل می‌تواند با تمام ابزارهای کلاینت PCP جهت رسم نمودار از زیرمجموعه داده‌ها با استفاده از pmchart(1)، کاهش حجم داده‌ها و گزارش‌گیری، فیلتر کردن با موتور استنتاج PCP یعنی pmie(1) و موارد دیگر به کار رود.

مجموعه‌ای از فایل‌های فیزیکی با پیشوند outfile ایجاد خواهند شد. این فایل‌ها عبارتند از outfile.0 (داده‌های کارایی)، outfile.meta (متاداده‌ای که داده‌های کارایی را توصیف می‌کند) و outfile.index (یک نمایه‌ زمانی برای بهبود کارایی عملیات بازپخش بایگانی). اگر هر یک از این فایل‌ها از قبل وجود داشته باشد، sar2pcp روی آن‌ها بازنویسی نخواهد کرد (not overwrite) و با یک پیام خطا با قالبی مشابه زیر خارج می‌شود:

_&__pmLogNewFile: ``blah.0'' already exists, not over-written

ابزار sar2pcp یک اسکریپت Perl است که از پوشش Perl به نام PCP::LogImport در اطراف کتابخانه PCP libpcp_import استفاده می‌کند، و به همین جهت می‌تواند به عنوان یک الگو برای توسعه ابزارهای جدید جهت وارد کردن انواع دیگر داده‌های کارایی و ایجاد بایگانی‌های PCP به کار رود. یک ماژول پوشش Python نیز در دسترس است.

نکات (NOTES)

از نسخه 12.0.5 بسته sysstat، به sadc(1) قابلیتی برای نوشتن مستقیم فایل‌های بایگانی PCP افزوده شده است. برای تولید فایل‌های بایگانی از sar، دستور زیر را اجرا کنید:

$ sadf -l -O pcparchive=ARCHIVE_NAME sar.dat -- -A

هشدارها (CAVEATS)

در صورت عدم استفاده از گزینه ورودی XML، دستور sar2pcp نیازمند این است که infile توسط نسخه‌ای از sadc(1) برگرفته از http://sebastien.godard.pagesperso-orange.fr ایجاد شده باشد که شامل ابزار sadf(1) برای تبدیل infile به یک جریان XML است (هر نسخه‌ای از نسخه 6 به بعد)؛ sar2pcp به طور خودکار sadf(1) را اجرا کرده و XML حاصل را به یک بایگانی PCP تبدیل خواهد کرد.

هنگام استفاده از فایل‌های باینری sadc، بسیار مهم است اطمینان حاصل شود که sadf نصب‌شده با نسخه sadc که در ابتدا فایل‌های باینری را ایجاد کرده سازگار باشد. صرفاً با این فرض که نسخه جدیدترِ نصب‌شده کار خواهد کرد متأسفانه بیش از حد خوش‌بینانه است؛ و همچنین نباید فرض کرد که داده‌های باینری از سکوهای مختلف (مثلاً با ترتیب بایت یا endianness متفاوت) کار خواهند کرد - این مسائل به دلیل محدودیت‌های موجود در sadc و sadf است، نه خود sar2pcp.

خوشبختانه، پیام sadf که نشان می‌دهد ناسازگاری تشخیص داده شده است، در بین تمام نسخه‌ها یکنواخت بوده و همواره دارای پیشوند زیر است:

Invalid system activity file

استفاده از یک infile با قالب XML این مزیت را دارد که نسخه نصب‌شده sadf به طور کامل نادیده گرفته می‌شود. sar2pcp متعهد است که هر XML معتبر تولید شده توسط هر یک از نگارش‌های مختلف sadf را به یک بایگانی معتبر PCP تبدیل کند. هر نسخه‌ای از PCP قادر خواهد بود فایل‌های بایگانی تولید شده توسط هر نسخه‌ای از sar2pcp را تفسیر کند، و همچنین شما آزاد هستید بایگانی باینری PCP را بین سکوهای مختلف، سخت‌افزارهای مختلف و حتی سیستم‌عامل‌های گوناگون انتقال دهید - و بدون هیچ مشکلی کار خواهد کرد (TM Just Works).

محیط پی‌سی‌پی (PCP ENVIRONMENT)

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

برای متغیرهای محیطی مؤثر بر ابزارهای PCP، به pmGetOptions(3) مراجعه کنید.

همچنین ببینید (SEE ALSO)

pmie(1)، pmchart(1)، pmlogger(1)، pmlogextract(1)، pmlogsummary(1)، sadc(1)، sadf(1)، sar(1)، Date::Parse(3pm)، Date::Format(3pm)، PCP::LogImport(3pm)، XML::TokeParser(3pm) و LOGIMPORT(3).