'\"macro stdmacro
.\"
.\" Copyright (c) 2022-2023 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 PCP-GEOLOCATE 1 "PCP" "Performance Co-Pilot"
.SH "نام (NAME)"
\f3pcp-geolocate\f1 \- شناسایی برچسب‌های جغرافیایی سیستم جمع‌آوری‌کننده
.SH "خلاصه دستور (SYNOPSIS)"
\f3pcp\f1 \f3geolocate\f1
.SH "توضیحات (DESCRIPTION)"
دستور
.B pcp-geolocate
عرض و طول جغرافیایی را برای میزبان محلی جمع‌آوری‌کنندهٔ Performance Co-Pilot در قالب JSON گزارش می‌دهد.
این اطلاعات موقعیت مکانی، در صورت موجود بودن از فایل کش
.I $PCP_SYSCONF_DIR/labels/optional/geolocate
خوانده می‌شود؛ در غیر این صورت، تلاشی برای تعیین موقعیت جغرافیایی بر پایهٔ آدرس IP میزبان و از طریق چندین منبع برخط (REST APIها) انجام می‌گیرد.
.PP
خروجی این دستور برای ذخیره‌سازی به عنوان برچسب‌های متریک از طریق ذخیره در فایل کش یادشده در بالا، مناسب است.
.PP
فایل واحد سرویس اختیاری
.BR systemd (1)
برای این دستور، سازوکار شناسایی خودکار موقعیت مکانی را برای برچسب‌های متریک PCP فراهم می‌کند.
.SH "برچسب‌های متریک (METRIC LABELS)"
خروجی JSON، قالب ترجیحی برای ذخیرهٔ موقعیت جغرافیایی به عنوان برچسب‌های متریک PCP است.
هر متریک PCP موجود از این میزبان با برچسب‌های عرض و طول جغرافیایی برچسب‌گذاری خواهد شد، که این امر ابزارهای استفاده‌کننده از این اطلاعات مانند پنل geomap در Grafana را فعال می‌سازد.
.PP
برای اطلاعات بیشتر دربارهٔ برچسب‌های متریک به صفحات راهنمای
.BR pmcd (1)،
.BR pminfo (1)،
.BR pmlogger (1)
و
.BR pmLookupLabels (3)
مراجعه کنید.
.SH "محیط PCP (PCP ENVIRONMENT)"
متغیرهای محیطی با پیشوند \fBPCP_\fP برای پارامتریک‌سازی نام فایل‌ها و دایرکتوری‌های استفاده‌شده توسط PCP به کار می‌روند.
در هر نصب، فایل \fI/etc/pcp.conf\fP حاوی مقادیر محلی برای این متغیرها است.
متغیر \fB$PCP_CONF\fP می‌تواند برای تعیین یک فایل پیکربندی جایگزین استفاده شود، همان‌طور که در \fBpcp.conf\fP(5) شرح داده شده است.
.SH "همچنین ببینید (SEE ALSO)"
.BR PCPIntro (1)،
.BR pmcd (1)،
.BR pminfo (1)،
.BR pmseries (1)،
.BR pmlogger (1)،
.BR systemd (1)،
.BR pmLookupLabels (3)،
.BR pcp.conf (5)
و
.BR pcp.env (5).

.\" control lines for scripts/man-spell
.\" +ok+ Grafana geomap