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 la‐
14       bels  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  pm‐
20       series(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 re‐
34            flecting 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