CLUSTERVIS(1)

🎀 NAME 🎀

clustervis — it visualizes cpu and network performance on a cluster. that's the whole vibe. 💖

---

🦋 SYNOPSIS 🦋

clustervis [-H nodesfile] [-h host[,host...]]  [-a archive[,archive...]]
       [-m max] [pmview options]

---

✨ DESCRIPTION ✨

okay so clustervis pulls up three dimensional bar charts of CPU utilization and network traffic for one or more hosts in a cluster. it's giving data, but make it art. 🎨

if you want a different flavour, there's an alternative two dimensional cluster performance monitoring tool called pmgcluster(1). and clustervis is literally designed to give you a scalable overview of the performance of large clusters — like, the whole cluster at once, bestie. 👑

other tools like pmchart(1) and pmgsys(1) are the ones that give you the drill-down details on a per-host basis. and here's the cute part: you can launch those tools by clicking on the purple base plane for a particular host, and then selecting a tool from the launch menu in clustervis. click a purple square, get a whole new tool. main character energy fr. 💜

🫶 the -H, -h and -a situation

the -H, -h and -a arguments are all mutually exclusive and have the following semantics:

• if none of -H, -h or -a is given, and either the file /etc/nodes or /etc/ace/nodes exists, or the $PCP_CLUSTER_CONFIG environment variable is set, then use the named file as the set of hosts for live monitoring. 🌈
• if the default nodes file does not exist, the environment variable is not set, and none of the three flags were given, an error is reported. 😭 no hosts, no chart, no service.
• otherwise, if -H is given, then the set of hosts is given in nodesfile. 💖

the -h flag specifies one or more hosts for live monitoring (comma separated, no spaces), and the -a flag specifies one or more archives for archive replay (comma separated). ngl, the no-spaces thing is important. don't be cute with it. 💅

📊 what you're actually looking at

the height of the CPU stack is proportional to the CPU utilization in each of the modes:

• sys — red, executing in the kernel
• user — blue, executing user code

the network traffic stack is shown for each network interface as the packet rate:

• in — light blue
• out — orange
• errors — red

the height of the network stack is modulated by the -m argument, with a default of 750 packets/second representing saturated network traffic. so like, that's your "this is a lot of packets" line. 🔥

🌸 one more thing

clustervis generates a pmview(1) configuration file, and passes most command line options to pmview(1). therefore, the command line options -A, -a, -C, -h, -n, -O, -p, -S, -t, -T, -Z and -z, and the user interface, are all described in the pmview(1) man page. go read that one too, i'm not retyping it. 🙈

---

📁 FILES 📁

• $PCP_VAR_DIR/config/pmlogger/config.clustervis — a pmlogger(1) configuration file for clustervis metrics. the receipts file. 🧾
• /usr/pcp/lib/pmview-args — shell procedures for parsing pmview(1) command line options. the little parser bestie. 🫶
• /etc/nodes — default set of hosts in the cluster. your og host list. 🌸

---

🌈 PCP ENVIRONMENT 🌈

the PCP_CLUSTER_CONFIG environment variable may be used to specify the default nodes file instead of using the -H flag. each line in the file is a host name (or a comment starting with #). so, one host per line, and # for your lil notes. 💅

other 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. the $PCP_CONF variable may be used to specify an alternative configuration file, as described in pcp.conf(4). ⭐

---

👑 SEE ALSO 👑

• dkvis(1)
• mpvis(1)
• nfsvis(1)
• pmcd(1)
• pmchart(1)
• pmlogger(1)
• pmview(1)
• pcp.conf(4)
• pcp.env(4)

also, the CPU view for pmchart(1). 🎀

---

💖 that's the whole page bestie. go make some 3D bar charts, you got this. periodt.

stay slaying, this was brought to you by Performance Co-Pilot, CLUSTERVIS(1), straight out of the General Commands Manual (section 1, where the user commands live). 🦋✨