'\"macro stdmacro
.\"
.\" Copyright (c) 2000 Silicon Graphics, Inc.  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 PMLOGDUMP 1 "PCP" "Performance Co-Pilot"
.SH "نام (NAME)"
\f3pmlogdump\f1,
\f3pmdumplog\f1 \- استخراج و نمایش جزئیات درونی یک آرشیو معیارهای کارایی
.SH "خلاصه دستور (SYNOPSIS)"
\f3pmlogdump\f1
[\f3\-adehIilLmMrstxzV?\f1]
[\f3\-D\f1 \f2debug\f1]
[\f3\-n\f1 \f2pmnsfile\f1]
[\f3\-S\f1 \f2starttime\f1]
[\f3\-T\f1 \f2endtime\f1]
[\f3\-Z\f1 \f2timezone\f1]
\f2archive\f1
[\f2metricname\f1 ...]
.br
\f3pmlogdump\f1
[\f3\-v\f1 \f2file\f1]
.SH "توضیحات (DESCRIPTION)"
دستور
.B pmlogdump
انواع اطلاعات کنترلی، فراداده، نمایه و وضعیت را از فایل‌های یک آرشیو Performance Co-Pilot (PCP) استخراج و نمایش می‌دهد.
این آرشیو دارای نام پایه
.I archive
است و باید پیش‌تر با استفاده از
.BR pmlogger (1)
ایجاد شده باشد.
به عنوان روش دیگر،
.I archive
می‌تواند نام دایرکتوری‌ای باشد که شامل مجموعه‌ای از آرشیوهای PCP است که می‌توان آن‌ها را با
.BR pmNewContext (3)
باز کرد.
.PP
از نظر تاریخی،
.B pmlogdump
با نام
.B pmdumplog
شناخته می‌شد، اما نام دوم با دیگر دستورهای PCP که روی آرشیوهای PCP عمل می‌کنند هماهنگ نیست؛ بنابراین استفاده از
.B pmlogdump
ترجیح داده می‌شود، هرچند
.B pmdumplog
جهت سازگاری با نسخه‌های پیشین حفظ شده است.
.PP
در حالت عادی
.B pmlogdump
روی فضای نام توزیع‌شده معیارهای کارایی (PMNS) عمل می‌کند؛ با این حال اگر گزینه
.B \-n
مشخص شود، یک PMNS محلی جایگزین از فایل
.IR pmnsfile
بارگذاری می‌شود.
.PP
اگر هر گونه آرگومان
.I metricname
ارائه شود، گزارش محدود به اطلاعات مرتبط با معیارهای کارایی مشخص‌شده خواهد بود.
اگر
.I metricname
یک گره غیربرگ در فضای نام باشد (ببینید \c
.BR PMNS (5))،
آنگاه
.B pmlogdump
به‌صورت بازگشتی در فضای نام آرشیو به پایین پیمایش کرده و تمام گره‌های برگ را گزارش می‌دهد.
.PP
گزینه‌های خط فرمان مشخص می‌کنند که چه اطلاعات خاصی گزارش شود.
.SH "گزینه‌ها (OPTIONS)"
گزینه‌های خط فرمان موجود عبارتند از:
.TP 5
\fB\-a\fR, \fB\-\-all\fR
گزارش تقریباً همه‌چیز، یعنی پرچم‌های
.BR \-d ،
.BR \-i ،
.BR \-L ،
.BR \-m ،
.BR \-s
و
.BR \-t .
متن راهنمای اختیاری (\-\f3h\f1) و رشته‌های فراداده برچسب (\-\f3e\f1) به‌طور پیش‌فرض گزارش نمی‌شوند.
.TP
\fB\-d\fR, \fB\-\-descs\fR
نمایش فراداده و توضیحات برای آن دسته از معیارهای کارایی که حداقل یک بار در آرشیو ظاهر شده‌اند:
برای جزئیات بیشتر در مورد فراداده‌های توصیف‌کننده معیارها، به
.BR pmLookupDesc (3)
مراجعه کنید.
معیارها به ترتیب صعودی شناسه معیار کارایی (PMID) گزارش می‌شوند.
.TP
\fB\-e\fR, \fB\-\-labelsets\fR
نمایش فراداده برچسب، در صورتی که در آرشیو موجود باشد.
برای جزئیات بیشتر درباره سلسله‌مراتب فراداده برچسب مرتبط با معیارها، به
.BR pmLookupLabels (3)
مراجعه کنید.
.TP
\fB\-h\fR, \fB\-\-helptext\fR
نمایش متن راهنمای معیار و دامنه نمونه (instance domain) در صورت موجود بودن در آرشیو.
برای جزئیات بیشتر درباره متن راهنمای مرتبط با معیارها، به
.BR pmLookupText (3)
مراجعه کنید.
.TP
\fB\-i\fR, \fB\-\-insts\fR
نمایش دامنه‌های نمونه و هرگونه تغییر در اعضای نمونه آن‌ها در طول مدت زمان آرشیو: برای جزئیات بیشتر درباره دامنه‌های نمونه، به
.BR pmGetInDom (3)
مراجعه کنید.
دامنه‌های نمونه به ترتیب صعودی شناسه دامنه نمونه (Instance Domain Identifier) و سپس زمان صعودی برای هر مجموعه از اعضای نمونه مشاهده‌شده در یک دامنه نمونه گزارش می‌شوند.
.TP
\fB\-I\fR, \fB\-\-on-disk-insts\fR
نمایش دامنه‌های نمونه روی دیسک، که ممکن است از قالب و کدگذاری متفاوتی نسبت به آنچه از طریق واسط برنامه‌نویسی معیارهای کارایی (PMAPI) هنگام استفاده از
.BR pmGetInDom (3)
و توابع مرتبط قابل مشاهده است، استفاده کنند.
قالب روی دیسک تنها هنگام بررسی ساختار درونی آرشیوهای PCP مورد توجه است.
.TP
\fB\-l\fR, \fB\-\-label\fR
نمایش برچسب آرشیو، که نسخه قالب آرشیو، زمان و تاریخ شروع و پایان (فعلی) آرشیو، و میزبانی که مقادیر معیارهای کارایی از آن جمع‌آوری شده‌اند را نشان می‌دهد.
.TP
\fB\-L\fR
مانند
.BR \-l ،
تنها با جزئیات کمی بیشتر.
.TP
\fB\-m\fR, \fB\-\-metrics\fR
چاپ مقادیر معیارهای کارایی از آرشیو.
این گزینه پیش‌فرض نمایش است.
.RS +5n
.P
معیارهای بدون دامنه نمونه به این صورت گزارش می‌شوند:
.br
.ti +2n
[\fItimestamp\fR] \fImetric-id\fR (\fImetric-name\fR): \fBvalue1\fR \fIvalue2\fR
.P
معیارهای دارای دامنه نمونه به این صورت گزارش می‌شوند:
.br
.ti +2n
[\fItimestamp\fR] \fImetric-id\fR (\fImetric-name\fR):
.br
.ti +6n
\fBinst\fR [\fIinternal-id\fR \fBor\fR "\fIexternal-id\fR"]
\fBvalue1\fR \fIvalue2\fR
.P
مقدار \fItimestamp\fR تنها برای اولین معیار در گروهی از معیارها که برچسب زمانی مشترک دارند گزارش می‌شود.
.RE
.TP
\fB\-M\fR, \fB\-\-markrecs\fR
اگر هیچ
.I metricname
ای مشخص نشده باشد، آنگاه رکوردهای
.I <mark>
در صورت یافت شدن در
.IR archive
گزارش می‌شوند.
اگر آرگومان‌های
.I metricname
مشخص شده باشند، رکوردهای
.I <mark>
به‌طور پیش‌فرض گزارش نمی‌شوند.
گزینه
.B \-M
گزارش شدن رکوردهای
.I <mark>
را اجباری می‌کند، حتی زمانی که آرگومان‌های
.I metricname
مشخص شده باشند.
.RS +5n
.P
رکوردهای
.I <mark>
توسط
.BR pmlogger (1)،
.BR pmlogextract (1)
و ابزارهای مشابه در آرشیو PCP درج می‌شوند تا نشان‌دهنده یک گسستگیزمانی در سری زمانی مقادیر معیار باشند.
.RE
.TP
\fB\-n\fR \fIpmnsfile\fR, \fB\-\-namespace\fR=\fIpmnsfile\fR
بارگذاری یک فضای نام معیارهای کارایی جایگزین
.RB ( PMNS (5))
از فایل
.IR pmnsfile ..TP
\fB\-r\fR, \fB\-\-reverse\fR
پردازش بایگانی با ترتیب معکوس، از جدیدترین به قدیمی‌ترین مقادیر ثبت‌شدهٔ سنجه.
.TP
\fB\-s\fR, \fB\-\-sizes\fR
گزارش اندازهٔ هر رکورد فیزیکی موجود در بایگانی بر حسب بایت.
.TP
\fB\-S\fR \fIstarttime\fR, \fB\-\-start\fR=\fIstarttime\fR
هنگام استفاده از گزینهٔ
.BR \-m ،
گزارش به رکوردهایی که در
.IR starttime
یا پس از آن ثبت شده‌اند محدود خواهد شد. برای شرح کامل نحو
.IR starttime
به
.BR PCPIntro (1)
مراجعه کنید.
.TP
\fB\-t\fR
برون‌ریزی نمایهٔ زمانی (temporal index) که برای دسترسی سریع‌تر به فایل‌های بزرگ بایگانی استفاده می‌شود.
.RS
.PP
سلامت و یکپارچگی نمایه نیز بررسی خواهد شد.
در صورتی که مشخص شود نمایه آسیب دیده است، فایل \(lq*.index\(rq را می‌توان تغییر نام داد
یا حذف کرد و بایگانی همچنان قابل دسترس خواهد بود؛ هرچند بدون وجود نمایه، بازیابی داده‌ها
ممکن است زمان بیشتری ببرد.
با این حال، توجه داشته باشید که نمایهٔ زمانی آسیب‌دیده معمولاً نشان‌دهندهٔ مشکلی عمیق‌تر
است که ممکن است بر تمامی فایل‌های یک بایگانی PCP اثر بگذارد.
.RE
.TP
\fB\-T\fR \fIendtime\fR, \fB\-\-finish\fR=\fIendtime\fR
هنگام استفاده از گزینهٔ
.BR \-m ،
گزارش به رکوردهایی که پیش از
.IR endtime
یا در همان زمان ثبت شده‌اند محدود خواهد شد. برای شرح کامل نحو
.IR endtime
به
.BR PCPIntro (1)
مراجعه کنید.
.TP
\fB\-v\fR \fIfile\fR
حالت پرگو (verbose).
برون‌ریزی رکوردهای یک فایل بایگانی فیزیکی در قالب شانزده‌شانزدهی (هگزادسیمال).
در این حالت،
.I file
نام یک تک‌فایل است، معمولاً یک نام پایه (basename) (که در غیر این صورت به عنوان آرگومان خط فرمان
.I archive
ظاهر می‌شد)، متصل‌شده با \(lq.\(rq و به دنبال آن یکی از موارد
.B meta
(متاداده)،
.B index
(نمایهٔ زمانی)، یا
یک رقم (یکی از حجم‌های مقادیر سنجه).
.sp 1.5v
استفاده از
.B \-v
مانع از استفاده از تمام گزینه‌ها و آرگومان‌های دیگر می‌شود.
.TP
\fB\-V\fR, \fB\-\-version\fR
نمایش شماره نسخه و خروج.
.TP
\fB\-x\fR
قالب گزارش گسترش‌یافتهٔ برچسب زمانی که علاوه بر ساعت، دقیقه و ثانیه (پیش‌فرض)، شامل روز هفته، روز ماه، ماه و سال نیز می‌شود.
این گزینه برای بایگانی‌هایی که چندین روز را پوشش می‌دهند مفید است.
.RS +5n
.PP
دومین گزینهٔ
.B \-x
برچسب زمانی را همچنین به عنوان یک آفست از ابتدای بایگانی و بر حسب ثانیه گزارش می‌کند.
این ویژگی در ترکیب با پیام‌های اشکال‌زداییِ روتین‌های مدیریت بایگانی در
.IR libpcp
مفید است.
.PP
سومین گزینهٔ
.B \-x
برچسب زمانی را همچنین در قالب \(lqEpoch\(rq (تعداد ثانیه‌های سپری‌شده از 1970-01-01 00:00:00 UTC) گزارش می‌دهد.
.RE
.TP
\fB\-z\fR, \fB\-\-hostzone\fR
تغییر منطقهٔ زمانی به منطقهٔ زمانی محلیِ میزبانی که منبع سنجه‌های کارایی است، همان‌طور که در رکورد برچسب بایگانی مشخص شده است.
.TP
\fB\-Z\fR \fItimezone\fR, \fB\-\-timezone\fR=\fItimezone\fR
به صورت پیش‌فرض،
.B pmlogdump
زمان روز را مطابق با منطقهٔ زمانی محلیِ سیستمی که
.B pmlogdump
روی آن اجرا می‌شود گزارش می‌دهد.
گزینهٔ
.B \-Z
منطقهٔ زمانی را به
.I timezone
در قالب متغیر محیطی
.B TZ
مطابق با توضیحات
.BR environ (7)
تغییر می‌دهد.
.TP
\fB\-?\fR, \fB\-\-help\fR
نمایش پیام راهنما و خروج.
.SH "فایل‌ها (FILES)"
.TP 5
.I $PCP_LOG_DIR/pmlogger/<hostname>
دایرکتوری پیش‌فرض برای بایگانی‌های PCP شامل مقادیر سنجه‌های کارایی جمع‌آوری‌شده از میزبان
.IR hostname .
.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
برای به‌دست آوردن فهرستی از گزینه‌های اشکال‌زدایی دردسترس و معانی آن‌ها استفاده کنید.
.SH "همچنین ببینید (SEE ALSO)"
.BR PCPIntro (1),
.BR pmlogcheck (1),
.BR pmlogextract (1),
.BR pmlogger (1),
.BR pmlogger_check (1),
.BR pmlogger_daily (1),
.BR pmloglabel (1),
.BR PMAPI (3),
.BR pmGetInDom (3),
.BR pmLookupDesc (3),
.BR pmNewContext (3),
.BR pcp.conf (5),
.BR pcp.env (5)
و
.BR PMNS (5).

.\" control lines for scripts/man-spell
.\" +ok+ pmdumplog { old name ref }