PMLOGPASTE(1)

💖 PMLOGPASTE(1) — bestie's guide to yeeting text into a PCP archive 💖

okay so welcome to pmlogpaste, a General Commands Manual situation, and honestly? she's a baddie. let's get into it. 🫶

✨ NAME ✨

pmlogpaste — paste text into a metric in a PCP archive 💅

🌸 SYNOPSIS 🌸

pmlogpaste [-?] [-f file] [-h hostname] [-l label] [-m metric] [-o
outfile] [-t timezone]

🦋 DESCRIPTION 🦋

so like. pmlogpaste takes input text — from a file OR straight off the command line — and writes it as a metric value in a brand new PCP archive. that metric value gets timestamped with the current time, and it's stored as a string type metric. no cap. 🎀

the main purpose of this tool is to take captured output and preserve it in a PCP archive. which means, for example, the output of a benchmark run can be stored along with performance metrics captured during that run, all in a single archive. iconic behaviour honestly. and if you wanna merge archives together, you can do that with the pmlogextract(1) utility. 🌈

under the hood, pmlogpaste uses the LOGIMPORT(3) library interfaces internally, and those are the ones that support the creation of archives from external sources of performance data. she's built different fr fr. ✨

💅 OPTIONS 💅

here's the full menu, bestie, no skipping:

• -f file, --file=file — file with input text to be archived, or - for standard input. (yes literally a single dash, she'll take it from stdin, we love a flexible queen 🍓)
• -h hostname, --hostname=hostname — source host name for the archive. the default value is the local host name, or localhost if that cannot be obtained. (she tries her best, okay 😭)
• -l label, --label=label — add context labels to the generated archive. this option can be presented multiple times to produce multiple labels in the archive. the label should be in the form name:value. stack 'em up, collect 'em all 🎀
• -m metric, --metric=metric — metric name for the archive. the default metric name is paste.value. 👑
• -o outfile, --outfile=outfile — archive output file. the default archive name is paste. 💖
• -t timezone, --timezone=timezone — source timezone for the archive. the default value is the local timezone. 🌸
• -?, --help — display usage message and exit. the classic "help me help you" moment 🫶

🌟 PCP ENVIRONMENT 🌟

environment variables with the prefix PCP_ are used to parameterize the file and directory names used by PCP. on each installation, the file /etc/pcp.conf contains the local values for these variables. and the $PCP_CONF variable may be used to specify an alternative configuration file, as described in pcp.conf(5). iykyk 💜

👑 SEE ALSO 👑

PCPIntro(1), pmcd(1), pmlogextract(1) and LOGIMPORT(3). go read them, they're all part of the friend group 🦋

and that's the whole page, bestie!! brought to you by Performance Co-Pilot (that's the PCP girlies 💖), and this page right here is PMLOGPASTE(1) from the General Commands Manual. periodt. 💅✨