'\"macro stdmacro
.\"
.\" 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 IOSTAT2PCP 1 "PCP" "Performance Co-Pilot"
.SH "نام (NAME)"
\f3iostat2pcp\f1 \- وارد کردن داده‌های iostat و ایجاد یک آرشیو PCP
.SH "خلاصه دستور (SYNOPSIS)"
\&\fBiostat2pcp\fR
[\fB\-v\fR]
[\fB\-S\fR \fIstart\fR]
[\fB\-t\fR \fIinterval\fR]
[\fB\-V\fR \fIversion\fR]
[\fB\-Z\fR \fItimezone\fR]
\fIinfile\fR
\fIoutfile\fR
.SH "توضیحات (DESCRIPTION)"
دستور
\&\fBiostat2pcp\fR
یک فایل متنی ایجادشده توسط
\&\fBiostat\fR(1)
(\fIinfile\fR) را خوانده و آن را به یک آرشیو Performance Co-Pilot (\s-1PCP\s0) با نام پایه
\fIoutfile\fR
تبدیل می‌کند.
اگر
\fIinfile\fR
برابر «\-» باشد،
\fBiostat2pcp\fR
از ورودی استاندارد (standard input) می‌خواند، که امکان پیش‌پردازش آسان خروجی
\fBiostat\fR(1)
با استفاده از
\fIsed\fR(1)
یا ابزارهای مشابه را فراهم می‌سازد.
.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
(یک نمایه زمانی برای بهبود کارایی عملیات بازپخش در آرشیو).
اگر هر یک از این فایل‌ها از قبل موجود باشد،
\fBiostat2pcp\fR
روی آن‌ها بازنویسی \fBنخواهد کرد\fR و با یک پیام خطا خارج می‌شود.
.PP
اولین نمونه خروجی از
\fBiostat\fR(1)
شامل خلاصه آماری از زمان بالا آمدن سیستم (boot time) است و توسط
\fBiostat2pcp\fR
نادیده گرفته می‌شود؛ بنابراین اولین مجموعه داده واقعی، دومین نمونه در خروجی
\fBiostat\fR(1)
است.
.PP
بهترین نتایج زمانی حاصل می‌شود که
\fBiostat\fR(1)
با فلگ اختصاصی
\fB\-t\fR
خود اجرا شده باشد، تا هر نمونه خروجی دارای یک برچسب زمانی (timestamp) در ابتدا باشد.
حالت حتی بهتر این است که
\fB\-t\fR
همراه با متغیر محیطی
$\fBS_TIME_FORMAT=ISO\fR
در هنگام اجرای
\fBiostat\fR(1)
تنظیم شده باشد، که در این حالت برچسب زمانی شامل منطقه زمانی نیز خواهد بود.
.PP
توجه داشته باشید که اگر
$\fBS_TIME_FORMAT=ISO\fR
همراه با گزینه
\fB\-t\fR
استفاده \fBنشود\fR،
ممکن است
\fBiostat\fR(1)
یک برچسب زمانی تحت کنترل
\fB\s-1LC_TIME\s0\fR
از لوکال سیستم تولید کند که در قالبی باشد که
\fBiostat2pcp\fR
قادر به تجزیه آن نباشد.
قالب‌های برچسب زمانی قابل قبول برای
\fBiostat2pcp\fR
با مثال‌های زیر نشان داده شده‌اند:
.IP "\fB2013\-07\-06T21:34:39+1000\fR" 4
.IX Item "2013-07-06T21:34:39+1000"
(برای حالت $\fBS_TIME_FORMAT=ISO\fR).
.IP "\fB2013\-07\-06 21:34:39\fR" 4
.IX Item "2013-07-06 21:34:39"
(برای برخی از قالب‌های اروپایی، مانند de_AT،
de_BE، de_LU و en_DK.utf8).
.IP "\fB06/07/13 21:34:39\fR" 4
.IX Item "06/07/13 21:34:39"
(برای تمام تنظیمات $\fB\s-1LC_TIME\s0\fR در لوکال‌های انگلیسی خارج از آمریکای شمالی، مانند en_AU، en_GB، en_IE، en_NZ،
en_SG و en_ZA، و تمام لوکال‌های اسپانیایی، مانند es_ES، es_MX و es_AR).
.PP
به‌طور خاص توجه داشته باشید که برخی از تنظیمات متداول $\fB\s-1LC_TIME\s0\fR در آمریکای شمالی با
\fBiostat2pcp\fR
کار \fBنخواهند کرد\fR (به‌ویژه en_US، \s-1POSIX\s0 و C) زیرا از قالب \s-1MM/DD\s0 استفاده می‌کنند که ممکن است به‌اشتباه با قالب پیش‌فرض \s-1DD/MM\s0 تبدیل شود.
این دلیل دیگری برای توصیه به تنظیم $\fBS_TIME_FORMAT=ISO\fR است.
.PP
اگر هیچ برچسب زمانی در جریان ورودی وجود نداشته باشد،
\fBiostat2pcp\fR
سعی می‌کند بازه زمانی نمونه‌ها را در صورت یافتن داده‌های پایه‌ای دیسک (گزینه
\fB\-d\fR
در
\fBiostat\fR(1))
استنتاج کند. اگر این کار ناموفق باشد، می‌توان از گزینه
\fB\-t\fR
برای تعیین بازه زمانی نمونه‌برداری
\fIinterval\fR
به ثانیه استفاده کرد. این گزینه در صورت وجود برچسب‌های زمانی در جریان ورودی نادیده گرفته می‌شود.
.PP
گزینه
\fB\-S\fR
می‌تواند برای تعیین زمان شروع اولین نمونه واقعی در
\fIinfile\fR
استفاده شود، که در آن
\fIstart\fR
باید دارای قالب \s-1HH:MM:SS\s0 باشد.
در صورت وجود برچسب‌های زمانی در جریان ورودی، این گزینه نادیده گرفته می‌شود.
.PP
گزینه
.B \-V
نسخه آرشیو PCP خروجی را مشخص می‌کند.
به‌طور پیش‌فرض، نسخه آرشیو
.B $PCP_ARCHIVE_VERSION
(که در انتشار‌های فعلی PCP برابر ۳ تنظیم شده) استفاده می‌شود، و تنها مقادیر معتبر در حال حاضر برای
.I version
برابر ۲ یا ۳ هستند.
.PP
گزینه
\fB\-Z\fR
می‌تواند برای تعیین یک منطقه زمانی استفاده شود.
این گزینه باید دارای قالب +HHMM (برای ساعت و دقیقه در شرق \s-1UTC\s0) یا \-HHMM (برای ساعت و دقیقه در غرب \s-1UTC\s0) باشد.
به‌ویژه توجه داشته باشید که برای گزینه
\fB\-Z\fR،
\fBنه\fR قالب \fBzoneinfo\fR (معروف به Olson مانند Europe/Paris) و \fBنه\fR قالب Posix مربوط به \fB\s-1TZ\s0\fR (مانند \s-1EST+5\s0) مجاز نیستند.
این گزینه در صورت یافتن برچسب‌های زمانی \s-1ISO\s0 در جریان ورودی نادیده گرفته می‌شود.
اگر منطقه زمانی مشخص نشده باشد و قابل استنتاج هم نباشد، مقدار پیش‌فرض آن \&``\s-1UTC\s0'' خواهد بود.
.PP
برخی خروجی‌های تشخیصی اضافی با گزینه
\fB\-v\fR
تولید می‌شوند.
.PP
دستور
\&\fBiostat2pcp\fR
یک اسکریپت Perl است که از پوشش‌دهنده پرل PCP::LogImport پیرامون کتابخانه
\fIlibpcp_import\fR
در \s-1PCP\s0 استفاده می‌کند، و از این رو می‌تواند به‌عنوان نمونه‌ای برای توسعه ابزارهای جدید جهت وارد کردن انواع دیگر داده‌های کارایی و ایجاد آرشیوهای \s-1PCP\s0 استفاده شود.
.SH "گزینه‌ها (OPTIONS)"
گزینه‌های موجود خط فرمان عبارتند از:
.TP 5
\fB\-S\fR \fIstart\fR
تعیین زمان شروع
.I start
برای اولین نمونه.
.TP
\fB\-t\fR \fIinterval\fR
تعیین بازه نمونه‌برداری
.I interval
به ثانیه.
.TP
\fB\-v\fR
چاپ خروجی با جزئیات کامل (verbose).
.TP
\fB\-Z\fR \fItimezone\fR
تعیین منطقه زمانی
.I timezone
مورد استفاده، توضیحات بالا را ببینید.
.SH "هشدارها (CAVEATS)"
.IX Header "CAVEATS"
دستور
\&\fBiostat2pcp\fR
نیاز دارد که
\fIinfile\fR
توسط نسخه‌ای از
\fBiostat\fR(1)
موجود در
.BR http://freshmeat.net/projects/sysstat
ایجاد شده باشد.
.PP
ابزار
\&\fBiostat2pcp\fR
قالب‌های گزارش
\fB\-c\fR (\s-1CPU\s0)،
\fB\-d\fR (دیسک)،
\fB\-x\fR (دیسک گسترش‌یافته)
و
\fB\-p\fR (پارتیشن)
(شامل انواع
\fB\-k\fR،
\fB\-m\fR،
\&\fB\-z\fR
و
\&\fB\s-1ALL\s0\fR)
را پشتیبانی می‌کند، اما از قالب گزارش
\fB\-n\fR (سامانه فایل شبکه‌ای یا Network Filesystem)
دستور
\fBiostat\fR(1)
پشتیبانی نمی‌کند؛ این یک محدودیت ناشی از تقاضا است و نه یک محدودیت فنی.
.SH "محیط PCP (PCP ENVIRONMENT)"
متغیرهای محیطی با پیشوند
\fBPCP_\fP
برای پارامتریک کردن نام فایل‌ها و دایرکتوری‌های مورد استفاده PCP به کار می‌روند.
در هر نصب، فایل
\fI/etc/pcp.conf\fP
حاوی مقادیر محلی برای این متغیرها است.
متغیر
\fB$PCP_CONF\fP
می‌تواند برای تعیین یک فایل پیکربندی جایگزین استفاده شود، همان‌گونه که در
\fBpcp.conf\fP(5)
توصیف شده است.
.SH "همچنین ببینید (SEE ALSO)"
.BR iostat (1),
.BR pmchart (1),
.BR pmie (1),
.BR pmlogger (1),
.BR sed (1),
.BR Date::Format (3pm),
.BR Date::Parse (3pm),
.BR PCP::LogImport (3pm)
و
.BR LOGIMPORT (3).

.\" control lines for scripts/man-spell
.\" +ok+ DD EST HH HHMM LC_TIME SS S_TIME_FORMAT
.\" +ok+ aka de_AT de_BE de_LU eXtended en_AU en_DK en_GB en_IE en_NZ en_SG
.\" +ok+ en_US en_ZA es_AR es_ES es_MX freshmeat utf