نام (NAME)

pmlogdump, pmdumplog - استخراج و نمایش جزئیات درونی یک آرشیو معیارهای کارایی

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

pmlogdump [-adehIilLmMrstxzV?] [-D debug] [-n pmnsfile] [-S starttime] [-T endtime] [-Z timezone] archive [metricname ...]
pmlogdump [-v file]

توضیحات (DESCRIPTION)

دستور pmlogdump انواع اطلاعات کنترلی، فراداده، نمایه و وضعیت را از فایل‌های یک آرشیو Performance Co-Pilot (PCP) استخراج و نمایش می‌دهد. این آرشیو دارای نام پایه archive است و باید پیش‌تر با استفاده از pmlogger(1) ایجاد شده باشد. به عنوان روش دیگر، archive می‌تواند نام دایرکتوری‌ای باشد که شامل مجموعه‌ای از آرشیوهای PCP است که می‌توان آن‌ها را با pmNewContext(3) باز کرد.

از نظر تاریخی، pmlogdump با نام pmdumplog شناخته می‌شد، اما نام دوم با دیگر دستورهای PCP که روی آرشیوهای PCP عمل می‌کنند هماهنگ نیست؛ بنابراین استفاده از pmlogdump ترجیح داده می‌شود، هرچند pmdumplog جهت سازگاری با نسخه‌های پیشین حفظ شده است.

در حالت عادی pmlogdump روی فضای نام توزیع‌شده معیارهای کارایی (PMNS) عمل می‌کند؛ با این حال اگر گزینه -n مشخص شود، یک PMNS محلی جایگزین از فایل pmnsfile بارگذاری می‌شود.

اگر هر گونه آرگومان metricname ارائه شود، گزارش محدود به اطلاعات مرتبط با معیارهای کارایی مشخص‌شده خواهد بود. اگر metricname یک گره غیربرگ در فضای نام باشد (ببینید PMNS(5))، آنگاه pmlogdump به‌صورت بازگشتی در فضای نام آرشیو به پایین پیمایش کرده و تمام گره‌های برگ را گزارش می‌دهد.

گزینه‌های خط فرمان مشخص می‌کنند که چه اطلاعات خاصی گزارش شود.

گزینه‌ها (OPTIONS)

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

-a, --all: گزارش تقریباً همه‌چیز، یعنی پرچم‌های -d، -i، -L، -m، -s و -t. متن راهنمای اختیاری (-h) و رشته‌های فراداده برچسب (-e) به‌طور پیش‌فرض گزارش نمی‌شوند.
-d, --descs: نمایش فراداده و توضیحات برای آن دسته از معیارهای کارایی که حداقل یک بار در آرشیو ظاهر شده‌اند: برای جزئیات بیشتر در مورد فراداده‌های توصیف‌کننده معیارها، به pmLookupDesc(3) مراجعه کنید. معیارها به ترتیب صعودی شناسه معیار کارایی (PMID) گزارش می‌شوند.
-e, --labelsets: نمایش فراداده برچسب، در صورتی که در آرشیو موجود باشد. برای جزئیات بیشتر درباره سلسله‌مراتب فراداده برچسب مرتبط با معیارها، به pmLookupLabels(3) مراجعه کنید.
-h, --helptext: نمایش متن راهنمای معیار و دامنه نمونه (instance domain) در صورت موجود بودن در آرشیو. برای جزئیات بیشتر درباره متن راهنمای مرتبط با معیارها، به pmLookupText(3) مراجعه کنید.
-i, --insts: نمایش دامنه‌های نمونه و هرگونه تغییر در اعضای نمونه آن‌ها در طول مدت زمان آرشیو: برای جزئیات بیشتر درباره دامنه‌های نمونه، به pmGetInDom(3) مراجعه کنید. دامنه‌های نمونه به ترتیب صعودی شناسه دامنه نمونه (Instance Domain Identifier) و سپس زمان صعودی برای هر مجموعه از اعضای نمونه مشاهده‌شده در یک دامنه نمونه گزارش می‌شوند.
-I, --on-disk-insts: نمایش دامنه‌های نمونه روی دیسک، که ممکن است از قالب و کدگذاری متفاوتی نسبت به آنچه از طریق واسط برنامه‌نویسی معیارهای کارایی (PMAPI) هنگام استفاده از pmGetInDom(3) و توابع مرتبط قابل مشاهده است، استفاده کنند. قالب روی دیسک تنها هنگام بررسی ساختار درونی آرشیوهای PCP مورد توجه است.
-l, --label: نمایش برچسب آرشیو، که نسخه قالب آرشیو، زمان و تاریخ شروع و پایان (فعلی) آرشیو، و میزبانی که مقادیر معیارهای کارایی از آن جمع‌آوری شده‌اند را نشان می‌دهد.
-L: مانند -l، تنها با جزئیات کمی بیشتر.
-m, --metrics: چاپ مقادیر معیارهای کارایی از آرشیو. این گزینه پیش‌فرض نمایش است.

معیارهای بدون دامنه نمونه به این صورت گزارش می‌شوند:
[timestamp] metric-id (metric-name): value1 value2

معیارهای دارای دامنه نمونه به این صورت گزارش می‌شوند:
[timestamp] metric-id (metric-name):
inst [internal-id or "external-id"] value1 value2

مقدار timestamp تنها برای اولین معیار در گروهی از معیارها که برچسب زمانی مشترک دارند گزارش می‌شود.

-M, --markrecs: اگر هیچ metricname ای مشخص نشده باشد، آنگاه رکوردهای <mark> در صورت یافت شدن در archive گزارش می‌شوند. اگر آرگومان‌های metricname مشخص شده باشند، رکوردهای <mark> به‌طور پیش‌فرض گزارش نمی‌شوند. گزینه -M گزارش شدن رکوردهای <mark> را اجباری می‌کند، حتی زمانی که آرگومان‌های metricname مشخص شده باشند.

رکوردهای <mark> توسط pmlogger(1)، pmlogextract(1) و ابزارهای مشابه در آرشیو PCP درج می‌شوند تا نشان‌دهنده یک گسستگیزمانی در سری زمانی مقادیر معیار باشند.

-n pmnsfile, --namespace=pmnsfile: بارگذاری یک فضای نام معیارهای کارایی جایگزین (PMNS(5)) از فایل pmnsfile..TP -r, --reverse پردازش بایگانی با ترتیب معکوس، از جدیدترین به قدیمی‌ترین مقادیر ثبت‌شدهٔ سنجه.
-s, --sizes: گزارش اندازهٔ هر رکورد فیزیکی موجود در بایگانی بر حسب بایت.
-S starttime, --start=starttime: هنگام استفاده از گزینهٔ -m، گزارش به رکوردهایی که در starttime یا پس از آن ثبت شده‌اند محدود خواهد شد. برای شرح کامل نحو starttime به PCPIntro(1) مراجعه کنید.
-t: برون‌ریزی نمایهٔ زمانی (temporal index) که برای دسترسی سریع‌تر به فایل‌های بزرگ بایگانی استفاده می‌شود.

سلامت و یکپارچگی نمایه نیز بررسی خواهد شد. در صورتی که مشخص شود نمایه آسیب دیده است، فایل “*.index” را می‌توان تغییر نام داد یا حذف کرد و بایگانی همچنان قابل دسترس خواهد بود؛ هرچند بدون وجود نمایه، بازیابی داده‌ها ممکن است زمان بیشتری ببرد. با این حال، توجه داشته باشید که نمایهٔ زمانی آسیب‌دیده معمولاً نشان‌دهندهٔ مشکلی عمیق‌تر است که ممکن است بر تمامی فایل‌های یک بایگانی PCP اثر بگذارد.

-T endtime, --finish=endtime: هنگام استفاده از گزینهٔ -m، گزارش به رکوردهایی که پیش از endtime یا در همان زمان ثبت شده‌اند محدود خواهد شد. برای شرح کامل نحو endtime به PCPIntro(1) مراجعه کنید.
-v file: حالت پرگو (verbose). برون‌ریزی رکوردهای یک فایل بایگانی فیزیکی در قالب شانزده‌شانزدهی (هگزادسیمال). در این حالت، file نام یک تک‌فایل است، معمولاً یک نام پایه (basename) (که در غیر این صورت به عنوان آرگومان خط فرمان archive ظاهر می‌شد)، متصل‌شده با “.” و به دنبال آن یکی از موارد meta (متاداده)، index (نمایهٔ زمانی)، یا یک رقم (یکی از حجم‌های مقادیر سنجه).
استفاده از -v مانع از استفاده از تمام گزینه‌ها و آرگومان‌های دیگر می‌شود.
-V, --version: نمایش شماره نسخه و خروج.
-x: قالب گزارش گسترش‌یافتهٔ برچسب زمانی که علاوه بر ساعت، دقیقه و ثانیه (پیش‌فرض)، شامل روز هفته، روز ماه، ماه و سال نیز می‌شود. این گزینه برای بایگانی‌هایی که چندین روز را پوشش می‌دهند مفید است.

دومین گزینهٔ -x برچسب زمانی را همچنین به عنوان یک آفست از ابتدای بایگانی و بر حسب ثانیه گزارش می‌کند. این ویژگی در ترکیب با پیام‌های اشکال‌زداییِ روتین‌های مدیریت بایگانی در libpcp مفید است.

سومین گزینهٔ -x برچسب زمانی را همچنین در قالب “Epoch” (تعداد ثانیه‌های سپری‌شده از 1970-01-01 00:00:00 UTC) گزارش می‌دهد.

-z, --hostzone: تغییر منطقهٔ زمانی به منطقهٔ زمانی محلیِ میزبانی که منبع سنجه‌های کارایی است، همان‌طور که در رکورد برچسب بایگانی مشخص شده است.
-Z timezone, --timezone=timezone: به صورت پیش‌فرض، pmlogdump زمان روز را مطابق با منطقهٔ زمانی محلیِ سیستمی که pmlogdump روی آن اجرا می‌شود گزارش می‌دهد. گزینهٔ -Z منطقهٔ زمانی را به timezone در قالب متغیر محیطی TZ مطابق با توضیحات environ(7) تغییر می‌دهد.
-?, --help: نمایش پیام راهنما و خروج.

فایل‌ها (FILES)

$PCP_LOG_DIR/pmlogger/<hostname>: دایرکتوری پیش‌فرض برای بایگانی‌های PCP شامل مقادیر سنجه‌های کارایی جمع‌آوری‌شده از میزبان hostname.

محیط PCP (PCP ENVIRONMENT)

متغیرهای محیطی با پیشوند PCP_ برای پارامتربندی نام فایل‌ها و دایرکتوری‌های مورد استفادهٔ PCP به کار می‌روند. در هر نصب، فایل /etc/pcp.conf حاوی مقادیر محلی برای این متغیرها است. متغیر $PCP_CONF ممکن است برای تعیین یک فایل پیکربندی جایگزین استفاده شود، همان‌طور که در pcp.conf(5) شرح داده شده است..SH "گزینه‌های اشکال‌زدایی (DEBUGGING OPTIONS)" گزینهٔ -D یا --debug خروجی پیام‌های عیب‌یابی تکمیلی را روی stderr فعال می‌کند تا به عیب‌یابی و دسته‌بندی مشکلات کمک کند، هرچند این اطلاعات گاهی پیچیده و مبهم است و در وهلهٔ اول برای راهنمایی توسعه‌دهندگان به جای کاربران نهایی در نظر گرفته شده است. debug فهرستی جداشده با کاما از گزینه‌های اشکال‌زدایی است؛ از pmdbg(1) با گزینهٔ -l برای به‌دست آوردن فهرستی از گزینه‌های اشکال‌زدایی دردسترس و معانی آن‌ها استفاده کنید.

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

PCPIntro(1), pmlogcheck(1), pmlogextract(1), pmlogger(1), pmlogger_check(1), pmlogger_daily(1), pmloglabel(1), PMAPI(3), pmGetInDom(3), pmLookupDesc(3), pmNewContext(3), pcp.conf(5), pcp.env(5) و PMNS(5).