'\"macro stdmacro
.\"
.\" Copyright (c) 2025 Red Hat, Inc.  All Rights Reserved.
.\"
.\" This program is free software; you can redistribute it and/or modify it
.\" under the terms of the GNU General Public License as published by the
.\" Free Software Foundation; either version 2 of the License, or (at your
.\" option) any later version.
.\"
.\" This program is distributed in the hope that it will be useful, but
.\" WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
.\" or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
.\" for more details.
.\"
.\"
.TH PMLOGPUSH 1 "PCP" "Performance Co-Pilot"
.SH "نام (NAME)"
\f3pmlogpush\f1 \- ارسال یک بایگانی به یک سرور دوردست pmproxy
.SH "خلاصه دستور (SYNOPSIS)"
\f3pmlogpush\f1
[\f3\-vV?\f1]
[\f3\-D\f1 \f2debug\f1]
[\f3\-h\f1 \f2host\f1]
[\f3\-p\f1 \f2port\f1]
[\f3\-s\f1 \f2unix\f1]
[\f3\-Z\f1 \f2timezone\f1]
\f2archive\f1
.SH "توضیحات (DESCRIPTION)"
دستور
.B pmlogpush
محتوای یک بایگانی Performance Co-Pilot (PCP) را با استفاده از زیرمجموعهٔ API لاگر در
.BR PMWEBAPI (5)
به یک سرور HTTP (معمولاً به یک دیمن دوردست
.BR pmproxy (1))
ارسال می‌کند.
.I archive
باید از قبل با استفاده از
.BR pmlogger (1)
ایجاد شده باشد.
.PP
این بایگانی باید کامل و نهایی شده باشد (به‌طور فعال داده‌ای در آن نوشته نشود).
قابلیت مشابهی مستقیماً از طریق
.B pmlogger
با ساختار نام بایگانی دارای پیشوند HTTP در دسترس است که بایگانی‌ها را حین نوشته‌شدنِ فعال، به‌صورت دوردست ارسال می‌کند.
.SH "گزینه‌ها (OPTIONS)"
گزینه‌های موجود در خط فرمان عبارتند از:
.TP 5
\fB\-h\fR \fIhostname\fR, \fB\-\-host\fR=\fIhostname\fR
نام میزبان
.RI ( hostname )
برای سرور دوردست
.B pmproxy
که بایگانی PCP داده‌شده
.RI ( archive )
را دریافت می‌کند.
.TP
\fB\-p\fR \fIport\fR, \fB\-\-port\fR=\fIport\fR
شماره پورت
.RI ( port )
سوکت اینترنت که در آن سرور دوردست
.B pmproxy
به‌انتظار دریافت
.I archive
داده‌شدهٔ PCP گوش می‌دهد.
پورت پیش‌فرض 44322 است.
.TP
\fB\-s\fR \fIpath\fR, \fB\-\-unix\fR=\fIpath\fR
مسیر
.RI ( path )
سوکت دامنهٔ یونیکس (Unix domain socket) که در آن سرور محلی
.B pmproxy
(به‌صورت محلی) به‌انتظار دریافت
.I archive
داده‌شدهٔ PCP گوش می‌دهد.
.TP
\fB\-v\fR, \fB\-\-verbose\fR
افزایش اطلاعات تشخیصی گزارش‌شده هنگام اجرای
.BR pmlogpush .
.TP
\fB\-?\fR, \fB\-\-help\fR
نمایش پیام راهنمای استفاده و خروج.
.TP
\fB\-V\fR, \fB\-\-version\fR
نمایش شماره نسخه و خروج.
.SH "فایل‌ها (FILES)"
.TP 5
.I $PCP_LOG_DIR/pmproxy/<hostname>
دایرکتوری پیش‌فرض برای بایگانی‌های ارسال‌شدهٔ PCP که (به‌صورت دوردست) توسط سرور دریافت‌کنندهٔ
.B pmproxy
ایجاد می‌شوند.
.I hostname
از
.I archive
داده‌شده استخراج می‌شود، همانند زمان شروع ضبط؛ این ویژگی‌ها در کنار هم برای نام‌گذاری بایگانی ارسال‌شده در سمت دریافت‌کننده (یعنی توسط سرور
.BR pmproxy )
به کار می‌روند.
.SH "محیط PCP (PCP ENVIRONMENT)"
متغیرهای محیطی با پیشوند \fBPCP_\fP برای تعیین پارامترهای نام فایل‌ها و دایرکتوری‌های مورد استفادهٔ PCP به کار می‌روند.
در هر نصب، فایل \fI/etc/pcp.conf\fP حاوی مقادیر محلی برای این متغیرها است.
متغیر \fB$PCP_CONF\fP می‌تواند برای تعیین یک فایل پیکربندی جایگزین استفاده شود، همان‌طور که در \fBpcp.conf\fP(5) شرح داده شده است.
.SH "گزینه‌های اشکال‌زدایی (DEBUGGING OPTIONS)"
گزینهٔ
.B \-D
یا
.B \-\-debug
خروجی اطلاعات تشخیصی اضافی روی
.I stderr
را فعال می‌کند تا به تریاژ و دسته‌بندی مشکلات کمک کند، اگرچه این اطلاعات گاهی پیچیده و مبهم است و اصولاً برای راهنمایی توسعه‌دهندگان در نظر گرفته شده تا کاربران نهایی.
.I debug
یک فهرست جداشده با کاما از گزینه‌های اشکال‌زدایی است؛ از
.BR pmdbg (1)
همراه با گزینهٔ
.B \-l
برای دریافت فهرستی از گزینه‌های اشکال‌زدایی موجود و معانی آن‌ها استفاده کنید.
گزینهٔ اشکال‌زدایی
.I http
برای این ابزار از اهمیت ویژه‌ای برخوردار است.
.SH "همچنین ببینید (SEE ALSO)"
.BR PCPIntro (1),
.BR pmlogger (1),
.BR pmproxy (1),
.BR PMWEBAPI (3),
.BR pcp.conf (5)
و
.BR pcp.env (5).

.\" control lines for scripts/man-spell
.\" +ok+ pmpushlog { old name ref }