| 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)
| PCP | Performance Co-Pilot |