نام (NAME)

pcp-geolocate - شناسایی برچسب‌های جغرافیایی سیستم جمع‌آوری‌کننده

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

pcp geolocate

توضیحات (DESCRIPTION)

دستور pcp-geolocate عرض و طول جغرافیایی را برای میزبان محلی جمع‌آوری‌کنندهٔ Performance Co-Pilot در قالب JSON گزارش می‌دهد. این اطلاعات موقعیت مکانی، در صورت موجود بودن از فایل کش $PCP_SYSCONF_DIR/labels/optional/geolocate خوانده می‌شود؛ در غیر این صورت، تلاشی برای تعیین موقعیت جغرافیایی بر پایهٔ آدرس IP میزبان و از طریق چندین منبع برخط (REST APIها) انجام می‌گیرد.

خروجی این دستور برای ذخیره‌سازی به عنوان برچسب‌های متریک از طریق ذخیره در فایل کش یادشده در بالا، مناسب است.

فایل واحد سرویس اختیاری systemd(1) برای این دستور، سازوکار شناسایی خودکار موقعیت مکانی را برای برچسب‌های متریک PCP فراهم می‌کند.

برچسب‌های متریک (METRIC LABELS)

خروجی JSON، قالب ترجیحی برای ذخیرهٔ موقعیت جغرافیایی به عنوان برچسب‌های متریک PCP است. هر متریک PCP موجود از این میزبان با برچسب‌های عرض و طول جغرافیایی برچسب‌گذاری خواهد شد، که این امر ابزارهای استفاده‌کننده از این اطلاعات مانند پنل geomap در Grafana را فعال می‌سازد.

برای اطلاعات بیشتر دربارهٔ برچسب‌های متریک به صفحات راهنمای pmcd(1)، pminfo(1)، pmlogger(1) و pmLookupLabels(3) مراجعه کنید.

محیط PCP (PCP ENVIRONMENT)

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

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

PCPIntro(1)، pmcd(1)، pminfo(1)، pmseries(1)، pmlogger(1)، systemd(1)، pmLookupLabels(3)، pcp.conf(5) و pcp.env(5).