نام (NAME)

pmtrace - ابزار سنجش کارایی در خط فرمان

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

pmtrace [-q?] [-c value | -e command | -v value] [-h host] [-S state] tag

توضیحات (DESCRIPTION)

دستور pmtrace یک رابط خط فرمانی ساده برای عامل حوزه معیارهای کارایی (PMDA) ردگیری و کتابخانهٔ وابستهٔ pcp_trace فراهم می‌کند.

رفتار پیش‌فرض pmtrace ارائهٔ داده‌های ردگیری نقطه‌ای به PMDA ردگیری است که در آن از آرگومان tag به‌عنوان نام شناسایی مرتبط با هر نقطهٔ ردگیری استفاده می‌شود. سپس tag به یک شناسهٔ نمونه درون مجموعه‌معیارهای trace.point تبدیل می‌شود.

گزینه‌ها (OPTIONS)

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

-c value

اجازه می‌دهد یک مقدار شمارندهٔ (value) دلخواه از طریق معیارهای trace.count صادر شود.

-e command

اجازه می‌دهد یک command دلخواه اجرا شود. از آنجا که این command نقاط شروع و پایان مشخصی دارد، به‌عنوان یک تراکنش سنجیده خواهد شد. اطلاعات حاصل از طریق معیارهای trace.transact در دسترس قرار می‌گیرند.

-h host

ارسال داده‌های ردگیری به PMDA ردگیری در حال اجرا روی host به‌جای localhost. این گزینه استفاده از متغیر محیطی PCP_TRACE_HOST را لغو می‌کند.

-q

فرونشانی پیام‌های حاصل از یک ردگیری موفق، تا pmtrace در سکوت (بدون خروجی اضافی) اجرا شود.

-S state

فعال‌سازی اشکال‌زدایی و ردگیری داخلی. مقدار state ترکیبی بیتی از پرچم‌های اشکال‌زدایی طبق تعریف در pmtracestate(3) است، و می‌توان آن را با نحو ده‌دهی یا شانزده‌شانزدهی ارائه‌شده توسط strtol(3) مشخص کرد.

-v value

اجازه می‌دهد یک مقدار ممیز شناور (value) دلخواه از طریق معیارهای trace.observe صادر شود.

-?

نمایش پیام نحوهٔ استفاده و خروج.

خطاها (DIAGNOSTICS)

همهٔ پیام‌ها روی خطای استاندارد تولید می‌شوند و خودتوضیح هستند.

وضعیت خروج pmtrace همیشه صفر است، مگر زمانی که گزینهٔ -e استفاده شود؛ که در این صورت وضعیت خروج command بازگردانده می‌شود.

فایل‌ها (FILES)

$PCP_DEMOS_DIR/trace/pmtrace.c

کد منبع برای pmtrace

محیط (ENVIRONMENT)

از آنجا که pmtrace از توابع کتابخانهٔ libpcp_trace استفاده می‌کند، متغیرهای محیطی PCP_TRACE_HOST، PCP_TRACE_PORT و PCP_TRACE_TIMEOUT همگی در نظر گرفته می‌شوند. برای شرح مفصل معنای هر یک از آن‌ها به pmdatrace(3) مراجعه کنید.

محیط PCP (PCP ENVIRONMENT)

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

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

pmcd(1)، pmdatrace(1)، pmprobe(1)، PMAPI(3) و pmdatrace(3).