|
NAME | SYNOPSIS | DESCRIPTION | SEE ALSO | COLOPHON |
|
|
|
LABELS.CONF(5) File Formats Manual LABELS.CONF(5)
labels.conf - Performance Co-Pilot labels configuration
/etc/pcp/labels.conf
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.
pmcd(1), pmproxy(1), pmseries(1), PMAPI(3), pmLookupLabels(3) and
machine-id(5).
This page is part of the PCP (Performance Co-Pilot) project.
Information about the project can be found at
⟨http://www.pcp.io/⟩. If you have a bug report for this manual
page, send it to [email protected]. This page was obtained from the
project's upstream Git repository
⟨https://github.com/performancecopilot/pcp.git⟩ on 2025-08-11.
(At that time, the date of the most recent commit that was found
in the repository was 2025-08-11.) If you discover any rendering
problems in this HTML version of the page, or you believe there is
a better or more up-to-date source for the page, or you have
corrections or improvements to the information in this COLOPHON
(which is not part of the original manual page), send a mail to
[email protected]
Performance Co-Pilot PCP LABELS.CONF(5)
Pages that refer to this page: pmcd(1), pmlookuplabels(3)