NAME¶

pmlogsize - report sizes for parts of PCP archive(s)

SYNOPSIS¶

pmlogsize [-drv] [-x thres] archive ...

DESCRIPTION¶

pmlogsize prints information about the size of the index, metadata and data sections of a Performance Co-Pilot (PCP) archive. The output is intended to guide improvements in archive encoding format for PCP developers and to help trim pmlogger(1) configuration files to remove metrics that are bloating the PCP archives with low-value data in production environments.

The archive arguments can be any mixture of the names of the physical files of a PCP archive or the basename that is common to all the component physical files in a single archive. In the latter case archive is replaced by a list of all of the matching component file names.

Note the semantics is a little different to other PCP tools in that foo.meta means just the file foo.meta, not foo.index, foo.meta, foo.0, etc.

The -d flag requests more detailed reporting. This means space per instance domain in a metadata file and space per metric (for values) in a data file.

The -r flag requests additional information about possible replicated values in the data file and replicated instances in the metadata file. It implies -d.

When the -d (or -r) flag is specified, the -x flag may be used to cut off the report after at least thres percent of the associated space (metric values or instance domains) has been reported. The default behaviour is equivalent to thres being set to 100.

Additional verbosity can be enabled with one or more -v flags.

SEE ALSO¶

PCPIntro(1), pmdumplog(1), pmlogcheck(1) and pmlogger(1).

DIAGNOSTICS¶

All are generated on standard error and are intended to be self- explanatory.