'\"macro stdmacro
.\"
.\" Copyright (c) 2025 Red Hat.
.\"
.\" 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 PMSERIES_IMPORT 1 "PCP" "Performance Co-Pilot"
.SH "نام (NAME)"
pmseries_import \- وارد کردن فایل‌های آرشیو PCP برای پرس‌وجوی سری‌های زمانی تاریخی
.SH "خلاصه دستور (SYNOPSIS)"
.B $PCP_BINADM_DIR/pmseries_import
[\f3\-h\f1]
[\f3\-\-archives\f1 \f2path\f1]
[\f3\-\-json\f1 \f2file\f1]
[\f3\-\-import-timeout\f1 \f2time\f1]
[\f3\-\-noop\f1]
[\f3\-\-poll-interval\f1 \f2delta\f1]
[\f3\-p\f1 \f2port\f1]
[\f3\-Z\f1 \f2TZ\f1]
.SH "توضیحات (DESCRIPTION)"
دستور
.B pmseries_import
یک \f2path\f1 مشخص‌شده را برای آرشیوهای PCP پایش می‌کند و محتویات آن‌ها را به‌طور خودکار درون یک سرور کلید-مقدار (مانند Valkey یا Redis) بارگذاری می‌نماید.
این کار داده‌ها را برای پرس‌وجوی سریع سری‌های زمانی با استفاده از زبان
.BR pmseries (1)،
همان‌طور که توسط ابزار خط فرمان و سرویس‌های REST API مربوط به
.BR pmproxy (1)
ارائه شده است، مناسب می‌سازد.
.PP
دستور
.B pmseries_import
از روش سرکشی (polling) ساده‌ای استفاده می‌کند و هر ۱۰ ثانیه یک‌بار دایرکتوری آرشیوها را برای یافتن فایل‌های آرشیو جدید بررسی می‌نماید.
.PP
این ابزار بیش از همه در کانتینرهایی استفاده می‌شود که راه‌اندازی خودکار داشبورد Grafana را برای آرشیوهای دلخواه PCP فراهم می‌کنند.
این رویکرد محیطی شامل یک سرور
.BR systemd (1)
برای فعال‌سازی این ابزار پایش آرشیو، و همچنین سرویس‌های از پیش پیکربندی‌شدهٔ
.BR grafana-server (1)،
.BR valkey-server (1)
و سرویس‌های REST API ابزار
.BR pmproxy (1)
را فراهم می‌آورد.
.SH "گزینه‌ها (OPTIONS)"
.TP 5
\fB\-\-archives\fR=\fIpath\fR
یک
.I path
جایگزین را برای سرکشی و یافتن آرشیوهای جدید PCP مشخص می‌کند.
مقدار پیش‌فرض
.IR /archives
است.
.TP 5
\fB\-\-jsonfile\fR=\fIfile\fR
یک
.I file
با قالب JSON جایگزین را برای به‌روزرسانی در هنگام تشخیص تغییر در مرزهای پنجره زمانی مشخص می‌کند.
این فایل باید حاوی محتوای JSON باشد، از جمله یک نگاشت JSON به نام «time» با فیلدهای «start» و «end» که برچسب‌های زمانی رشته‌ای در آن‌ها نوشته خواهند شد.
مقدار پیش‌فرض
.IR /usr/local/var/lib/grafana/dashboards/pcp-archive-analysis.json
است.
.TP 5
\fB\-h\fR, \fB\-\-help\fR
نمایش پیام راهنمای نحوه استفاده از دستور و خروج.
.TP 5
\fB\-\-import-timeout\fR=\fItimeout\fR
تعداد ثانیه‌های مجاز برای تکمیل واردسازی هر آرشیو مجزا، از طریق دستور load در
.B pmseries
برای آن آرشیو را مشخص می‌کند.
مقدار پیش‌فرض
.I timeout
برابر با
.I 600
ثانیه (۵ دقیقه) است.
.TP 5
\fB\-\-noop\fR
از تمام عملیات نوشتن صرف‌نظر می‌کند (برای اهداف عیب‌یابی یا آزمایشی) و در عوض تنها پیام‌های تشخیصی را گزارش می‌دهد.
.TP 5
\fB\-\-poll-interval\fR=\fIdelta\fR
بسامد (فاصله زمانی) بررسی و پیمایش دایرکتوری آرشیو.
مقدار پیش‌فرض
.I delta
یک‌بار در هر ۱۰ ثانیه است.
.TP 5
\fB\-p\fR \fIport\fR, \fB\-\-port\fR=\fIport\fR
یک
.I port
اختیاری که
.B pmseries
باید از طریق آن به سرور کلید-مقدار متصل شود.
پورت پیش‌فرض 6379 است.
.TP 5
\fB\-Z\fR \fITZ\fR, \fB\-\-timezone\fR=\fITZ\fR
یک مقدار اختیاری
.I TZ
که نشان‌دهنده منطقه زمانی است که
.B pmseries
باید هنگام ارسال مقادیر به سرور کلید-مقدار، تمام برچسب‌های زمانی آرشیو را به آن تبدیل کند.
.SH "همچنین ببینید (SEE ALSO)"
.BR grafana-server (1),
.BR systemd (1),
.BR valkey-server (1),
.BR pmproxy (1)
و
.BR pmseries (1).

.\" control lines for scripts/man-spell
.\" +ok+ grafana Grafana pre valkey Valkey