LABELS.CONF(5)

💖 LABELS.CONF 💖

okay bestie, so this is the manual for labels.conf — it's part of the File Formats Manual fam, and it's literally just called labels.conf (Performance Co-Pilot labels configuration, if we're being formal). it's the lil config file that tells PCP how to do its labels thing. let's get into it 🎀

✨ SYNOPSIS ✨

/etc/pcp/labels.conf

that's it. one file. one vibe. she's lowkey iconic for that 🦋

🌸 DESCRIPTION 🌸

so, a bunch of Performance Co-Pilot (PCP) tools and utilities are out here supporting metric labels. what that means is: this functionality applied a hierarchical set of labels to each instance of every metric — and it's all described over in pmLookupLabels(3) if you wanna go deeper, which you should, no cap 💅

now, the pmcd(1) and pmproxy(1) daemons? they are main character energy in the labels system. like, genuinely crucial. pmcd(1) is the one serving up the labels in real-time, and pmproxy(1) is the one discovering recorded (archive) labels and indexing all of that so pmseries(1) queries can go off — using a distributed key-value service like https://valkey.io/ ✨

and the /etc/pcp/labels.conf file? she is the 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 here's the tea: any variable it specifies that is not sitting inside an explicit square-bracket enclosed section gets treated as a [global] variable. so if you're being lazy with your sections, congrats, it's global now 🙈

the available configuration variables are as follows :

• machineid_hash=none|sha256 — when you put this in the [global] section, it controls the manner in which the local machine-id(5) is exported as a label. the default setting (none) exports a "machineid" context label, and its value reflects 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. so like, either you're showing the whole thing or you're showing the glow-up version 🔥

ngl the one-way hash one is giving privacy-conscious queen. pick your fighter 💅

🫶 SEE ALSO 🫶

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

go read 'em, bestie, they're all in the group chat 💜

mwah, that's the whole page. this one's brought to you by Performance Co-Pilot — PCP — and it's the LABELS.CONF(5) girlie herself. go configure something cute 💖✨🎀