---
name: "clustervis"
section: "1"
platform: "linux"
package: "pcp"
version: "7.2.2-2"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/clustervis"
---

# clustervis(1)

visualize cpu and network performance on a cluster

## NAME

**clustervis** - visualize cpu and network performance on a cluster

## SYNOPSIS

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

## DESCRIPTION

**clustervis** displays three dimensional bar charts of CPU utilization and network traffic for one or most hosts in a cluster. An alternative two dimensional cluster performance monitoring tool is **pmgcluster**(1). **clustervis** is designed to provide a scalable overview of the performance of large clusters. Other tools such as [**pmchart**(1)](/pmchart/1.md) and **pmgsys**(1) provide drill-down details on a per-host basis. These tools may be launched by clicking on the purple base plane for a particular host and then selecting a tool from the *launch* menu in **clustervis**.

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. Otherwise, if **-H** is given, then the set of hosts is given in *nodesfile*.

The **-h** flag specifies one or more (comma separated with no spaces) hosts for live monitoring and the **-a** flag specifies one or more archives for archive replay (comma separated).

The height of the CPU stack is proportional to the CPU utilization in each of the modes **sys** (red, executing in the kernel) and **user** (blue, executing user code). The network traffic stack is shown for each network interface as the packet rate **in** (light blue), **out** (orange) and **errors** (red). The hight of the network stack is modulated by the **-m** argument, with a default of *750* packets/second representing saturated network traffic.

**clustervis** generates a [**pmview**(1)](/pmview/1.md) configuration file, and passes most command line options to [**pmview**(1)](/pmview/1.md). Therefore, the command line options **-A**, **-a**, **-C**, **-h**, **-n**, **-O**, **-p**, **-S**, **-t**, **-T**, **-Z** and **-z**, and the user interface are described in the [**pmview**(1)](/pmview/1.md) man page.

## FILES

- **$PCP\_VAR\_DIR/config/pmlogger/config.clustervis**

  A [**pmlogger**(1)](/pmlogger/1.md) configuration file for **clustervis** metrics.

- **/usr/pcp/lib/pmview-args**

  Shell procedures for parsing [**pmview**(1)](/pmview/1.md) command line options.

- **/etc/nodes**

  Default set of hosts in the cluster.

## 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 **#**). 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)](/pcp.conf/4.md).

## SEE ALSO

[**dkvis**(1)](/dkvis/1.md), [**mpvis**(1)](/mpvis/1.md), [**nfsvis**(1)](/nfsvis/1.md), [**pmcd**(1)](/pmcd/1.md), [**pmchart**(1)](/pmchart/1.md), [**pmlogger**(1)](/pmlogger/1.md), [**pmview**(1)](/pmview/1.md), [**pcp.conf**(4)](/pcp.conf/4.md) and [**pcp.env**(4)](/pcp.env/4.md).

The **CPU** view for [**pmchart**(1)](/pmchart/1.md).