NAME

       labels.conf - Performance Co-Pilot labels configuration

SYNOPSIS

       /etc/pcp/labels.conf

DESCRIPTION

       Several  Performance  Co-Pilot  (PCP)  tools  and  utilities  support  the  use  of  metric labels.  This
       functionality applied a hierarchical set of labels to each instance of  every  metric,  as  described  in
       pmLookupLabels(3).

       The  pmcd(1)  and  pmproxy(1)  daemons  are  particularly  important  to  the labels system, respectively
       providing the labels in real-time and then discovering recorded (archive) labels and indexing  these  for
       pmseries(1) queries using a redis-server(1).

       The  /etc/pcp/labels.conf  file  is  a  single  point of configuration for behaviour affecting all labels
       exported by pmcd or through tools using PMAPI local context services.  It uses the  common  ``ini''  file
       format  and  any  variable  it  specifies  that  is not in an explicit square-bracket enclosed section is
       considered a [global] variable.

       The available configuration variables are as follows :

       machineid_hash=none|sha256
            When specified in the [global] section, controls the manner in  which  the  local  machine-id(5)  is
            exported  as  a  label.   The  default setting (none) exports a "machineid" context label with value
            reflecting the contents of the /etc/machine-id file, on any platforms that provide this  file.   The
            alternative  (sha256) exports a "machineid_sha256" label, instead, and the value is the SHA256 (one-
            way) hash of the file.

SEE ALSO

       pmcd(1), pmproxy(1), pmseries(1), redis-server(1), PMAPI(3), pmLookupLabels(3) and machine-id(5).