PMSERIES_IMPORT(1)

✨ PMSERIES_IMPORT ✨

okay so bestie, welcome to pmseries_import(1) — that's section 1 of the General Commands Manual, so you know it's a real one 💅

🌸 NAME 🌸

pmseries_import — import PCP archive files so you can do historical time series querying later 🦋

🎀 SYNOPSIS 🎀

$PCP_BINADM_DIR/pmseries_import [-h] [--archives path] [--json file]
[--import-timeout time] [--noop] [--poll-interval delta] [-p port] [-Z
TZ]

💖 DESCRIPTION 💖

So like, here's the vibe: pmseries_import keeps an eye on a given path full of PCP archives, and when it spots them it automatically loads their contents into a key server (think Valkey or Redis 👑). And once they're in there? Chef's kiss. That data is now suitable for fast time series querying using the pmseries(1) language — which you get via the command line tool and the PCP REST API services of pmproxy(1). slay.

Not me checking the archives directory every 10 seconds… literally that's the whole technique. pmseries_import uses a simple polling approach, scanning the archives directory for new archive files every 10 seconds. periodt. ⏰

This utility is most commonly used inside a container that's giving automated Grafana dashboard setup for arbitrary PCP archives ✨. That whole approach hands you an environment containing a systemd(1) server to enable this archive monitoring utility, plus a pre-configured grafana-server(1), valkey-server(1), and pmproxy(1) REST API services. it's giving infrastructure. 🫶

⭐ OPTIONS ⭐

• --archives=path — lets you point at a different path to poll for new PCP archives. the default value is /archives 🍓
• --jsonfile=file — names an alternate JSON format file that gets updated whenever the time window boundaries are seen to have changed. heads up bestie, this file must contain JSON content, and that content includes a JSON map named "time" with "start" and "end" fields — that's where the string timestamps will be written. the default value is /usr/local/var/lib/grafana/dashboards/pcp-archive-analysis.json 📁
• -h, --help — displays the command usage message and then exits. classic. no notes. 💁
• --import-timeout=timeout — pick a number of seconds to allow for any individual archive import to complete, via the pmseries load command for that archive. the default timeout value is 600 seconds (5 minutes) ⏳
• --noop — skips all write operations (for debugging or testing purposes, iykyk), reporting only diagnostic messages instead. nothing gets written, she's just talking 🌸
• --poll-interval=delta — how often the archive directory gets scanned. the default delta is once every 10 seconds 🔁
• -p port, --port=port — an optional port on which pmseries should connect to the key server. the default port is **6379 🔌
• *-Z *TZ, --timezone=TZ — an optional TZ value indicating the timezone to which pmseries should convert all archive timestamps when it sends values to the key server 🌍

🦋 SEE ALSO 🦋

grafana-server(1), systemd(1), valkey-server(1), pmproxy(1) and pmseries(1). go read them, they're iconic 💜

ok that's the whole page, you ate it, no cap 💅✨

and that's a wrap, bestie — brought to you by Performance Co-Pilot (PCP) 🎀 she's iconic, she's everything, mwah 💖