1LABELS.CONF(5)                File Formats Manual               LABELS.CONF(5)
2
3
4

NAME

6       labels.conf - Performance Co-Pilot labels configuration
7

SYNOPSIS

9       /etc/pcp/labels.conf
10

DESCRIPTION

12       Several  Performance Co-Pilot (PCP) tools and utilities support the use
13       of metric labels.  This functionality applied  a  hierarchical  set  of
14       labels  to  each  instance of every metric, as described in pmLookupLa‐
15       bels(3).
16
17       The pmcd(1) and pmproxy(1) daemons are particularly  important  to  the
18       labels  system, respectively providing the labels in real-time and then
19       discovering  recorded  (archive)  labels   and   indexing   these   for
20       pmseries(1) queries using a redis-server(1).
21
22       The  /etc/pcp/labels.conf  file  is a single point of configuration for
23       behaviour affecting all labels exported by pmcd or through tools  using
24       PMAPI  local  context services.  It uses the common ``ini'' file format
25       and any variable it specifies that is not in an explicit square-bracket
26       enclosed section is considered a [global] variable.
27
28       The available configuration variables are as follows :
29
30       machineid_hash=none|sha256
31            When  specified  in  the  [global] section, controls the manner in
32            which the local machine-id(5) is exported as a label.  The default
33            setting  (none)  exports  a  "machineid"  context label with value
34            reflecting the contents of the /etc/machine-id file, on any  plat‐
35            forms  that provide this file.  The alternative (sha256) exports a
36            "machineid_sha256" label, instead, and the  value  is  the  SHA256
37            (one-way) hash of the file.
38

SEE ALSO

40       pmcd(1),  pmproxy(1),  pmseries(1), redis-server(1), PMAPI(3), pmLooku‐
41       pLabels(3) and machine-id(5).
42
43
44
45Performance Co-Pilot                  PCP                       LABELS.CONF(5)
Impressum