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 distributed key-value service such as https://valkey.io/.

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), PMAPI(3), pmLookupLabels(3) and machine-id(5).