نام (NAME)

pmloglabel - بررسی و تعمیر برچسب آرشیو معیارهای کارایی

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

pmloglabel [-lLsv?] [-D debug] [-h hostname] [-p pid] [-V version] [-Z timezone] archive

توضیحات (DESCRIPTION)

دستور pmloglabel تمام جزئیات برچسب‌ها را در هر یک از فایل‌های یک آرشیو Performance Co-Pilot (PCP) اعتبارسنجی کرده، گزارش می‌دهد و می‌تواند آن‌ها را اصلاح کند. این آرشیو دارای نام پایه archive است و باید پیش‌تر با استفاده از pmlogger(1) ایجاد شده باشد.

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

بنابراین، عملکرد اصلی pmloglabel امکان تعمیر هرگونه فیلد ناهماهنگ یا آسیب‌دیده در برچسب است، به گونه‌ای که کل آرشیو از دست نرود. این دستور باقی‌مانده آرشیو را بررسی نمی‌کند، اما شانس مناسبی برای بازیابی داده‌هایی که در غیر این صورت از دست می‌رفتند فراهم می‌سازد. دستورهای pmloglabel و pmlogextract در کنار یکدیگر قادرند از انواع گوناگون خرابی‌ها، یک آرشیو معتبر PCP تولید کنند.

توجه داشته باشید که اگر مشخص شود نمایه زمانی آسیب دیده است، فایل "*.index" را می‌توان با خیال راحت کنار گذاشت و آرشیو همچنان در دسترس خواهد بود؛ هرچند بازیابی داده‌ها بدون نمایه ممکن است زمان بیشتری ببرد.

گزینه‌ها (OPTIONS)

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

-h hostname, --host=hostname: اصلاح hostname ثبت‌شده در برچسب آرشیو، برای تمام فایل‌های موجود در آرشیو.
-l, --label: تخلیه و نمایش برچسب آرشیو، شامل نمایش نسخه قالب آرشیو، تاریخ و زمان شروع و پایان (فعلی) آرشیو، و میزبانی که مقادیر معیارهای کارایی از آن جمع‌آوری شده است.
-L: مانند -l، اما با جزئیات کمی بیشتر، که منطقه زمانی و شناسه فرایند ایجادکننده را نیز از برچسب آرشیو نمایش می‌دهد.
-p pid, --pid=pid: تنظیم شناسه فرایند ذخیره‌شده در برچسب آرشیو روی pid، برای تمام فایل‌های موجود در آرشیو.
-s: بازنویسی مقادیر نگهبان (sentinel values) که پیش و پس از برچسب آرشیو قرار دارند، برای تمام فایل‌های موجود در آرشیو.
-v, --verbose: حالت پرگو. اطلاعات پیشرفت بیشتری در هر مرحله تولید می‌شود.
-V version, --version=version: ثبت شماره نسخه version در فیلد عدد جادویی (magic number) در ابتدای برچسب آرشیو، برای تمام فایل‌های موجود در آرشیو.
-Z timezone, --timezone=timezone: تغییر منطقه زمانی در برچسب‌های آرشیو به timezone در قالب متغیر محیطی TZ مطابق با آنچه در environ(7) شرح داده شده است.
-?, --help: نمایش پیام راهنمای استفاده و خروج.

مثال‌ها (EXAMPLES)

مثال زیر نحوه استفاده از pmloglabel را در یافتن و سپس تصحیح یک فیلد آسیب‌دیده (PID) در برچسب نمایه زمانی آرشیوی با نام "20080125" نشان می‌دهد.

$ pmlogdump -l 20080125
pmlogdump: Cannot open archive "20080125": Illegal label record at start of a PCP archive file
$ pmloglabel 20080125
Mismatched PID (5264/5011) between temporal index and data volume 0
$ pmloglabel -p 5264 20080125
$ pmlogdump -l 20080125
Log Label (Log Format Version 2)
Performance metrics from host fw1
  commencing Fri Jan 25 00:10:09.341 2008
  ending     Sat Jan 26 00:09:54.344 2008

وضعیت خروج (EXIT STATUS)

دستور pmloglabel در صورتی که برچسب‌های آرشیو سالم باشند با وضعیت 0 خارج می‌شود. اگر به صورت نادرست فراخوانی شود، وضعیت خروج 1 خواهد بود. اگر خرابی شناسایی شود و در پایان همچنان وجود داشته باشد، وضعیت خروج 2 خواهد بود. اگر درخواست نوشتن برچسب‌های آرشیو داده شود و بخشی از این نوشتن با شکست مواجه گردد، وضعیت خروج 3 خواهد بود.

فایل‌ها (FILES)

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

محیط PCP (PCP ENVIRONMENT)

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

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

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

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

PCPIntro(1), pmlogcheck(1), pmlogdump(1), pmlogextract(1), pmlogger(1), pmlogger_check(1), pmlogger_daily(1), pmlogrewrite(1), pcp.conf(5) و pcp.env(5).