|
HTML rendering created 2024-06-26 by Michael Kerrisk, author of The Linux Programming Interface. For details of in-depth Linux/UNIX system programming training courses that I teach, look here. Hosting by jambit GmbH. |
|
|
NAME | SYNOPSIS | DESCRIPTION | METRIC LABELS | PCP ENVIRONMENT | SEE ALSO | COLOPHON |
|
|
|
PCP-GEOLOCATE(1) General Commands Manual PCP-GEOLOCATE(1)
pcp-geolocate - discover collector system geographical labels
pcp geolocate
pcp-geolocate reports the latitude and longitude for the local
Performance Co-Pilot collector host in JSON format. This
geolocation information is sourced from the cache file
$PCP_SYSCONF_DIR/labels/optional/geolocate if it exists, else an
attempt is made to perform geolocation based on the host IP
address, via several online sources (REST APIs).
The output from this command is suited for storing as metric
labels by saving it to the cache file mentioned above.
The opt-in systemd(1) service unit file for this command provides
an automated location discovery for PCP metric labels.
The JSON output is the preferred format for storing geographical
location as PCP metric labels. Every PCP metric available from
this host will be tagged with the labels for latitude and
longitude, enabling tools that make use of this such as the
Grafana geomap panel.
For more information about metric labels refer to the pmcd(1),
pminfo(1), pmlogger(1) and pmLookupLabels(3) manual entries.
Environment variables with the prefix PCP_ are used to
parameterize the file and directory names used by PCP. On each
installation, the file /etc/pcp.conf contains the local values
for these variables. The $PCP_CONF variable may be used to
specify an alternative configuration file, as described in
pcp.conf(5).
PCPIntro(1), pmcd(1), pminfo(1), pmseries(1), pmlogger(1),
systemd(1), pmLookupLabels(3), pcp.conf(5) and pcp.env(5).
This page is part of the PCP (Performance Co-Pilot) project.
Information about the project can be found at
⟨http://www.pcp.io/⟩. If you have a bug report for this manual
page, send it to [email protected]. This page was obtained from the
project's upstream Git repository
⟨https://github.com/performancecopilot/pcp.git⟩ on 2024-06-14.
(At that time, the date of the most recent commit that was found
in the repository was 2024-06-14.) If you discover any rendering
problems in this HTML version of the page, or you believe there
is a better or more up-to-date source for the page, or you have
corrections or improvements to the information in this COLOPHON
(which is not part of the original manual page), send a mail to
[email protected]
Performance Co-Pilot PCP PCP-GEOLOCATE(1)
|
HTML rendering created 2024-06-26 by Michael Kerrisk, author of The Linux Programming Interface. For details of in-depth Linux/UNIX system programming training courses that I teach, look here. Hosting by jambit GmbH. |
|