PMLOGPASTE(1) General Commands Manual PMLOGPASTE(1)

pmlogpaste - درج متن در یک متریک در آرشیو PCP

pmlogpaste [-?] [-f file] [-h hostname] [-l label] [-m metric] [-o outfile] [-t timezone]

دستور pmlogpaste متن ورودی را از یک فایل یا خط فرمان دریافت کرده و آن را به عنوان مقدار یک متریک در یک آرشیو جدید PCP می‌نویسد. این مقدار متریک با زمان فعلی برچسب زمانی می‌خورد و به عنوان یک متریک از نوع رشته (string) ذخیره می‌شود.

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

ابزار pmlogpaste به صورت داخلی از رابط‌های کتابخانه LOGIMPORT(3) استفاده می‌کند که از ایجاد آرشیوها از منابع خارجیِ داده‌های کارایی پشتیبانی می‌کنند.

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

فایلی با متن ورودی که باید آرشیو شود، یا «-» برای ورودی استاندارد.
نام میزبان مبدأ برای آرشیو. مقدار پیش‌فرض، نام میزبان محلی است، یا اگر دریافت آن ممکن نباشد «localhost» خواهد بود.
افزودن برچسب‌های متنی (context labels) به آرشیو تولیدشده. این گزینه می‌تواند چندین بار مشخص شود تا برچسب‌های متعددی در آرشیو ایجاد گردند. مقدار label باید به قالب name:value باشد.
نام متریک برای آرشیو. نام پیش‌فرض متریک paste.value است.
فایل خروجی آرشیو. نام پیش‌فرض آرشیو paste است.
منطقه زمانی مبدأ برای آرشیو. مقدار پیش‌فرض، منطقه زمانی محلی است.
-?, --help
نمایش پیام راهنمای استفاده و خروج.

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

PCPIntro(1)، pmcd(1)، pmlogextract(1) و LOGIMPORT(3).

PCP Performance Co-Pilot