نام (NAME)

pmlogpush - ارسال یک بایگانی به یک سرور دوردست pmproxy

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

pmlogpush [-vV?] [-D debug] [-h host] [-p port] [-s unix] [-Z timezone] archive

توضیحات (DESCRIPTION)

دستور pmlogpush محتوای یک بایگانی Performance Co-Pilot (PCP) را با استفاده از زیرمجموعهٔ API لاگر در PMWEBAPI(5) به یک سرور HTTP (معمولاً به یک دیمن دوردست pmproxy(1)) ارسال می‌کند. archive باید از قبل با استفاده از pmlogger(1) ایجاد شده باشد.

این بایگانی باید کامل و نهایی شده باشد (به‌طور فعال داده‌ای در آن نوشته نشود). قابلیت مشابهی مستقیماً از طریق pmlogger با ساختار نام بایگانی دارای پیشوند HTTP در دسترس است که بایگانی‌ها را حین نوشته‌شدنِ فعال، به‌صورت دوردست ارسال می‌کند.

گزینه‌ها (OPTIONS)

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

-h hostname, --host=hostname

نام میزبان (hostname) برای سرور دوردست pmproxy که بایگانی PCP داده‌شده (archive) را دریافت می‌کند.

-p port, --port=port

شماره پورت (port) سوکت اینترنت که در آن سرور دوردست pmproxy به‌انتظار دریافت archive داده‌شدهٔ PCP گوش می‌دهد. پورت پیش‌فرض 44322 است.

-s path, --unix=path

مسیر (path) سوکت دامنهٔ یونیکس (Unix domain socket) که در آن سرور محلی pmproxy (به‌صورت محلی) به‌انتظار دریافت archive داده‌شدهٔ PCP گوش می‌دهد.

-v, --verbose

افزایش اطلاعات تشخیصی گزارش‌شده هنگام اجرای pmlogpush.

-?, --help

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

-V, --version

نمایش شماره نسخه و خروج.

فایل‌ها (FILES)

$PCP_LOG_DIR/pmproxy/<hostname>

دایرکتوری پیش‌فرض برای بایگانی‌های ارسال‌شدهٔ PCP که (به‌صورت دوردست) توسط سرور دریافت‌کنندهٔ pmproxy ایجاد می‌شوند. hostname از archive داده‌شده استخراج می‌شود، همانند زمان شروع ضبط؛ این ویژگی‌ها در کنار هم برای نام‌گذاری بایگانی ارسال‌شده در سمت دریافت‌کننده (یعنی توسط سرور pmproxy) به کار می‌روند.

محیط PCP (PCP ENVIRONMENT)

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

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

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

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

PCPIntro(1), pmlogger(1), pmproxy(1), PMWEBAPI(3), pcp.conf(5) و pcp.env(5).