1PCP-GEOLOCATE(1)            General Commands Manual           PCP-GEOLOCATE(1)
2
3
4

NAME

6       pcp-geolocate - discover collector system geographical labels
7

SYNOPSIS

9       pcp geolocate
10

DESCRIPTION

12       pcp-geolocate  reports the latitude and longitude for the local Perfor‐
13       mance Co-Pilot collector host in JSON format.  This geolocation  infor‐
14       mation  is  sourced  from  the  cache  file $PCP_SYSCONF_DIR/labels/op‐
15       tional/geolocate if it exists, else an attempt is made to  perform  ge‐
16       olocation  based  on  the  host  IP address, via several online sources
17       (REST APIs).
18
19       The output from this command is suited for storing as metric labels  by
20       saving it to the cache file mentioned above.
21
22       The  opt-in  systemd(1)  service unit file for this command provides an
23       automated location discovery for PCP metric labels.
24

METRIC LABELS

26       The JSON output is the preferred format for storing geographical  loca‐
27       tion  as  PCP metric labels.  Every PCP metric available from this host
28       will be tagged with the labels for  latitude  and  longitude,  enabling
29       tools that make use of this such as the Grafana geomap panel.
30
31       For  more  information  about  metric  labels  refer  to  the  pmcd(1),
32       pminfo(1), pmlogger(1) and pmLookupLabels(3) manual entries.
33

PCP ENVIRONMENT

35       Environment variables with the prefix PCP_ are used to parameterize the
36       file  and  directory names used by PCP.  On each installation, the file
37       /etc/pcp.conf contains the  local  values  for  these  variables.   The
38       $PCP_CONF  variable may be used to specify an alternative configuration
39       file, as described in pcp.conf(5).
40

SEE ALSO

42       PCPIntro(1), pmcd(1), pminfo(1), pmseries(1), pmlogger(1),  systemd(1),
43       pmLookupLabels(3), pcp.conf(5) and pcp.env(5).
44
45
46
47Performance Co-Pilot                  PCP                     PCP-GEOLOCATE(1)