'\"macro stdmacro
.\"
.\" Copyright (c) 2020,2024 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 PMSEARCH 1 "PCP" "Performance Co-Pilot"
.SH "نام (NAME)"
\f3pmsearch\f1 \- جستجوی متن راهنما و نام‌ها برای معیارها، نمونه‌ها و دامنه‌های نمونه
.SH "خلاصه دستور (SYNOPSIS)"
\fBpmsearch\fR
[\fB\-CdinqsStTV?\fR]
[\fB\-c\fR \fIconfig\fR]
[\f3\-D\f1 \f2debug\f1]
[\fB\-h\fR \fIhost\fR]
[\fB\-p\fR \fIport\fR]
[\fB\-N\fR \fInumber\fR]
[\fB\-O\fR \fIoffset\fR]
[\fIquery\fR | \fIindom\fR]
.SH "توضیحات (DESCRIPTION)"
.de SAMPLE
.RS 2n
.nf
.nh
..
.de ESAMPLE
.hy
.fi
.RE
..
دستور
.B pmsearch
پرس‌وجوهای جستجوی تمام‌متن را برای یافتن معیارها با استفاده از نام‌ها و متن راهنمای معیارها، دامنه‌های نمونه و نمونه‌ها انجام می‌دهد.
.PP
این ابزار از قابلیت‌های سرویس
.BR pmproxy (1)
در Performance Co-Pilot (PCP)، پایگاه داده کلید-مقدار توزیع‌شدهٔ Valkey و ماژول
ValkeySearch
مرتبط با آن استفاده می‌کند.
.PP
توجه داشته باشید که برای استفاده از این سرویس‌ها،
.B الزامی
است که
.B pmproxy
با یک سرور کلید-مقدار Valkey که ماژول
.I valkey-search.so
را بارگذاری کرده باشد، ارتباط برقرار کند.
در صورت پیکربندی مناسب،
.B pmproxy
به‌طور خودکار نام معیارهای PCP، نام نمونه‌ها، متن راهنمای معیارها و دامنه‌های نمونه را از آرشیوهای PCP که به‌صورت محلی پیدا می‌کند، در مخزن ValkeySearch نمایه‌سازی خواهد کرد.
برای جزئیات بیشتر به
.BR pmlogger (1)
و
.BR pmlogger_daily (1)
مراجعه کنید.
.PP
به‌طور پیش‌فرض
.B pmsearch
با یک سرور کلید-مقدار محلی ارتباط برقرار می‌کند؛
با این حال می‌توان از گزینه‌های \fB\-h\fR و \fB\-p\fR برای مشخص کردن یک نمونهٔ جایگزین Valkey استفاده کرد.
اگر این نمونه گرهی از یک کلاستر Valkey باشد، تمام نمونه‌های دیگر موجود در کلاستر به‌طور خودکار شناسایی شده و مورد استفاده قرار خواهند گرفت.
.SH "گزینه‌ها (OPTIONS)"
.TP 5
\fB\-c\fR \fIconfig\fR, \fB\-\-config\fR=\fIconfig\fR
مشخص کردن فایل
.IR config
مورد استفاده.
.TP
\fB\-C\fR, \fB\-\-no-colour\fR
عدم برجسته‌سازی رنگی در متن نتایج.
.TP
\fB\-d\fR, \fB\-\-docid\fR
گزارش شناسهٔ سند (document ID) برای هر نتیجهٔ جستجو.
اسناد با استفاده از یک هش یکتای SHA-1 شناسایی می‌شوند که همواره به‌صورت یک مقدار ۴۰ رقمی شانزده‌شانزدهی خوانا برای انسان نمایش داده می‌شود.
.TP
\fB\-h\fR \fIhost\fR, \fB\-\-host\fR=\fIhost\fR
اتصال به سرور کلید-مقدار در
.IR host
به‌جای سرور موجود در localhost.
.TP
\fB\-i\fR, \fB\-\-info\fR
گزارش معیارهای داخلی موتور جستجو.
.TP
\fB\-n\fR, \fB\-\-indom\fR
انجام جستجو برای موجودیت‌های مرتبط با دامنهٔ نمونه
(\c
.IR instance
.IR domain ).
.TP
\fB\-N\fR \fIN\fR, \fB\-\-number\fR=\fIN\fR
بازگرداندن حداکثر
.IR N
نتیجهٔ جستجو.
.TP
\fB\-O\fR \fIN\fR, \fB\-\-offset\fR=\fIN\fR
صفحه‌بندی نتایج از مبداء مشخص‌شده.
.TP
\fB\-p\fR \fIport\fR, \fB\-\-port\fR=\fIport\fR
اتصال به سرور کلید-مقدار در
.IR port
به‌جای درگاه پیش‌فرض
.BR 6379 .
.TP
\fB\-q\fR, \fB\-\-query\fR
انجام جستجوی متنی عمومی (پیش‌فرض).
.TP
\fB\-s\fR, \fB\-\-suggest\fR
انجام جستجوی پیشنهاد نام.
.TP
\fB\-S\fR, \fB\-\-score\fR
گزارش امتیاز (رتبه) هر نتیجه.
.TP
\fB\-T\fR, \fB\-\-total\fR
گزارش تعداد کل نتایج جستجو.
.TP
\fB\-t\fR, \fB\-\-times\fR
گزارش مدت زمان سپری‌شده برای اجرای جستجو.
.TP
\fB\-V\fR, \fB\-\-version\fR
نمایش شماره نسخه و خروج.
.TP
\fB\-?\fR, \fB\-\-help\fR
نمایش پیام راهنما و خروج.
.SH "مثال‌ها (EXAMPLES)"
.SAMPLE
$ pmsearch kernel idle
Type: metric
Name: \fBkernel\fR.all.cpu.\fBidle\fR
One line: total \fBidle\fR CPU time from /proc/stat for all CPUs

Type: metric
Name: \fBkernel\fR.all.idletime
One line: time the current \fBkernel\fR has been \fBidle\f1 since boot

Type: metric
Name: \fBkernel\f1.percpu.cpu.\fBidle\fR
InDom: 60.0
One line: percpu \fBidle\fR CPU time metric from /proc/stat
.ESAMPLE
.SH "محیط پی‌سی‌پی (PCP ENVIRONMENT)"
متغیرهای محیطی با پیشوند \fBPCP_\fP برای مقداردهی و پارامتربندی نام فایل‌ها و دایرکتوری‌های مورد استفاده توسط PCP به کار می‌روند.
در هر بار نصب، فایل \fI/etc/pcp.conf\fP حاوی مقادیر محلی برای این متغیرها است.
متغیر \fB$PCP_CONF\fP می‌تواند برای تعیین یک فایل پیکربندی جایگزین استفاده شود، همان‌طور که در \fBpcp.conf\fP(5) توضیح داده شده است.
.PP
برای مشاهده متغیرهای محیطی تأثیرگذار بر ابزارهای PCP، به \fBpmGetOptions\fP(3) مراجعه کنید.
.SH "گزینه‌های اشکال‌زدایی (DEBUGGING OPTIONS)"
گزینهٔ
.B \-D
یا
.B \-\-debug
خروجی اطلاعات تشخیصی اضافی را در
.I stderr
برای کمک به تفکیک و ریشه‌یابی مشکلات فعال می‌کند، هرچند این اطلاعات گاهی مبهم است و اساساً به جای کاربران نهایی، برای راهنمایی توسعه‌دهندگان طراحی شده است.
.I debug
فهرستی از گزینه‌های اشکال‌زدایی جداشده با کاما است؛ برای دریافت فهرستی از گزینه‌های اشکال‌زدایی موجود و معانی آن‌ها از
.BR pmdbg (1)
به همراه گزینهٔ
.B \-l
استفاده کنید.
.SH "همچنین ببینید (SEE ALSO)"
.BR PCPIntro (1),
.BR pmproxy (1),
.BR pmlogger (1)
و
.BR pmlogger_daily (1).

.\" control lines for scripts/man-spell
.\" +ok+ SHA Valkey ValkeySearch hexdigit idletime
.\" +ok+ stat {from /proc/stat}