'\" t
.\"
.\" Copyright (c) 2012-2013 Red Hat.
.\" Copyright (c) 2010 Ken McDonell.  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 GANGLIA2PCP 1 "PCP" "Performance Co-Pilot"
.SH "نام (NAME)"
\f3ganglia2pcp\f1 \- وارد کردن داده‌های ganglia و ایجاد یک آرشیو PCP
.SH "خلاصه دستور (SYNOPSIS)"
\&\fBganglia2pcp\fR
[\f3\-D\f1 \f2debug\f1]
[\fB\-d\fR \fIoutdir\fR]
[\fB\-e\fR \fIend\fR]
[\fB\-f\fR \fIoutfile\fR]
[\fB\-h\fR \fIhostname\fR]
[\fB\-s\fR \fIstart\fR]
[\fB\-V\fR \fIversion\fR]
[\fB\-Z\fR \fItimezone\fR]
\fIinput_dir\fR
.SH "توضیحات (DESCRIPTION)"
دستور
\&\fBganglia2pcp\fR
برای خواندن مجموعه‌ای از فایل‌های ganglia ذخیره‌شده در قالب
rrd
و تبدیل آن‌ها به یک آرشیو Performance Co-Pilot (\s-1PCP\s0) با نام پایه
\fIoutfile\fR
طراحی شده است.
.PP
هدف این مبدل، دریافت تمامی فایل‌های rrd موجود در
\fIinput_dir\fR
و ایجاد یک فایل آرشیو واحد pcp است.
نگاشت متریک‌های ganglia به متریک‌های pcp به‌صورت داخلی تعریف شده است.
.PP
آرشیو \s-1PCP\s0 حاصل می‌تواند همراه با تمام ابزارهای کلاینت \s-1PCP\s0 برای رسم نمودار زیرمجموعه‌هایی از داده‌ها با استفاده از
\fBpmchart\fR(1)،
انجام تلخیص داده‌ها و گزارش‌گیری، فیلتر کردن با موتور استنتاج \s-1PCP\s0 به نام
\fBpmie\fR(1)
و غیره به کار رود.
.PP
مجموعه‌ای از فایل‌های فیزیکی با پیشوند
\fIoutfile\fR
ایجاد خواهند شد. این فایل‌ها عبارتند از:
\fIoutfile\fR\fB.0\fR
(داده‌های کارایی)،
\&\fIoutfile\fR\fB.meta\fR
(متاداده‌ای که داده‌های کارایی را توصیف می‌کند) و
\&\fIoutfile\fR\fB.index\fR
(یک نمایه زمانی برای بهبود کارایی عملیات بازپخش در آرشیو).
اگر هر یک از این فایل‌ها از قبل وجود داشته باشد،
\fBganglia2pcp\fR
روی آن‌ها بازنویسی \fBنخواهد کرد\fR و با پیام خطایی به شکل زیر خارج می‌شود:
.PP
__pmLogNewFile: ``blah.0'' already exists, not over-written
.PP
\&\fBganglia2pcp\fR
یک اسکریپت Perl است که از پوشش‌دهنده پرل PCP::LogImport پیرامون کتابخانه
\fIlibpcp_import\fR
در \s-1PCP\s0 استفاده می‌کند، و از این رو می‌تواند به‌عنوان نمونه‌ای برای توسعه ابزارهای جدید جهت وارد کردن سایر انواع داده‌های کارایی و ایجاد آرشیوهای \s-1PCP\s0 استفاده شود.
پوشش‌دهنده پرل RRDs نیز برای تحلیل فایل‌های خام قالب rrd به کار می‌رود.
.SH "گزینه‌ها (OPTIONS)"
گزینه‌های موجود خط فرمان عبارتند از:
.TP 5
\fB\-d\fR \fIoutdir\fR
آرگومان
.I outdir
دایرکتوری خروجی را برای نوشتن مشخص می‌کند.
پیش‌فرض، دایرکتوری جاری است.
.TP
\fB\-e\fR \fIend\fR
آرگومان
.I end
زمان پایان را در قالبی قابل فهم برای str2time مشخص می‌کند.
زمان پیش‌فرض پایان، زمان جاری است.
.TP
\fB\-f\fR \fIoutfile\fR
آرگومان
.I outfile
نام فایل خروجی را مشخص می‌کند.
نام پیش‌فرض در قالب استاندارد pmlogger بر اساس زمان شروع است، مانند 20150201.00.10.
.TP
\fB\-h\fR \fIhostname\fR
آرگومان
.I hostname
نام میزبانی را که باید در آرشیو ثبت شود مشخص می‌کند.
پیش‌فرض از نام دایرکتوری محل قرارگیری فایل‌های rrd برداشته می‌شود.
.TP
\fB\-s\fR \fIstart\fR
آرگومان
.I start
زمان شروع را در قالبی قابل فهم برای str2time مشخص می‌کند.
زمان پیش‌فرض شروع، ۲۴ ساعت قبل از زمان جاری است.
.TP
\fB\-V\fR \fIversion\fR
گزینه
.B \-V
نسخه آرشیو PCP خروجی را مشخص می‌کند.
به‌طور پیش‌فرض، نسخه آرشیو
.B $PCP_ARCHIVE_VERSION
(که در انتشار‌های فعلی PCP برابر ۳ تنظیم شده) استفاده می‌شود، و تنها مقادیر معتبر در حال حاضر برای
.I version
برابر ۲ یا ۳ هستند.
.TP
\fB\-Z\fR \fItimezone\fR
آرگومان
.I timezone
منطقه زمانی مبدا را در آرشیو \s-1PCP\s0 تعیین می‌کند (پیش‌فرض استفاده از منطقه زمانی محلی است).
منطقه زمانی باید قالبی مانند +HHMM (برای ساعت و دقیقه در شرق \s-1UTC\s0) یا \-HHMM (برای ساعت و دقیقه در غرب \s-1UTC\s0) یا \s-1UTC\s0 داشته باشد.
به‌ویژه توجه داشته باشید که \fBنه\fR قالب \fBzoneinfo\fR (معروف به Olson مانند Europe/Paris) و \fBنه\fR قالب Posix مربوط به \fB\s-1TZ\s0\fR (مانند \s-1EST+5\s0) مجاز نیستند.
مثال: timezone=``+1100''.
.SH "محیط PCP (PCP ENVIRONMENT)"
متغیرهای محیطی با پیشوند
\fBPCP_\fP
برای پارامتریک کردن نام فایل‌ها و دایرکتوری‌های مورد استفاده PCP به کار می‌روند.
در هر نصب، فایل
\fI/etc/pcp.conf\fP
حاوی مقادیر محلی برای این متغیرها است.
متغیر
\fB$PCP_CONF\fP
می‌تواند برای تعیین یک فایل پیکربندی جایگزین استفاده شود، همان‌گونه که در
\fBpcp.conf\fP(5)
توصیف شده است.
.SH "گزینه‌های اشکال‌زدایی (DEBUGGING OPTIONS)"
گزینه
.B \-D
یا
.B \-\-debug
خروجی پیام‌های عیب‌یابی اضافی را روی
.I stderr
برای کمک به ریشه‌یابی مشکلات فعال می‌کند، اگرچه این اطلاعات گاهی مبهم است و در درجه اول برای راهنمایی توسعه‌دهندگان در نظر گرفته شده تا کاربران نهایی.
.I debug
یک لیست جدا شده با کاما از گزینه‌های اشکال‌زدایی است؛ از
.BR pmdbg (1)
همراه با گزینه
.B \-l
برای دریافت فهرستی از گزینه‌های اشکال‌زدایی موجود و معانی آن‌ها استفاده کنید.
.PP
گزینه‌های اشکال‌زدایی اختصاصی
.B ganglia2pcp
عبارتند از:
.TS
box;
lf(B) | lf(B)
lf(B) | lf(R) .
Option	Description
_
appl0	راه‌اندازی و کشف متریک‌ها
_
appl1	تولید مقادیر متریک
.TE
.SH "همچنین ببینید (SEE ALSO)"
.BR pmie (1),
.BR pmchart (1),
.BR pmlogger (1),
.BR pmlogextract (1),
.BR pmlogsummary (1),
.BR Date::Parse (3pm),
.BR Date::Format (3pm),
.BR PCP::LogImport (3pm),
.BR RRDs (3pm)
و
.BR LOGIMPORT (3).

.\" control lines for scripts/man-spell
.\" +ok+ EST HHMM RRDs achive aka rrd
.\" +ok+ str {from str2time}