PMSEARCH(1)                 General Commands Manual                PMSEARCH(1)

نام (NAME)
       pmsearch - جستجوی متن راهنما و نام‌ها برای معیارها، نمونه‌ها و دامنه‌های
       نمونه

خلاصه دستور (SYNOPSIS)
       pmsearch [-CdinqsStTV?] [-c config] [-D debug] [-h host] [-p port] [-N
       number] [-O offset] [query | indom]

توضیحات (DESCRIPTION)
       دستور pmsearch پرس‌وجوهای جستجوی تمام‌متن را برای یافتن معیارها با
       استفاده از نام‌ها و متن راهنمای معیارها، دامنه‌های نمونه و نمونه‌ها انجام
       می‌دهد.

       این ابزار از قابلیت‌های سرویس pmproxy(1) در Performance Co-Pilot (PCP)،
       پایگاه داده کلید-مقدار توزیع‌شدهٔ Valkey و ماژول ValkeySearch مرتبط با آن
       استفاده می‌کند.

       توجه داشته باشید که برای استفاده از این سرویس‌ها، الزامی است که pmproxy
       با یک سرور کلید-مقدار Valkey که ماژول valkey-search.so را بارگذاری کرده
       باشد، ارتباط برقرار کند.  در صورت پیکربندی مناسب، pmproxy به‌طور خودکار
       نام معیارهای PCP، نام نمونه‌ها، متن راهنمای معیارها و دامنه‌های نمونه را
       از آرشیوهای PCP که به‌صورت محلی پیدا می‌کند، در مخزن ValkeySearch
       نمایه‌سازی خواهد کرد.  برای جزئیات بیشتر به pmlogger(1) و
       pmlogger_daily(1) مراجعه کنید.

       به‌طور پیش‌فرض pmsearch با یک سرور کلید-مقدار محلی ارتباط برقرار می‌کند؛
       با این حال می‌توان از گزینه‌های -h و -p برای مشخص کردن یک نمونهٔ جایگزین
       Valkey استفاده کرد.  اگر این نمونه گرهی از یک کلاستر Valkey باشد، تمام
       نمونه‌های دیگر موجود در کلاستر به‌طور خودکار شناسایی شده و مورد استفاده
       قرار خواهند گرفت.

گزینه‌ها (OPTIONS)
       -c config, --config=config
            مشخص کردن فایل config مورد استفاده.

       -C, --no-colour
            عدم برجسته‌سازی رنگی در متن نتایج.

       -d, --docid
            گزارش شناسهٔ سند (document ID) برای هر نتیجهٔ جستجو.  اسناد با
            استفاده از یک هش یکتای SHA-1 شناسایی می‌شوند که همواره به‌صورت یک
            مقدار ۴۰ رقمی شانزده‌شانزدهی خوانا برای انسان نمایش داده می‌شود.

       -h host, --host=host
            اتصال به سرور کلید-مقدار در host به‌جای سرور موجود در localhost.

       -i, --info
            گزارش معیارهای داخلی موتور جستجو.

       -n, --indom
            انجام جستجو برای موجودیت‌های مرتبط با دامنهٔ نمونه (instance
            domain).

       -N N, --number=N
            بازگرداندن حداکثر N نتیجهٔ جستجو.

       -O N, --offset=N
            صفحه‌بندی نتایج از مبداء مشخص‌شده.

       -p port, --port=port
            اتصال به سرور کلید-مقدار در port به‌جای درگاه پیش‌فرض 6379.

       -q, --query
            انجام جستجوی متنی عمومی (پیش‌فرض).

       -s, --suggest
            انجام جستجوی پیشنهاد نام.

       -S, --score
            گزارش امتیاز (رتبه) هر نتیجه.

       -T, --total
            گزارش تعداد کل نتایج جستجو.

       -t, --times
            گزارش مدت زمان سپری‌شده برای اجرای جستجو.

       -V, --version
            نمایش شماره نسخه و خروج.

       -?, --help
            نمایش پیام راهنما و خروج.

مثال‌ها (EXAMPLES)
         $ pmsearch kernel idle
         Type: metric
         Name: kernel.all.cpu.idle
         One line: total idle CPU time from /proc/stat for all CPUs

         Type: metric
         Name: kernel.all.idletime
         One line: time the current kernel has been idle since boot

         Type: metric
         Name: kernel.percpu.cpu.idle
         InDom: 60.0
         One line: percpu idle CPU time metric from /proc/stat

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

       برای مشاهده متغیرهای محیطی تأثیرگذار بر ابزارهای PCP، به
       pmGetOptions(3) مراجعه کنید.

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

همچنین ببینید (SEE ALSO)
       PCPIntro(1), pmproxy(1), pmlogger(1) و pmlogger_daily(1).


Performance Co-Pilot                  PCP                          PMSEARCH(1)