Performance Co-Pilot (PCP) archives may contain a wealth of information collected from across all
components of a system.
Some of this information may be deemed sensitive outside the context of the original collection for
analysis of system performance. Examples of sensitive information might include user names, paths to
user home directories (that may imply user names), hostnames, IP addresses, MAC addresses, command line
arguments, process environment variables, etc.
pmlogredact may be used to remove sensitive information before archives are shipped to another
organization, or stored in another geography, or to meet regulatory or privacy compliance. The output
archive outarch is the redacted version of the input archive inarch.
pmlogredact is a thin wrapper around pmlogrewrite(1), and so the configuration files for pmlogredact
follow the same syntax as the configuration files for pmlogrewrite(1).
There are a default set of redaction rules in the $PCP_VAR_DIR/config/pmlogredact/* files. These rules
remove some metrics, rewrite the instance domains of some metrics and rewrite the values of some metrics.
The -x (or --exclude-std) option may be used to not use the default set of rules.
Additional (or alternative) configuration files may be specified with one or more -c (or --config) op‐
tions, where each config is either a file or a directory (implying all the files within that directory).
The -v (or --verbose) option adds verbosity (and is passed directly to pmlogrewrite(1)).
The -? (or --help) option displays a usage message and exits.