نام (NAME)

pmseries_import - وارد کردن فایل‌های آرشیو PCP برای پرس‌وجوی سری‌های زمانی تاریخی

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

$PCP_BINADM_DIR/pmseries_import [-h] [--archives path] [--json file] [--import-timeout time] [--noop] [--poll-interval delta] [-p port] [-Z TZ]

توضیحات (DESCRIPTION)

دستور pmseries_import یک path مشخص‌شده را برای آرشیوهای PCP پایش می‌کند و محتویات آن‌ها را به‌طور خودکار درون یک سرور کلید-مقدار (مانند Valkey یا Redis) بارگذاری می‌نماید. این کار داده‌ها را برای پرس‌وجوی سریع سری‌های زمانی با استفاده از زبان pmseries(1)، همان‌طور که توسط ابزار خط فرمان و سرویس‌های REST API مربوط به pmproxy(1) ارائه شده است، مناسب می‌سازد.

دستور pmseries_import از روش سرکشی (polling) ساده‌ای استفاده می‌کند و هر ۱۰ ثانیه یک‌بار دایرکتوری آرشیوها را برای یافتن فایل‌های آرشیو جدید بررسی می‌نماید.

این ابزار بیش از همه در کانتینرهایی استفاده می‌شود که راه‌اندازی خودکار داشبورد Grafana را برای آرشیوهای دلخواه PCP فراهم می‌کنند. این رویکرد محیطی شامل یک سرور systemd(1) برای فعال‌سازی این ابزار پایش آرشیو، و همچنین سرویس‌های از پیش پیکربندی‌شدهٔ grafana-server(1)، valkey-server(1) و سرویس‌های REST API ابزار pmproxy(1) را فراهم می‌آورد.

گزینه‌ها (OPTIONS)

--archives=path: یک path جایگزین را برای سرکشی و یافتن آرشیوهای جدید PCP مشخص می‌کند. مقدار پیش‌فرض /archives است.
--jsonfile=file: یک file با قالب JSON جایگزین را برای به‌روزرسانی در هنگام تشخیص تغییر در مرزهای پنجره زمانی مشخص می‌کند. این فایل باید حاوی محتوای JSON باشد، از جمله یک نگاشت JSON به نام «time» با فیلدهای «start» و «end» که برچسب‌های زمانی رشته‌ای در آن‌ها نوشته خواهند شد. مقدار پیش‌فرض /usr/local/var/lib/grafana/dashboards/pcp-archive-analysis.json است.
-h, --help: نمایش پیام راهنمای نحوه استفاده از دستور و خروج.
--import-timeout=timeout: تعداد ثانیه‌های مجاز برای تکمیل واردسازی هر آرشیو مجزا، از طریق دستور load در pmseries برای آن آرشیو را مشخص می‌کند. مقدار پیش‌فرض timeout برابر با 600 ثانیه (۵ دقیقه) است.
--noop: از تمام عملیات نوشتن صرف‌نظر می‌کند (برای اهداف عیب‌یابی یا آزمایشی) و در عوض تنها پیام‌های تشخیصی را گزارش می‌دهد.
--poll-interval=delta: بسامد (فاصله زمانی) بررسی و پیمایش دایرکتوری آرشیو. مقدار پیش‌فرض delta یک‌بار در هر ۱۰ ثانیه است.
-p port, --port=port: یک port اختیاری که pmseries باید از طریق آن به سرور کلید-مقدار متصل شود. پورت پیش‌فرض 6379 است.
-Z TZ, --timezone=TZ: یک مقدار اختیاری TZ که نشان‌دهنده منطقه زمانی است که pmseries باید هنگام ارسال مقادیر به سرور کلید-مقدار، تمام برچسب‌های زمانی آرشیو را به آن تبدیل کند.

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

grafana-server(1), systemd(1), valkey-server(1), pmproxy(1) و pmseries(1).