نام (NAME)

ganglia2pcp - وارد کردن داده‌های ganglia و ایجاد یک آرشیو PCP

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

ganglia2pcp [-D debug] [-d outdir] [-e end] [-f outfile] [-h hostname] [-s start] [-V version] [-Z timezone] input_dir

توضیحات (DESCRIPTION)

دستور ganglia2pcp برای خواندن مجموعه‌ای از فایل‌های ganglia ذخیره‌شده در قالب rrd و تبدیل آن‌ها به یک آرشیو Performance Co-Pilot (PCP) با نام پایه outfile طراحی شده است.

هدف این مبدل، دریافت تمامی فایل‌های rrd موجود در input_dir و ایجاد یک فایل آرشیو واحد pcp است. نگاشت متریک‌های ganglia به متریک‌های pcp به‌صورت داخلی تعریف شده است.

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

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

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

ganglia2pcp یک اسکریپت Perl است که از پوشش‌دهنده پرل PCP::LogImport پیرامون کتابخانه libpcp_import در PCP استفاده می‌کند، و از این رو می‌تواند به‌عنوان نمونه‌ای برای توسعه ابزارهای جدید جهت وارد کردن سایر انواع داده‌های کارایی و ایجاد آرشیوهای PCP استفاده شود. پوشش‌دهنده پرل RRDs نیز برای تحلیل فایل‌های خام قالب rrd به کار می‌رود.

گزینه‌ها (OPTIONS)

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

-d outdir

آرگومان outdir دایرکتوری خروجی را برای نوشتن مشخص می‌کند. پیش‌فرض، دایرکتوری جاری است.

-e end

آرگومان end زمان پایان را در قالبی قابل فهم برای str2time مشخص می‌کند. زمان پیش‌فرض پایان، زمان جاری است.

-f outfile

آرگومان outfile نام فایل خروجی را مشخص می‌کند. نام پیش‌فرض در قالب استاندارد pmlogger بر اساس زمان شروع است، مانند 20150201.00.10.

-h hostname

آرگومان hostname نام میزبانی را که باید در آرشیو ثبت شود مشخص می‌کند. پیش‌فرض از نام دایرکتوری محل قرارگیری فایل‌های rrd برداشته می‌شود.

-s start

آرگومان start زمان شروع را در قالبی قابل فهم برای str2time مشخص می‌کند. زمان پیش‌فرض شروع، ۲۴ ساعت قبل از زمان جاری است.

-V version

گزینه -V نسخه آرشیو PCP خروجی را مشخص می‌کند. به‌طور پیش‌فرض، نسخه آرشیو $PCP_ARCHIVE_VERSION (که در انتشار‌های فعلی PCP برابر ۳ تنظیم شده) استفاده می‌شود، و تنها مقادیر معتبر در حال حاضر برای version برابر ۲ یا ۳ هستند.

-Z timezone

آرگومان timezone منطقه زمانی مبدا را در آرشیو PCP تعیین می‌کند (پیش‌فرض استفاده از منطقه زمانی محلی است). منطقه زمانی باید قالبی مانند +HHMM (برای ساعت و دقیقه در شرق UTC) یا -HHMM (برای ساعت و دقیقه در غرب UTC) یا UTC داشته باشد. به‌ویژه توجه داشته باشید که نه قالب zoneinfo (معروف به Olson مانند Europe/Paris) و نه قالب Posix مربوط به TZ (مانند EST+5) مجاز نیستند. مثال: timezone=``+1100''.

محیط PCP (PCP ENVIRONMENT)

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

گزینه‌های اشکال‌زدایی (DEBUGGING OPTIONS)

گزینه -D یا --debug خروجی پیام‌های عیب‌یابی اضافی را روی stderr برای کمک به ریشه‌یابی مشکلات فعال می‌کند، اگرچه این اطلاعات گاهی مبهم است و در درجه اول برای راهنمایی توسعه‌دهندگان در نظر گرفته شده تا کاربران نهایی. debug یک لیست جدا شده با کاما از گزینه‌های اشکال‌زدایی است؛ از pmdbg(1) همراه با گزینه -l برای دریافت فهرستی از گزینه‌های اشکال‌زدایی موجود و معانی آن‌ها استفاده کنید.

گزینه‌های اشکال‌زدایی اختصاصی ganglia2pcp عبارتند از:

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

pmie(1), pmchart(1), pmlogger(1), pmlogextract(1), pmlogsummary(1), Date::Parse(3pm), Date::Format(3pm), PCP::LogImport(3pm), RRDs(3pm) و LOGIMPORT(3).